Development · MODEL CONTEXT PROTOCOL

mcp-openapi-schema

OpenAPI Schema Model Context Protocol Server

WHAT IT CONNECTS

What mcp-openapi-schema gives an AI Agent

  • 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
  • macOS/Linux: `~/Library/Application Support/Claude/claude_desktop_config.json`
  • Windows: `$env:AppData\Claude\claude_desktop_config.json`
  • **Add the OpenAPI Schema MCP server to Claude Code**
  • **Verify the MCP server is registered**
  • **Remove the server if needed**
  • **Use the tool in Claude Code**
  • Use the `-s` or `--scope` flag with `project` (default) or `global` to specify where the configuration is stored
  • Add multiple MCP servers for different APIs with different names
  • `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

SECURITY

An MCP listing is not a security review

An MCP server may receive model context, credentials, local files, or permission to call external systems. Review its code, requested environment variables, network behavior, package provenance, and maintenance status before connecting it to an agent.