mcp-docs-server
AI access to Mapbox docs, API references, style specs, and guides. No token required.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"mcp-docs-server": {
"command": "npx",
"args": [
"@mapbox/mcp-docs-server"
]
}
}
}Runnable packages
0.3.1stdioRemote endpoints
https://mcp-docs.mapbox.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (3)
🟢get_document_tool(url)
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.
Input Schema
{
"type": "object",
"properties": {
"url": {
"type": "string",
"format": "uri",
"description": "URL of a Mapbox documentation page to fetch. Must be a mapbox.com URL (e.g. https://docs.mapbox.com/api/search/geocoding/)."
}
},
"required": [
"url"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢batch_get_documents_tool(urls)
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.
Input Schema
{
"type": "object",
"properties": {
"urls": {
"minItems": 1,
"maxItems": 20,
"type": "array",
"items": {
"type": "string",
"format": "uri"
},
"description": "Array of Mapbox documentation page URLs to fetch (max 20). All must be mapbox.com URLs."
}
},
"required": [
"urls"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢search_mapbox_docs_tool(query, limit)
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.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"description": "Search query for Mapbox documentation (e.g. \"add a marker\", \"camera animation\", \"geocoding API\")."
},
"limit": {
"default": 5,
"description": "Maximum number of results to return (1–20, default 5).",
"type": "integer",
"minimum": 1,
"maximum": 20
}
},
"required": [
"query"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}Community
Evidence