add doc

Author: zmofei

README.md

@@ -189,6 +189,32 @@ List Mapbox access tokens for the authenticated user with optional filtering and
 - "List the 5 most recently modified tokens"
 - "Show all public tokens in my account"
 
+#### get_latest_mapbox_docs_tool
+
+Access the latest official Mapbox documentation directly from the source. This tool fetches comprehensive, up-to-date information about all Mapbox APIs, SDKs, and developer resources from docs.mapbox.com/llms.txt.
+
+**Parameters:** None required
+
+**Example:**
+
+```json
+{}
+```
+
+**Returns:** Complete Mapbox documentation including all current APIs, SDKs, tools, and developer resources. Always up-to-date and more reliable than web search results.
+
+**Example prompts:**
+
+- "What are the latest Mapbox APIs available for developers?"
+- "Show me all current Mapbox services and SDKs"
+- "I need up-to-date Mapbox documentation for my project"
+- "What mapping solutions does Mapbox offer for my tech stack?"
+- "Give me an overview of Mapbox's navigation and routing capabilities"
+- "Compare Mapbox web SDKs versus mobile SDKs"
+- "What's new in the Mapbox ecosystem?"
+
+📖 **[See more examples and interactive demo →](./docs/mapbox-docs-tool-demo.md)**
+
 ### Local processing tools
 
 #### GeoJSON Preview tool (Beta)

docs/mapbox-docs-tool-demo.md

@@ -0,0 +1,171 @@
+# Mapbox Documentation Tool Demo
+
+This demo showcases the `get_latest_mapbox_docs_tool` and provides example prompts that will trigger the AI assistant to use this tool instead of web search.
+
+## 🎯 Tool Overview
+
+The `get_latest_mapbox_docs_tool` automatically fetches the latest official Mapbox documentation from `docs.mapbox.com/llms.txt`. This ensures AI assistants always have access to current, authoritative information about Mapbox APIs and services.
+
+## 📝 Demo Prompts
+
+Try these prompts with your AI assistant to see the tool in action:
+
+### 1. Basic Documentation Queries
+
+```
+What are the latest Mapbox APIs available for developers? I want to make sure I'm using the most current information.
+```
+
+```
+Show me all current Mapbox services and SDKs available for developers.
+```
+
+```
+I need the most up-to-date Mapbox documentation for my project planning.
+```
+
+### 2. Development Planning
+
+```
+I'm building a location-based mobile application. What Mapbox tools and APIs should I consider for my tech stack?
+```
+
+```
+Help me understand the complete Mapbox developer platform - what options do I have?
+```
+
+```
+What mapping solutions does Mapbox offer? I need to choose the right approach for my web application.
+```
+
+### 3. Learning & Research
+
+```
+Give me a comprehensive overview of Mapbox's current product ecosystem.
+```
+
+```
+What are Mapbox's navigation and routing capabilities? Please provide current details.
+```
+
+```
+Explain the differences between Mapbox web SDKs and mobile SDKs.
+```
+
+```
+I'm new to Mapbox development. Can you give me an overview of their documentation and resources?
+```
+
+### 4. Architecture Decisions
+
+```
+For a real estate application with interactive maps and address search, what Mapbox APIs would be most relevant?
+```
+
+```
+I need to implement mapping, geocoding, and turn-by-turn routing. What are my Mapbox options?
+```
+
+```
+Compare Mapbox solutions for web applications versus mobile app implementations.
+```
+
+```
+I'm building a logistics platform. What Mapbox services should I evaluate?
+```
+
+### 5. Latest Information Requests
+
+```
+What's new in the Mapbox ecosystem? I want to make sure I'm aware of all current offerings.
+```
+
+```
+Are there any recent additions to Mapbox's API collection that I should know about?
+```
+
+```
+Give me a current state overview of Mapbox developer tools and services.
+```
+
+```
+I last used Mapbox 2 years ago. What has changed and what new services are available?
+```
+
+## 🎪 Interactive Demo Session
+
+Try this complete conversation flow:
+
+**You:** "I'm planning a food delivery app with real-time tracking and route optimization. What current Mapbox services would be relevant?"
+
+**Expected AI behavior:**
+
+1. The AI should use `get_latest_mapbox_docs_tool`
+2. Provide specific recommendations based on current Mapbox offerings
+3. Include relevant APIs like Navigation SDK, Directions API, etc.
+
+**Follow-up:** "Can you give me more details about the Navigation SDK options?"
+
+**Expected AI behavior:**
+
+1. Reference the already-fetched documentation
+2. Provide specific details about iOS/Android Navigation SDKs
+3. Include links to relevant documentation
+
+## 🔍 What Makes These Prompts Effective
+
+These prompts work because they:
+
+- ✅ **Emphasize currency**: Use words like "latest", "current", "up-to-date"
+- ✅ **Request completeness**: Ask for "all", "comprehensive", "complete overview"
+- ✅ **Imply official sources**: Request "current offerings", "official documentation"
+- ✅ **Suggest comparison needs**: Multiple options require comprehensive data
+- ✅ **Focus on accuracy**: "make sure I'm using correct information"
+
+## 🚀 Benefits Demonstration
+
+### Before (using web search):
+
+- May get outdated information
+- Fragmented results from multiple sources
+- Potential inaccuracies from third-party sites
+- Missing new APIs or changes
+
+### After (using get_latest_mapbox_docs_tool):
+
+- ✅ Always current official information
+- ✅ Complete ecosystem overview
+- ✅ Authoritative source (directly from Mapbox)
+- ✅ Includes latest APIs and features
+
+## 🎛 Advanced Usage
+
+### Complex Project Planning
+
+```
+I need to architect a complete geospatial solution with mapping, search, routing, and analytics. Based on the latest Mapbox offerings, what would be the optimal combination of services?
+```
+
+### Competitive Analysis
+
+```
+I'm evaluating Mapbox versus other mapping platforms. What are all the current Mapbox capabilities I should consider in my analysis?
+```
+
+### Migration Planning
+
+```
+We're currently using [other platform]. What are all the Mapbox services that could replace our current functionality?
+```
+
+## 💡 Pro Tips
+
+1. **Use temporal keywords**: "latest", "current", "up-to-date", "recent"
+2. **Request comprehensiveness**: "all", "complete", "entire", "full"
+3. **Emphasize accuracy**: "official", "authoritative", "correct"
+4. **Avoid specific tool names**: Let the AI choose the right tool naturally
+5. **Context matters**: Mention your project needs to get relevant filtering
+
+---
+
+_This demo file is designed to help developers and AI assistants make the most of the Mapbox Documentation Tool. The prompts are crafted to naturally trigger the correct tool selection while providing valuable, current information._

src/tools/__snapshots__/tool-naming-convention.test.ts.snap

@@ -39,8 +39,8 @@ exports[`Tool Naming Convention should maintain consistent tool list (snapshot t
   },
   {
     "className": "GetMapboxDocSourceTool",
-    "description": "Fetch and return Mapbox documentation source collection content from llms.txt",
-    "toolName": "get_mapbox_doc_source_tool",
+    "description": "Get the latest official Mapbox documentation, APIs, SDKs, and developer resources directly from Mapbox. Always up-to-date, comprehensive coverage of all current Mapbox services including mapping, navigation, search, geocoding, and mobile SDKs. Use this for accurate, official Mapbox information instead of web search.",
+    "toolName": "get_latest_mapbox_docs_tool",
   },
   {
     "className": "ListStylesTool",

src/tools/get-mapbox-doc-source-tool/GetMapboxDocSourceTool.test.ts

@@ -13,8 +13,12 @@ describe('GetMapboxDocSourceTool', () => {
   });
 
   it('should have correct name and description', () => {
-    expect(tool.name).toBe('get_mapbox_doc_source_tool');
-    expect(tool.description).toContain('Fetch and return Mapbox documentation');
+    expect(tool.name).toBe('get_latest_mapbox_docs_tool');
+    expect(tool.description).toContain(
+      'Get the latest official Mapbox documentation'
+    );
+    expect(tool.description).toContain('Always up-to-date');
+    expect(tool.description).toContain('instead of web search');
   });
 
   it('should successfully fetch documentation content', async () => {

src/tools/get-mapbox-doc-source-tool/GetMapboxDocSourceTool.ts

@@ -7,9 +7,9 @@ import {
 export class GetMapboxDocSourceTool extends BaseTool<
   typeof GetMapboxDocSourceSchema
 > {
-  name = 'get_mapbox_doc_source_tool';
+  name = 'get_latest_mapbox_docs_tool';
   description =
-    'Fetch and return Mapbox documentation source collection content from llms.txt';
+    'Get the latest official Mapbox documentation, APIs, SDKs, and developer resources directly from Mapbox. Always up-to-date, comprehensive coverage of all current Mapbox services including mapping, navigation, search, geocoding, and mobile SDKs. Use this for accurate, official Mapbox information instead of web search.';
 
   constructor() {
     super({ inputSchema: GetMapboxDocSourceSchema });