chore: remove docs tools/resources, keep static reference data#102
Merged
mattpodwysocki merged 6 commits intomainfrom Apr 22, 2026
Merged
chore: remove docs tools/resources, keep static reference data#102mattpodwysocki merged 6 commits intomainfrom
mattpodwysocki merged 6 commits intomainfrom
Conversation
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Documentation retrieval (llms.txt fetching, get_latest_mapbox_docs_tool, get_reference_tool) is now owned by the dedicated mcp-docs-server which provides richer functionality: search, per-page fetching with .md support, caching, and per-product resources. Removed: - MapboxDocumentationResource (fetched llms.txt — superseded by docs server) - GetMapboxDocSourceTool / GetReferenceTool (resource fallback tools) - RESOURCE_FALLBACK_TOOLS category and CLIENT_NEEDS_RESOURCE_FALLBACK handling Kept: - MapboxStyleLayersResource — layer types, paint/layout properties - MapboxStreetsV8FieldsResource — used directly by StyleBuilderTool - MapboxTokenScopesResource — token scope reference for auth flows - MapboxLayerTypeMappingResource — source layer to GL layer type mapping These four static resources are directly relevant to DevKit's core purpose of style creation, validation, and optimization. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Valiunia
requested changes
Apr 21, 2026
Valiunia
left a comment
Valiunia
left a comment
There was a problem hiding this comment.
In readme there is ### Documentation Tools section
also there is mapbox/mcp-devkit-server/docs/mapbox-docs-tool-demo.md
and there could be other stale references - please have another look
…and prompts - Remove Documentation Tools section from README (moved to mcp-docs-server) - Delete docs/mapbox-docs-tool-demo.md - Remove CLIENT_NEEDS_RESOURCE_FALLBACK section from README - Update Resources section to remove get_reference_tool references - Update prompt files to reference resource URIs directly - Update tracing docs to remove stale tool names - Fix prettier formatting in test files Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…ocs tools Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
package-lock.json was pinned to 3.6.2 while local install had 3.8.x, causing conflicting formatting between CI and the pre-commit hook. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Valiunia
approved these changes
Apr 22, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Documentation retrieval is now owned by the dedicated
mcp-docs-server, which provides richer functionality: full-text search, per-page fetching with.mdsupport, caching, and per-product resources. This PR removes the lightweight/duplicate docs functionality from DevKit to avoid drift and confusion.Removed:
MapboxDocumentationResource— fetchedllms.txt, superseded by docs serverGetMapboxDocSourceTool(get_latest_mapbox_docs_tool) — docs server equivalent is betterGetReferenceTool(get_reference_tool) — was a resource fallback tool for the aboveRESOURCE_FALLBACK_TOOLScategory andCLIENT_NEEDS_RESOURCE_FALLBACKenv var handlingKept (static reference data relevant to DevKit's core purpose):
MapboxStyleLayersResource— layer types, paint/layout properties for style buildingMapboxStreetsV8FieldsResource— used directly byStyleBuilderToolMapboxTokenScopesResource— token scope reference for auth/validation flowsMapboxLayerTypeMappingResource— source layer to GL layer type mappingRelated
mcp-docs-serverPRs Introduce hosted mcp #17 (.mdURL fetching) and AddedremovePolicyandlistPoliciesmethods toPolicyPipelineto allow for easier modification and inspection of the pipeline's policies. #18 (Algolia search) provide the full docs experienceTest plan
🤖 Generated with Claude Code