Which integrations are available for this server?

Converts any OpenAPI/Swagger specification into MCP tools, allowing interaction with any REST API defined by the spec.

How do I use OpenAPI to MCP Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@OpenAPI to MCP Server serve my pet store API spec" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

OpenAPI to MCP Server

by Afstkla

Overview Schema Source Related Servers Discussions Admin

Python

Remote

openapi-to-mcp

PyPI Python codecov License

Convert any OpenAPI/Swagger spec into an MCP server, instantly exposing your REST API as tools for Claude.

uvx openapi-to-mcp serve ./spec.json --base-url https://api.example.com -a bearer --bearer-token $TOKEN

Installation

No installation needed — just use uvx:

uvx openapi-to-mcp --help

Or install globally:

uv tool install openapi-to-mcp

Related MCP server: Swagger MCP

Quick Start

# See what tools will be generated
uvx openapi-to-mcp list-endpoints ./openapi.json

# Run MCP server
uvx openapi-to-mcp serve ./openapi.json --base-url https://api.example.com

Authentication

Supports all OpenAPI/Swagger security schemes:

# HTTP Basic
uvx openapi-to-mcp serve spec.json -b https://api.example.com \
  -a basic -u user -p pass

# Bearer Token
uvx openapi-to-mcp serve spec.json -b https://api.example.com \
  -a bearer --bearer-token $TOKEN

# API Key (header, query, or cookie)
uvx openapi-to-mcp serve spec.json -b https://api.example.com \
  -a api-key-header --api-key $KEY --api-key-name X-API-Key

# OAuth2 Password (cookie-based login)
uvx openapi-to-mcp serve spec.json -b https://api.example.com \
  -a oauth2-password -u user -p pass --login-url /auth/login

# OAuth2 Password (token-based)
uvx openapi-to-mcp serve spec.json -b https://api.example.com \
  -a oauth2-password -u user -p pass --token-url /oauth/token

# OAuth2 Client Credentials
uvx openapi-to-mcp serve spec.json -b https://api.example.com \
  -a oauth2-client --client-id $ID --client-secret $SECRET --token-url /oauth/token

Adding to Claude Code

Add to ~/.claude.json or .mcp.json:

{
  "mcpServers": {
    "my-api": {
      "command": "uvx",
      "args": [
        "openapi-to-mcp",
        "serve",
        "/path/to/spec.json",
        "--base-url", "https://api.example.com",
        "--auth-type", "bearer",
        "--bearer-token", "your-token"
      ]
    }
  }
}

Or generate a config:

uvx openapi-to-mcp generate-config ./spec.json \
  --base-url https://api.example.com \
  --server-name my-api \
  -a bearer --bearer-token $TOKEN

Filtering Endpoints

Large APIs can expose hundreds of tools. Use tag filters:

# Only include specific tags
uvx openapi-to-mcp serve spec.json -b https://api.example.com \
  --include-tag Users --include-tag Orders

# Exclude tags
uvx openapi-to-mcp serve spec.json -b https://api.example.com \
  --exclude-tag Admin --exclude-tag Internal

Commands

Command	Description
`serve`	Run MCP server for an OpenAPI spec
`list-endpoints`	Preview endpoints and generated tool names
`inspect`	Show full tool definitions as JSON
`generate-config`	Generate Claude Code MCP config

Tool Naming

Endpoints are converted to clean tool names:

Method	Path	Tool Name
GET	/users	`list_users`
POST	/users	`create_user`
GET	/users/{id}	`get_user`
PATCH	/users/{id}	`update_user`
DELETE	/users/{id}	`delete_user`

How It Works

Parse — Reads OpenAPI 3.x spec (JSON or YAML, file or URL)
Generate — Converts each endpoint to an MCP tool with proper input schema
Authenticate — Handles login flows, stores tokens/cookies
Serve — Runs stdio MCP server, executes HTTP calls on tool invocation

License

MIT

This server cannot be deployed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

bridge AOAuth
ai.kaiv
Create hosted MCP servers from any OpenAPI spec. Requires a free Kaiva Bridge account.
Cloud Platforms Developer Tools
41
simceptorOAuth
io.github.ayda212
AI-native mock API server with MCP. Create REST/SOAP mocks from Claude, Cursor, or Windsurf.
API Testing Testing & QA Tools
2
OneSchema MCP Server
co.oneschema
MCP server that lets AI assistants use all OneSchema features exposed via the public API.
Data Platforms App Automation
1
Swagger MCPOAuth
com.smartbear
MCP server for AI access to Swagger by SmartBear.
API Testing Documentation Access Developer Tools
144

Related MCP Servers

OpenAPI to MCP
API Testing Developer Tools App Automation
procoders
A
license
Not graded
quality
D
maintenance
Automatically converts any OpenAPI specification or Postman Collection into an MCP server, enabling AI assistants like Claude to directly interact with REST APIs without writing any code.
Updated 9 months ago (2025-12-22 00:29 UTC)
Apache 2.0
Swagger MCP
API Testing Developer Tools RAG Systems
kyle-pena-nlp
F
license
Not graded
quality
D
maintenance
Automatically converts Swagger/OpenAPI specifications into MCP servers, enabling AI agents to interact with any REST API through natural language by exposing endpoints as AI-friendly tools.
Updated a year ago (2025-08-05 20:59 UTC)
3
-
swagger-mcp-server
Developer Tools API Testing Documentation Access
salacoste
F
license
Not graded
quality
D
maintenance
Converts any Swagger/OpenAPI specification into an MCP server, enabling AI assistants to intelligently query API endpoints, schemas, and generate code examples.
Updated a year ago (2025-10-02 00:34 UTC)
18
-
FastMCP Gateway
Developer Tools AI & Machine Learning
4human-ai
F
license
Not graded
quality
D
maintenance
Automatically converts OpenAPI specifications into MCP servers, allowing tools like Claude Desktop to interact with your REST APIs through a standard protocol.
Updated 10 months ago (2025-11-04 21:24 UTC)
-