kadykov/mcp-openapi-schema-explorer

Overview

An MCP server that provides token-efficient access to OpenAPI and Swagger specifications. It exposes API schema details through MCP Resource Templates, enabling client-side exploration without unnecessary context bloat. Built in TypeScript, it is designed for integration with MCP-compatible clients.

Best for

Best for
Developers building MCP-native assistants that need quick, contextual access to REST API documentation

Use cases

• Exploring OpenAPI specs programmatically in AI assistants
• Building tools that need low-token-cost access to API documentation
• Integrating REST API schemas into MCP-based workflows

How to use

Install

npm install -g mcp-openapi-schema-explorer

Tested with

Claude Code, Claude Desktop, Windsurf, Cline

Example client config

{\n  "mcpServers": {\n    "My API Spec (npx)": {\n      "command": "npx",\n      "args": [\n        "-y",\n        "mcp-openapi-schema-explorer@latest",\n        "<path-or-url-to-spec>",\n        "--output-format",\n        "yaml"\n      ],\n      "env": {}\n    }\n  }\n}

Notes

An MCP server that provides token-efficient access to OpenAPI and Swagger specifications. It exposes API schema details through MCP Resource Templates, enabling client-side exploration without unnecessary context bloat. Built in TypeScript, it is designed for integration with MCP-compatible clients.

72 stars on GitHub. Last updated 2026-06-01. Licensed MIT.

Use cases

• Exploring OpenAPI specs programmatically in AI assistants
• Building tools that need low-token-cost access to API documentation
• Integrating REST API schemas into MCP-based workflows

Pros

• Token-efficient design reduces costs when retrieving large specs
• Uses standard MCP Resource Templates for structured, on-demand access
• Open-source TypeScript implementation easy to audit and extend

Cons

• Limited to clients that support the MCP protocol
• Small community (72 stars) may mean sparse documentation or support
• Relies on hosted OpenAPI files; offline use requires manual mirroring

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.