# mcp-docs-server [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/mapbox/mcp-docs-server  
**GitHub Stars:** 1  
**npm Downloads (last month):** 1187  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/mcp-docs-server

## Description
AI access to Mapbox docs, API references, style specs, and guides. No token required.

## Tools
Capabilities this server exposes over MCP:

- **get_document_tool** — Fetch the full content of a specific Mapbox documentation page by URL. Use this after get_latest_mapbox_docs_tool to follow a link from the index and retrieve the complete page content. For fetching multiple pages at once, use batch_get_documents_tool instead.
- **batch_get_documents_tool** — Fetch the full content of multiple Mapbox documentation pages in a single call (max 20). More efficient than calling get_document_tool multiple times. Returns an array of results — failed pages include an error message rather than failing the whole batch.
- **search_mapbox_docs_tool** — Search Mapbox documentation by keyword or natural language query. Searches across API reference, GL JS, Help Center, Style Spec, Studio, Search JS, iOS/Android Maps and Navigation SDKs, and Tilesets. Returns ranked results with titles, URLs, and descriptions. Use get_document_tool to fetch the full content of a result page.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

## Documentation

## 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:

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

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

```json
{
  "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.

_Full upstream README: https://allmcps.com/mcp/mcp-docs-server/readme_