Connect a client

Every client connects to the same server URL:

https://app.tryleap.ai/api/mcp

The first time you use it, the client opens Leap in your browser. Sign in, or create an account on the same page, and select Allow. The client never sees your password or an API key. Sign-in and scopes explains what you allow.

ChatGPT

Add Leap as a custom MCP server on chatgpt.com.

Claude

One link adds Leap as a connector on the web, desktop and mobile.

Claude Code

One command, then /mcp to sign in.

Codex

The CLI, the IDE extension and the ChatGPT desktop app.

Cursor

Install from a link, with an API key.

Visual Studio Code

Install from a link, or add it to mcp.json.

ChatGPT

Add Leap to ChatGPT as a custom MCP server, on chatgpt.com.

Add the server

Go to chatgpt.com/plugins, select the plus button, then Add custom MCP server. Name it Leap, and enter the server URL https://app.tryleap.ai/api/mcp.If you don’t see that option, turn on developer mode in ChatGPT’s settings first. In a work or school workspace, an admin may have to allow custom servers.

Choose OAuth

For authentication, choose OAuth. Leave the client ID and secret empty: Leap reads ChatGPT’s published client details, so there’s nothing to register. Read the warning, select I understand and want to continue, then Create as a plugin.

Install it and sign in

Install the plugin, then sign in to Leap and select Allow when ChatGPT opens the sign-in page.

Use it in a chat

Type @ in the message box, pick Leap, and ask for what you want.

ChatGPT asks you to confirm each call that changes something, such as a run or an upload, and shows what it will send. You can let it remember your answer for the rest of the conversation. A file you attach in the chat goes straight to Leap when the agent needs it as an input. OpenAI’s plugin rules don’t allow links to a checkout, so in ChatGPT and Codex, when you’re out of credit, the agent points you to Leap’s prices. Add credits in the studio at app.tryleap.ai/go/settings/credits.

Claude

Leap is a custom connector in Claude. Claude’s connector directory doesn’t list apps that generate images, video or audio, so you add Leap by its URL. This link opens Claude with the name and URL filled in:

Add Leap to Claude

Opens Claude’s connector settings with Leap ready to add.

Add the connector

Open the link above and select Add. To do it by hand, go to Customize, Connectors, select Add custom connector, and enter Leap and https://app.tryleap.ai/api/mcp. Keep the default sign-in settings.

Connect

Select Connect, sign in to Leap and select Allow.

Use it in a chat

Ask for what you want. If Claude doesn’t reach for Leap, check that it’s on under the + button, Connectors, or start with “Use Leap to”.

Once added, Leap works on claude.ai, in Claude Desktop and in the Claude mobile apps. The mobile apps show connectors you added on the web or on desktop; you can’t add one from a phone. The Free plan allows one custom connector. On a Team or Enterprise plan, an Owner adds Leap under Organization settings, Connectors (Add, then Custom), and each member then connects with their own Leap account. Claude asks before each tool call until you choose Always allow for that tool. To stop Claude from spending at all, open Leap under Customize, Connectors and set generate and generate_batch to Blocked. Claude can’t hand Leap a picture you attach in the chat, so give it a public link to the photo instead.

Claude Code

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

Then run /mcp in Claude Code, choose leap, and select Authenticate. Your browser opens to sign in. The command adds Leap to the current project only. Add --scope user to have it in every project, or --scope project to write it to the project’s .mcp.json so everyone who clones the repository gets it. If you already added Leap on claude.ai with the same Claude account, it’s in /mcp as claude.ai Leap and needs no command. To install the Leap skill and connect the server in one go:

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

Claude Code shows results as text, with thumbnails it can look at and links to the files. It can read a photo on your computer and pass a small one to upload_file as base64.

Codex

codex mcp add leap --url https://app.tryleap.ai/api/mcp
codex mcp login leap

codex mcp login opens your browser to sign in. Or add the server to ~/.codex/config.toml yourself, then run codex mcp login leap:

[mcp_servers.leap]
url = "https://app.tryleap.ai/api/mcp"

The Codex CLI, the IDE extension and the ChatGPT desktop app share this file, so you set Leap up once for all three. In the Codex TUI, /mcp lists your servers. As in ChatGPT, the agent points you to Leap’s prices when you need credit, and you add it in the studio.

Cursor

Cursor can’t sign in with your Leap account yet, so it connects with an API key. Create one at app.tryleap.ai/go/api and set it as LEAP_API_KEY in your environment, then add the server:

Add Leap to Cursor

Opens Cursor and installs Leap with the settings below.

Or add this to ~/.cursor/mcp.json for every project, or to .cursor/mcp.json for one:

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

Cursor reads the key from the environment it started in, so restart it after you set the variable. With a key, the agent works in the key’s workspace and can do what the key can.

Visual Studio Code

Add Leap to VS Code

Opens VS Code and installs Leap for your user.

Or add it to one project, in .vscode/mcp.json:

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

VS Code asks you to sign in to Leap the first time it starts the server. Use Leap from Copilot Chat in agent mode.

Any other client

Leap’s server speaks MCP over Streamable HTTP and is stateless, so any client that supports remote servers can use it. It signs clients in with OAuth 2.1, or takes an API key.


Server	`https://app.tryleap.ai/api/mcp` (Streamable HTTP)
Resource metadata	`https://app.tryleap.ai/.well-known/oauth-protected-resource/api/mcp`
Authorization server	`https://app.tryleap.ai/api/auth`
Client registration	A Client ID Metadata Document: your client ID is the HTTPS URL of a JSON document that describes your client. Dynamic client registration is off.
Scopes	`workspace:read media:generate offline_access`
Without OAuth	A Leap API key in the `x-api-key` header, or as `Authorization: Bearer leap_...`

A request without credentials gets a 401 whose WWW-Authenticate header points to the resource metadata and names the scopes to ask for, so a client that follows the MCP authorization spec signs in on its own. Use PKCE, and ask for offline_access to get a refresh token: an access token lasts 15 minutes. To check a key, list the tools:

curl https://app.tryleap.ai/api/mcp \
  -H "Authorization: Bearer $LEAP_API_KEY" \
  -H "content-type: application/json" \
  -H "accept: application/json, text/event-stream" \
  -H "mcp-protocol-version: 2025-06-18" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}'

The server refuses requests that a web page on another site sends from a browser (any Origin it doesn’t trust gets a 403), so call it from a server, a desktop app or a CLI.

Get started

Build

MCP server

Examples

Agents

Connect a client

ChatGPT

Claude

Claude Code

Codex

Cursor

Visual Studio Code

ChatGPT

Claude

Add Leap to Claude

Claude Code

Codex

Cursor

Add Leap to Cursor

Visual Studio Code

Add Leap to VS Code

Any other client

ChatGPT

Claude

Claude Code

Codex

Cursor

Visual Studio Code

​ChatGPT

​Claude

Add Leap to Claude

​Claude Code

​Codex

​Cursor

Add Leap to Cursor

​Visual Studio Code

Add Leap to VS Code

​Any other client

ChatGPT

Claude

Claude Code

Codex

Cursor

Visual Studio Code

Any other client