Openapi MCP

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

GitHub

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

ToolDescription
load_specLoad an OpenAPI spec from URL or file
list_endpointsList all endpoints with optional filtering
search_endpointsSearch endpoints by keyword
get_endpoint_detailsGet full details for an endpoint
get_request_schemaGet request body schema
get_response_schemaGet response schema by status code
validate_payloadValidate JSON against schema
generate_sampleGenerate sample request payload
generate_typescript_typesGenerate TypeScript interfaces from schemas
generate_curlGenerate ready-to-use cURL command
get_auth_schemesGet security schemes
get_serversGet 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

Related Servers