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

package/README.md

@@ -44,6 +44,7 @@ For more information about Mapbox access tokens, see the [Mapbox documentation o
 For detailed setup instructions for different integrations, refer to the following guides:
 
 - [Claude Desktop Setup](./docs/claude-desktop-setup.md) - Instructions for configuring Claude Desktop to work with this MCP server
+- [Goose Setup](./docs/goose-setup.md) - Setting up Goose AI agent framework with MCP-UI support
 - [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
@@ -83,11 +84,109 @@ Try these prompts with Claude Desktop or other MCP clients after setup:
 - 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")
 
+## Resources
+
+The MCP server exposes static reference data as **MCP resources**. Resources provide read-only access to data that clients can reference directly without making tool calls.
+
+### Available Resources
+
+#### Mapbox Categories Resource
+
+**URI Pattern**: `mapbox://categories` or `mapbox://categories/{language}`
+
+Access the complete list of available category IDs for use with the category search tool. Categories can be used to filter search results by type (e.g., "restaurant", "hotel", "gas_station").
+
+**Examples**:
+
+- `mapbox://categories` - Default (English) category list
+- `mapbox://categories/ja` - Japanese category names
+- `mapbox://categories/es` - Spanish category names
+
+**Accessing Resources**:
+
+- **Clients with native MCP resource support**: Use the `resources/read` MCP protocol method
+- **Clients without resource support**: Use the `resource_reader_tool` with the resource URI
+
+## MCP-UI Support
+
+This MCP server supports **MCP-UI**, an open specification that allows compatible clients to render interactive UI elements like embedded iframes. This provides a richer visual experience while maintaining full backwards compatibility with clients that don't support MCP-UI.
+
+### What is MCP-UI?
+
+MCP-UI enables tools to return interactive UI resources alongside their standard output. Compatible clients can render these as embedded iframes, while clients without MCP-UI support simply ignore them and use the standard output.
+
+### Supported Tools
+
+- **Static Map Image Tool**: Returns both image data and an embeddable iframe URL for inline map visualization
+
+### Benefits
+
+- **Enhanced Experience**: Compatible clients (e.g., Goose) can display maps inline without leaving the chat
+- **Backwards Compatible**: Non-supporting clients (e.g., Claude Desktop) continue working unchanged
+- **No Configuration Required**: MCP-UI is enabled by default
+
+### Configuration
+
+MCP-UI is **enabled by default**. To disable it:
+
+**Via Environment Variable:**
+
+```bash
+ENABLE_MCP_UI=false npm run build
+```
+
+**Via Command-Line Flag:**
+
+```bash
+node dist/esm/index.js --disable-mcp-ui
+```
+
+**In Claude Desktop config:**
+
+```json
+{
+  "mcpServers": {
+    "mapbox": {
+      "command": "npx",
+      "args": ["-y", "@mapbox/mcp-server", "--disable-mcp-ui"],
+      "env": {
+        "MAPBOX_ACCESS_TOKEN": "your_token_here"
+      }
+    }
+  }
+}
+```
+
+**For more detailed information**, including compatible clients, technical implementation details, and troubleshooting, see the [MCP-UI documentation](./docs/mcp-ui.md).
+
 ## Tools
 
-### Mapbox API tools
+### Utility Tools
+
+#### Resource Reader Tool
+
+Provides access to MCP resources for clients that don't support the native MCP resource API. Use this tool to read resources like the category list.
+
+**Parameters**:
+
+- `uri`: The resource URI to read (e.g., `mapbox://categories`, `mapbox://categories/ja`)
+
+**Example Usage**:
+
+- Read default categories: `{"uri": "mapbox://categories"}`
+- Read Japanese categories: `{"uri": "mapbox://categories/ja"}`
+
+**Note**: If your MCP client supports native resources, prefer using the resource API directly for better performance.
+
+### Mapbox API Tools
+
+#### Category List Tool (Deprecated)
+
+**⚠️ Deprecated**: Use the `resource_reader_tool` with URI `mapbox://categories` instead, or access the `mapbox://categories` resource directly if your client supports MCP resources.
+
+This tool is maintained for backward compatibility with clients that don't support MCP resources or the resource_reader_tool.
 
-#### Matrix tool
+#### Matrix Tool
 
 Calculates travel times and distances between multiple points using [Mapbox Matrix API](https://www.mapbox.com/matrix-api). Features include:
 
@@ -168,11 +267,8 @@ This tool consolidates the functionality that was previously provided by the For
 ### Using Node.js
 
 ```sh
-# Build
-npm run build
-
-# Inspect
-npx @modelcontextprotocol/inspector node dist/esm/index.js
+# Run the built image
+npm run inspect:build
 ```
 
 ### Using Docker
@@ -199,31 +295,57 @@ This MCP server includes comprehensive OpenTelemetry tracing for production obse
 ### Quick Demo
 
 ```sh
-# Run tracing demo with console output
-npm run demo:tracing
-```
+# 1. Copy the example configuration
+cp .env.example .env
 
-### Testing with Tracing
+# 2. Edit .env to add your MAPBOX_ACCESS_TOKEN and configure tracing
 
-```sh
-# Run tests with tracing enabled
-npm run test:tracing
+# 3. Start Jaeger for local development
+npm run tracing:jaeger:start
+
+# 4. Run the server (it will automatically use .env configuration)
+npm run inspect:build
+
+# 5. View traces at http://localhost:16686
+
+# 6. Stop Jaeger when done
+npm run tracing:jaeger:stop
 ```
 
+**Note:** The server automatically loads configuration from your `.env` file at startup. The `.env.example` file includes configuration examples for multiple observability platforms.
+
+### Supported Observability Platforms
+
+Configuration examples included in `.env.example` for:
+
+**Cloud Providers:**
+
+- ☁️ AWS X-Ray
+- ☁️ Azure Monitor (Application Insights)
+- ☁️ Google Cloud Trace
+
+**SaaS Platforms:**
+
+- 📊 Datadog
+- 📊 New Relic
+- 📊 Honeycomb
+- 📊 Any OTLP-compatible backend
+
 ### Production Configuration
 
 See [docs/tracing.md](./docs/tracing.md) for complete setup instructions including:
 
-- 🔧 Environment variable configuration
-- 📊 Supported backends (Jaeger, AWS X-Ray, Google Cloud, etc.)
+- 🔧 Platform-specific configuration guides
+- 📊 Authentication and endpoint setup
 - 🎯 Custom trace attributes and context
 - 🚀 Performance optimization (minimal overhead)
 - 🔍 Troubleshooting and debugging
 
 **Tracing Features:**
 
+- ✅ Configuration loading tracing (.env file loading)
 - ✅ Automatic tool execution tracing
-- ✅ HTTP request instrumentation
+- ✅ HTTP request instrumentation with CloudFront correlation IDs
 - ✅ Configurable exporters (console, OTLP)
 - ✅ Security-conscious (data protection, JWT validation)
 - ✅ Production-ready (<1% CPU overhead)
@@ -232,19 +354,21 @@ See [docs/tracing.md](./docs/tracing.md) for complete setup instructions includi
 
 We welcome contributions to the Mapbox MCP Server! Please review our standards and guidelines before contributing:
 
-- **[Engineering Standards (CLAUDE.md)](./CLAUDE.md)** - Code quality, testing, documentation, and collaboration standards for all contributors
-- **[AI Agent Instructions (AGENTS.md)](./AGENTS.md)** - Comprehensive guide for AI agents working with this codebase
+- **[Engineering Standards (docs/engineering_standards.md)](./docs/engineering_standards.md)** - Complete code quality, testing, documentation, and collaboration standards for all contributors
+- **[Claude Code Guide (CLAUDE.md)](./CLAUDE.md)** - Standards and patterns for contributors using Claude Code
+- **[AI Agent Instructions (AGENTS.md)](./AGENTS.md)** - Guide for general AI coding assistants (Cursor, Continue, Aider, etc.)
 - **[GitHub Copilot Guidelines](./.github/copilot-instructions.md)** - Best practices for using GitHub Copilot responsibly in this project
 
 ### Quick Start for Contributors
 
 1. Fork the repository and clone your fork
-2. Follow the development setup in our [Engineering Standards](./CLAUDE.md#getting-started)
+2. Install dependencies: `npm install`
 3. Make your changes following our coding standards
-4. Add tests for any new functionality
-5. Submit a pull request with a clear description
+4. Run tests and linting: `npm test && npm run lint`
+5. Add tests for any new functionality
+6. Submit a pull request with a clear description
 
-All contributions must pass our CI checks and code review process. See [CLAUDE.md](./CLAUDE.md) for detailed requirements.
+All contributions must pass our CI checks and code review process. See [docs/engineering_standards.md](./docs/engineering_standards.md) for detailed requirements.
 
 ## Data Usage & Privacy
 

package/dist/commonjs/config/toolConfig.d.ts

@@ -2,7 +2,17 @@ import type { ToolInstance } from '../tools/toolRegistry.js';
 export interface ToolConfig {
     enabledTools?: string[];
     disabledTools?: string[];
+    enableMcpUi?: boolean;
 }
 export declare function parseToolConfigFromArgs(): ToolConfig;
 export declare function filterTools(tools: readonly ToolInstance[], config: ToolConfig): ToolInstance[];
+/**
+ * Check if MCP-UI support is enabled.
+ * MCP-UI is enabled by default and can be explicitly disabled via:
+ * - Environment variable: ENABLE_MCP_UI=false
+ * - Command-line flag: --disable-mcp-ui
+ *
+ * @returns true if MCP-UI is enabled (default), false if explicitly disabled
+ */
+export declare function isMcpUiEnabled(): boolean;
 //# sourceMappingURL=toolConfig.d.ts.map

package/dist/commonjs/config/toolConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toolConfig.d.ts","sourceRoot":"","sources":["../../../src/config/toolConfig.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,MAAM,WAAW,UAAU;IACzB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,wBAAgB,uBAAuB,IAAI,UAAU,CAqBpD;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,MAAM,EAAE,UAAU,GACjB,YAAY,EAAE,CAqBhB"}
+{"version":3,"file":"toolConfig.d.ts","sourceRoot":"","sources":["../../../src/config/toolConfig.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,MAAM,WAAW,UAAU;IACzB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,wBAAgB,uBAAuB,IAAI,UAAU,CAoCpD;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,MAAM,EAAE,UAAU,GACjB,YAAY,EAAE,CAqBhB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAcxC"}

package/dist/commonjs/config/toolConfig.js

@@ -4,9 +4,14 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseToolConfigFromArgs = parseToolConfigFromArgs;
 exports.filterTools = filterTools;
+exports.isMcpUiEnabled = isMcpUiEnabled;
 function parseToolConfigFromArgs() {
     const args = process.argv.slice(2);
     const config = {};
+    // Check environment variable first (takes precedence)
+    if (process.env.ENABLE_MCP_UI !== undefined) {
+        config.enableMcpUi = process.env.ENABLE_MCP_UI === 'true';
+    }
     for (let i = 0; i < args.length; i++) {
         const arg = args[i];
         if (arg === '--enable-tools') {
@@ -21,6 +26,16 @@ function parseToolConfigFromArgs() {
                 config.disabledTools = value.split(',').map((t) => t.trim());
             }
         }
+        else if (arg === '--disable-mcp-ui') {
+            // Command-line flag can disable it if env var not set
+            if (config.enableMcpUi === undefined) {
+                config.enableMcpUi = false;
+            }
+        }
+    }
+    // Default to true if not set (enabled by default)
+    if (config.enableMcpUi === undefined) {
+        config.enableMcpUi = true;
     }
     return config;
 }
@@ -39,4 +54,25 @@ function filterTools(tools, config) {
     }
     return filteredTools;
 }
+/**
+ * Check if MCP-UI support is enabled.
+ * MCP-UI is enabled by default and can be explicitly disabled via:
+ * - Environment variable: ENABLE_MCP_UI=false
+ * - Command-line flag: --disable-mcp-ui
+ *
+ * @returns true if MCP-UI is enabled (default), false if explicitly disabled
+ */
+function isMcpUiEnabled() {
+    // Check environment variable first (takes precedence)
+    if (process.env.ENABLE_MCP_UI === 'false') {
+        return false;
+    }
+    // Check command-line arguments
+    const args = process.argv.slice(2);
+    if (args.includes('--disable-mcp-ui')) {
+        return false;
+    }
+    // Default to enabled
+    return true;
+}
 //# sourceMappingURL=toolConfig.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"toolConfig.js","sourceRoot":"","sources":["../../../src/config/toolConfig.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;AASlC,0DAqBC;AAED,kCAwBC;AA/CD,SAAgB,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,SAAgB,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/commonjs/index.d.ts

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

package/dist/commonjs/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/commonjs/index.js

@@ -3,50 +3,186 @@
 // Copyright (c) Mapbox, Inc.
 // Licensed under the MIT License.
 Object.defineProperty(exports, "__esModule", { value: true });
+// Load environment variables from .env file if present
+// Use Node.js built-in util.parseEnv() and manually apply to override existing vars
+const node_util_1 = require("node:util");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const node_fs_2 = require("node:fs");
+const api_1 = require("@opentelemetry/api");
 const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
 const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
 const toolConfig_js_1 = require("./config/toolConfig.js");
 const toolRegistry_js_1 = require("./tools/toolRegistry.js");
+const resourceRegistry_js_1 = require("./resources/resourceRegistry.js");
+const promptRegistry_js_1 = require("./prompts/promptRegistry.js");
 const versionUtils_js_1 = require("./utils/versionUtils.js");
 const tracing_js_1 = require("./utils/tracing.js");
-require("dotenv/config");
+// 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 = (0, node_path_1.join)(process.cwd(), '.env');
+let envLoadError = null;
+let envLoadedCount = 0;
+if ((0, node_fs_2.existsSync)(envPath)) {
+    try {
+        // Read and parse .env file using Node.js built-in parseEnv
+        const envFile = (0, node_fs_1.readFileSync)(envPath, 'utf-8');
+        const parsed = (0, node_util_1.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 = (0, versionUtils_js_1.getVersionInfo)();
 // Parse configuration from command-line arguments
 const config = (0, toolConfig_js_1.parseToolConfigFromArgs)();
 // Get and filter tools based on configuration
 const allTools = (0, toolRegistry_js_1.getAllTools)();
 const enabledTools = (0, toolConfig_js_1.filterTools)(allTools, config);
+// Get all resources
+const allResources = (0, resourceRegistry_js_1.getAllResources)();
 // Create an MCP server
 const server = new mcp_js_1.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(types_js_1.ListPromptsRequestSchema, async () => {
+    const allPrompts = (0, promptRegistry_js_1.getAllPrompts)();
+    return {
+        prompts: allPrompts.map((prompt) => prompt.getMetadata())
+    };
+});
+server.server.setRequestHandler(types_js_1.GetPromptRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    const prompt = (0, promptRegistry_js_1.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 (0, tracing_js_1.initializeTracing)();
-            logIfEnabled('log', `OpenTelemetry tracing: ${(0, tracing_js_1.isTracingInitialized)() ? 'enabled' : 'disabled'}`);
+            tracingInitialized = (0, tracing_js_1.isTracingInitialized)();
+            // Record .env loading as a span (retrospectively since it happened before tracing init)
+            if (tracingInitialized) {
+                const tracer = (0, tracing_js_1.getTracer)();
+                const span = tracer.startSpan('config.load_env', {
+                    attributes: {
+                        'config.file.path': envPath,
+                        'config.file.exists': (0, node_fs_2.existsSync)(envPath),
+                        'config.vars.loaded': envLoadedCount,
+                        'operation.type': 'config_load'
+                    }
+                });
+                if (envLoadError) {
+                    span.recordException(envLoadError);
+                    span.setStatus({
+                        code: api_1.SpanStatusCode.ERROR,
+                        message: envLoadError.message
+                    });
+                    span.setAttribute('error.type', envLoadError.name);
+                    span.setAttribute('error.message', envLoadError.message);
+                }
+                else if (envLoadedCount > 0) {
+                    span.setStatus({ code: api_1.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: api_1.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 stdio_js_1.StdioServerTransport();
     await server.connect(transport);
@@ -57,13 +193,31 @@ async function shutdown() {
     try {
         await (0, tracing_js_1.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/commonjs/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/commonjs/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/commonjs/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"}