Use Leap from your agent

The Leap skill teaches a coding agent, such as Claude Code or Codex, to write code against the API. The MCP server lets an agent make images, video and audio itself, with no code. And every page of these docs is also plain Markdown, with an index for LLMs.

Install the Leap skill

One command installs the skill for every coding agent it finds on your machine: Claude Code, Codex, and agents that read .agents/skills.

curl -fsSL https://www.tryleap.ai/install.sh | sh

The skill tells the agent which endpoints to call, how to read a model’s schema, when to wait and when to poll, how to upload files and how to handle errors. Run the command again to update it.

Option	Effect
`sh -s -- --project`	Install into the current repository instead (`.claude/skills` and `.agents/skills`), so everyone who clones it gets the skill.
`sh -s -- --mcp`	Also connect Claude Code to Leap’s MCP server.

The skill is also one readable file at www.tryleap.ai/skills/leap/SKILL.md.

Connect over MCP

Leap’s MCP server lets an agent find models, read their schemas, price a run, generate and check on it. Connect with your Leap account, signing in once in the browser, or with an API key for clients that can’t sign in and for agents that run unattended.

Claude Code
Claude.ai and ChatGPT
VS Code

claude mcp add --transport http leap https://app.tryleap.ai/api/mcp

Then run /mcp in Claude Code and choose leap to sign in.

Add a custom connector with the URL https://app.tryleap.ai/api/mcp. In Claude, that’s Settings, then Connectors. In ChatGPT, it’s Settings, then Apps and connectors.

Add this to .vscode/mcp.json:

{
  "servers": {
    "leap": { "type": "http", "url": "https://app.tryleap.ai/api/mcp" }
  }
}

Any other client works if it supports MCP’s OAuth sign-in with client metadata documents. You approve what the agent may do, and it spends the workspace you choose.

Connect with an API key

The key goes in the Authorization header. The agent then works in the key’s workspace, with the key’s scopes.

Cursor
Claude Code
Codex

Add this to .cursor/mcp.json, with LEAP_API_KEY set in your environment:

{
  "mcpServers": {
    "leap": {
      "url": "https://app.tryleap.ai/api/mcp",
      "headers": { "Authorization": "Bearer ${env:LEAP_API_KEY}" }
    }
  }
}

claude mcp add --transport http leap https://app.tryleap.ai/api/mcp --header "Authorization: Bearer $LEAP_API_KEY"

codex mcp add leap --url https://app.tryleap.ai/api/mcp --bearer-token-env-var LEAP_API_KEY

Tool	What it does
`search_models`	Finds models and presets by what they make.
`get_model`	Returns one model with its input schema and price.
`quote`	Prices a run without starting it.
`generate`	Runs a model or preset and waits for the result, with thumbnails the agent can look at.
`get_generation`	Reads a run’s status, cost and outputs.
`cancel_generation`	Stops a run that hasn’t finished.
`get_account`	Shows the balance of the workspace the agent spends from.
`list_workspaces`	Lists your workspaces, so the agent can pick one.

The agent spends the balance of the workspace you choose, at the same prices as the API.

Point your agent at these docs

www.tryleap.ai/docs/llms.txt lists every page with a one-line summary.
www.tryleap.ai/docs/llms-full.txt is every page in one file.
Add .md to any page’s URL for its Markdown, such as www.tryleap.ai/docs/quickstart.md.
The menu at the top of each page copies it as Markdown, or opens it in ChatGPT or Claude.

To add Leap to an app with a coding agent, paste this prompt:

Add Leap media generation to this app. Read https://www.tryleap.ai/docs/llms.txt first, then the Quickstart, Generations and Files pages it links to.

- Call https://api.tryleap.ai from server code only, with the key from the LEAP_API_KEY environment variable in the x-api-key header.
- Pick the model, then read its input schema from GET /v1/models/{creator}/{name} (input_schema). Send only fields the schema lists; unknown fields are a 400.
- Files are inputs by ID, never by URL: upload images to POST /v1/files (raw bytes as the body) and videos or sounds through POST /v1/uploads, then pass the file_... ID.
- Start runs with POST /v1/generations and a new idempotency-key header per request. For images, send prefer: wait=60 to get the result in one call. For video, long-poll: read GET /v1/generations/{id} with prefer: wait=60 in a loop until status is succeeded, failed or canceled. In a web app, name a webhook URL on the request instead (see /docs/webhooks).
- Check status before reading output. A failed run has error.message and isn't charged.
- Output URLs expire after 24 hours: download what you keep, or read the generation again for fresh links.
- On an error answer, branch on error.type and error.code, and show error.message to the user.

Get started

Build

Examples

Agents

Use Leap from your agent

Install the Leap skill

Connect over MCP

Connect with an API key

Point your agent at these docs

​Install the Leap skill

​Connect over MCP

​Sign in with your Leap account

​Connect with an API key

​Point your agent at these docs

Install the Leap skill

Connect over MCP

Sign in with your Leap account

Connect with an API key

Point your agent at these docs