feat: add API endpoint explorer tool (#71)

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>

Author: mattpodwysocki

CHANGELOG.md

@@ -1,5 +1,15 @@
 ## Unreleased
 
+### Features Added
+
+- **API Endpoint Explorer Tool**: New `explore_mapbox_api_tool` provides structured, queryable information about Mapbox APIs (#71)
+  - List all available Mapbox APIs with descriptions and operation counts
+  - View detailed operations for specific APIs (geocoding, styles, tokens, static-images, directions, tilequery, feedback)
+  - Get complete endpoint details including HTTP methods, parameters, required scopes, and rate limits
+  - Optional detailed mode includes example requests and responses
+  - Complements `get_latest_mapbox_docs_tool` by providing structured API reference data
+  - No API access required - works with curated endpoint definitions
+
 ### Documentation
 
 - **PR Guidelines**: Added CHANGELOG requirement to CLAUDE.md (#67)

README.md

@@ -131,6 +131,23 @@ The `MAPBOX_ACCESS_TOKEN` environment variable is required. **Each tool requires
 
 📖 **[See more examples and interactive demo →](./docs/mapbox-docs-tool-demo.md)**
 
+**explore_mapbox_api_tool** - Explore Mapbox API endpoints with structured, queryable information. Get details about available APIs, their operations, required parameters, authentication scopes, and rate limits. This tool provides structured API reference data complementing the prose documentation from `get_latest_mapbox_docs_tool`.
+
+**Features:**
+
+- List all available Mapbox APIs (geocoding, styles, tokens, static-images, directions, tilequery, feedback)
+- View operations for a specific API
+- Get detailed endpoint information including HTTP methods, parameters, and examples
+- See required token scopes and rate limits for each operation
+
+**Example prompts:**
+
+- "What Mapbox APIs are available?"
+- "Show me the geocoding API operations"
+- "What parameters does the forward geocoding endpoint accept?"
+- "What scopes do I need for the Styles API?"
+- "How do I use the directions API? Show me examples"
+
 ### Reference Tools
 
 **get_reference_tool** - Access static Mapbox reference documentation and schemas. This tool provides essential reference information that helps AI assistants understand Mapbox concepts and build correct styles and tokens.