Leeway MCP Setup: Connect Cursor, Claude, VS Code & ChatGPT

1. Get your API token

Every connection authenticates with your personal Leeway API token. Find it in your account area. Replace YOUR_TOKEN in all examples with your real token.

Open token in account

2. Pick a connection method

There are three paths — pick the one your client supports.

Remote MCP (HTTP)

Streamable HTTP with a bearer token. For Cursor, VS Code and most MCP clients.

Local bridge (stdio)

A tiny bridge via npx — no OAuth, no Leeway server to install. For Claude Desktop.

OpenAPI / REST

For assistants without MCP that expect an OpenAPI schema — e.g. Custom GPTs or other AI clients.

Cursor

Cursor connects remotely over Streamable HTTP. The fastest path is the one-click install; alternatively add the server to mcp.json manually.

Add to Cursor

Click "Add to Cursor" or copy the config below.
Open ~/.cursor/mcp.json and add the block under mcpServers.
Replace YOUR_TOKEN with your Leeway API token.
In Cursor settings under MCP, refresh the server — the Leeway tools show up in chat.

Config file: ~/.cursor/mcp.json

{
  "mcpServers": {
    "leeway-api": {
      "url": "https://mcp.leeway.tech/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Claude Desktop

Claude Desktop's built-in "Add custom connector" only supports OAuth, which our token-based API doesn't use. Instead, bridge the hosted Leeway server into stdio with the mcp-remote package — via npx, so there's no Leeway server to install or host yourself.

Make sure Node.js is installed (needed for npx — nothing else to install).
In Claude Desktop, open Settings → Developer → Edit Config.
Paste the block below and replace YOUR_TOKEN with your Leeway API token.
Restart Claude Desktop — the tools are ready in your conversation.

Config file: claude_desktop_config.json

{
  "mcpServers": {
    "leeway": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.leeway.tech/mcp",
        "--header",
        "Authorization:Bearer YOUR_TOKEN"
      ]
    }
  }
}

VS Code

VS Code (with an MCP-capable extension) connects remotely over Streamable HTTP — the same config as Cursor.

Install an MCP-capable extension and open its MCP configuration.
Add the server block below and replace YOUR_TOKEN.
Reload the extension — the tools become available.

{
  "mcpServers": {
    "leeway-api": {
      "url": "https://mcp.leeway.tech/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

OpenAPI clients (Custom GPTs, AI Assistants)

Assistants that don't support MCP can be connected using our OpenAPI specification. You provide the JSON schema and authenticate via a query parameter.

OpenAPI schema (URL)https://api.leeway.tech/openapi.json

REST base URLhttps://api.leeway.tech

Authentication (query parameter)?apitoken=YOUR_TOKEN

Open the OpenAPI URL in your browser, select all, and copy the entire JSON text.
Create a new action or skill in your AI assistant and paste the copied JSON text into the 'Schema' field.
Set the authentication type to 'API Key' (passed as a Query parameter). The parameter name is 'apitoken' and the value is your Leeway token.
Save the configuration. The endpoints will now be available as actions.

OpenAPI specification

Other MCP clients

Any MCP-compatible client connects with the same two pieces: the endpoint and the Authorization header. The endpoint is meant for MCP clients — not for opening in a browser (there you only get an auth message).

Endpointhttps://mcp.leeway.tech/mcp

Auth headerAuthorization: Bearer YOUR_TOKEN

Note: opening the MCP endpoint directly in a browser returns an auth error — that's expected. It's only used by the MCP client with your token.

Troubleshooting

No tools appear.

Check that the server is enabled and refreshed in the client. After editing the config, a restart or refresh is usually required.

401 / Unauthorized.

YOUR_TOKEN was not replaced, or the token is invalid. Get a fresh token in your account area.

Rate limit reached.

The free tier includes 50 request units per day. For production use, the Data API plan offers 100,000 per day.

Connect Leeway MCP to your client