Create Custom MCP Link

Configure a custom MCP link for any API with an OpenAPI specification.

Try These Examples

Click any example to auto-fill the configuration form below:

GitHub API

Full Public Access

Access all public GitHub API endpoints without authentication.

Read-Only Mode

GET requests only

Safe read-only access to GitHub, filtering out write operations.

Search & Repos

Specific endpoints only

Limited to search and repository reading operations only.

Custom Configuration

Enter the details of the API you want to connect to.

OpenAPI Specification URL

URL to the OpenAPI specification (YAML/JSON)

API Base URL

Base URL of the target service where API requests will be forwarded

HTTP Headers

Authentication headers required for most APIs

Path Filters

Filter Format:

+/path/** - Include all endpoints under /path/
-/path/** - Exclude all endpoints under /path/
+/users/*:GET - Include GET endpoints for /users/{id}
+/api/items/*:GET POST PUT - Include GET, POST, PUT methods only
+/**:GET;-/internal/** - Multiple expressions with semicolons

Server Options

Local (localhost:3000)

Hosted (onrender.com)

Use hosted MCP adapter on onrender.com (no installation required)

Encoding Options

Default (URL Encoded)

Base64 (JSON Encoded)

Parameters are added individually to the URL (s=, u=, h=)

How It Works

The MCP Link adapter transforms OpenAPI specifications into Model-Context-Protocol Protocol (MCP) endpoints, making API integration with AI assistants seamless and efficient.

MCP Link Formats

Default Format (URL Encoded):

https://[SERVER_URL]/sse?s=[SPEC_URL]&u=[BASE_URL]&h=[JSON_HEADERS]

Base64 Format (JSON Encoded):

https://[SERVER_URL]/sse?code=[BASE64_ENCODED_JSON]

SERVER_URL: Either localhost:3000 (local) or mcp-openapi-to-mcp-adapter.onrender.com (hosted)
s: URL to the OpenAPI specification (YAML/JSON)
u: Base URL of the target service where API requests will be forwarded
h: JSON encoded headers object (e.g. h={"key1": "value1", "key2": "value2"})
f: Filter expression (e.g. f=+/search/**:GET to include only GET requests to search endpoints)
code: (Alternative format) Base64 encoded JSON containing all parameters

Connect to AI Assistants

Use the generated MCP link with your favorite AI assistants like Claude, Cursor, Windsurf, and more.

Configuration

Add this JSON configuration to your AI assistant's settings.

{
  "mcpServers": {
    "@your-api-name": {
      "url": "YOUR_GENERATED_MCP_LINK"
    }
  }
}

Replace @your-api-name with a descriptive name for your API and YOUR_GENERATED_MCP_LINK with the MCP link you generated above. Then paste this configuration in your AI assistant's settings.