ReAPI-com/mcp-openapi

Overview

An MCP server that serves OpenAPI specifications for use by AI agents and tools. It exposes API documentation as resources or tools under the Model Context Protocol. Built in TypeScript, it connects standard OpenAPI specs to MCP-compatible clients.

Best for

Best for
Developers building AI agents or tools that need to consume OpenAPI documentation via the Model Context Protocol

Use cases

• Providing API specs to AI coding assistants for code generation
• Enabling AI agents to dynamically discover and call API endpoints
• Integrating OpenAPI documentation into MCP-compatible development tools

How to use

Tools exposed

• refresh-api-catalog
• get-api-catalog
• search-api-operations
• search-api-schemas
• load-api-operation-by-operationId
• load-api-operation-by-path-and-method
• load-api-schema-by-schemaName

Tested with

Cursor

Example client config

{\n  "mcpServers": {\n    "@reapi/mcp-openapi": {\n      "command": "npx",\n      "args": ["-y", "@reapi/mcp-openapi@latest", "--dir", "./specs"],\n      "env": {}\n    }\n  }\n}

Notes

An MCP server that serves OpenAPI specifications for use by AI agents and tools. It exposes API documentation as resources or tools under the Model Context Protocol. Built in TypeScript, it connects standard OpenAPI specs to MCP-compatible clients.

87 stars on GitHub. Last updated 2025-03-30. Licensed MIT.

Use cases

• Providing API specs to AI coding assistants for code generation
• Enabling AI agents to dynamically discover and call API endpoints
• Integrating OpenAPI documentation into MCP-compatible development tools

Pros

• Simplifies connecting AI agents to existing OpenAPI documentation
• Leverages the standard OpenAPI format for broad compatibility
• Lightweight TypeScript project with low overhead

Cons

• Requires an MCP-compatible client or agent to be useful
• Limited adoption (87 stars) suggests a small community and fewer contributions
• Narrow focus: only works with OpenAPI specs, not other API description formats

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