@mapbox/mcp-server 0.2.1-dev.1 → 0.2.1-dev.1.0

package/README.md

@@ -1,5 +1,7 @@
 # Mapbox MCP Server
 
+[![npm version](https://badge.fury.io/js/@mapbox%2Fmcp-server.svg)](https://badge.fury.io/js/@mapbox%2Fmcp-server)
+
 Node.js server implementing Model Context Protocol (MCP) for Mapbox APIs.
 
 ## Unlock Geospatial Intelligence for Your AI Applications
@@ -35,8 +37,44 @@ For detailed setup instructions for different integrations, refer to the followi
 
 - [Claude Desktop Setup](./docs/claude-desktop-setup.md) - Instructions for configuring Claude Desktop to work with this MCP server
 - [VS Code Setup](./docs/vscode-setup.md) - Setting up a development environment in Visual Studio Code
+- [Cursor AI IDE Setup](./docs/cursor-setup.md) - Setting up a development environment in Cursor AI IDE
 - [Smolagents Integration](./docs/using-mcp-with-smolagents/README.md) - Example showing how to connect Smolagents AI agents to Mapbox's tools
 
+## Example Prompts
+
+Try these prompts with Claude Desktop or other MCP clients after setup:
+
+### Location Discovery
+
+- "Find coffee shops within walking distance of the Empire State Building"
+- "Show me gas stations along the route from Boston to New York"
+- "What restaurants are near Times Square?"
+
+### Navigation & Travel
+
+- "Get driving directions from LAX to Hollywood with current traffic"
+- "How long would it take to walk from Central Park to Times Square?"
+- "Calculate travel time from my hotel (Four Seasons) to JFK Airport by taxi during rush hour"
+
+### Visualization & Maps
+
+- "Create a map image showing the route from Golden Gate Bridge to Fisherman's Wharf with markers at both locations"
+- "Show me a satellite view of Manhattan with key landmarks marked"
+- "Generate a map highlighting all Starbucks locations within a mile of downtown Seattle"
+
+### Analysis & Planning
+
+- "Show me areas reachable within 30 minutes of downtown Portland by car"
+- "Calculate a travel time matrix between these 3 hotel locations (Marriott, Sheraton and Hilton) and the convention center in Denver"
+- "Find the optimal route visiting these 3 tourist attractions (Golden Gate, Musical Stairs and Fisherman's Wharf) in San Francisco"
+
+### Tips for Better Results
+
+- Be specific about locations (use full addresses or landmark names)
+- Specify your preferred travel method (driving, walking, cycling)
+- Include time constraints when relevant ("during rush hour", "at 3 PM")
+- Ask for specific output formats when needed ("as a map image", "in JSON format")
+
 ## Tools
 
 ### Mapbox API tools
@@ -112,13 +150,12 @@ Fetches routing directions using the [Mapbox Directions API](https://docs.mapbox
   - Future departure time (`depart_at`) for driving and driving-traffic profiles
   - Desired arrival time (`arrive_by`) for driving profile only
 - Profile-specific optimizations:
-  - Walking: customizable walking speed and bias for/against walkways
   - Driving: vehicle dimension constraints (height, width, weight)
 - Exclusion options for routing:
   - Common exclusions: ferry routes, cash-only tolls
   - Driving-specific exclusions: tolls, motorways, unpaved roads, tunnels, country borders, state borders
   - Custom point exclusions (up to 50 geographic points to avoid)
-- Multiple geometry output formats (GeoJSON, polyline)
+- GeoJSON geometry output format
 
 #### Isochrone tool
 
@@ -169,9 +206,53 @@ Set `VERBOSE_ERRORS=true` to get detailed error messages from the MCP server. Th
 
 By default, the server returns generic error messages. With verbose errors enabled, you'll receive the actual error details, which can help diagnose API connection issues, invalid parameters, or other problems.
 
-## Feedback
+## Data Usage & Privacy
+
+### What data is sent to Mapbox APIs
+
+When you use the MCP server tools, the following data is sent directly from your environment to Mapbox APIs:
+
+- **Geocoding tools**: Address/location text, coordinates, country/region filters
+- **Search tools**: Search queries, location coordinates for proximity, category filters
+- **Directions tool**: Start/end coordinates, waypoints, routing preferences, vehicle constraints
+- **Matrix tool**: Multiple coordinate pairs, travel profile, departure times
+- **Static map tool**: Coordinates, zoom level, styling preferences, marker information
+- **Isochrone tool**: Origin coordinates, time/distance parameters, travel profile
+
+### Your privacy
+
+- **Local execution**: All API calls are made directly from your environment to Mapbox APIs
+- **Token security**: Your Mapbox API token remains on your local machine and is never transmitted to or stored by this MCP server
+- **No data storage**: This MCP server does not store, log, or collect any of your data or API requests
+- **Direct communication**: There is no intermediary server between you and Mapbox APIs
+
+### Third-party data usage
+
+- **Mapbox's privacy policy** governs data sent to their APIs: https://www.mapbox.com/legal/privacy/
+- **API usage**: Standard Mapbox API terms apply to all requests made through these tools
+- **Data retention**: Refer to Mapbox's documentation for their data retention policies
+
+## Support & Contact
+
+### For MCP Server Issues
+
+- **Email**: mcp-feedback@mapbox.com
+- **GitHub Issues**: [Report bugs and feature requests](https://github.com/mapbox/mcp-server/issues)
+
+### For Mapbox API Questions
+
+- **Mapbox Support**: https://support.mapbox.com/
+- **Documentation**: https://docs.mapbox.com/
+- **API Status**: https://status.mapbox.com/
+
+### Maintenance Commitment
+
+This MCP server is officially maintained by Mapbox, Inc. We provide:
 
-For feedback and questions about this MCP server, email mcp-feedback@mapbox.com.
+- Regular updates for new Mapbox API features
+- Bug fixes and security updates
+- Compatibility with latest MCP protocol versions
+- Community support through GitHub issues
 
 ---
 

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACV,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAC;AACxF,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAC;AACxF,OAAO,EAAE,kBAAkB,EAAE,MAAM,qDAAqD,CAAC;AACzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,8BAA8B;AAE9B,IAAI,iBAAiB,GAAG,cAAc,EAAE,CAAC;AACzC,gBAAgB,CAAC,iBAAiB,CAAC,CAAC;AAEpC,uBAAuB;AACvB,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;IACE,IAAI,EAAE,iBAAiB,CAAC,IAAI;IAC5B,OAAO,EAAE,iBAAiB,CAAC,OAAO;CACnC,EACD;IACE,YAAY,EAAE;QACZ,OAAO,EAAE,EAAE;KACZ;CACF,CACF,CAAC;AAEF,oCAAoC;AACpC,IAAI,UAAU,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AACnC,IAAI,kBAAkB,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAC3C,IAAI,kBAAkB,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAC3C,IAAI,aAAa,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AACtC,IAAI,aAAa,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AACtC,IAAI,kBAAkB,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAC3C,IAAI,kBAAkB,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAC3C,IAAI,cAAc,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAEvC,mEAAmE;AACnE,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAC;AACxF,OAAO,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAC;AACzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oDAAoD,CAAC;AACxF,OAAO,EAAE,kBAAkB,EAAE,MAAM,qDAAqD,CAAC;AACzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,8BAA8B;AAE9B,IAAI,iBAAiB,GAAG,cAAc,EAAE,CAAC;AACzC,gBAAgB,CAAC,iBAAiB,CAAC,CAAC;AAEpC,uBAAuB;AACvB,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;IACE,IAAI,EAAE,iBAAiB,CAAC,IAAI;IAC5B,OAAO,EAAE,iBAAiB,CAAC,OAAO;CACnC,EACD;IACE,YAAY,EAAE;QACZ,OAAO,EAAE,EAAE;KACZ;CACF,CACF,CAAC;AAEF,oCAAoC;AACpC,IAAI,UAAU,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AACnC,IAAI,kBAAkB,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAC3C,IAAI,kBAAkB,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAC3C,IAAI,aAAa,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AACtC,IAAI,aAAa,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AACtC,IAAI,kBAAkB,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAC3C,IAAI,kBAAkB,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAC3C,IAAI,cAAc,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAEvC,mEAAmE;AACnE,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/tools/MapboxApiBasedTool.d.ts

@@ -55,6 +55,13 @@ export declare abstract class MapboxApiBasedTool<InputSchema extends ZodTypeAny>
     constructor(params: {
         inputSchema: InputSchema;
     });
+    /**
+     * Validates if a string has the format of a JWT token (header.payload.signature)
+     * Docs: https://docs.mapbox.com/api/accounts/tokens/#token-format
+     * @param token The token string to validate
+     * @returns boolean indicating if the token has valid JWT format
+     */
+    private isValidJwtFormat;
     /**
      * Validates and runs the tool logic.
      */

package/dist/tools/MapboxApiBasedTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MapboxApiBasedTool.d.ts","sourceRoot":"","sources":["../../src/tools/MapboxApiBasedTool.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,cAAc,EACf,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAEpC,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAevB,CAAC;AAEH,8BAAsB,kBAAkB,CAAC,WAAW,SAAS,UAAU;IACrE,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAEtC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAQ;IAE1C,MAAM,CAAC,QAAQ,CAAC,mBAAmB,qBAAmC;IACtE,MAAM,CAAC,QAAQ,CAAC,mBAAmB,SAC4B;gBAEnD,MAAM,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE;IAIhD;;OAEG;IACG,GAAG,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;IA2CnE;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IAEtE;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,cAAc;IAU5C;;OAEG;IACH,SAAS,CAAC,GAAG,CACX,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,EAC7C,IAAI,EAAE,GAAG,GACR,IAAI;CAKR"}
+{"version":3,"file":"MapboxApiBasedTool.d.ts","sourceRoot":"","sources":["../../src/tools/MapboxApiBasedTool.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,cAAc,EACf,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAEpC,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAevB,CAAC;AAEH,8BAAsB,kBAAkB,CAAC,WAAW,SAAS,UAAU;IACrE,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAEtC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAQ;IAE1C,MAAM,CAAC,QAAQ,CAAC,mBAAmB,qBAAmC;IACtE,MAAM,CAAC,QAAQ,CAAC,mBAAmB,SAC4B;gBAEnD,MAAM,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE;IAIhD;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IASxB;;OAEG;IACG,GAAG,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;IAwDnE;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IAEtE;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,cAAc;IAU5C;;OAEG;IACH,SAAS,CAAC,GAAG,CACX,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,EAC7C,IAAI,EAAE,GAAG,GACR,IAAI;CAKR"}

package/dist/tools/MapboxApiBasedTool.js

@@ -21,6 +21,20 @@ export class MapboxApiBasedTool {
     constructor(params) {
         this.inputSchema = params.inputSchema;
     }
+    /**
+     * Validates if a string has the format of a JWT token (header.payload.signature)
+     * Docs: https://docs.mapbox.com/api/accounts/tokens/#token-format
+     * @param token The token string to validate
+     * @returns boolean indicating if the token has valid JWT format
+     */
+    isValidJwtFormat(token) {
+        // JWT consists of three parts separated by dots: header.payload.signature
+        const parts = token.split('.');
+        if (parts.length !== 3)
+            return false;
+        // Check that all parts are non-empty
+        return parts.every((part) => part.length > 0);
+    }
     /**
      * Validates and runs the tool logic.
      */
@@ -29,6 +43,10 @@ export class MapboxApiBasedTool {
             if (!MapboxApiBasedTool.MAPBOX_ACCESS_TOKEN) {
                 throw new Error('MAPBOX_ACCESS_TOKEN is not set');
             }
+            // Validate that the token has the correct JWT format
+            if (!this.isValidJwtFormat(MapboxApiBasedTool.MAPBOX_ACCESS_TOKEN)) {
+                throw new Error('MAPBOX_ACCESS_TOKEN is not in valid JWT format');
+            }
             const input = this.inputSchema.parse(rawInput);
             const result = await this.execute(input);
             // Check if result is already a content object (image or text)
@@ -47,12 +65,16 @@ export class MapboxApiBasedTool {
             };
         }
         catch (error) {
-            this.log('error', `${this.name}: Error during execution: ${error instanceof Error ? error.message : String(error)}`);
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.log('error', `${this.name}: Error during execution: ${errorMessage}`);
+            const isVerboseErrors = process.env.VERBOSE_ERRORS === 'true';
             return {
                 content: [
                     {
                         type: 'text',
-                        text: 'Internal error has occurred.'
+                        text: isVerboseErrors
+                            ? errorMessage
+                            : 'Internal error has occurred.'
                     }
                 ],
                 is_error: true

package/dist/tools/MapboxApiBasedTool.js.map

@@ -1 +1 @@
-{"version":3,"file":"MapboxApiBasedTool.js","sourceRoot":"","sources":["../../src/tools/MapboxApiBasedTool.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"MapboxApiBasedTool.js","sourceRoot":"","sources":["../../src/tools/MapboxApiBasedTool.ts"],"names":[],"mappings":"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"}

package/dist/tools/MapboxApiBasedTool.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=MapboxApiBasedTool.test.d.ts.map

package/dist/tools/MapboxApiBasedTool.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MapboxApiBasedTool.test.d.ts","sourceRoot":"","sources":["../../src/tools/MapboxApiBasedTool.test.ts"],"names":[],"mappings":""}

package/dist/tools/MapboxApiBasedTool.test.js

@@ -0,0 +1,143 @@
+// Use a token with valid JWT format for tests
+process.env.MAPBOX_ACCESS_TOKEN =
+    'eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJ0ZXN0In0.signature';
+import { z } from 'zod';
+import { MapboxApiBasedTool } from './MapboxApiBasedTool';
+// Create a minimal implementation of MapboxApiBasedTool for testing
+class TestTool extends MapboxApiBasedTool {
+    name = 'test-tool';
+    description = 'Tool for testing MapboxApiBasedTool error handling';
+    static inputSchema = z.object({
+        testParam: z.string()
+    });
+    constructor() {
+        super({ inputSchema: TestTool.inputSchema });
+    }
+    async execute(_input) {
+        throw new Error('Test error message');
+    }
+}
+describe('MapboxApiBasedTool', () => {
+    let testTool;
+    const originalEnv = process.env;
+    beforeEach(() => {
+        testTool = new TestTool();
+        // Mock the log method to test that errors are properly logged
+        testTool['log'] = jest.fn();
+    });
+    afterEach(() => {
+        // Restore the process.env to its original state
+        process.env = { ...originalEnv };
+        jest.clearAllMocks();
+    });
+    describe('JWT token validation', () => {
+        it('throws an error when the token is not in a valid JWT format', async () => {
+            // Test the private isValidJwtFormat method directly
+            const originalToken = MapboxApiBasedTool.MAPBOX_ACCESS_TOKEN;
+            try {
+                // Temporarily modify the static property for testing
+                Object.defineProperty(MapboxApiBasedTool, 'MAPBOX_ACCESS_TOKEN', {
+                    value: 'invalid-token-format',
+                    writable: true,
+                    configurable: true
+                });
+                // Create a new instance with the modified token
+                const toolWithInvalidToken = new TestTool();
+                // Mock the log method separately for this instance
+                toolWithInvalidToken['log'] = jest.fn();
+                // Try to call the run method, it should throw an error due to invalid JWT format
+                const result = await toolWithInvalidToken.run({ testParam: 'test' });
+                // Verify the error response
+                expect(result.is_error).toBe(true);
+                // Check for error message content
+                if (process.env.VERBOSE_ERRORS === 'true') {
+                    expect(result.content[0].text).toContain('not in valid JWT format');
+                }
+                // Verify the error was logged
+                expect(toolWithInvalidToken['log']).toHaveBeenCalledWith('error', expect.stringMatching(/.*not in valid JWT format.*/));
+            }
+            finally {
+                // Restore the original value
+                Object.defineProperty(MapboxApiBasedTool, 'MAPBOX_ACCESS_TOKEN', {
+                    value: originalToken,
+                    writable: true,
+                    configurable: true
+                });
+            }
+        });
+        it('accepts a token with valid JWT format', async () => {
+            // Set a valid JWT format token (header.payload.signature)
+            process.env.MAPBOX_ACCESS_TOKEN =
+                'eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJ0ZXN0In0.signature';
+            // Override execute to return a success result instead of throwing an error
+            testTool['execute'] = jest.fn().mockResolvedValue({ success: true });
+            const result = await testTool.run({ testParam: 'test' });
+            // The token validation should pass, and we should get the success result
+            expect(result.is_error).toBe(false);
+            expect(result.content[0]).toHaveProperty('type', 'text');
+            expect(JSON.parse(result.content[0].text)).toEqual({ success: true });
+        });
+    });
+    describe('error handling', () => {
+        it('returns generic error message when VERBOSE_ERRORS is not set to true', async () => {
+            // Make sure VERBOSE_ERRORS is not set to true
+            delete process.env.VERBOSE_ERRORS;
+            const result = await testTool.run({ testParam: 'test' });
+            // Verify the response contains the generic error message
+            expect(result.is_error).toBe(true);
+            expect(result.content).toHaveLength(1);
+            expect(result.content[0]).toMatchObject({
+                type: 'text',
+                text: 'Internal error has occurred.'
+            });
+            // Verify the error was logged with the actual error message
+            expect(testTool['log']).toHaveBeenCalledWith('error', expect.stringContaining('Test error message'));
+        });
+        it('returns actual error message when VERBOSE_ERRORS=true', async () => {
+            // Set VERBOSE_ERRORS to true
+            process.env.VERBOSE_ERRORS = 'true';
+            const result = await testTool.run({ testParam: 'test' });
+            // Verify the response contains the actual error message
+            expect(result.is_error).toBe(true);
+            expect(result.content).toHaveLength(1);
+            expect(result.content[0]).toMatchObject({
+                type: 'text',
+                text: 'Test error message'
+            });
+            // Verify the error was logged with the actual error message
+            expect(testTool['log']).toHaveBeenCalledWith('error', expect.stringContaining('Test error message'));
+        });
+        it('returns generic error message when VERBOSE_ERRORS is set to a value other than true', async () => {
+            // Set VERBOSE_ERRORS to something other than 'true'
+            process.env.VERBOSE_ERRORS = 'yes';
+            const result = await testTool.run({ testParam: 'test' });
+            // Verify the response contains the generic error message
+            expect(result.is_error).toBe(true);
+            expect(result.content).toHaveLength(1);
+            expect(result.content[0]).toMatchObject({
+                type: 'text',
+                text: 'Internal error has occurred.'
+            });
+            // Verify the error was logged with the actual error message
+            expect(testTool['log']).toHaveBeenCalledWith('error', expect.stringContaining('Test error message'));
+        });
+        it('handles non-Error objects thrown', async () => {
+            // Override the execute method to throw a string instead of an Error
+            testTool['execute'] = jest.fn().mockImplementation(() => {
+                throw 'String error message';
+            });
+            process.env.VERBOSE_ERRORS = 'true';
+            const result = await testTool.run({ testParam: 'test' });
+            // Verify the response contains the string error
+            expect(result.is_error).toBe(true);
+            expect(result.content).toHaveLength(1);
+            expect(result.content[0]).toMatchObject({
+                type: 'text',
+                text: 'String error message'
+            });
+            // Verify the error was logged
+            expect(testTool['log']).toHaveBeenCalledWith('error', expect.stringContaining('String error message'));
+        });
+    });
+});
+//# sourceMappingURL=MapboxApiBasedTool.test.js.map

package/dist/tools/MapboxApiBasedTool.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MapboxApiBasedTool.test.js","sourceRoot":"","sources":["../../src/tools/MapboxApiBasedTool.test.ts"],"names":[],"mappings":"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"}

package/dist/tools/category-search-tool/CategorySearchTool.d.ts

@@ -4,26 +4,75 @@ declare const CategorySearchInputSchema: z.ZodObject<{
     category: z.ZodString;
     language: z.ZodOptional<z.ZodString>;
     limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-    proximity: z.ZodOptional<z.ZodUnion<[z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>, z.ZodEffects<z.ZodString, [number, number] | "ip", string>]>>;
-    bbox: z.ZodOptional<z.ZodTuple<[z.ZodNumber, z.ZodNumber, z.ZodNumber, z.ZodNumber], null>>;
+    proximity: z.ZodOptional<z.ZodUnion<[z.ZodObject<{
+        longitude: z.ZodNumber;
+        latitude: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        longitude: number;
+        latitude: number;
+    }, {
+        longitude: number;
+        latitude: number;
+    }>, z.ZodEffects<z.ZodString, "ip" | {
+        longitude: any;
+        latitude: any;
+    }, string>]>>;
+    bbox: z.ZodOptional<z.ZodObject<{
+        minLongitude: z.ZodNumber;
+        minLatitude: z.ZodNumber;
+        maxLongitude: z.ZodNumber;
+        maxLatitude: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        minLongitude: number;
+        minLatitude: number;
+        maxLongitude: number;
+        maxLatitude: number;
+    }, {
+        minLongitude: number;
+        minLatitude: number;
+        maxLongitude: number;
+        maxLatitude: number;
+    }>>;
     country: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
     poi_category_exclusions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    format: z.ZodDefault<z.ZodOptional<z.ZodEnum<["json_string", "formatted_text"]>>>;
 }, "strip", z.ZodTypeAny, {
     category: string;
     limit: number;
+    format: "json_string" | "formatted_text";
     country?: string[] | undefined;
     language?: string | undefined;
-    proximity?: [number, number] | "ip" | undefined;
-    bbox?: [number, number, number, number] | undefined;
+    proximity?: {
+        longitude: number;
+        latitude: number;
+    } | "ip" | {
+        longitude: any;
+        latitude: any;
+    } | undefined;
+    bbox?: {
+        minLongitude: number;
+        minLatitude: number;
+        maxLongitude: number;
+        maxLatitude: number;
+    } | undefined;
     poi_category_exclusions?: string[] | undefined;
 }, {
     category: string;
     country?: string[] | undefined;
     language?: string | undefined;
     limit?: number | undefined;
-    proximity?: string | [number, number] | undefined;
-    bbox?: [number, number, number, number] | undefined;
+    proximity?: string | {
+        longitude: number;
+        latitude: number;
+    } | undefined;
+    bbox?: {
+        minLongitude: number;
+        minLatitude: number;
+        maxLongitude: number;
+        maxLatitude: number;
+    } | undefined;
     poi_category_exclusions?: string[] | undefined;
+    format?: "json_string" | "formatted_text" | undefined;
 }>;
 export declare class CategorySearchTool extends MapboxApiBasedTool<typeof CategorySearchInputSchema> {
     name: string;

package/dist/tools/category-search-tool/CategorySearchTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CategorySearchTool.d.ts","sourceRoot":"","sources":["../../../src/tools/category-search-tool/CategorySearchTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAwe9D,QAAA,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;EAsE7B,CAAC;AAEH,qBAAa,kBAAmB,SAAQ,kBAAkB,CACxD,OAAO,yBAAyB,CACjC;IACC,IAAI,SAAwB;IAC5B,WAAW,SACwU;;IAMnV,OAAO,CAAC,mBAAmB;cAsDX,OAAO,CACrB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,GAC/C,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAgE3C"}
+{"version":3,"file":"CategorySearchTool.d.ts","sourceRoot":"","sources":["../../../src/tools/category-search-tool/CategorySearchTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAwe9D,QAAA,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8F7B,CAAC;AAEH,qBAAa,kBAAmB,SAAQ,kBAAkB,CACxD,OAAO,yBAAyB,CACjC;IACC,IAAI,SAAwB;IAC5B,WAAW,SACoX;;IAM/X,OAAO,CAAC,mBAAmB;cAsDX,OAAO,CACrB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,GAC/C,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAsE3C"}

package/dist/tools/category-search-tool/CategorySearchTool.js

@@ -502,12 +502,30 @@ const CategorySearchInputSchema = z.object({
         .describe('Maximum number of results to return (1-25)'),
     proximity: z
         .union([
-        z.tuple([z.number().min(-180).max(180), z.number().min(-90).max(90)]),
+        z.object({
+            longitude: z.number().min(-180).max(180),
+            latitude: z.number().min(-90).max(90)
+        }),
         z.string().transform((val) => {
             // Handle special case of 'ip'
             if (val === 'ip') {
                 return 'ip';
             }
+            // Handle JSON-stringified object: "{\"longitude\": -82.458107, \"latitude\": 27.937259}"
+            if (val.startsWith('{') && val.endsWith('}')) {
+                try {
+                    const parsed = JSON.parse(val);
+                    if (typeof parsed === 'object' &&
+                        parsed !== null &&
+                        typeof parsed.longitude === 'number' &&
+                        typeof parsed.latitude === 'number') {
+                        return { longitude: parsed.longitude, latitude: parsed.latitude };
+                    }
+                }
+                catch {
+                    // Fall back to other formats
+                }
+            }
             // Handle string that looks like an array: "[-82.451668, 27.942964]"
             if (val.startsWith('[') && val.endsWith(']')) {
                 const coords = val
@@ -515,28 +533,28 @@ const CategorySearchInputSchema = z.object({
                     .split(',')
                     .map((s) => Number(s.trim()));
                 if (coords.length === 2 && !isNaN(coords[0]) && !isNaN(coords[1])) {
-                    return coords;
+                    return { longitude: coords[0], latitude: coords[1] };
                 }
             }
             // Handle comma-separated string: "-82.451668,27.942964"
             const parts = val.split(',').map((s) => Number(s.trim()));
             if (parts.length === 2 && !isNaN(parts[0]) && !isNaN(parts[1])) {
-                return parts;
+                return { longitude: parts[0], latitude: parts[1] };
             }
-            throw new Error('Invalid proximity format. Expected [longitude, latitude], "longitude,latitude", or "ip"');
+            throw new Error('Invalid proximity format. Expected {longitude, latitude}, "longitude,latitude", or "ip"');
         })
     ])
         .optional()
-        .describe('Location to bias results towards. Either [longitude, latitude] or "ip" for IP-based location'),
+        .describe('Location to bias results towards. Either coordinate object with longitude and latitude or "ip" for IP-based location'),
     bbox: z
-        .tuple([
-        z.number().min(-180).max(180),
-        z.number().min(-90).max(90),
-        z.number().min(-180).max(180),
-        z.number().min(-90).max(90)
-    ])
+        .object({
+        minLongitude: z.number().min(-180).max(180),
+        minLatitude: z.number().min(-90).max(90),
+        maxLongitude: z.number().min(-180).max(180),
+        maxLatitude: z.number().min(-90).max(90)
+    })
         .optional()
-        .describe('Bounding box to limit results within [minLon, minLat, maxLon, maxLat]'),
+        .describe('Bounding box to limit results within specified bounds'),
     country: z
         .array(z.string().length(2))
         .optional()
@@ -544,11 +562,16 @@ const CategorySearchInputSchema = z.object({
     poi_category_exclusions: z
         .array(z.string())
         .optional()
-        .describe('Array of POI categories to exclude from results')
+        .describe('Array of POI categories to exclude from results'),
+    format: z
+        .enum(['json_string', 'formatted_text'])
+        .optional()
+        .default('formatted_text')
+        .describe('Output format: "json_string" returns raw GeoJSON data as a JSON string that can be parsed; "formatted_text" returns human-readable text with place names, addresses, and coordinates. Both return as text content but json_string contains parseable JSON data while formatted_text is for display.')
 });
 export class CategorySearchTool extends MapboxApiBasedTool {
     name = 'CategorySearchTool';
-    description = "Return all places that match a category (industry, amenity, or NAICS‑style code). Use when the user asks for a type of place, plural or generic terms like 'museums', 'coffee shops', 'electric‑vehicle chargers', or when the query includes is‑a phrases such as 'any', 'all', 'nearby'. Do not use when a unique name or brand is provided.";
+    description = "Return all places that match a category (industry, amenity, or NAICS‑style code). Use when the user asks for a type of place, plural or generic terms like 'museums', 'coffee shops', 'electric‑vehicle chargers', or when the query includes is‑a phrases such as 'any', 'all', 'nearby'. Do not use when a unique name or brand is provided. Supports both JSON and text output formats.";
     constructor() {
         super({ inputSchema: CategorySearchInputSchema });
     }
@@ -611,13 +634,13 @@ export class CategorySearchTool extends MapboxApiBasedTool {
                 url.searchParams.append('proximity', 'ip');
             }
             else {
-                const [lng, lat] = input.proximity;
-                url.searchParams.append('proximity', `${lng},${lat}`);
+                const { longitude, latitude } = input.proximity;
+                url.searchParams.append('proximity', `${longitude},${latitude}`);
             }
         }
         if (input.bbox) {
-            const [minLon, minLat, maxLon, maxLat] = input.bbox;
-            url.searchParams.append('bbox', `${minLon},${minLat},${maxLon},${maxLat}`);
+            const { minLongitude, minLatitude, maxLongitude, maxLatitude } = input.bbox;
+            url.searchParams.append('bbox', `${minLongitude},${minLatitude},${maxLongitude},${maxLatitude}`);
         }
         if (input.country && input.country.length > 0) {
             url.searchParams.append('country', input.country.join(','));
@@ -632,7 +655,12 @@ export class CategorySearchTool extends MapboxApiBasedTool {
             throw new Error(`Failed to search category: ${response.status} ${response.statusText}`);
         }
         const data = await response.json();
-        return { type: 'text', text: this.formatGeoJsonToText(data) };
+        if (input.format === 'json_string') {
+            return { type: 'text', text: JSON.stringify(data, null, 2) };
+        }
+        else {
+            return { type: 'text', text: this.formatGeoJsonToText(data) };
+        }
     }
 }
 //# sourceMappingURL=CategorySearchTool.js.map