Mcp Docs Server

io.github.mapboxPublished by GitHub account mapboxv0.3.2Updated Nov 3, 2026

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

VerifiedStreamable HTTPWeb executableKnowledge & MemoryDeveloper Tools

Overview

Mcp Docs Server's hosted MCP server (mcp-docs.mapbox.com); no sign-in required; Streamable HTTP; 3 tools.

No AI overview yet: these facts come from the registry entry and the server itself.

Endpoint
mcp-docs.mapbox.com
Last checked

Installation

In SourceWeft

  1. Open Mcp Docs Server in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.mapbox%2Fmcp-docs-server/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

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

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

npx (runs locally, no install)

Claude Code — run claude mcp add:

bash
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):

json
{  "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:

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

Or pull from the registry:

bash
docker pull mapbox/mcp-docs-server

Claude Desktop / Cursor / VS Code — configure your MCP client to run the container:

json
{  "mcpServers": {    "mapbox-docs": {      "command": "docker",      "args": ["run", "--rm", "-i", "mapbox/mcp-docs-server"]    }  }}

Local (from source)

bash
git clone https://github.com/mapbox/mcp-docs-server.gitcd mcp-docs-servernpm installnpm run build

Claude Desktop / Cursor / VS Code:

json
{  "mcpServers": {    "mapbox-docs": {      "command": "node",      "args": ["/absolute/path/to/mcp-docs-server/dist/esm/index.js"]    }  }}

Tools

get_document_tool — Fetches the full content of a specific Mapbox documentation page by URL. Use this to follow a link from a resource and retrieve the complete page content.

Example prompts:

  • "What Mapbox APIs are available?"
  • "How do I add a custom layer to a Mapbox style?"
  • "What's the latest Mapbox GL JS version?"

batch_get_documents_tool — Fetches multiple Mapbox documentation pages in a single call (max 20). More efficient than calling get_document_tool multiple times. Failed pages include an error message rather than failing the whole batch.

search_mapbox_docs_tool — Searches Mapbox documentation across API reference, GL JS, Help Center, Style Spec, Studio, Search JS, iOS/Android Maps and Navigation SDKs, and Tilesets, returning ranked page URLs and descriptions. Use this to find relevant documentation before fetching full pages with get_document_tool or batch_get_documents_tool.

Example prompts:

  • "Find docs about camera animation"
  • "Search for geocoding API examples"
  • "What documentation exists for custom layers?"

Resources

MCP resources expose reference data that AI assistants can read on demand:

Resource URIContents
resource://mapbox-api-referenceREST API reference docs (endpoints, parameters, rate limits)
resource://mapbox-sdk-docsSDK and client library docs (iOS, Android, Flutter, web)
resource://mapbox-guidesTutorials, how-tos, and guides
resource://mapbox-examplesCode examples, API playgrounds, and interactive demos
resource://mapbox-referenceTilesets, data products, accounts, and pricing reference
resource://mapbox-style-layersStyle layer reference (paint/layout properties for all layer types)
resource://mapbox-streets-v8-fieldsMapbox Streets v8 tileset field reference
resource://mapbox-token-scopesAll available Mapbox token scopes with descriptions
resource://mapbox-layer-type-mappingMapping of Mapbox layer types to their properties

Development

Prerequisites

  • Node.js >= 22
  • npm

Setup

bash
git clone https://github.com/mapbox/mcp-docs-server.gitcd mcp-docs-servernpm install

Commands

bash
npm run build          # Compile TypeScript (ESM + CJS)npm test               # Run test suite (vitest)npm run lint           # ESLintnpm run format         # Prettier checknpm run format:fix     # Prettier auto-fixnpm run inspect:build  # Launch MCP Inspector against built servernpm run inspect:dev    # Launch MCP Inspector against source (tsx)

Architecture

The server is a TypeScript MCP server using @modelcontextprotocol/sdk with a dual ESM/CJS build via tshy.

  • Tools extend BaseTool<InputSchema, OutputSchema> in src/tools/
  • Resources extend BaseResource in src/resources/
  • No Mapbox access token required for documentation tools
  • HTTP requests use a shared httpPipeline with 1-hour caching

Creating a New Tool

  1. Create a directory src/tools/my-tool/
  2. Add MyTool.input.schema.ts (Zod schema), MyTool.output.schema.ts, and MyTool.ts (extends BaseTool)
  3. Register in src/tools/toolRegistry.ts
  4. Add tests in test/tools/my-tool/

Contributing

Please read CONTRIBUTING.md and VISION.md before submitting a pull request. Contributors using AI coding assistants should also review:

  • CLAUDE.md — for Claude Code
  • AGENTS.md — for other AI coding assistants (Cursor, Copilot, Aider, etc.)

License

MIT — see LICENSE

Source: README.md at commit d1f32cc

Tools

3

get_document_tool

Get Mapbox Document Tool

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.

Parametersurlrequired

batch_get_documents_tool

Batch Get Mapbox 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.

Parametersurlsrequired

search_mapbox_docs_tool

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.

Parameterslimitqueryrequired

Version history

2
  1. v0.3.2LatestNov 3, 2026
  2. v0.3.1Sep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts