OpenAPI MCP Server

An MCP server that lets LLMs inspect and interact with OpenAPI specifications.

Features

• Load OpenAPI specs from URL or file (OpenAPI 2.0 & 3.x)
• List and search endpoints
• Get request/response schemas (fully dereferenced)
• Validate payloads against schemas
• Generate sample request payloads
• Generate TypeScript types from schemas
• Extract authentication schemes

Installation

Via npm (recommended)

npm install -g @blackkspydo/openapi-mcp

Or run directly with npx:

npx --yes @blackkspydo/openapi-mcp

From source

git clone https://github.com/blackkspydo/openapi-mcp.git cd openapi-mcp bun install bun run build

Usage

With Claude CLI

claude mcp add openapi-mcp -- npx --yes @blackkspydo/openapi-mcp

With Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{ "mcpServers": { "openapi-mcp": { "command": "npx", "args": ["--yes", "@blackkspydo/openapi-mcp"] } } }

Or if installed globally:

{ "mcpServers": { "openapi-mcp": { "command": "openapi-mcp" } } }

Standalone

openapi-mcp

or

npx --yes @blackkspydo/openapi-mcp

Available Tools

Tool	Description
load_spec	Load an OpenAPI spec from URL or file
list_endpoints	List all endpoints with optional filtering
search_endpoints	Search endpoints by keyword
get_endpoint_details	Get full details for an endpoint
get_request_schema	Get request body schema
get_response_schema	Get response schema by status code
validate_payload	Validate JSON against schema
generate_sample	Generate sample request payload
generate_typescript_types	Generate TypeScript interfaces from schemas
generate_curl	Generate ready-to-use cURL command
get_auth_schemes	Get security schemes
get_servers	Get available API servers

Example

You: Load the Petstore API spec from https://petstore.swagger.io/v2/swagger.json

You: List all POST endpoints

You: Generate TypeScript types for the Pet schema

You: Generate a cURL command for POST /pet

You: Generate a sample request for POST /pet

License

MIT