MCP Docs Server

What mcp-docs-server does

mcp-docs-server gives MCP-compatible AI clients access to Mapbox documentation through a hosted service or a locally run package. It covers Mapbox API references, GL JS, the Help Center, Style Spec, Studio, Search JS, iOS and Android Maps and Navigation SDKs, and Tilesets.

The server is intended for documentation lookup. It can help an agent locate relevant pages, retrieve complete page content, inspect API parameters and rate limits, consult SDK guidance, and look up style-layer properties or Streets v8 fields. Documentation access does not require a Mapbox access token.

How it works

search_mapbox_docs_tool accepts a keyword or natural-language query and returns ranked results with page titles, URLs, and descriptions. After finding a relevant result, an agent can use get_document_tool to retrieve the complete page by URL.

For several related pages, batch_get_documents_tool fetches up to 20 URLs in one call. The response contains an entry for each requested page; a failed fetch reports an error for that page without aborting the entire batch.

The server also publishes MCP resources that clients can read on demand. These include REST API references, SDK and client-library documentation, tutorials, examples, product and pricing references, style-layer definitions, Streets v8 fields, token scopes, and layer-type mappings. HTTP requests use a shared pipeline with one-hour caching.

Setup and configuration

The hosted endpoint can be connected without installing the package:

{
  "mcpServers": {
    "mapbox-docs": {
      "url": "https://mcp-docs.mapbox.com/mcp"
    }
  }
}

For a local stdio setup, run the package with npx:

{
  "mcpServers": {
    "mapbox-docs": {
      "command": "npx",
      "args": ["-y", "@mapbox/mcp-docs-server"]
    }
  }
}

Docker is also supported. Build the repository image or pull mapbox/mcp-docs-server, then configure the client to run docker run --rm -i mapbox/mcp-docs-server. Running from source requires Node.js 22 or newer and npm; install dependencies, build the project, and start dist/esm/index.js with Node.

The documented client configurations cover Claude Code, Claude Desktop, Cursor, and VS Code. No Mapbox credential environment variable is needed for the documentation tools.

Tools and capabilities

• Search Mapbox content with natural-language or keyword queries.
• Retrieve a complete documentation page from its URL.
• Fetch up to 20 documentation pages in one batch.
• Read structured MCP resources for APIs, SDKs, guides, examples, styles, tilesets, and token scopes.
• Use TypeScript output built in both ESM and CommonJS formats.

Limitations and notes

The batch operation is limited to 20 pages per call. Search returns result metadata rather than complete page content, so a follow-up document request is needed to read a full result. The server provides documentation and reference material; its documented tools do not require a Mapbox access token.