@mapbox/mcp-server 0.6.1 → 0.8.1-dev.0

package/dist/esm/config/toolConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"toolConfig.js","sourceRoot":"","sources":["../../../src/config/toolConfig.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,kCAAkC;AASlC,MAAM,UAAU,uBAAuB;IACrC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,MAAM,GAAe,EAAE,CAAC;IAE9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAEpB,IAAI,GAAG,KAAK,gBAAgB,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YACxB,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,CAAC,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;aAAM,IAAI,GAAG,KAAK,iBAAiB,EAAE,CAAC;YACrC,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YACxB,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,CAAC,aAAa,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,KAA8B,EAC9B,MAAkB;IAElB,IAAI,aAAa,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;IAE/B,mEAAmE;IACnE,2CAA2C;IAC3C,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACtC,aAAa,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAC5C,MAAM,CAAC,YAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CACzC,CAAC;QACF,mDAAmD;QACnD,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,mEAAmE;IACnE,IAAI,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5D,aAAa,GAAG,aAAa,CAAC,MAAM,CAClC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,aAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CACrD,CAAC;IACJ,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC"}
+{"version":3,"file":"toolConfig.js","sourceRoot":"","sources":["../../../src/config/toolConfig.ts"],"names":[],"mappings":"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"}

package/dist/esm/index.d.ts

@@ -1,2 +1,2 @@
-import 'dotenv/config';
+export {};
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAaA,OAAO,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":""}

package/dist/esm/index.js

@@ -1,50 +1,186 @@
 #!/usr/bin/env node
 // Copyright (c) Mapbox, Inc.
 // Licensed under the MIT License.
+// Load environment variables from .env file if present
+// Use Node.js built-in util.parseEnv() and manually apply to override existing vars
+import { parseEnv } from 'node:util';
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { existsSync } from 'node:fs';
+import { SpanStatusCode } from '@opentelemetry/api';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { ListPromptsRequestSchema, GetPromptRequestSchema } from '@modelcontextprotocol/sdk/types.js';
 import { parseToolConfigFromArgs, filterTools } from './config/toolConfig.js';
 import { getAllTools } from './tools/toolRegistry.js';
+import { getAllResources } from './resources/resourceRegistry.js';
+import { getAllPrompts, getPromptByName } from './prompts/promptRegistry.js';
 import { getVersionInfo } from './utils/versionUtils.js';
-import { initializeTracing, shutdownTracing, isTracingInitialized } from './utils/tracing.js';
-import 'dotenv/config';
+import { initializeTracing, shutdownTracing, isTracingInitialized, getTracer } from './utils/tracing.js';
+// Load .env from current working directory (where npm run is executed)
+// This happens before tracing is initialized, but we'll add a span when tracing is ready
+const envPath = join(process.cwd(), '.env');
+let envLoadError = null;
+let envLoadedCount = 0;
+if (existsSync(envPath)) {
+    try {
+        // Read and parse .env file using Node.js built-in parseEnv
+        const envFile = readFileSync(envPath, 'utf-8');
+        const parsed = parseEnv(envFile);
+        // Apply parsed values to process.env (with override)
+        // Note: process.loadEnvFile() doesn't override, so we use parseEnv + manual assignment
+        for (const [key, value] of Object.entries(parsed)) {
+            process.env[key] = value;
+            envLoadedCount++;
+        }
+    }
+    catch (error) {
+        envLoadError = error instanceof Error ? error : new Error(String(error));
+    }
+}
 const versionInfo = getVersionInfo();
 // Parse configuration from command-line arguments
 const config = parseToolConfigFromArgs();
 // Get and filter tools based on configuration
 const allTools = getAllTools();
 const enabledTools = filterTools(allTools, config);
+// Get all resources
+const allResources = getAllResources();
 // Create an MCP server
 const server = new McpServer({
     name: versionInfo.name,
     version: versionInfo.version
 }, {
     capabilities: {
-        tools: {}
+        tools: {},
+        resources: {},
+        prompts: {}
     }
 });
 // Register enabled tools to the server
 enabledTools.forEach((tool) => {
     tool.installTo(server);
 });
-// MCP-compatible logging functions
-// Completely suppress logging when MCP_DISABLE_LOGGING is set (for MCP inspector compatibility)
-function logIfEnabled(level, ...args) {
-    if (!process.env.MCP_DISABLE_LOGGING) {
-        console[level](...args);
+// Register all resources to the server
+allResources.forEach((resource) => {
+    resource.installTo(server);
+});
+// Register prompt handlers
+server.server.setRequestHandler(ListPromptsRequestSchema, async () => {
+    const allPrompts = getAllPrompts();
+    return {
+        prompts: allPrompts.map((prompt) => prompt.getMetadata())
+    };
+});
+server.server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    const prompt = getPromptByName(name);
+    if (!prompt) {
+        throw new Error(`Prompt not found: ${name}`);
     }
-}
+    // Convert args to object for easier access
+    const argsObj = {};
+    if (args && typeof args === 'object') {
+        Object.assign(argsObj, args);
+    }
+    // Get the prompt messages with filled-in arguments
+    const messages = prompt.getMessages(argsObj);
+    return {
+        description: prompt.description,
+        messages
+    };
+});
 async function main() {
     // Initialize OpenTelemetry tracing if not in test mode
+    let tracingInitialized = false;
     if (process.env.NODE_ENV !== 'test' && !process.env.VITEST) {
         try {
             await initializeTracing();
-            logIfEnabled('log', `OpenTelemetry tracing: ${isTracingInitialized() ? 'enabled' : 'disabled'}`);
+            tracingInitialized = isTracingInitialized();
+            // Record .env loading as a span (retrospectively since it happened before tracing init)
+            if (tracingInitialized) {
+                const tracer = getTracer();
+                const span = tracer.startSpan('config.load_env', {
+                    attributes: {
+                        'config.file.path': envPath,
+                        'config.file.exists': existsSync(envPath),
+                        'config.vars.loaded': envLoadedCount,
+                        'operation.type': 'config_load'
+                    }
+                });
+                if (envLoadError) {
+                    span.recordException(envLoadError);
+                    span.setStatus({
+                        code: SpanStatusCode.ERROR,
+                        message: envLoadError.message
+                    });
+                    span.setAttribute('error.type', envLoadError.name);
+                    span.setAttribute('error.message', envLoadError.message);
+                }
+                else if (envLoadedCount > 0) {
+                    span.setStatus({ code: SpanStatusCode.OK });
+                    span.setAttribute('config.load.success', true);
+                }
+                else {
+                    // No error, but no variables loaded either (file might be empty or not exist)
+                    span.setStatus({ code: SpanStatusCode.OK });
+                    span.setAttribute('config.load.success', true);
+                    span.setAttribute('config.load.empty', true);
+                }
+                span.end();
+            }
         }
         catch (error) {
-            logIfEnabled('warn', 'Failed to initialize tracing:', error);
+            // Tracing initialization failed, log it but continue without tracing
+            server.server.sendLoggingMessage({
+                level: 'warning',
+                data: `Failed to initialize tracing: ${error instanceof Error ? error.message : String(error)}`
+            });
         }
     }
+    // Log tracing status and configuration
+    if (tracingInitialized) {
+        const tracingConfig = {
+            status: 'enabled',
+            endpoint: process.env.OTEL_EXPORTER_OTLP_ENDPOINT || 'not set',
+            serviceName: process.env.OTEL_SERVICE_NAME || 'mapbox-mcp-server (default)'
+        };
+        server.server.sendLoggingMessage({
+            level: 'info',
+            data: `OpenTelemetry tracing enabled - Endpoint: ${tracingConfig.endpoint}, Service: ${tracingConfig.serviceName}`
+        });
+    }
+    else {
+        server.server.sendLoggingMessage({
+            level: 'info',
+            data: 'OpenTelemetry tracing: disabled'
+        });
+    }
+    // Send MCP logging message about environment variables
+    if (envLoadError) {
+        server.server.sendLoggingMessage({
+            level: 'warning',
+            data: `Warning loading .env file: ${envLoadError.message}`
+        });
+    }
+    else if (envLoadedCount > 0) {
+        server.server.sendLoggingMessage({
+            level: 'info',
+            data: `Loaded ${envLoadedCount} environment variables from ${envPath}`
+        });
+    }
+    const relevantEnvVars = Object.freeze({
+        MAPBOX_ACCESS_TOKEN: process.env.MAPBOX_ACCESS_TOKEN ? '***' : undefined,
+        MAPBOX_API_ENDPOINT: process.env.MAPBOX_API_ENDPOINT,
+        OTEL_SERVICE_NAME: process.env.OTEL_SERVICE_NAME,
+        OTEL_EXPORTER_OTLP_ENDPOINT: process.env.OTEL_EXPORTER_OTLP_ENDPOINT,
+        OTEL_TRACING_ENABLED: process.env.OTEL_TRACING_ENABLED,
+        NODE_ENV: process.env.NODE_ENV
+    });
+    server.server.sendLoggingMessage({
+        level: 'debug',
+        data: JSON.stringify(relevantEnvVars, null, 2)
+    });
     // Start receiving messages on stdin and sending messages on stdout
     const transport = new StdioServerTransport();
     await server.connect(transport);
@@ -55,13 +191,31 @@ async function shutdown() {
     try {
         await shutdownTracing();
     }
-    catch (e) {
-        logIfEnabled('error', 'Error shutting down tracing:', e);
+    catch (error) {
+        // Tracing shutdown failed, log via MCP if server is available
+        try {
+            server.server.sendLoggingMessage({
+                level: 'error',
+                data: `Error shutting down tracing: ${error instanceof Error ? error.message : String(error)}`
+            });
+        }
+        catch {
+            // Server not available, ignore
+        }
     }
     process.exit(0);
 }
 function exitWithLog(message, error, code = 1) {
-    logIfEnabled('error', message, error);
+    // Log error via MCP server if available
+    try {
+        server.server.sendLoggingMessage({
+            level: 'error',
+            data: `${message}: ${error instanceof Error ? error.message : String(error)}`
+        });
+    }
+    catch {
+        // Server not available, ignore
+    }
     process.exit(code);
 }
 ['SIGINT', 'SIGTERM'].forEach((signal) => {

package/dist/esm/index.js.map

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

package/dist/esm/prompts/BasePrompt.d.ts

@@ -0,0 +1,40 @@
+import { type Prompt, type PromptArgument, type PromptMessage } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Base class for all MCP prompts.
+ *
+ * Prompts are pre-built, parameterized workflows that guide multi-step geospatial tasks.
+ * They capture domain expertise and best practices for common use cases.
+ */
+export declare abstract class BasePrompt {
+    /**
+     * Unique identifier for this prompt (e.g., "find-places-nearby")
+     */
+    abstract readonly name: string;
+    /**
+     * Human-readable description of what this prompt does
+     */
+    abstract readonly description: string;
+    /**
+     * Arguments this prompt accepts
+     */
+    abstract readonly arguments: PromptArgument[];
+    /**
+     * Get the prompt metadata for listing
+     */
+    getMetadata(): Prompt;
+    /**
+     * Generate the prompt messages with filled-in arguments
+     *
+     * @param args - The argument values provided by the user/agent
+     * @returns Array of messages to send to the LLM
+     */
+    abstract getMessages(args: Record<string, string>): PromptMessage[];
+    /**
+     * Validate that all required arguments are provided
+     *
+     * @param args - The argument values to validate
+     * @throws Error if required arguments are missing
+     */
+    protected validateArguments(args: Record<string, string>): void;
+}
+//# sourceMappingURL=BasePrompt.d.ts.map

package/dist/esm/prompts/BasePrompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BasePrompt.d.ts","sourceRoot":"","sources":["../../../src/prompts/BasePrompt.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,MAAM,EACX,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,oCAAoC,CAAC;AAE5C;;;;;GAKG;AACH,8BAAsB,UAAU;IAC9B;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAE/B;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAEtC;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,cAAc,EAAE,CAAC;IAE9C;;OAEG;IACH,WAAW,IAAI,MAAM;IAQrB;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,aAAa,EAAE;IAEnE;;;;;OAKG;IACH,SAAS,CAAC,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;CAOhE"}

package/dist/esm/prompts/BasePrompt.js

@@ -0,0 +1,34 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+/**
+ * Base class for all MCP prompts.
+ *
+ * Prompts are pre-built, parameterized workflows that guide multi-step geospatial tasks.
+ * They capture domain expertise and best practices for common use cases.
+ */
+export class BasePrompt {
+    /**
+     * Get the prompt metadata for listing
+     */
+    getMetadata() {
+        return {
+            name: this.name,
+            description: this.description,
+            arguments: this.arguments
+        };
+    }
+    /**
+     * Validate that all required arguments are provided
+     *
+     * @param args - The argument values to validate
+     * @throws Error if required arguments are missing
+     */
+    validateArguments(args) {
+        for (const arg of this.arguments) {
+            if (arg.required && !args[arg.name]) {
+                throw new Error(`Missing required argument: ${arg.name}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=BasePrompt.js.map

package/dist/esm/prompts/BasePrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BasePrompt.js","sourceRoot":"","sources":["../../../src/prompts/BasePrompt.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,kCAAkC;AAQlC;;;;;GAKG;AACH,MAAM,OAAgB,UAAU;IAgB9B;;OAEG;IACH,WAAW;QACT,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC;IACJ,CAAC;IAUD;;;;;OAKG;IACO,iBAAiB,CAAC,IAA4B;QACtD,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACjC,IAAI,GAAG,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpC,MAAM,IAAI,KAAK,CAAC,8BAA8B,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;YAC5D,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/esm/prompts/FindPlacesNearbyPrompt.d.ts

@@ -0,0 +1,22 @@
+import { BasePrompt } from './BasePrompt.js';
+import type { PromptArgument, PromptMessage } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Prompt for finding places near a location with optional map visualization.
+ *
+ * This prompt guides the agent through:
+ * 1. Geocoding the location (if needed)
+ * 2. Searching for places by category
+ * 3. Formatting results with map visualization
+ *
+ * Example queries:
+ * - "Find coffee shops near downtown Seattle"
+ * - "Show me restaurants near 123 Main St"
+ * - "What museums are near the Eiffel Tower?"
+ */
+export declare class FindPlacesNearbyPrompt extends BasePrompt {
+    readonly name = "find-places-nearby";
+    readonly description = "Helps you search for specific types of places near a location with optional map visualization";
+    readonly arguments: PromptArgument[];
+    getMessages(args: Record<string, string>): PromptMessage[];
+}
+//# sourceMappingURL=FindPlacesNearbyPrompt.d.ts.map

package/dist/esm/prompts/FindPlacesNearbyPrompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FindPlacesNearbyPrompt.d.ts","sourceRoot":"","sources":["../../../src/prompts/FindPlacesNearbyPrompt.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACd,MAAM,oCAAoC,CAAC;AAE5C;;;;;;;;;;;;GAYG;AACH,qBAAa,sBAAuB,SAAQ,UAAU;IACpD,QAAQ,CAAC,IAAI,wBAAwB;IACrC,QAAQ,CAAC,WAAW,mGAC8E;IAElG,QAAQ,CAAC,SAAS,EAAE,cAAc,EAAE,CAkBlC;IAEF,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,aAAa,EAAE;CAyB3D"}

package/dist/esm/prompts/FindPlacesNearbyPrompt.js

@@ -0,0 +1,61 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+import { BasePrompt } from './BasePrompt.js';
+/**
+ * Prompt for finding places near a location with optional map visualization.
+ *
+ * This prompt guides the agent through:
+ * 1. Geocoding the location (if needed)
+ * 2. Searching for places by category
+ * 3. Formatting results with map visualization
+ *
+ * Example queries:
+ * - "Find coffee shops near downtown Seattle"
+ * - "Show me restaurants near 123 Main St"
+ * - "What museums are near the Eiffel Tower?"
+ */
+export class FindPlacesNearbyPrompt extends BasePrompt {
+    name = 'find-places-nearby';
+    description = 'Helps you search for specific types of places near a location with optional map visualization';
+    arguments = [
+        {
+            name: 'location',
+            description: 'The location to search near (address, place name, or coordinates)',
+            required: true
+        },
+        {
+            name: 'category',
+            description: 'Type of place to search for (e.g., "coffee shops", "restaurants", "museums")',
+            required: false
+        },
+        {
+            name: 'radius',
+            description: 'Search radius in meters (default: 1000)',
+            required: false
+        }
+    ];
+    getMessages(args) {
+        this.validateArguments(args);
+        const { location, category, radius } = args;
+        const radiusText = radius ? ` within ${radius} meters` : '';
+        const categoryText = category || 'places';
+        return [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Find ${categoryText} near ${location}${radiusText}.
+
+Please follow these steps:
+1. If the location is not in coordinate format, geocode it first using search_and_geocode_tool
+2. Use category_search_tool or search_tool to find ${categoryText} near the location
+3. Display the results on a map showing the location and the found places
+4. Provide a summary of the top results with key details (name, address, distance)
+
+Make the output clear and actionable.`
+                }
+            }
+        ];
+    }
+}
+//# sourceMappingURL=FindPlacesNearbyPrompt.js.map

package/dist/esm/prompts/FindPlacesNearbyPrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FindPlacesNearbyPrompt.js","sourceRoot":"","sources":["../../../src/prompts/FindPlacesNearbyPrompt.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,kCAAkC;AAElC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAM7C;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,sBAAuB,SAAQ,UAAU;IAC3C,IAAI,GAAG,oBAAoB,CAAC;IAC5B,WAAW,GAClB,+FAA+F,CAAC;IAEzF,SAAS,GAAqB;QACrC;YACE,IAAI,EAAE,UAAU;YAChB,WAAW,EACT,mEAAmE;YACrE,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,UAAU;YAChB,WAAW,EACT,8EAA8E;YAChF,QAAQ,EAAE,KAAK;SAChB;QACD;YACE,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,yCAAyC;YACtD,QAAQ,EAAE,KAAK;SAChB;KACF,CAAC;IAEF,WAAW,CAAC,IAA4B;QACtC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAE7B,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAC5C,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,WAAW,MAAM,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,MAAM,YAAY,GAAG,QAAQ,IAAI,QAAQ,CAAC;QAE1C,OAAO;YACL;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,QAAQ,YAAY,SAAS,QAAQ,GAAG,UAAU;;;;qDAIb,YAAY;;;;sCAI3B;iBAC7B;aACF;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/prompts/GetDirectionsPrompt.d.ts

@@ -0,0 +1,23 @@
+import { BasePrompt } from './BasePrompt.js';
+import type { PromptArgument, PromptMessage } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Prompt for getting turn-by-turn directions between two locations.
+ *
+ * This prompt guides the agent through:
+ * 1. Geocoding start and end locations (if needed)
+ * 2. Getting directions via the appropriate routing profile
+ * 3. Visualizing the route on a map
+ * 4. Providing clear turn-by-turn instructions
+ *
+ * Example queries:
+ * - "Get directions from my office to the airport"
+ * - "How do I drive from Seattle to Portland?"
+ * - "Walking directions from here to the museum"
+ */
+export declare class GetDirectionsPrompt extends BasePrompt {
+    readonly name = "get-directions";
+    readonly description = "Provides turn-by-turn directions between two locations with options for different travel modes";
+    readonly arguments: PromptArgument[];
+    getMessages(args: Record<string, string>): PromptMessage[];
+}
+//# sourceMappingURL=GetDirectionsPrompt.d.ts.map

package/dist/esm/prompts/GetDirectionsPrompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GetDirectionsPrompt.d.ts","sourceRoot":"","sources":["../../../src/prompts/GetDirectionsPrompt.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACd,MAAM,oCAAoC,CAAC;AAE5C;;;;;;;;;;;;;GAaG;AACH,qBAAa,mBAAoB,SAAQ,UAAU;IACjD,QAAQ,CAAC,IAAI,oBAAoB;IACjC,QAAQ,CAAC,WAAW,oGAC+E;IAEnG,QAAQ,CAAC,SAAS,EAAE,cAAc,EAAE,CAiBlC;IAEF,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,aAAa,EAAE;CA0B3D"}

package/dist/esm/prompts/GetDirectionsPrompt.js

@@ -0,0 +1,63 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+import { BasePrompt } from './BasePrompt.js';
+/**
+ * Prompt for getting turn-by-turn directions between two locations.
+ *
+ * This prompt guides the agent through:
+ * 1. Geocoding start and end locations (if needed)
+ * 2. Getting directions via the appropriate routing profile
+ * 3. Visualizing the route on a map
+ * 4. Providing clear turn-by-turn instructions
+ *
+ * Example queries:
+ * - "Get directions from my office to the airport"
+ * - "How do I drive from Seattle to Portland?"
+ * - "Walking directions from here to the museum"
+ */
+export class GetDirectionsPrompt extends BasePrompt {
+    name = 'get-directions';
+    description = 'Provides turn-by-turn directions between two locations with options for different travel modes';
+    arguments = [
+        {
+            name: 'from',
+            description: 'Starting location (address, place name, or coordinates)',
+            required: true
+        },
+        {
+            name: 'to',
+            description: 'Destination location (address, place name, or coordinates)',
+            required: true
+        },
+        {
+            name: 'mode',
+            description: 'Travel mode: driving, walking, or cycling (default: driving)',
+            required: false
+        }
+    ];
+    getMessages(args) {
+        this.validateArguments(args);
+        const { from, to, mode = 'driving' } = args;
+        return [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Get ${mode} directions from ${from} to ${to}.
+
+Please follow these steps:
+1. Geocode both the starting point and destination if they're not in coordinate format
+2. Use directions_tool to get the route with profile set to ${mode}
+3. Display the route on a map with clear start and end markers
+4. Provide:
+   - Total distance and estimated travel time
+   - Turn-by-turn directions (summarized if very long)
+   - Any notable features along the route (tolls, ferries, etc.)
+
+Format the output to be clear and easy to follow.`
+                }
+            }
+        ];
+    }
+}
+//# sourceMappingURL=GetDirectionsPrompt.js.map

package/dist/esm/prompts/GetDirectionsPrompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GetDirectionsPrompt.js","sourceRoot":"","sources":["../../../src/prompts/GetDirectionsPrompt.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,kCAAkC;AAElC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAM7C;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,mBAAoB,SAAQ,UAAU;IACxC,IAAI,GAAG,gBAAgB,CAAC;IACxB,WAAW,GAClB,gGAAgG,CAAC;IAE1F,SAAS,GAAqB;QACrC;YACE,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,yDAAyD;YACtE,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,IAAI;YACV,WAAW,EAAE,4DAA4D;YACzE,QAAQ,EAAE,IAAI;SACf;QACD;YACE,IAAI,EAAE,MAAM;YACZ,WAAW,EACT,8DAA8D;YAChE,QAAQ,EAAE,KAAK;SAChB;KACF,CAAC;IAEF,WAAW,CAAC,IAA4B;QACtC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAE7B,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,GAAG,SAAS,EAAE,GAAG,IAAI,CAAC;QAE5C,OAAO;YACL;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,OAAO,IAAI,oBAAoB,IAAI,OAAO,EAAE;;;;8DAIE,IAAI;;;;;;;kDAOhB;iBACzC;aACF;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/prompts/ShowReachableAreasPrompt.d.ts

@@ -0,0 +1,23 @@
+import { BasePrompt } from './BasePrompt.js';
+import type { PromptArgument, PromptMessage } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Prompt for visualizing areas reachable within a specified time from a location.
+ *
+ * This prompt guides the agent through:
+ * 1. Geocoding the starting location (if needed)
+ * 2. Calculating isochrones for the specified travel time
+ * 3. Visualizing the reachable areas on a map
+ * 4. Providing context about what the isochrone represents
+ *
+ * Example queries:
+ * - "Show me areas I can reach in 15 minutes from downtown"
+ * - "What's the 30-minute driving range from our warehouse?"
+ * - "Display my 10-minute walk radius from home"
+ */
+export declare class ShowReachableAreasPrompt extends BasePrompt {
+    readonly name = "show-reachable-areas";
+    readonly description = "Visualizes areas that can be reached from a location within a specified time using isochrones";
+    readonly arguments: PromptArgument[];
+    getMessages(args: Record<string, string>): PromptMessage[];
+}
+//# sourceMappingURL=ShowReachableAreasPrompt.d.ts.map

package/dist/esm/prompts/ShowReachableAreasPrompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShowReachableAreasPrompt.d.ts","sourceRoot":"","sources":["../../../src/prompts/ShowReachableAreasPrompt.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACd,MAAM,oCAAoC,CAAC;AAE5C;;;;;;;;;;;;;GAaG;AACH,qBAAa,wBAAyB,SAAQ,UAAU;IACtD,QAAQ,CAAC,IAAI,0BAA0B;IACvC,QAAQ,CAAC,WAAW,mGAC8E;IAElG,QAAQ,CAAC,SAAS,EAAE,cAAc,EAAE,CAiBlC;IAEF,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,aAAa,EAAE;CA6B3D"}

package/dist/esm/prompts/ShowReachableAreasPrompt.js

@@ -0,0 +1,66 @@
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+import { BasePrompt } from './BasePrompt.js';
+/**
+ * Prompt for visualizing areas reachable within a specified time from a location.
+ *
+ * This prompt guides the agent through:
+ * 1. Geocoding the starting location (if needed)
+ * 2. Calculating isochrones for the specified travel time
+ * 3. Visualizing the reachable areas on a map
+ * 4. Providing context about what the isochrone represents
+ *
+ * Example queries:
+ * - "Show me areas I can reach in 15 minutes from downtown"
+ * - "What's the 30-minute driving range from our warehouse?"
+ * - "Display my 10-minute walk radius from home"
+ */
+export class ShowReachableAreasPrompt extends BasePrompt {
+    name = 'show-reachable-areas';
+    description = 'Visualizes areas that can be reached from a location within a specified time using isochrones';
+    arguments = [
+        {
+            name: 'location',
+            description: 'Starting location (address, place name, or coordinates)',
+            required: true
+        },
+        {
+            name: 'time_minutes',
+            description: 'Travel time in minutes (default: 15)',
+            required: false
+        },
+        {
+            name: 'mode',
+            description: 'Travel mode: driving, walking, or cycling (default: driving)',
+            required: false
+        }
+    ];
+    getMessages(args) {
+        this.validateArguments(args);
+        const { location, time_minutes = '15', mode = 'driving' } = args;
+        return [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Show areas reachable within ${time_minutes} minutes of ${mode} from ${location}.
+
+Please follow these steps:
+1. Geocode the location if it's not in coordinate format
+2. Use isochrone_tool to calculate the ${time_minutes}-minute ${mode} isochrone
+3. Visualize the reachable area on a map with:
+   - The starting location clearly marked
+   - The isochrone polygon showing the reachable area
+   - Appropriate styling to make it easy to understand
+4. Provide context explaining:
+   - What area is covered (approximate square miles/km)
+   - What this means practically (e.g., "You can reach X locations within ${time_minutes} minutes")
+   - Any limitations or caveats (traffic conditions, time of day, etc.)
+
+Make the visualization clear and the explanation actionable.`
+                }
+            }
+        ];
+    }
+}
+//# sourceMappingURL=ShowReachableAreasPrompt.js.map