OpenAPI Documentation
Converts OpenAPI/Swagger documentation into interactive tools, letting you browse, search, and explore API endpoints without writing code.
Transforms OpenAPI specifications into dynamic tools for interacting with external services, handling authentication, validation, and request routing without custom code.
What it does
- List API groups from OpenAPI specs
- Browse APIs within specific groups
- Get detailed endpoint information
- Search APIs by keyword
- Load remote or local OpenAPI files
- Auto-refresh documentation on requests
Best for
About OpenAPI Documentation
OpenAPI Documentation is a community-built MCP server published by zkytech that provides AI assistants with tools and capabilities via the Model Context Protocol. Transform OpenAPI specifications into dynamic tools for integrating external services, supporting JSON web token authent It is categorized under developer tools.
How to install
You can install OpenAPI Documentation in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.
License
OpenAPI Documentation is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.
api-doc-mcp
This is a set of MCP tools for managing and retrieving OpenAPI documentation.
Features
This toolkit provides the following features:
- List all API groups
- List APIs in a specified group
- Get API details
- Search APIs
- Support both remote API docs and local JSON files
- Auto-refresh API documentation on each request
Usage
For cursor
# remote api
npx -y api-doc-mcp http://localhost:8000/swagger.json
# local file
npx -y api-doc-mcp ./swagger.json
Build
npm run build
Usage
Command Format
npx api-doc-mcp <API_DOC_URL_OR_FILE_PATH>
Examples
- View help:
npx api-doc-mcp
- List all API groups (Remote API):
npx api-doc-mcp https://api.example.com/swagger.json
- List all API groups (Local file):
npx api-doc-mcp ./swagger.json
Development
npm run dev
Tool Description
listApiGroups
List all available API groups.
Returns:
- name: Group name
- description: Group description
- apiCount: API count
listGroupApis
List all APIs in a specified group.
Parameters:
- groupName: API group name
Returns:
- path: API path
- method: HTTP method
- summary: API summary
getApiDetail
Get detailed information about a specified API.
Parameters:
- path: API path
- method: HTTP method
Returns:
- Complete API details, including parameters, request body, and response definition
searchApis
Search APIs.
Parameters:
- keyword: Search keyword
Returns:
- path: API path
- method: HTTP method
- summary: API summary
Alternatives
Related Skills
Browse all skillsMaster API documentation with OpenAPI 3.1, AI-powered tools, and modern developer experience practices. Create interactive docs, generate SDKs, and build comprehensive developer portals. Use PROACTIVELY for API documentation or developer portal creation.
UI design system toolkit for Senior UI Designer including design token generation, component documentation, responsive design calculations, and developer handoff tools. Use for creating design systems, maintaining visual consistency, and facilitating design-dev collaboration.
Use when working with the OpenAI API (Responses API) or OpenAI platform features (tools, streaming, Realtime API, auth, models, rate limits, MCP) and you need authoritative, up-to-date documentation (schemas, examples, limits, edge cases). Prefer the OpenAI Developer Documentation MCP server tools when available; otherwise guide the user to enable `openaiDeveloperDocs`.
Generate and maintain OpenAPI 3.1 specifications from code, design-first specs, and validation patterns. Use when creating API documentation, generating SDKs, or ensuring API contract compliance.
Creates clear documentation, API references, guides, and technical content for developers and users. Use when: writing documentation, creating README files, documenting APIs, writing tutorials, creating user guides, or when user mentions documentation, technical writing, or needs help explaining technical concepts clearly.
Guide for building TypeScript CLIs with Bun. Use when creating command-line tools, adding subcommands to existing CLIs, or building developer tooling. Covers argument parsing, subcommand patterns, output formatting, and distribution.