mapbox avatar

Mcp Docs Server

mapbox/mcp-docs-serverOfficial

Gives Claude direct access to Mapbox's full documentation library without needing an API token. You get search across all docs via Algolia, single and batch document fetching, and structured resources covering the REST API reference, SDK docs for iOS/Android/Flutter/web, style layer specs, Streets v8 tileset fields, and token scopes. Useful when you're building maps, need to look up camera animation syntax, check geocoding endpoints, or figure out which paint properties apply to a layer type. Available as a hosted endpoint, via npx, or self hosted through Docker. Built with TypeScript and dual ESM/CJS output.

GitHub stars
1
tools
3
transport
STDIO, HTTP
last updated
Nov 11, 2026

Install

From registry metadata
$ npx add-mcp https://mcp-docs.mapbox.com/mcp --name mcp-docs-server

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http mcp-docs-server https://mcp-docs.mapbox.com/mcp

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 3 tools

Verified live against the running server on Nov 6, 2026.

get_document_toolFetch the full content of a specific Mapbox documentation page by URL. Use this after search_mapbox_docs_tool to follow a link from the search results and retrieve the complete page content. For fetching multiple pages at once, use batch_get_documents_tool instead.1 params

Fetch the full content of a specific Mapbox documentation page by URL. Use this after search_mapbox_docs_tool to follow a link from the search results and retrieve the complete page content. For fetching multiple pages at once, use batch_get_documents_tool instead.

Parameters* required
url*string
URL of a Mapbox documentation page to fetch. Must be an https://docs.mapbox.com URL (e.g. https://docs.mapbox.com/api/search/geocoding/).
batch_get_documents_toolFetch 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.1 params

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.

Parameters* required
urls*array
Array of Mapbox documentation page URLs to fetch (max 20). All must be https://docs.mapbox.com URLs.
search_mapbox_docs_toolSearch 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_...2 params

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_...

Parameters* required
limitinteger
Maximum number of results to return (1–20, default 5).default: 5
query*string
Search query for Mapbox documentation (e.g. "add a marker", "camera animation", "geocoding API").

Sponsors

Readme

Mapbox MCP Documentation Server

A Model Context Protocol (MCP) server that gives AI assistants instant access to Mapbox documentation and reference materials — no Mapbox access token required.

Quick Start

Hosted (no install required)

Connect directly to the hosted endpoint — nothing to install or maintain:

Claude Code / Claude Desktop / Cursor / VS Code

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

npx (runs locally, no install)

Claude Code — run claude mcp add:

claude mcp add mapbox-docs -- npx -y @mapbox/mcp-docs-server

Claude Desktop — add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Cursor / VS Code — add the same mcpServers block to your editor's MCP settings file.


Docker

Build the image:

docker build -t mapbox/mcp-docs-server .

View the full README on GitHub

Details

Repository
github.com/mapbox/mcp-docs-server
Package
@mapbox/mcp-docs-server
Transport
STDIO, HTTP
Registry
MCP registry, active
Resources
10
Tools verified
Nov 6, 2026

More from mapbox