API Docs MCP

@EliFuzz

About API Docs MCP

MCP server for API documentation, supporting GraphQL, OpenAPI/Swagger, and gRPC from local files or remote URLs

#api #documentation #graphql #openapi #swagger #grpc

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "api-docs-mcp": {
      "command": "npx",
      "args": [
        "api-docs-mcp"
      ],
      "env": {
        "API_SOURCES": "[{\"name\": \"PetstoreAPI\", \"method\": \"GET\", \"url\": \"https://petstore.swagger.io/v2/swagger.json\", \"type\": \"api\"}]"
      }
    }
  }
}

Tools

Get a list of all available API methods

Search for a specific API method by name and get its full definition

Overview

What is API Docs MCP?

API Docs MCP is an MCP server that provides tools for interacting with API documentation. It supports GraphQL, OpenAPI/Swagger, and gRPC specifications, fetching schema definitions from local files or remote URLs, caching them, and exposing them through a set of tools.

How to use API Docs MCP?

Configure API sources via the API_SOURCES environment variable, then run the MCP server. The server automatically registers tools from a specified directory. Use the api_docs tool to list available API methods and api_search to retrieve detailed documentation for specific methods.

Key features of API Docs MCP

Dynamic tool registration from a specified directory
Provides api_docs and api_search tools
Schema caching with automatic periodic refresh
Supports GraphQL, OpenAPI, and gRPC schemas
Loads schemas from local files or remote URLs
Environment-based configuration via API_SOURCES

Use cases of API Docs MCP

Quickly explore GraphQL schema methods and their arguments without leaving the chat
Look up OpenAPI endpoint details during API integration development
Browse gRPC service definitions and RPC methods interactively
Cache remote API documentation locally for offline or faster access

FAQ from API Docs MCP

How do I configure API sources?

Set the API_SOURCES environment variable to specify the schema files or URLs. The format supports local file paths and remote URLs for GraphQL, OpenAPI, and gRPC.

What schema formats are supported?

GraphQL schemas can be loaded from .graphql, .gql, or JSON introspection results. OpenAPI/Swagger supports YAML and JSON. gRPC supports .proto files or reflection from remote URLs.

How does caching work?

The server caches schema data after fetching to reduce redundant requests. It automatically refreshes the cache periodically to keep documentation up-to-date.

Does the server require any runtime dependencies?

The server runs as an MCP server and is configured entirely through the API_SOURCES environment variable. No additional authentication or transport setup is required.

Frequently asked questions

How do I configure API sources?

Set the `API_SOURCES` environment variable to specify the schema files or URLs. The format supports local file paths and remote URLs for GraphQL, OpenAPI, and gRPC.

What schema formats are supported?

GraphQL schemas can be loaded from `.graphql`, `.gql`, or JSON introspection results. OpenAPI/Swagger supports YAML and JSON. gRPC supports `.proto` files or reflection from remote URLs.

How does caching work?

The server caches schema data after fetching to reduce redundant requests. It automatically refreshes the cache periodically to keep documentation up-to-date.

Does the server require any runtime dependencies?

The server runs as an MCP server and is configured entirely through the `API_SOURCES` environment variable. No additional authentication or transport setup is required.

Comments

Basic information

More Developer Tools MCP servers

TranscriptFetch MCP Server

TranscriptFetch

Model Context Protocol (MCP) server for TranscriptFetch: fetch YouTube transcripts, search, channels, and playlists from any MCP client.

ZeroBeacon — 1000-Tool Collision-Proof Commerce Router

DavidFox998

ZeroBeacon.ai — Collision-proof commerce router for AI agents. 1000 MCP tools: commerce, trust, billing, sovereign ID + everyday tools. LIVE.

Air Pipe

airpipe

Build, validate, deploy — HTTP APIs, cron jobs, webhooks and MCP tools — from your AI client.

Agent Conductor

icohangar-ops

Agent conductor — AGENTS.md contract parser, SKILL.md registry, CHP decision engine over MCP

ship.page

Bitgate

Throw HTML at an API, get an unguessable URL back. Zero-config remote MCP server — your agent deploys pages, sites and CI reports in one call. Free, no signup needed.