MCP Link - Convert Any OpenAPI V3 API to MCP Server
RemoteAbout MCP Link - Convert Any OpenAPI V3 API to MCP Server
MCP Link converts any OpenAPI V3 API into an MCP server without changing the original API implementation. It is aimed at developers who want existing REST APIs available to AI agents. A hosted version is available, and the project can also be run locally with Go.
Key features
- 01Automatic MCP server generation from OpenAPI specs
- 02Configuration of spec URL, base URL and auth header via URL parameters
- 03Path and method filters to include or exclude endpoints
- 04Example links for several common services
Use cases
- 01Exposing an internal REST API to AI agents through MCP
- 02Connecting services such as GitHub, Slack or Notion to agents
- 03Testing MCP access to an API without modifying backend code
MCP support
The project serves an MCP interface over an SSE endpoint, so MCP clients can call tools generated from an API's OpenAPI endpoints using the configured URL.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
http://localhost:8080/sse?s=[OpenAPI-Spec-URL]&u=[API-Base-URL]&h=[Auth-Header]:[Value-Prefix]claude mcp add --transport http link http://localhost:8080/sse?s=[OpenAPI-Spec-URL]&u=[API-Base-URL]&h=[Auth-Header]:[Value-Prefix]{"mcpServers":{"link":{"type":"http","url":"http://localhost:8080/sse?s=[OpenAPI-Spec-URL]&u=[API-Base-URL]&h=[Auth-Header]:[Value-Prefix]"}}}Open in Cursor{"servers":{"link":{"type":"http","url":"http://localhost:8080/sse?s=[OpenAPI-Spec-URL]&u=[API-Base-URL]&h=[Auth-Header]:[Value-Prefix]"}}}Open in VS Code{"mcpServers":{"link":{"type":"http","url":"http://localhost:8080/sse?s=[OpenAPI-Spec-URL]&u=[API-Base-URL]&h=[Auth-Header]:[Value-Prefix]"}}}{"mcpServers":{"link":{"serverUrl":"http://localhost:8080/sse?s=[OpenAPI-Spec-URL]&u=[API-Base-URL]&h=[Auth-Header]:[Value-Prefix]"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
Details
From the project READMEMCP Link - Convert Any OpenAPI V3 API to MCP Server
🧩 Architecture
🤔 Why MCP Link?
There is a notable gap in the current AI Agent ecosystem:
- Most MCP Servers are simple wrappers around Web APIs
- Functionality interfaces may not be complete, depending on developer implementation
- Manual creation of MCP interfaces is time-consuming and error-prone
- Lack of standardized conversion processes
MCP Link solves these issues through automation and standardization, allowing any API to easily join the AI-driven application ecosystem.
🌟 Key Features
- Automatic Conversion: Generate complete MCP Servers based on OpenAPI Schema
- Seamless Integration: Make existing RESTful APIs immediately compatible with AI Agent calling standards
- Complete Functionality: Ensure all API endpoints and features are correctly mapped
- Zero Code Modification: Obtain MCP compatibility without modifying the original API implementation
- Open Standard: Follow the MCP specification to ensure compatibility with various AI Agent frameworks
🌐 Online Version
Try our hosted version at mcp-link.vercel.app to quickly convert and test your APIs without installation.
🚀 Quick Start
Installation
# Clone repository
git clone https://github.com/automation-ai-labs/mcp-link.git
cd mcp-openapi-to-mcp-adapter
# Install dependencies
go mod download
Running
# Specify port
go run main.go serve --port 8080 --host 0.0.0.0
Parameter Description
s=- URL of the OpenAPI specification fileu=- Base URL of the target APIh=- Authentication header format, in the format ofheader-name:value-prefixf=- Path filter expressions to include or exclude API endpoints. Syntax:+/path/**- Include all endpoints under /path/-/path/**- Exclude all endpoints under /path/+/users/*:GET- Include only GET endpoints for /users/{id}- Multiple filters can be separated by semicolons:
+/**:GET;-/internal/** - Wildcards:
*matches any single path segment,**matches zero or more segments
Examples
| _ | API | MCP Link URL | Authentication Method |
|---|---|---|---|
 | Brave Search | https://mcp-link.vercel.app/links/brave | API Key |
 | DuckDuckGo | https://mcp-link.vercel.app/links/duckduckgo | None |
 | Figma | https://mcp-link.vercel.app/links/figma | API Token |
 | GitHub | https://mcp-link.vercel.app/links/github | Bearer Token |
 | Home Assistant | https://mcp-link.vercel.app/links/homeassistant | Bearer Token |
 | Notion | https://mcp-link.vercel.app/links/notion | Bearer Token |
 | Slack | https://mcp-link.vercel.app/links/slack | Bearer Token |
 | Stripe | https://mcp-link.vercel.app/links/stripe | Bearer Token |
 | TMDB | https://mcp-link.vercel.app/links/tmdb | Bearer Token |
 | YouTube | https://mcp-link.vercel.app/links/youtube | Bearer Token |
Usage in AI Agents
{
"mcpServers": {
"@service-name": {
"url": "http://localhost:8080/sse?s=[OpenAPI-Spec-URL]&u=[API-Base-URL]&h=[Auth-Header]:[Value-Prefix]"
}
}
}
These URLs allow any API with an OpenAPI specification to be immediately converted into an MCP-compatible interface accessible to AI Agents.
📋 Future Development
- MCP Protocol OAuthflow: Implement OAuth authentication flow support for MCP Protocol
- Resources Support: Add capability to handle resource-based API interactions
- MIME Types: Enhance support for various MIME types in API requests and responses
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.