OpenAPI Schema — Claude Code MCP server: what it does, how to install
OpenAPI Schema — an MCP server that exposes OpenAPI specs in JSON or YAML to LLMs. It helps assistants inspect endpoints, query parameters, and schema definitions.
no license updated 2026-10-29
Open on GitHubWhat OpenAPI Schema does
The server gives coding assistants access to OpenAPI files stored in JSON or YAML format. Models can query route details, inspect request payloads, verify path parameters, and look up authentication methods. Tool responses return in YAML.
Execution relies on npx. Omitting a file path forces the process to search for openapi.yaml in the current directory. You can also pass a relative or absolute path as an argument.
Working with multiple distinct specs requires registering separate server instances under unique names. Configuration scope can be set to project or global level.
What it helps with
- inspect route definitions and HTTP methods in API specs
- view request body and response schemas by status code
- look up component objects and usage examples
- search across full API definitions for specific entities
Example prompts for the agent
- Show me the parameters for the
GET /pets/{petId}route. - What does the payload schema look like for creating a pet?
- Search this specification for anything related to
user.
How to install OpenAPI Schema
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about OpenAPI Schema
How to install OpenAPI Schema in Claude Code?
Run claude mcp add openapi-schema npx -y mcp-openapi-schema. Then verify the registration by executing claude mcp list.
Which file types are supported?
The server accepts OpenAPI specification files in either YAML or JSON format.
What tools does this MCP server offer?
It provides tools like list-endpoints, get-endpoint, get-request-body, get-response-schema, and search-schema.