Skip to main content
MCP server CX Codex

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 GitHub

What 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.

Similar MCP servers

All MCP servers for Backend and APIs →

Project sponsors

Companies that keep this analytics open