feat: Add API endpoint explorer tool #75
Open
Conversation
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
Add explore_mapbox_api_tool to provide structured, queryable information about Mapbox API endpoints, operations, parameters, and authentication. Features: - List all available Mapbox APIs (7 APIs with 24 operations total) - View operations for specific APIs - Get detailed endpoint information with parameters, scopes, rate limits - Optional detailed mode includes example requests/responses - Proper MCP structured content support with separate text and data Coverage: - Geocoding API (forward/reverse geocoding) - Styles API (CRUD operations) - Tokens API (token management) - Static Images API (map image generation) - Directions API (route calculation) - Tilequery API (vector tile queries) - Feedback API (user feedback events) Implementation: - Created mapboxApiEndpoints.ts with curated API definitions - Implemented BaseTool with input/output schemas - Returns both markdown content and structured data - 21 comprehensive test cases, all passing - Updated tool registry and documentation Complements get_latest_mapbox_docs_tool by providing structured API reference data instead of prose documentation. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
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
Implements
explore_mapbox_api_toolto provide structured, queryable information about Mapbox API endpoints, operations, parameters, and authentication requirements. Resolves #71.Features
details: true)API Coverage
Documented 7 APIs with 24 total operations:
Implementation Details
/src/constants/mapboxApiEndpoints.tswith curated API definitionsBaseToolwith proper input/output schemasTesting
Documentation
get_latest_mapbox_docs_toolby providing structured API reference dataScreenshots
Successfully tested in both MCP Inspector (structured content validation) and Claude Desktop (natural language queries).
🤖 Generated with Claude Code