{
  "markdown": "# Mapbox MCP Documentation Server\n\nA [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server that gives AI assistants instant access to Mapbox documentation and reference materials — **no Mapbox access token required**.\n\n## Quick Start\n\n### Hosted (no install required)\n\nConnect directly to the hosted endpoint — nothing to install or maintain:\n\n**Claude Code / Claude Desktop / Cursor / VS Code**\n\n```json\n{\n  \"mcpServers\": {\n    \"mapbox-docs\": {\n      \"url\": \"https://mcp-docs.mapbox.com/mcp\"\n    }\n  }\n}\n```\n\n---\n\n### npx (runs locally, no install)\n\n**Claude Code** — run `claude mcp add`:\n\n```bash\nclaude mcp add mapbox-docs -- npx -y @mapbox/mcp-docs-server\n```\n\n**Claude Desktop** — add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"mapbox-docs\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@mapbox/mcp-docs-server\"]\n    }\n  }\n}\n```\n\n**Cursor / VS Code** — add the same `mcpServers` block to your editor's MCP settings file.\n\n---\n\n### Docker\n\n**Build the image:**\n\n```bash\ndocker build -t mapbox/mcp-docs-server .\n```\n\n**Or pull from the registry:**\n\n```bash\ndocker pull mapbox/mcp-docs-server\n```\n\n**Claude Desktop / Cursor / VS Code** — configure your MCP client to run the container:\n\n```json\n{\n  \"mcpServers\": {\n    \"mapbox-docs\": {\n      \"command\": \"docker\",\n      \"args\": [\"run\", \"--rm\", \"-i\", \"mapbox/mcp-docs-server\"]\n    }\n  }\n}\n```\n\n---\n\n### Local (from source)\n\n```bash\ngit clone https://github.com/mapbox/mcp-docs-server.git\ncd mcp-docs-server\nnpm install\nnpm run build\n```\n\n**Claude Desktop / Cursor / VS Code:**\n\n```json\n{\n  \"mcpServers\": {\n    \"mapbox-docs\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/mcp-docs-server/dist/esm/index.js\"]\n    }\n  }\n}\n```\n\n## Tools\n\n**`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.\n\nExample prompts:\n\n- \"What Mapbox APIs are available?\"\n- \"How do I add a custom layer to a Mapbox style?\"\n- \"What's the latest Mapbox GL JS version?\"\n\n**`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.\n\n**`search_mapbox_docs_tool`** — Searches Mapbox documentation using Algolia full-text search and returns matching page URLs and excerpts. Use this to find relevant documentation before fetching full pages with `get_document_tool` or `batch_get_documents_tool`.\n\nExample prompts:\n\n- \"Find docs about camera animation\"\n- \"Search for geocoding API examples\"\n- \"What documentation exists for custom layers?\"\n\n## Resources\n\nMCP resources expose reference data that AI assistants can read on demand:\n\n| Resource URI                           | Contents                                                            |\n| -------------------------------------- | ------------------------------------------------------------------- |\n| `resource://mapbox-api-reference`      | REST API reference docs (endpoints, parameters, rate limits)        |\n| `resource://mapbox-sdk-docs`           | SDK and client library docs (iOS, Android, Flutter, web)            |\n| `resource://mapbox-guides`             | Tutorials, how-tos, and guides                                      |\n| `resource://mapbox-examples`           | Code examples, API playgrounds, and interactive demos               |\n| `resource://mapbox-reference`          | Tilesets, data products, accounts, and pricing reference            |\n| `resource://mapbox-style-layers`       | Style layer reference (paint/layout properties for all layer types) |\n| `resource://mapbox-streets-v8-fields`  | Mapbox Streets v8 tileset field reference                           |\n| `resource://mapbox-token-scopes`       | All available Mapbox token scopes with descriptions                 |\n| `resource://mapbox-layer-type-mapping` | Mapping of Mapbox layer types to their properties                   |\n\n## Development\n\n### Prerequisites\n\n- Node.js >= 22\n- npm\n\n### Setup\n\n```bash\ngit clone https://github.com/mapbox/mcp-docs-server.git\ncd mcp-docs-server\nnpm install\n```\n\n### Commands\n\n```bash\nnpm run build          # Compile TypeScript (ESM + CJS)\nnpm test               # Run test suite (vitest)\nnpm run lint           # ESLint\nnpm run format         # Prettier check\nnpm run format:fix     # Prettier auto-fix\nnpm run inspect:build  # Launch MCP Inspector against built server\nnpm run inspect:dev    # Launch MCP Inspector against source (tsx)\n```\n\n### Architecture\n\nThe server is a TypeScript MCP server using `@modelcontextprotocol/sdk` with a dual ESM/CJS build via `tshy`.\n\n- **Tools** extend `BaseTool<InputSchema, OutputSchema>` in `src/tools/`\n- **Resources** extend `BaseResource` in `src/resources/`\n- No Mapbox access token required for documentation tools\n- HTTP requests use a shared `httpPipeline` with 1-hour caching\n\n### Creating a New Tool\n\n1. Create a directory `src/tools/my-tool/`\n2. Add `MyTool.input.schema.ts` (Zod schema), `MyTool.output.schema.ts`, and `MyTool.ts` (extends `BaseTool`)\n3. Register in `src/tools/toolRegistry.ts`\n4. Add tests in `test/tools/my-tool/`\n\n## Contributing\n\nPlease read [CONTRIBUTING.md](./CONTRIBUTING.md) and [VISION.md](./VISION.md) before submitting a pull request. Contributors using AI coding assistants should also review:\n\n- [CLAUDE.md](./CLAUDE.md) — for Claude Code\n- [AGENTS.md](./AGENTS.md) — for other AI coding assistants (Cursor, Copilot, Aider, etc.)\n\n## License\n\nMIT — see [LICENSE](./LICENSE)\n",
  "bytes": 5727,
  "sha": "f14d31a890886d5e11a7e99452537536163135ee501de8090da4c1f6fe85a482",
  "repo_slug": "mapbox/mcp-docs-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_mapbox_mcp_docs_server_84591c36/readme"
}