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

package/dist/commonjs/resources/category-list/CategoryListResource.d.ts

@@ -0,0 +1,27 @@
+import { MapboxApiBasedResource } from '../MapboxApiBasedResource.js';
+import type { HttpRequest } from '../../utils/types.js';
+import type { ReadResourceResult } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Resource for retrieving the list of supported categories from Mapbox Search API
+ *
+ * Available URIs:
+ * - mapbox://categories - Default (English)
+ * - mapbox://categories/{language} - Localized (e.g., mapbox://categories/ja)
+ */
+export declare class CategoryListResource extends MapboxApiBasedResource {
+    readonly uri = "mapbox://categories";
+    readonly name = "Mapbox Categories";
+    readonly description = "List of all available Mapbox Search API categories. Categories can be used for filtering search results. Supports localization via language parameter in URI (e.g., mapbox://categories/ja for Japanese).";
+    readonly mimeType = "application/json";
+    constructor(params: {
+        httpRequest: HttpRequest;
+    });
+    protected execute(uri: string, accessToken: string): Promise<ReadResourceResult>;
+    /**
+     * Extract language code from URI
+     * @param uri Resource URI (e.g., mapbox://categories/ja)
+     * @returns Language code or undefined if not present
+     */
+    private extractLanguageFromUri;
+}
+//# sourceMappingURL=CategoryListResource.d.ts.map

package/dist/commonjs/resources/category-list/CategoryListResource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CategoryListResource.d.ts","sourceRoot":"","sources":["../../../../src/resources/category-list/CategoryListResource.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAiB7E;;;;;;GAMG;AACH,qBAAa,oBAAqB,SAAQ,sBAAsB;IAC9D,QAAQ,CAAC,GAAG,yBAAyB;IACrC,QAAQ,CAAC,IAAI,uBAAuB;IACpC,QAAQ,CAAC,WAAW,+MAC0L;IAC9M,QAAQ,CAAC,QAAQ,sBAAsB;gBAE3B,MAAM,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE;cAIhC,OAAO,CACrB,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,kBAAkB,CAAC;IAmD9B;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;CAI/B"}

package/dist/commonjs/resources/category-list/CategoryListResource.js

@@ -0,0 +1,71 @@
+"use strict";
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CategoryListResource = void 0;
+const MapboxApiBasedResource_js_1 = require("../MapboxApiBasedResource.js");
+// API Documentation: https://docs.mapbox.com/api/search/search-box/#list-categories
+/**
+ * Resource for retrieving the list of supported categories from Mapbox Search API
+ *
+ * Available URIs:
+ * - mapbox://categories - Default (English)
+ * - mapbox://categories/{language} - Localized (e.g., mapbox://categories/ja)
+ */
+class CategoryListResource extends MapboxApiBasedResource_js_1.MapboxApiBasedResource {
+    uri = 'mapbox://categories';
+    name = 'Mapbox Categories';
+    description = 'List of all available Mapbox Search API categories. Categories can be used for filtering search results. Supports localization via language parameter in URI (e.g., mapbox://categories/ja for Japanese).';
+    mimeType = 'application/json';
+    constructor(params) {
+        super(params);
+    }
+    async execute(uri, accessToken) {
+        // Parse language from URI if present
+        // Format: mapbox://categories or mapbox://categories/ja
+        const language = this.extractLanguageFromUri(uri);
+        const apiUrl = new URL('https://api.mapbox.com/search/searchbox/v1/list/category');
+        apiUrl.searchParams.set('access_token', accessToken);
+        if (language) {
+            apiUrl.searchParams.set('language', language);
+        }
+        const response = await this.httpRequest(apiUrl.toString(), {
+            method: 'GET',
+            headers: {
+                'User-Agent': `@mapbox/mcp-server/${process.env.npm_package_version || 'dev'}`
+            }
+        });
+        if (!response.ok) {
+            throw new Error(`Mapbox API request failed: ${response.status} ${response.statusText}`);
+        }
+        const rawData = await response.json();
+        const data = rawData;
+        // Extract just the category IDs for a simplified response
+        const categoryIds = data.listItems.map((item) => item.canonical_id);
+        const result = {
+            listItems: categoryIds,
+            version: data.version,
+            attribution: data.attribution
+        };
+        return {
+            contents: [
+                {
+                    uri,
+                    mimeType: 'application/json',
+                    text: JSON.stringify(result, null, 2)
+                }
+            ]
+        };
+    }
+    /**
+     * Extract language code from URI
+     * @param uri Resource URI (e.g., mapbox://categories/ja)
+     * @returns Language code or undefined if not present
+     */
+    extractLanguageFromUri(uri) {
+        const match = uri.match(/^mapbox:\/\/categories\/([a-z]{2})$/i);
+        return match?.[1];
+    }
+}
+exports.CategoryListResource = CategoryListResource;
+//# sourceMappingURL=CategoryListResource.js.map

package/dist/commonjs/resources/category-list/CategoryListResource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CategoryListResource.js","sourceRoot":"","sources":["../../../../src/resources/category-list/CategoryListResource.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;;AAElC,4EAAsE;AAiBtE,oFAAoF;AAEpF;;;;;;GAMG;AACH,MAAa,oBAAqB,SAAQ,kDAAsB;IACrD,GAAG,GAAG,qBAAqB,CAAC;IAC5B,IAAI,GAAG,mBAAmB,CAAC;IAC3B,WAAW,GAClB,2MAA2M,CAAC;IACrM,QAAQ,GAAG,kBAAkB,CAAC;IAEvC,YAAY,MAAoC;QAC9C,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;IAES,KAAK,CAAC,OAAO,CACrB,GAAW,EACX,WAAmB;QAEnB,qCAAqC;QACrC,wDAAwD;QACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC;QAElD,MAAM,MAAM,GAAG,IAAI,GAAG,CACpB,0DAA0D,CAC3D,CAAC;QAEF,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;QAErD,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAChD,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE;YACzD,MAAM,EAAE,KAAK;YACb,OAAO,EAAE;gBACP,YAAY,EAAE,sBAAsB,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,KAAK,EAAE;aAC/E;SACF,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,8BAA8B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CACvE,CAAC;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,OAA4B,CAAC;QAE1C,0DAA0D;QAC1D,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAEpE,MAAM,MAAM,GAAG;YACb,SAAS,EAAE,WAAW;YACtB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC;QAEF,OAAO;YACL,QAAQ,EAAE;gBACR;oBACE,GAAG;oBACH,QAAQ,EAAE,kBAAkB;oBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;iBACtC;aACF;SACF,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACK,sBAAsB,CAAC,GAAW;QACxC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAChE,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;CACF;AA1ED,oDA0EC"}

package/dist/commonjs/resources/resourceRegistry.d.ts

@@ -0,0 +1,6 @@
+import { CategoryListResource } from './category-list/CategoryListResource.js';
+export declare const ALL_RESOURCES: readonly [CategoryListResource];
+export type ResourceInstance = (typeof ALL_RESOURCES)[number];
+export declare function getAllResources(): readonly ResourceInstance[];
+export declare function getResourceByUri(uri: string): ResourceInstance | undefined;
+//# sourceMappingURL=resourceRegistry.d.ts.map

package/dist/commonjs/resources/resourceRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resourceRegistry.d.ts","sourceRoot":"","sources":["../../../src/resources/resourceRegistry.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAI/E,eAAO,MAAM,aAAa,iCAGhB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9D,wBAAgB,eAAe,IAAI,SAAS,gBAAgB,EAAE,CAE7D;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAY1E"}

package/dist/commonjs/resources/resourceRegistry.js

@@ -0,0 +1,32 @@
+"use strict";
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ALL_RESOURCES = void 0;
+exports.getAllResources = getAllResources;
+exports.getResourceByUri = getResourceByUri;
+// INSERT NEW RESOURCE IMPORT HERE
+const CategoryListResource_js_1 = require("./category-list/CategoryListResource.js");
+const httpPipeline_js_1 = require("../utils/httpPipeline.js");
+// Central registry of all resources
+exports.ALL_RESOURCES = [
+    // INSERT NEW RESOURCE INSTANCE HERE
+    new CategoryListResource_js_1.CategoryListResource({ httpRequest: httpPipeline_js_1.httpRequest })
+];
+function getAllResources() {
+    return exports.ALL_RESOURCES;
+}
+function getResourceByUri(uri) {
+    // Find exact match first
+    const exactMatch = exports.ALL_RESOURCES.find((resource) => resource.uri === uri);
+    if (exactMatch)
+        return exactMatch;
+    // Find pattern match (e.g., mapbox://categories/ja matches mapbox://categories)
+    return exports.ALL_RESOURCES.find((resource) => {
+        // Check if the URI starts with the resource's base URI
+        const basePattern = resource.uri.replace(/\*/g, '.*');
+        const regex = new RegExp(`^${basePattern}`);
+        return regex.test(uri);
+    });
+}
+//# sourceMappingURL=resourceRegistry.js.map

package/dist/commonjs/resources/resourceRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resourceRegistry.js","sourceRoot":"","sources":["../../../src/resources/resourceRegistry.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;;AAclC,0CAEC;AAED,4CAYC;AA5BD,kCAAkC;AAClC,qFAA+E;AAC/E,8DAAuD;AAEvD,oCAAoC;AACvB,QAAA,aAAa,GAAG;IAC3B,oCAAoC;IACpC,IAAI,8CAAoB,CAAC,EAAE,WAAW,EAAX,6BAAW,EAAE,CAAC;CACjC,CAAC;AAIX,SAAgB,eAAe;IAC7B,OAAO,qBAAa,CAAC;AACvB,CAAC;AAED,SAAgB,gBAAgB,CAAC,GAAW;IAC1C,yBAAyB;IACzB,MAAM,UAAU,GAAG,qBAAa,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC;IAC1E,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC;IAElC,gFAAgF;IAChF,OAAO,qBAAa,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;QACrC,uDAAuD;QACvD,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACtD,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC;QAC5C,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/commonjs/schemas/geojson.d.ts

@@ -0,0 +1,115 @@
+/**
+ * GeoJSON interfaces based on RFC 7946
+ * https://tools.ietf.org/html/rfc7946
+ */
+export type GeoJSONGeometryType = 'Point' | 'LineString' | 'Polygon' | 'MultiPoint' | 'MultiLineString' | 'MultiPolygon' | 'GeometryCollection';
+export type GeoJSONFeatureType = 'Feature';
+export type GeoJSONFeatureCollectionType = 'FeatureCollection';
+export type GeoJSONType = GeoJSONGeometryType | GeoJSONFeatureType | GeoJSONFeatureCollectionType;
+/**
+ * Position array [longitude, latitude] or [longitude, latitude, elevation]
+ */
+export type Position = [number, number] | [number, number, number];
+/**
+ * Base interface for all GeoJSON objects
+ */
+export interface GeoJSONBase {
+    type: GeoJSONType;
+    bbox?: [number, number, number, number] | [number, number, number, number, number, number];
+}
+/**
+ * Point geometry
+ */
+export interface Point extends GeoJSONBase {
+    type: 'Point';
+    coordinates: Position;
+}
+/**
+ * LineString geometry
+ */
+export interface LineString extends GeoJSONBase {
+    type: 'LineString';
+    coordinates: Position[];
+}
+/**
+ * Polygon geometry
+ */
+export interface Polygon extends GeoJSONBase {
+    type: 'Polygon';
+    coordinates: Position[][];
+}
+/**
+ * MultiPoint geometry
+ */
+export interface MultiPoint extends GeoJSONBase {
+    type: 'MultiPoint';
+    coordinates: Position[];
+}
+/**
+ * MultiLineString geometry
+ */
+export interface MultiLineString extends GeoJSONBase {
+    type: 'MultiLineString';
+    coordinates: Position[][];
+}
+/**
+ * MultiPolygon geometry
+ */
+export interface MultiPolygon extends GeoJSONBase {
+    type: 'MultiPolygon';
+    coordinates: Position[][][];
+}
+/**
+ * GeometryCollection
+ */
+export interface GeometryCollection extends GeoJSONBase {
+    type: 'GeometryCollection';
+    geometries: Geometry[];
+}
+/**
+ * Union of all geometry types
+ */
+export type Geometry = Point | LineString | Polygon | MultiPoint | MultiLineString | MultiPolygon | GeometryCollection;
+/**
+ * GeoJSON Feature with properties
+ */
+export interface Feature<P = Record<string, unknown>, G extends Geometry = Geometry> extends GeoJSONBase {
+    type: 'Feature';
+    geometry: G | null;
+    properties: P | null;
+    id?: string | number;
+}
+/**
+ * GeoJSON FeatureCollection
+ */
+export interface FeatureCollection<P = Record<string, unknown>, G extends Geometry = Geometry> extends GeoJSONBase {
+    type: 'FeatureCollection';
+    features: Feature<P, G>[];
+}
+/**
+ * Union of all GeoJSON objects
+ */
+export type GeoJSON = Geometry | Feature | FeatureCollection;
+/**
+ * Mapbox-specific properties commonly found in Mapbox API responses
+ */
+export interface MapboxFeatureProperties extends Record<string, unknown> {
+    name?: string;
+    name_preferred?: string;
+    full_address?: string;
+    place_formatted?: string;
+    feature_type?: string;
+    poi_category?: string | string[];
+    category?: string;
+    mapbox_id?: string;
+    address?: string;
+}
+/**
+ * Mapbox Feature with common properties
+ */
+export type MapboxFeature = Feature<MapboxFeatureProperties>;
+/**
+ * Mapbox FeatureCollection with common properties
+ */
+export type MapboxFeatureCollection = FeatureCollection<MapboxFeatureProperties>;
+//# sourceMappingURL=geojson.d.ts.map

package/dist/commonjs/schemas/geojson.d.ts.map

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

package/dist/commonjs/schemas/geojson.js

@@ -0,0 +1,5 @@
+"use strict";
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=geojson.js.map

package/dist/commonjs/schemas/geojson.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geojson.js","sourceRoot":"","sources":["../../../src/schemas/geojson.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC"}

package/dist/commonjs/tools/BaseTool.d.ts

@@ -1,14 +1,17 @@
 import type { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
 import type { ToolAnnotations, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
 import type { ZodTypeAny } from 'zod';
-export declare abstract class BaseTool<InputSchema extends ZodTypeAny> {
+export declare abstract class BaseTool<InputSchema extends ZodTypeAny, OutputSchema extends ZodTypeAny = ZodTypeAny> {
     abstract readonly name: string;
     abstract readonly description: string;
     abstract readonly annotations: ToolAnnotations;
     readonly inputSchema: InputSchema;
+    readonly outputSchema?: OutputSchema;
     protected server: McpServer | null;
     constructor(params: {
         inputSchema: InputSchema;
+        outputSchema?: OutputSchema;
     });
     /**
      * Installs the tool to the given MCP server.
@@ -17,10 +20,17 @@ export declare abstract class BaseTool<InputSchema extends ZodTypeAny> {
     /**
      * Tool logic to be implemented by subclasses.
      */
-    abstract run(rawInput: unknown, extra?: any): Promise<CallToolResult>;
+    abstract run(rawInput: unknown, extra?: RequestHandlerExtra<any, any>): Promise<CallToolResult>;
     /**
      * Helper method to send logging messages
      */
     protected log(level: 'debug' | 'info' | 'warning' | 'error', data: unknown): void;
+    /**
+     * Validates output data against the output schema with graceful fallback.
+     * If validation fails, logs a warning and returns the raw data.
+     * @param rawData The raw data to validate
+     * @returns The validated data, or raw data if validation fails
+     */
+    protected validateOutput<T>(rawData: unknown): T;
 }
 //# sourceMappingURL=BaseTool.d.ts.map

package/dist/commonjs/tools/BaseTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BaseTool.d.ts","sourceRoot":"","sources":["../../../src/tools/BaseTool.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,SAAS,EACT,cAAc,EACf,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACf,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAGtC,8BAAsB,QAAQ,CAAC,WAAW,SAAS,UAAU;IAC3D,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IAE/C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAQ;gBAE9B,MAAM,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE;IAIhD;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,cAAc;IAc5C;;OAEG;IACH,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,cAAc,CAAC;IAErE;;OAEG;IACH,SAAS,CAAC,GAAG,CACX,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,EAC7C,IAAI,EAAE,OAAO,GACZ,IAAI;CAKR"}
+{"version":3,"file":"BaseTool.d.ts","sourceRoot":"","sources":["../../../src/tools/BaseTool.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,SAAS,EACT,cAAc,EACf,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACf,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACxF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAGtC,8BAAsB,QAAQ,CAC5B,WAAW,SAAS,UAAU,EAC9B,YAAY,SAAS,UAAU,GAAG,UAAU;IAE5C,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IAE/C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACrC,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAQ;gBAE9B,MAAM,EAAE;QAClB,WAAW,EAAE,WAAW,CAAC;QACzB,YAAY,CAAC,EAAE,YAAY,CAAC;KAC7B;IAKD;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,cAAc;IA+B5C;;OAEG;IACH,QAAQ,CAAC,GAAG,CACV,QAAQ,EAAE,OAAO,EAEjB,KAAK,CAAC,EAAE,mBAAmB,CAAC,GAAG,EAAE,GAAG,CAAC,GACpC,OAAO,CAAC,cAAc,CAAC;IAE1B;;OAEG;IACH,SAAS,CAAC,GAAG,CACX,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,EAC7C,IAAI,EAAE,OAAO,GACZ,IAAI;IAMP;;;;;OAKG;IACH,SAAS,CAAC,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,GAAG,CAAC;CAgBjD"}

package/dist/commonjs/tools/BaseTool.js

@@ -5,21 +5,31 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.BaseTool = void 0;
 class BaseTool {
     inputSchema;
+    outputSchema;
     server = null;
     constructor(params) {
         this.inputSchema = params.inputSchema;
+        this.outputSchema = params.outputSchema;
     }
     /**
      * Installs the tool to the given MCP server.
      */
     installTo(server) {
         this.server = server;
-        return server.registerTool(this.name, {
+        const config = {
             title: this.annotations.title,
             description: this.description,
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
             inputSchema: this.inputSchema.shape,
             annotations: this.annotations
-        }, (args, extra) => this.run(args, extra));
+        };
+        // Add outputSchema if provided
+        if (this.outputSchema) {
+            config.outputSchema =
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                this.outputSchema.shape;
+        }
+        return server.registerTool(this.name, config, (args, extra) => this.run(args, extra));
     }
     /**
      * Helper method to send logging messages
@@ -29,6 +39,25 @@ class BaseTool {
             void this.server.server.sendLoggingMessage({ level, data });
         }
     }
+    /**
+     * Validates output data against the output schema with graceful fallback.
+     * If validation fails, logs a warning and returns the raw data.
+     * @param rawData The raw data to validate
+     * @returns The validated data, or raw data if validation fails
+     */
+    validateOutput(rawData) {
+        if (!this.outputSchema) {
+            return rawData;
+        }
+        try {
+            return this.outputSchema.parse(rawData);
+        }
+        catch (validationError) {
+            this.log('warning', `${this.name}: Output schema validation failed: ${validationError instanceof Error ? validationError.message : 'Unknown validation error'}`);
+            // Graceful fallback to raw data
+            return rawData;
+        }
+    }
 }
 exports.BaseTool = BaseTool;
 //# sourceMappingURL=BaseTool.js.map

package/dist/commonjs/tools/BaseTool.js.map

@@ -1 +1 @@
-{"version":3,"file":"BaseTool.js","sourceRoot":"","sources":["../../../src/tools/BaseTool.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;;AAalC,MAAsB,QAAQ;IAKnB,WAAW,CAAc;IACxB,MAAM,GAAqB,IAAI,CAAC;IAE1C,YAAY,MAAoC;QAC9C,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,MAAiB;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,OAAO,MAAM,CAAC,YAAY,CACxB,IAAI,CAAC,IAAI,EACT;YACE,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,KAAK;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,WAAW,EAAG,IAAI,CAAC,WAA2C,CAAC,KAAK;YACpE,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,EACD,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CACvC,CAAC;IACJ,CAAC;IAOD;;OAEG;IACO,GAAG,CACX,KAA6C,EAC7C,IAAa;QAEb,IAAI,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;YACxB,KAAK,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;CACF;AA7CD,4BA6CC"}
+{"version":3,"file":"BaseTool.js","sourceRoot":"","sources":["../../../src/tools/BaseTool.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;;AAclC,MAAsB,QAAQ;IAQnB,WAAW,CAAc;IACzB,YAAY,CAAgB;IAC3B,MAAM,GAAqB,IAAI,CAAC;IAE1C,YAAY,MAGX;QACC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC;IAC1C,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,MAAiB;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,MAAM,MAAM,GAQR;YACF,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,KAAK;YAC7B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,8DAA8D;YAC9D,WAAW,EAAG,IAAI,CAAC,WAA2C,CAAC,KAAK;YACpE,WAAW,EAAE,IAAI,CAAC,WAAW;SAC9B,CAAC;QAEF,+BAA+B;QAC/B,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,MAAM,CAAC,YAAY;gBACjB,8DAA8D;gBAC7D,IAAI,CAAC,YAA4C,CAAC,KAAK,CAAC;QAC7D,CAAC;QAED,OAAO,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAC5D,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CACtB,CAAC;IACJ,CAAC;IAWD;;OAEG;IACO,GAAG,CACX,KAA6C,EAC7C,IAAa;QAEb,IAAI,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;YACxB,KAAK,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACO,cAAc,CAAI,OAAgB;QAC1C,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,OAAO,OAAY,CAAC;QACtB,CAAC;QAED,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,CAAM,CAAC;QAC/C,CAAC;QAAC,OAAO,eAAe,EAAE,CAAC;YACzB,IAAI,CAAC,GAAG,CACN,SAAS,EACT,GAAG,IAAI,CAAC,IAAI,sCAAsC,eAAe,YAAY,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,0BAA0B,EAAE,CAC5I,CAAC;YACF,gCAAgC;YAChC,OAAO,OAAY,CAAC;QACtB,CAAC;IACH,CAAC;CACF;AAjGD,4BAiGC"}

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

@@ -1,15 +1,20 @@
 import type { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
-import type { ZodTypeAny, z } from 'zod';
+import type { ZodTypeAny } from 'zod';
 import { BaseTool } from './BaseTool.js';
-import type { OutputSchema } from './MapboxApiBasedTool.schema.js';
-export declare abstract class MapboxApiBasedTool<InputSchema extends ZodTypeAny> extends BaseTool<InputSchema> {
+import type { CallToolResult, ToolAnnotations } from '@modelcontextprotocol/sdk/types.js';
+import type { HttpRequest } from '../utils/types.js';
+import type { ToolExecutionContext } from '../utils/tracing.js';
+export declare abstract class MapboxApiBasedTool<InputSchema extends ZodTypeAny, OutputSchema extends ZodTypeAny = ZodTypeAny> extends BaseTool<InputSchema, OutputSchema> {
     abstract readonly name: string;
     abstract readonly description: string;
-    abstract readonly annotations: import('@modelcontextprotocol/sdk/types.js').ToolAnnotations;
+    abstract readonly annotations: ToolAnnotations;
     static get mapboxAccessToken(): string | undefined;
     static get mapboxApiEndpoint(): string;
+    protected httpRequest: HttpRequest;
     constructor(params: {
         inputSchema: InputSchema;
+        outputSchema?: OutputSchema;
+        httpRequest: HttpRequest;
     });
     /**
      * Validates if a string has the format of a JWT token (header.payload.signature)
@@ -21,10 +26,10 @@ export declare abstract class MapboxApiBasedTool<InputSchema extends ZodTypeAny>
     /**
      * Validates and runs the tool logic.
      */
-    run(rawInput: unknown, extra?: RequestHandlerExtra<any, any>): Promise<z.infer<typeof OutputSchema>>;
+    run(rawInput: unknown, extra?: RequestHandlerExtra<any, any>): Promise<CallToolResult>;
     /**
-     * Tool logic to be implemented by subclasses.
+     * Tool-specific logic to be implemented by subclasses.
      */
-    protected abstract execute(_input: z.infer<InputSchema>, accessToken: string): Promise<any>;
+    protected abstract execute(input: any, accessToken: string, context: ToolExecutionContext): Promise<CallToolResult>;
 }
 //# sourceMappingURL=MapboxApiBasedTool.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"MapboxApiBasedTool.d.ts","sourceRoot":"","sources":["../../../src/tools/MapboxApiBasedTool.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACxF,OAAO,KAAK,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAEnE,8BAAsB,kBAAkB,CACtC,WAAW,SAAS,UAAU,CAC9B,SAAQ,QAAQ,CAAC,WAAW,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,oCAAoC,EAAE,eAAe,CAAC;IAE5F,MAAM,KAAK,iBAAiB,uBAE3B;IAED,MAAM,KAAK,iBAAiB,WAE3B;gBAEW,MAAM,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE;IAIhD;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IASxB;;OAEG;IACG,GAAG,CACP,QAAQ,EAAE,OAAO,EACjB,KAAK,CAAC,EAAE,mBAAmB,CAAC,GAAG,EAAE,GAAG,CAAC,GACpC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;IA4DxC;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,OAAO,CACxB,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,EAC5B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,GAAG,CAAC;CAChB"}
+{"version":3,"file":"MapboxApiBasedTool.d.ts","sourceRoot":"","sources":["../../../src/tools/MapboxApiBasedTool.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACxF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EAChB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGhE,8BAAsB,kBAAkB,CACtC,WAAW,SAAS,UAAU,EAC9B,YAAY,SAAS,UAAU,GAAG,UAAU,CAC5C,SAAQ,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC;IAC3C,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,eAAe,CAAC;IAE/C,MAAM,KAAK,iBAAiB,uBAE3B;IAED,MAAM,KAAK,iBAAiB,WAE3B;IAED,SAAS,CAAC,WAAW,EAAE,WAAW,CAAC;gBAEvB,MAAM,EAAE;QAClB,WAAW,EAAE,WAAW,CAAC;QACzB,YAAY,CAAC,EAAE,YAAY,CAAC;QAC5B,WAAW,EAAE,WAAW,CAAC;KAC1B;IAKD;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB;IASxB;;OAEG;IACG,GAAG,CACP,QAAQ,EAAE,OAAO,EAEjB,KAAK,CAAC,EAAE,mBAAmB,CAAC,GAAG,EAAE,GAAG,CAAC,GACpC,OAAO,CAAC,cAAc,CAAC;IAyF1B;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,OAAO,CAExB,KAAK,EAAE,GAAG,EACV,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,cAAc,CAAC;CAC3B"}

package/dist/commonjs/tools/MapboxApiBasedTool.js

@@ -4,6 +4,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MapboxApiBasedTool = void 0;
 const BaseTool_js_1 = require("./BaseTool.js");
+const api_1 = require("@opentelemetry/api");
+const tracing_js_1 = require("../utils/tracing.js");
 class MapboxApiBasedTool extends BaseTool_js_1.BaseTool {
     static get mapboxAccessToken() {
         return process.env.MAPBOX_ACCESS_TOKEN;
@@ -11,8 +13,10 @@ class MapboxApiBasedTool extends BaseTool_js_1.BaseTool {
     static get mapboxApiEndpoint() {
         return process.env.MAPBOX_API_ENDPOINT || 'https://api.mapbox.com/';
     }
+    httpRequest;
     constructor(params) {
         super(params);
+        this.httpRequest = params.httpRequest;
     }
     /**
      * Validates if a string has the format of a JWT token (header.payload.signature)
@@ -31,46 +35,70 @@ class MapboxApiBasedTool extends BaseTool_js_1.BaseTool {
     /**
      * Validates and runs the tool logic.
      */
-    async run(rawInput, extra) {
+    async run(rawInput, 
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    extra) {
+        // First check if token is provided via authentication context
+        // Check both standard token field and accessToken in extra for compatibility
+        // In the streamableHttp, the authInfo is injected into extra from `req.auth`
+        // https://github.com/modelcontextprotocol/typescript-sdk/blob/main/src/server/streamableHttp.ts#L405
+        const authToken = extra?.authInfo?.token;
+        const accessToken = authToken || MapboxApiBasedTool.mapboxAccessToken;
+        if (!accessToken) {
+            const errorMessage = 'No access token available. Please provide via Bearer auth or MAPBOX_ACCESS_TOKEN env var';
+            this.log('error', `${this.name}: ${errorMessage}`);
+            return {
+                content: [{ type: 'text', text: errorMessage }],
+                isError: true
+            };
+        }
+        // Validate that the token has the correct JWT format
+        if (!this.isValidJwtFormat(accessToken)) {
+            const errorMessage = 'Access token is not in valid JWT format';
+            this.log('error', `${this.name}: ${errorMessage}`);
+            return {
+                content: [{ type: 'text', text: errorMessage }],
+                isError: true
+            };
+        }
+        let toolContext;
         try {
-            // First check if token is provided via authentication context
-            // Check both standard token field and accessToken in extra for compatibility
-            // In the streamableHttp, the authInfo is injected into extra from `req.auth`
-            // https://github.com/modelcontextprotocol/typescript-sdk/blob/main/src/server/streamableHttp.ts#L405
-            const authToken = extra?.authInfo?.token;
-            const accessToken = authToken || MapboxApiBasedTool.mapboxAccessToken;
-            if (!accessToken) {
-                throw new Error('No access token available. Please provide via Bearer auth or MAPBOX_ACCESS_TOKEN env var');
-            }
-            // Validate that the token has the correct JWT format
-            if (!this.isValidJwtFormat(accessToken)) {
-                throw new Error('Access token is not in valid JWT format');
-            }
             const input = this.inputSchema.parse(rawInput);
-            const result = await this.execute(input, accessToken);
-            // Check if result is already a content object (image or text)
-            if (result &&
-                typeof result === 'object' &&
-                (result.type === 'image' || result.type === 'text')) {
-                return {
-                    content: [result],
-                    isError: false
-                };
-            }
-            // Otherwise return as text
-            return {
-                content: [{ type: 'text', text: JSON.stringify(result) }],
-                isError: false
+            // Create tool execution context - tracing is handled by the HTTP client
+            toolContext = {
+                ...(0, tracing_js_1.createToolExecutionContext)(this.name, 0, // Input size not needed since tracing is in HTTP client
+                this.httpRequest, extra),
+                httpRequest: this.httpRequest
             };
+            // Execute tool within the tool span context to connect all child spans
+            const result = await api_1.context.with(api_1.trace.setSpan(api_1.context.active(), toolContext.span), async () => {
+                return await this.execute(input, accessToken, toolContext);
+            });
+            // Mark span as successful and end it
+            toolContext.span.setStatus({ code: api_1.SpanStatusCode.OK });
+            toolContext.span.end();
+            return result;
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : String(error);
             this.log('error', `${this.name}: Error during execution: ${errorMessage}`);
+            // Mark span as failed and end it
+            if (toolContext?.span) {
+                toolContext.span.setStatus({
+                    code: api_1.SpanStatusCode.ERROR,
+                    message: errorMessage
+                });
+                toolContext.span.end();
+            }
+            const errorResponse = {
+                message: errorMessage,
+                tool: this.name
+            };
             return {
                 content: [
                     {
                         type: 'text',
-                        text: errorMessage
+                        text: JSON.stringify(errorResponse)
                     }
                 ],
                 isError: true

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

@@ -1 +1 @@
-{"version":3,"file":"MapboxApiBasedTool.js","sourceRoot":"","sources":["../../../src/tools/MapboxApiBasedTool.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;;AAIlC,+CAAyC;AAGzC,MAAsB,kBAEpB,SAAQ,sBAAqB;IAK7B,MAAM,KAAK,iBAAiB;QAC1B,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IACzC,CAAC;IAED,MAAM,KAAK,iBAAiB;QAC1B,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,yBAAyB,CAAC;IACtE,CAAC;IAED,YAAY,MAAoC;QAC9C,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACK,gBAAgB,CAAC,KAAa;QACpC,0EAA0E;QAC1E,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAErC,qCAAqC;QACrC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CACP,QAAiB,EACjB,KAAqC;QAErC,IAAI,CAAC;YACH,8DAA8D;YAC9D,6EAA6E;YAC7E,6EAA6E;YAC7E,qGAAqG;YACrG,MAAM,SAAS,GAAG,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC;YACzC,MAAM,WAAW,GAAG,SAAS,IAAI,kBAAkB,CAAC,iBAAiB,CAAC;YACtE,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CACb,0FAA0F,CAC3F,CAAC;YACJ,CAAC;YAED,qDAAqD;YACrD,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,EAAE,CAAC;gBACxC,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;YAC7D,CAAC;YAED,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC/C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;YAEtD,8DAA8D;YAC9D,IACE,MAAM;gBACN,OAAO,MAAM,KAAK,QAAQ;gBAC1B,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,EACnD,CAAC;gBACD,OAAO;oBACL,OAAO,EAAE,CAAC,MAAM,CAAC;oBACjB,OAAO,EAAE,KAAK;iBACf,CAAC;YACJ,CAAC;YAED,2BAA2B;YAC3B,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;gBACzD,OAAO,EAAE,KAAK;aACf,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAEzD,IAAI,CAAC,GAAG,CACN,OAAO,EACP,GAAG,IAAI,CAAC,IAAI,6BAA6B,YAAY,EAAE,CACxD,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,YAAY;qBACnB;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC;CASF;AA3GD,gDA2GC"}
+{"version":3,"file":"MapboxApiBasedTool.js","sourceRoot":"","sources":["../../../src/tools/MapboxApiBasedTool.ts"],"names":[],"mappings":"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"}

package/dist/commonjs/tools/category-list-tool/CategoryListTool.d.ts

@@ -1,11 +1,13 @@
 import { MapboxApiBasedTool } from '../MapboxApiBasedTool.js';
-import type { CategoryListInput } from './CategoryListTool.schema.js';
-import { CategoryListInputSchema } from './CategoryListTool.schema.js';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import type { HttpRequest } from '../../utils/types.js';
+import type { CategoryListInput } from './CategoryListTool.input.schema.js';
+import { CategoryListInputSchema } from './CategoryListTool.input.schema.js';
+import { CategoryListResponseSchema } from './CategoryListTool.output.schema.js';
 /**
  * Tool for retrieving the list of supported categories from Mapbox Search API
  */
-export declare class CategoryListTool extends MapboxApiBasedTool<typeof CategoryListInputSchema> {
-    private fetchImpl;
+export declare class CategoryListTool extends MapboxApiBasedTool<typeof CategoryListInputSchema, typeof CategoryListResponseSchema> {
     name: string;
     description: string;
     annotations: {
@@ -15,7 +17,9 @@ export declare class CategoryListTool extends MapboxApiBasedTool<typeof Category
         idempotentHint: boolean;
         openWorldHint: boolean;
     };
-    constructor(fetchImpl?: typeof fetch);
-    protected execute(input: CategoryListInput, accessToken: string): Promise<unknown>;
+    constructor(params: {
+        httpRequest: HttpRequest;
+    });
+    protected execute(input: CategoryListInput, accessToken: string): Promise<CallToolResult>;
 }
 //# sourceMappingURL=CategoryListTool.d.ts.map

package/dist/commonjs/tools/category-list-tool/CategoryListTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CategoryListTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/category-list-tool/CategoryListTool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAavE;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,kBAAkB,CACtD,OAAO,uBAAuB,CAC/B;IAYa,OAAO,CAAC,SAAS;IAX7B,IAAI,SAAwB;IAC5B,WAAW,SAC+X;IAC1Y,WAAW;;;;;;MAMT;gBAEkB,SAAS,GAAE,OAAO,KAAmB;cAIzC,OAAO,CACrB,KAAK,EAAE,iBAAiB,EACxB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC;CA2CpB"}
+{"version":3,"file":"CategoryListTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/category-list-tool/CategoryListTool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAC7E,OAAO,EAAE,0BAA0B,EAAE,MAAM,qCAAqC,CAAC;AAiBjF;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,kBAAkB,CACtD,OAAO,uBAAuB,EAC9B,OAAO,0BAA0B,CAClC;IACC,IAAI,SAAwB;IAC5B,WAAW,SAC0iB;IACrjB,WAAW;;;;;;MAMT;gBAEU,MAAM,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE;cAQhC,OAAO,CACrB,KAAK,EAAE,iBAAiB,EACxB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,cAAc,CAAC;CAkE3B"}