MCP Openapi Schema MCP Server

A Model Context Protocol server that exposes OpenAPI schema information to Large Language Models

Local serverstdio

What is the MCP Openapi Schema MCP server?

Most AI and media services work still happens through a UI a human drives. MCP Openapi Schema MCP server moves it into the conversation instead. A Model Context Protocol server that exposes OpenAPI schema information to Large Language Models.

The short version

A Model Context Protocol (MCP) server that exposes OpenAPI schema information to Large Language Models (LLMs) like Claude. This server allows an LLM to explore and understand OpenAPI specifications through a set of specialized tools.

  • Load any OpenAPI schema file (JSON or YAML) specified via command line argument
  • Explore API paths, operations, parameters, and schemas
  • View detailed request and response schemas
  • Look up component definitions and examples
  • Search across the entire API specification
  • Get responses in YAML format for better LLM comprehension

The tools it exposes

The server publishes 10 tools. What each one is for:

  • list-endpoints — Lists all API paths and their HTTP methods with summaries in a nested object structure
  • get-endpoint — Gets detailed information about a specific endpoint including parameters and responses
  • get-request-body — Gets the request body schema for a specific endpoint and method
  • get-response-schema — Gets the response schema for a specific endpoint, method, and status code
  • get-path-parameters — Gets the parameters for a specific path
  • list-components — Lists all schema components (schemas, responses, parameters, etc.)
  • get-component — Gets detailed definition for a specific component
  • list-security-schemes — Lists all available security schemes
  • get-examples — Gets examples for a specific component or endpoint
  • search-schema — Searches across paths, operations, and schemas

Getting it running

The server ships on npm as mcp-openapi-schema, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

How it compares

This sits in the AI and media services group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. MCP Openapi Schema's toolset — list-endpoints, get-endpoint, get-request-body and 7 more — is a fair guide to whether it matches your workflow. It is maintained by hannesj; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 10 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch MCP Openapi Schema.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
list-endpointsLists all API paths and their HTTP methods with summaries in a nested object structure
get-endpointGets detailed information about a specific endpoint including parameters and responses
get-request-bodyGets the request body schema for a specific endpoint and method
get-response-schemaGets the response schema for a specific endpoint, method, and status code
get-path-parametersGets the parameters for a specific path
list-componentsLists all schema components (schemas, responses, parameters, etc.)
get-componentGets detailed definition for a specific component
list-security-schemesLists all available security schemes
get-examplesGets examples for a specific component or endpoint
search-schemaSearches across paths, operations, and schemas

How to install the MCP Openapi Schema MCP server

{
  "mcpServers": {
    "openapi-schema": {
      "command": "npx",
      "args": ["-y", "mcp-openapi-schema"]
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Example prompts to try

  • Use MCP Openapi Schema to list-endpoints.
  • Use MCP Openapi Schema to get-endpoint.
  • Use MCP Openapi Schema to get-request-body.

Frequently asked questions

It connects MCP Openapi Schema to MCP-compatible AI assistants such as Claude and Cursor, exposing 10 tools (list-endpoints, get-endpoint, get-request-body, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with MCP Openapi Schema directly.