From d7cf5f2bcf9d4063631ae91dfcb31aabe91ed700 Mon Sep 17 00:00:00 2001 From: Matthew Podwysocki Date: Wed, 18 Mar 2026 11:26:58 -0400 Subject: [PATCH 1/3] Update README tools and resources to reflect current implementation - Replace stale tool names with get_document_tool and batch_get_documents_tool - Remove 'coming soon' markers from resources table (all resources are live) - Drop resource://mapbox-documentation (deprecated in favour of granular resources) Co-Authored-By: Claude Sonnet 4.6 --- README.md | 41 +++++++++++++---------------------------- 1 file changed, 13 insertions(+), 28 deletions(-) diff --git a/README.md b/README.md index eaa7714..7d67dbe 100644 --- a/README.md +++ b/README.md @@ -100,9 +100,7 @@ npm run build ## Tools -### Documentation Tools - -**`get_latest_mapbox_docs_tool`** — Fetches the full Mapbox documentation index from `docs.mapbox.com/llms.txt`. Returns up-to-date, comprehensive coverage of all Mapbox services, APIs, SDKs, and guides in a single LLM-optimized format. +**`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: @@ -110,36 +108,23 @@ Example prompts: - "How do I add a custom layer to a Mapbox style?" - "What's the latest Mapbox GL JS version?" -**`search_mapbox_docs_tool`** _(coming soon)_ — AI-powered search of Mapbox documentation. Returns ranked, relevant sections for a specific query instead of the full corpus. Supports filtering by category (apis, sdks, guides, examples). - -**`explore_mapbox_api_tool`** _(coming soon)_ — Structured, queryable information about Mapbox REST API endpoints. Lists available APIs, operations, required parameters, authentication scopes, and rate limits without making any API calls. - -**`validate_api_request_tool`** _(coming soon)_ — Validates a Mapbox API request before sending it. Checks required parameters, types, enum values, and token scopes. - -**`test_api_request_tool`** _(coming soon)_ — Makes real HTTP calls to Mapbox APIs and returns actual responses, with optional code generation in curl, JavaScript, and Python. Requires a Mapbox access token as input. - -**`get_contextual_docs_tool`** _(coming soon)_ — Retrieves documentation relevant to a specific code context, error message, or technology. - -### Reference Tools - -**`get_reference_tool`** — Serves static Mapbox reference documentation directly as tool output (useful for clients that don't support MCP resources). Covers style layers, Streets v8 fields, token scopes, and layer type mappings. +**`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. ## Resources MCP resources expose reference data that AI assistants can read on demand: -| Resource URI | Contents | -| ------------------------------------------------- | ------------------------------------------------------------------- | -| `resource://mapbox-documentation` | Full Mapbox docs from `docs.mapbox.com/llms.txt` | -| `resource://mapbox-api-reference` _(coming soon)_ | REST API reference docs only | -| `resource://mapbox-sdk-docs` _(coming soon)_ | SDK and client library docs only | -| `resource://mapbox-guides` _(coming soon)_ | Tutorials, how-tos, and guides only | -| `resource://mapbox-examples` _(coming soon)_ | Code examples and playgrounds only | -| `resource://mapbox-reference` _(coming soon)_ | Tilesets, data products, and reference materials | -| `resource://mapbox-style-layers` | Style layer reference (paint/layout properties for all layer types) | -| `resource://mapbox-streets-v8-fields` | Mapbox Streets v8 tileset field reference | -| `resource://mapbox-token-scopes` | All available Mapbox token scopes with descriptions | -| `resource://mapbox-layer-type-mapping` | Mapping of Mapbox layer types to their properties | +| Resource URI | Contents | +| -------------------------------------- | ------------------------------------------------------------------- | +| `resource://mapbox-api-reference` | REST API reference docs (endpoints, parameters, rate limits) | +| `resource://mapbox-sdk-docs` | SDK and client library docs (iOS, Android, Flutter, web) | +| `resource://mapbox-guides` | Tutorials, how-tos, and guides | +| `resource://mapbox-examples` | Code examples, API playgrounds, and interactive demos | +| `resource://mapbox-reference` | Tilesets, data products, accounts, and pricing reference | +| `resource://mapbox-style-layers` | Style layer reference (paint/layout properties for all layer types) | +| `resource://mapbox-streets-v8-fields` | Mapbox Streets v8 tileset field reference | +| `resource://mapbox-token-scopes` | All available Mapbox token scopes with descriptions | +| `resource://mapbox-layer-type-mapping` | Mapping of Mapbox layer types to their properties | ## Development From 7ba499aa8220181d5143f276710a14b97c5238d0 Mon Sep 17 00:00:00 2001 From: Matthew Podwysocki Date: Wed, 18 Mar 2026 11:35:40 -0400 Subject: [PATCH 2/3] chore: bump version to 0.1.0 and finalize changelog for release Co-Authored-By: Claude Sonnet 4.6 --- CHANGELOG.md | 24 ++++++++++++++++++++++++ package.json | 2 +- 2 files changed, 25 insertions(+), 1 deletion(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index ea9e5d7..1bfbcc3 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,29 @@ ## Unreleased +## 0.1.0 - 2026-03-18 + +### Add hosted deployment at mcp-docs.mapbox.com + +- `@mapbox/mcp-docs-server` is now available as a hosted MCP endpoint at `https://mcp-docs.mapbox.com/mcp` — no install or token required +- Connect directly from Claude Code, Claude Desktop, Cursor, or VS Code using the `url` field in your MCP config + +### Update README: correct tool names and resources table (#9) + +- Replaced stale tool name references with `get_document_tool` and `batch_get_documents_tool` +- Removed "coming soon" markers from all resources in the resources table +- Dropped deprecated `resource://mapbox-documentation` entry + +### Add Claude automated code review workflow (#6) + +- Added `.github/workflows/claude-review.yml` using `anthropics/claude-code-action@v1` +- Triggers automatically on PRs with ≥ 300 lines changed, or on any PR when a reviewer comments `@claude` + +### Add sub-path exports for tools, resources, and utils (#7) + +- Added barrel files `src/tools/index.ts`, `src/resources/index.ts`, and `src/utils/index.ts` +- Exposed `./tools`, `./resources`, and `./utils` sub-path exports via `tshy` and the `exports` map in `package.json` +- Enables hosted-mcp-server and other consumers to import server internals directly without bundling the full entry point + ### Fix transient memory amplification in `batch_get_documents_tool` (#4) - Deduplicate intra-batch URLs by normalized key: multiple input URLs that resolve to the same page (e.g. cache-busting query params) now share a single HTTP request and a single buffered body instead of each triggering a separate fetch diff --git a/package.json b/package.json index 415eda9..dea223d 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "@mapbox/mcp-docs-server", - "version": "0.1.0-dev", + "version": "0.1.0", "description": "Mapbox MCP documentation server", "mcpName": "io.github.mapbox/mcp-docs-server", "main": "./dist/commonjs/index.js", From 275ee35bb6b8ca6fe9b3484a661539bc440cfb08 Mon Sep 17 00:00:00 2001 From: Matthew Podwysocki Date: Wed, 18 Mar 2026 11:42:28 -0400 Subject: [PATCH 3/3] fix: add anthropics to cspell wordlist Co-Authored-By: Claude Sonnet 4.6 --- cspell.json | 1 + 1 file changed, 1 insertion(+) diff --git a/cspell.json b/cspell.json index d7f39b5..da4264a 100644 --- a/cspell.json +++ b/cspell.json @@ -7,6 +7,7 @@ "mapbox", "MAPBOX", "modelcontextprotocol", + "anthropics", "llms", "LLMS", "tileset",