@mapbox/mcp-server 0.2.4 → 0.4.0

package/dist/{tools → commonjs/tools}/version-tool/VersionTool.d.ts

@@ -1,4 +1,4 @@
-import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp';
+import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { z } from 'zod';
 export declare class VersionTool {
     readonly name = "version_tool";

package/dist/commonjs/tools/version-tool/VersionTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VersionTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/version-tool/VersionTool.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,cAAc,EACf,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,qBAAa,WAAW;IACtB,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,QAAQ,CAAC,WAAW,2DACsC;IAC1D,QAAQ,CAAC,WAAW,iDAAe;IAEnC,OAAO,CAAC,MAAM,CAA0B;IAGlC,GAAG,CAAC,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC;QACrC,OAAO,EAAE,KAAK,CAAC;YACb,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,EAAE,MAAM,CAAC;SACd,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC;IAoCF,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,cAAc;IAU5C,OAAO,CAAC,GAAG;CAKZ"}

package/dist/commonjs/tools/version-tool/VersionTool.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VersionTool = void 0;
+const zod_1 = require("zod");
+const versionUtils_js_1 = require("../../utils/versionUtils.js");
+const InputSchema = zod_1.z.object({});
+class VersionTool {
+    name = 'version_tool';
+    description = 'Get the current version information of the MCP server';
+    inputSchema = InputSchema;
+    server = null;
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    async run(_rawInput) {
+        try {
+            const versionInfo = (0, versionUtils_js_1.getVersionInfo)();
+            const versionText = `MCP Server Version Information:
+- Name: ${versionInfo.name}
+- Version: ${versionInfo.version}
+- SHA: ${versionInfo.sha}
+- Tag: ${versionInfo.tag}
+- Branch: ${versionInfo.branch}`;
+            return {
+                content: [{ type: 'text', text: versionText }],
+                isError: false
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            this.log('error', `${this.name}: Error during execution: ${errorMessage}`);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: errorMessage
+                    }
+                ],
+                isError: true
+            };
+        }
+    }
+    installTo(server) {
+        this.server = server;
+        return server.tool(this.name, this.description, this.inputSchema.shape, this.run.bind(this));
+    }
+    log(level, data) {
+        if (this.server) {
+            this.server.server.sendLoggingMessage({ level, data });
+        }
+    }
+}
+exports.VersionTool = VersionTool;
+//# sourceMappingURL=VersionTool.js.map

package/dist/commonjs/tools/version-tool/VersionTool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VersionTool.js","sourceRoot":"","sources":["../../../../src/tools/version-tool/VersionTool.ts"],"names":[],"mappings":";;;AAIA,6BAAwB;AACxB,iEAA6D;AAE7D,MAAM,WAAW,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAEjC,MAAa,WAAW;IACb,IAAI,GAAG,cAAc,CAAC;IACtB,WAAW,GAClB,uDAAuD,CAAC;IACjD,WAAW,GAAG,WAAW,CAAC;IAE3B,MAAM,GAAqB,IAAI,CAAC;IAExC,6DAA6D;IAC7D,KAAK,CAAC,GAAG,CAAC,SAAkB;QAO1B,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,IAAA,gCAAc,GAAE,CAAC;YAErC,MAAM,WAAW,GAAG;UAChB,WAAW,CAAC,IAAI;aACb,WAAW,CAAC,OAAO;SACvB,WAAW,CAAC,GAAG;SACf,WAAW,CAAC,GAAG;YACZ,WAAW,CAAC,MAAM,EAAE,CAAC;YAE3B,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;gBAC9C,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;IAED,SAAS,CAAC,MAAiB;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,OAAO,MAAM,CAAC,IAAI,CAChB,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,WAAW,CAAC,KAAK,EACtB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CACpB,CAAC;IACJ,CAAC;IAEO,GAAG,CAAC,KAA6C,EAAE,IAAS;QAClE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;CACF;AAlED,kCAkEC"}

package/dist/commonjs/utils/fetchRequest.d.ts

@@ -0,0 +1,38 @@
+export interface FetchPolicy {
+    id: string;
+    handle(input: string | URL | Request, init: RequestInit, next: typeof fetch): Promise<Response>;
+}
+export declare class PolicyPipeline {
+    private policies;
+    private fetchImpl;
+    constructor(fetchImpl?: typeof fetch);
+    usePolicy(policy: FetchPolicy): void;
+    removePolicy(policyOrId: FetchPolicy | string): void;
+    findPolicyById(id: string): FetchPolicy | undefined;
+    listPolicies(): FetchPolicy[];
+    fetch(input: string | URL | Request, init?: RequestInit): Promise<Response>;
+}
+export declare class UserAgentPolicy implements FetchPolicy {
+    private userAgent;
+    id: string;
+    constructor(userAgent: string, id?: string);
+    handle(input: string | URL | Request, init: RequestInit, next: typeof fetch): Promise<Response>;
+    static fromVersionInfo(versionInfo: {
+        name: string;
+        version: string;
+        sha: string;
+        tag: string;
+        branch: string;
+    }, id?: string): UserAgentPolicy;
+}
+export declare class RetryPolicy implements FetchPolicy {
+    private maxRetries;
+    private baseDelayMs;
+    private maxDelayMs;
+    id: string;
+    constructor(maxRetries?: number, baseDelayMs?: number, maxDelayMs?: number, id?: string);
+    handle(input: string | URL | Request, init: RequestInit, next: typeof fetch): Promise<Response>;
+}
+export declare const fetchClient: (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
+export declare const systemFetchPipeline: PolicyPipeline;
+//# sourceMappingURL=fetchRequest.d.ts.map

package/dist/commonjs/utils/fetchRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchRequest.d.ts","sourceRoot":"","sources":["../../../src/utils/fetchRequest.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CACJ,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAC7B,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,OAAO,KAAK,GACjB,OAAO,CAAC,QAAQ,CAAC,CAAC;CACtB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,SAAS,CAAe;gBAEpB,SAAS,CAAC,EAAE,OAAO,KAAK;IAIpC,SAAS,CAAC,MAAM,EAAE,WAAW;IAI7B,YAAY,CAAC,UAAU,EAAE,WAAW,GAAG,MAAM;IAQ7C,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAInD,YAAY;IAIN,KAAK,CACT,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAC7B,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,QAAQ,CAAC;CAerB;AAED,qBAAa,eAAgB,YAAW,WAAW;IAI/C,OAAO,CAAC,SAAS;IAHnB,EAAE,EAAE,MAAM,CAAC;gBAGD,SAAS,EAAE,MAAM,EACzB,EAAE,CAAC,EAAE,MAAM;IAMP,MAAM,CACV,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAC7B,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,OAAO,KAAK,GACjB,OAAO,CAAC,QAAQ,CAAC;IAmBpB,MAAM,CAAC,eAAe,CACpB,WAAW,EAAE;QACX,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;KAChB,EACD,EAAE,CAAC,EAAE,MAAM,GACV,eAAe;CAInB;AAED,qBAAa,WAAY,YAAW,WAAW;IAI3C,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,UAAU;IALpB,EAAE,EAAE,MAAM,CAAC;gBAGD,UAAU,GAAE,MAAU,EACtB,WAAW,GAAE,MAAY,EACzB,UAAU,GAAE,MAAa,EACjC,EAAE,CAAC,EAAE,MAAM;IAOP,MAAM,CACV,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAC7B,IAAI,EAAE,WAAW,EACjB,IAAI,EAAE,OAAO,KAAK,GACjB,OAAO,CAAC,QAAQ,CAAC;CA2BrB;AASD,eAAO,MAAM,WAAW,UA1Hb,MAAM,GAAG,GAAG,GAAG,OAAO,SACvB,WAAW,KAChB,OAAO,CAAC,QAAQ,CAwHmC,CAAC;AACzD,eAAO,MAAM,mBAAmB,gBAAW,CAAC"}

package/dist/commonjs/utils/fetchRequest.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.systemFetchPipeline = exports.fetchClient = exports.RetryPolicy = exports.UserAgentPolicy = exports.PolicyPipeline = void 0;
+const versionUtils_js_1 = require("./versionUtils.js");
+class PolicyPipeline {
+    policies = [];
+    fetchImpl;
+    constructor(fetchImpl) {
+        this.fetchImpl = fetchImpl ?? fetch;
+    }
+    usePolicy(policy) {
+        this.policies.push(policy);
+    }
+    removePolicy(policyOrId) {
+        if (typeof policyOrId === 'string') {
+            this.policies = this.policies.filter((p) => p.id !== policyOrId);
+        }
+        else {
+            this.policies = this.policies.filter((p) => p !== policyOrId);
+        }
+    }
+    findPolicyById(id) {
+        return this.policies.find((p) => p.id === id);
+    }
+    listPolicies() {
+        return this.policies;
+    }
+    async fetch(input, init = {}) {
+        const dispatch = async (i, req, options) => {
+            if (i < this.policies.length) {
+                return this.policies[i].handle(req, options, (nextReq, nextOptions) => dispatch(i + 1, nextReq, nextOptions));
+            }
+            return this.fetchImpl(req, options); // Use injected fetch
+        };
+        return dispatch(0, input, init);
+    }
+}
+exports.PolicyPipeline = PolicyPipeline;
+class UserAgentPolicy {
+    userAgent;
+    id;
+    constructor(userAgent, id) {
+        this.userAgent = userAgent;
+        this.id =
+            id ??
+                `user-agent-${Date.now()}-${Math.random().toString(36).substring(2, 11)}`;
+    }
+    async handle(input, init, next) {
+        let headers;
+        if (init.headers instanceof Headers) {
+            headers = init.headers;
+            if (!headers.has('User-Agent')) {
+                headers.set('User-Agent', this.userAgent);
+            }
+        }
+        else {
+            const h = (init.headers ?? {});
+            if (!('User-Agent' in h)) {
+                h['User-Agent'] = this.userAgent;
+            }
+            headers = h;
+        }
+        return next(input, { ...init, headers });
+    }
+    static fromVersionInfo(versionInfo, id) {
+        const userAgent = `${versionInfo.name}/${versionInfo.version} (${versionInfo.branch}, ${versionInfo.tag}, ${versionInfo.sha})`;
+        return new UserAgentPolicy(userAgent, id);
+    }
+}
+exports.UserAgentPolicy = UserAgentPolicy;
+class RetryPolicy {
+    maxRetries;
+    baseDelayMs;
+    maxDelayMs;
+    id;
+    constructor(maxRetries = 3, baseDelayMs = 200, maxDelayMs = 2000, id) {
+        this.maxRetries = maxRetries;
+        this.baseDelayMs = baseDelayMs;
+        this.maxDelayMs = maxDelayMs;
+        this.id =
+            id ??
+                `retry-${Date.now()}-${Math.random().toString(36).substring(2, 11)}`;
+    }
+    async handle(input, init, next) {
+        let attempt = 0;
+        let lastError;
+        while (attempt <= this.maxRetries) {
+            const response = await next(input, init);
+            if (response.ok || (response.status < 500 && response.status !== 429)) {
+                return response;
+            }
+            // Calculate exponential backoff with jitter
+            const expBackoff = Math.min(this.baseDelayMs * 2 ** attempt, this.maxDelayMs);
+            const jitter = Math.random() * expBackoff * 0.5;
+            const delay = expBackoff + jitter;
+            await new Promise((resolve) => setTimeout(resolve, delay));
+            attempt++;
+            lastError = response;
+        }
+        // If all retries failed, return last response
+        return lastError;
+    }
+}
+exports.RetryPolicy = RetryPolicy;
+const pipeline = new PolicyPipeline();
+const versionInfo = (0, versionUtils_js_1.getVersionInfo)();
+pipeline.usePolicy(UserAgentPolicy.fromVersionInfo(versionInfo, 'system-user-agent-policy'));
+pipeline.usePolicy(new RetryPolicy(3, 200, 2000, 'system-retry-policy'));
+exports.fetchClient = pipeline.fetch.bind(pipeline);
+exports.systemFetchPipeline = pipeline;
+//# sourceMappingURL=fetchRequest.js.map

package/dist/commonjs/utils/fetchRequest.js.map

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

package/dist/commonjs/utils/versionUtils-cjs.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"versionUtils-cjs.cjs","sourceRoot":"","sources":["../../../src/utils/versionUtils-cjs.cts"],"names":[],"mappings":";;;;;AAWA,wCAoCC;AA/CD,2BAAkC;AAClC,gDAAwB;AAUxB,SAAgB,cAAc;IAC5B,MAAM,IAAI,GAAG,mBAAmB,CAAC;IACjC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,SAAS,CAAC;QAE1B,4DAA4D;QAC5D,MAAM,eAAe,GAAG,cAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QACpE,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,IAAA,iBAAY,EAAC,eAAe,EAAE,OAAO,CAAC,CAAC;YAC3D,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAgB,CAAC;YACpD,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;YACpB,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,4BAA4B;YAC5B,MAAM,eAAe,GAAG,cAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;YAC1E,MAAM,WAAW,GAAG,IAAA,iBAAY,EAAC,eAAe,EAAE,OAAO,CAAC,CAAC;YAC3D,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAE5C,OAAO;gBACL,IAAI,EAAE,IAAI;gBACV,OAAO,EAAE,WAAW,CAAC,OAAO,IAAI,OAAO;gBACvC,GAAG,EAAE,SAAS;gBACd,GAAG,EAAE,SAAS;gBACd,MAAM,EAAE,SAAS;aAClB,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,gCAAgC,KAAK,EAAE,CAAC,CAAC;QACtD,OAAO;YACL,IAAI,EAAE,IAAI;YACV,OAAO,EAAE,OAAO;YAChB,GAAG,EAAE,SAAS;YACd,GAAG,EAAE,SAAS;YACd,MAAM,EAAE,SAAS;SAClB,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/commonjs/utils/versionUtils-cjs.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versionUtils-cjs.d.cts","sourceRoot":"","sources":["../../../src/utils/versionUtils-cjs.cts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,cAAc,IAAI,WAAW,CAoC5C"}

package/dist/commonjs/utils/versionUtils.d.ts

@@ -0,0 +1,9 @@
+export interface VersionInfo {
+    name: string;
+    version: string;
+    sha: string;
+    tag: string;
+    branch: string;
+}
+export declare function getVersionInfo(): VersionInfo;
+//# sourceMappingURL=versionUtils-cjs.d.cts.map

package/dist/commonjs/utils/versionUtils.js

@@ -0,0 +1,46 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getVersionInfo = getVersionInfo;
+const fs_1 = require("fs");
+const path_1 = __importDefault(require("path"));
+function getVersionInfo() {
+    const name = 'Mapbox MCP server';
+    try {
+        const dirname = __dirname;
+        // Try to read from version.json first (for build artifacts)
+        const versionJsonPath = path_1.default.resolve(dirname, '..', 'version.json');
+        try {
+            const versionData = (0, fs_1.readFileSync)(versionJsonPath, 'utf-8');
+            const info = JSON.parse(versionData);
+            info['name'] = name;
+            return info;
+        }
+        catch {
+            // Fall back to package.json
+            const packageJsonPath = path_1.default.resolve(dirname, '..', '..', 'package.json');
+            const packageData = (0, fs_1.readFileSync)(packageJsonPath, 'utf-8');
+            const packageInfo = JSON.parse(packageData);
+            return {
+                name: name,
+                version: packageInfo.version || '0.0.0',
+                sha: 'unknown',
+                tag: 'unknown',
+                branch: 'unknown'
+            };
+        }
+    }
+    catch (error) {
+        console.warn(`Failed to read version info: ${error}`);
+        return {
+            name: name,
+            version: '0.0.0',
+            sha: 'unknown',
+            tag: 'unknown',
+            branch: 'unknown'
+        };
+    }
+}
+//# sourceMappingURL=versionUtils-cjs.cjs.map

package/dist/commonjs/version.json

@@ -0,0 +1,6 @@
+{
+  "sha": "76fe2c14eca511860c9b7cda47897c4b719dc708",
+  "tag": "v0.2.4-6-g76fe2c1",
+  "branch": "main",
+  "version": "0.4.0"
+}

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

@@ -0,0 +1,8 @@
+import { ToolInstance } from '../tools/toolRegistry.js';
+export interface ToolConfig {
+    enabledTools?: string[];
+    disabledTools?: string[];
+}
+export declare function parseToolConfigFromArgs(): ToolConfig;
+export declare function filterTools(tools: readonly ToolInstance[], config: ToolConfig): ToolInstance[];
+//# sourceMappingURL=toolConfig.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toolConfig.d.ts","sourceRoot":"","sources":["../../../src/config/toolConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAExD,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"}

package/dist/esm/config/toolConfig.js

@@ -0,0 +1,36 @@
+export function parseToolConfigFromArgs() {
+    const args = process.argv.slice(2);
+    const config = {};
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--enable-tools') {
+            const value = args[++i];
+            if (value) {
+                config.enabledTools = value.split(',').map((t) => t.trim());
+            }
+        }
+        else if (arg === '--disable-tools') {
+            const value = args[++i];
+            if (value) {
+                config.disabledTools = value.split(',').map((t) => t.trim());
+            }
+        }
+    }
+    return config;
+}
+export function filterTools(tools, config) {
+    let filteredTools = [...tools];
+    // If enabledTools is specified, only those tools should be enabled
+    // This takes precedence over disabledTools
+    if (config.enabledTools !== undefined) {
+        filteredTools = filteredTools.filter((tool) => config.enabledTools.includes(tool.name));
+        // Return early since enabledTools takes precedence
+        return filteredTools;
+    }
+    // Apply disabledTools filter only if enabledTools is not specified
+    if (config.disabledTools && config.disabledTools.length > 0) {
+        filteredTools = filteredTools.filter((tool) => !config.disabledTools.includes(tool.name));
+    }
+    return filteredTools;
+}
+//# sourceMappingURL=toolConfig.js.map

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

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

package/dist/esm/index.d.ts

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

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

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

package/dist/esm/index.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { parseToolConfigFromArgs, filterTools } from './config/toolConfig.js';
+import { getAllTools } from './tools/toolRegistry.js';
+import { getVersionInfo } from './utils/versionUtils.js';
+import 'dotenv/config';
+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);
+// Create an MCP server
+const server = new McpServer({
+    name: versionInfo.name,
+    version: versionInfo.version
+}, {
+    capabilities: {
+        tools: {}
+    }
+});
+// Register enabled tools to the server
+enabledTools.forEach((tool) => {
+    tool.installTo(server);
+});
+async function main() {
+    // Start receiving messages on stdin and sending messages on stdout
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    console.error('Fatal error starting MCP server:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,eAAe,CAAC;AAEvB,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;AAErC,kDAAkD;AAClD,MAAM,MAAM,GAAG,uBAAuB,EAAE,CAAC;AAEzC,8CAA8C;AAC9C,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;AAC/B,MAAM,YAAY,GAAG,WAAW,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;AAEnD,uBAAuB;AACvB,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;IACE,IAAI,EAAE,WAAW,CAAC,IAAI;IACtB,OAAO,EAAE,WAAW,CAAC,OAAO;CAC7B,EACD;IACE,YAAY,EAAE;QACZ,KAAK,EAAE,EAAE;KACV;CACF,CACF,CAAC;AAEF,uCAAuC;AACvC,YAAY,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;IAC5B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AACzB,CAAC,CAAC,CAAC;AAEH,KAAK,UAAU,IAAI;IACjB,mEAAmE;IACnE,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,kCAAkC,EAAE,KAAK,CAAC,CAAC;IACzD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/esm/package.json

@@ -1,3 +1,3 @@
 {
   "type": "module"
-}
+}

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

@@ -0,0 +1,83 @@
+import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { RequestHandlerExtra } from '@modelcontextprotocol/sdk/shared/protocol.js';
+import { z, ZodTypeAny } from 'zod';
+export declare const OutputSchema: z.ZodObject<{
+    content: z.ZodArray<z.ZodUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        text: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "text";
+        text: string;
+    }, {
+        type: "text";
+        text: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"image">;
+        data: z.ZodString;
+        mimeType: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "image";
+        data: string;
+        mimeType: string;
+    }, {
+        type: "image";
+        data: string;
+        mimeType: string;
+    }>]>, "many">;
+    isError: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    content: ({
+        type: "text";
+        text: string;
+    } | {
+        type: "image";
+        data: string;
+        mimeType: string;
+    })[];
+    isError: boolean;
+}, {
+    content: ({
+        type: "text";
+        text: string;
+    } | {
+        type: "image";
+        data: string;
+        mimeType: string;
+    })[];
+    isError?: boolean | undefined;
+}>;
+export declare abstract class MapboxApiBasedTool<InputSchema extends ZodTypeAny> {
+    abstract readonly name: string;
+    abstract readonly description: string;
+    readonly inputSchema: InputSchema;
+    protected server: McpServer | null;
+    static get mapboxAccessToken(): string | undefined;
+    static get mapboxApiEndpoint(): string;
+    constructor(params: {
+        inputSchema: InputSchema;
+    });
+    /**
+     * Validates if a string has the format of a JWT token (header.payload.signature)
+     * Docs: https://docs.mapbox.com/api/accounts/tokens/#token-format
+     * @param token The token string to validate
+     * @returns boolean indicating if the token has valid JWT format
+     */
+    private isValidJwtFormat;
+    /**
+     * Validates and runs the tool logic.
+     */
+    run(rawInput: unknown, extra?: RequestHandlerExtra<any, any>): Promise<z.infer<typeof OutputSchema>>;
+    /**
+     * Tool logic to be implemented by subclasses.
+     */
+    protected abstract execute(_input: z.infer<InputSchema>, accessToken: string): Promise<any>;
+    /**
+     * Installs the tool to the given MCP server.
+     */
+    installTo(server: McpServer): RegisteredTool;
+    /**
+     * Helper method to send logging messages
+     */
+    protected log(level: 'debug' | 'info' | 'warning' | 'error', data: any): void;
+}
+//# sourceMappingURL=MapboxApiBasedTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MapboxApiBasedTool.d.ts","sourceRoot":"","sources":["../../../src/tools/MapboxApiBasedTool.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,cAAc,EACf,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACnF,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAEpC,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAevB,CAAC;AAEH,8BAAsB,kBAAkB,CAAC,WAAW,SAAS,UAAU;IACrE,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAEtC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAQ;IAE1C,MAAM,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;IAEf;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,cAAc;IAU5C;;OAEG;IACH,SAAS,CAAC,GAAG,CACX,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,EAC7C,IAAI,EAAE,GAAG,GACR,IAAI;CAKR"}

package/dist/{tools → esm/tools}/MapboxApiBasedTool.js

@@ -16,8 +16,12 @@ export const OutputSchema = z.object({
 export class MapboxApiBasedTool {
     inputSchema;
     server = null;
-    static MAPBOX_ACCESS_TOKEN = process.env.MAPBOX_ACCESS_TOKEN;
-    static MAPBOX_API_ENDPOINT = process.env.MAPBOX_API_ENDPOINT || 'https://api.mapbox.com/';
+    static get mapboxAccessToken() {
+        return process.env.MAPBOX_ACCESS_TOKEN;
+    }
+    static get mapboxApiEndpoint() {
+        return process.env.MAPBOX_API_ENDPOINT || 'https://api.mapbox.com/';
+    }
     constructor(params) {
         this.inputSchema = params.inputSchema;
     }
@@ -38,17 +42,23 @@ export class MapboxApiBasedTool {
     /**
      * Validates and runs the tool logic.
      */
-    async run(rawInput) {
+    async run(rawInput, extra) {
         try {
-            if (!MapboxApiBasedTool.MAPBOX_ACCESS_TOKEN) {
-                throw new Error('MAPBOX_ACCESS_TOKEN is not set');
+            // 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(MapboxApiBasedTool.MAPBOX_ACCESS_TOKEN)) {
-                throw new Error('MAPBOX_ACCESS_TOKEN is not in valid 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);
+            const result = await this.execute(input, accessToken);
             // Check if result is already a content object (image or text)
             if (result &&
                 typeof result === 'object' &&
@@ -67,14 +77,11 @@ export class MapboxApiBasedTool {
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : String(error);
             this.log('error', `${this.name}: Error during execution: ${errorMessage}`);
-            const isVerboseErrors = process.env.VERBOSE_ERRORS === 'true';
             return {
                 content: [
                     {
                         type: 'text',
-                        text: isVerboseErrors
-                            ? errorMessage
-                            : 'Internal error has occurred.'
+                        text: errorMessage
                     }
                 ],
                 isError: true
@@ -86,7 +93,7 @@ export class MapboxApiBasedTool {
      */
     installTo(server) {
         this.server = server;
-        return server.tool(this.name, this.description, this.inputSchema.shape, this.run.bind(this));
+        return server.tool(this.name, this.description, this.inputSchema.shape, (args, extra) => this.run(args, extra));
     }
     /**
      * Helper method to send logging messages

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

@@ -0,0 +1 @@
+{"version":3,"file":"MapboxApiBasedTool.js","sourceRoot":"","sources":["../../../src/tools/MapboxApiBasedTool.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,CAAC,EAAc,MAAM,KAAK,CAAC;AAEpC,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,OAAO,EAAE,CAAC,CAAC,KAAK,CACd,CAAC,CAAC,KAAK,CAAC;QACN,CAAC,CAAC,MAAM,CAAC;YACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;YACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;SACjB,CAAC;QACF,CAAC,CAAC,MAAM,CAAC;YACP,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;YACxB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;SACrB,CAAC;KACH,CAAC,CACH;IACD,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACpC,CAAC,CAAC;AAEH,MAAM,OAAgB,kBAAkB;IAI7B,WAAW,CAAc;IACxB,MAAM,GAAqB,IAAI,CAAC;IAE1C,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,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IACxC,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;IAUD;;OAEG;IACH,SAAS,CAAC,MAAiB;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,OAAO,MAAM,CAAC,IAAI,CAChB,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,WAAW,EACf,IAAI,CAAC,WAA2C,CAAC,KAAK,EACvD,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CACvC,CAAC;IACJ,CAAC;IAED;;OAEG;IACO,GAAG,CACX,KAA6C,EAC7C,IAAS;QAET,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,28 @@
+import { z } from 'zod';
+import { MapboxApiBasedTool } from '../MapboxApiBasedTool.js';
+declare const CategoryListInputSchema: z.ZodObject<{
+    language: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    offset: number;
+    language?: string | undefined;
+    limit?: number | undefined;
+}, {
+    language?: string | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+}>;
+type CategoryListInput = z.infer<typeof CategoryListInputSchema>;
+/**
+ * Tool for retrieving the list of supported categories from Mapbox Search API
+ */
+export declare class CategoryListTool extends MapboxApiBasedTool<typeof CategoryListInputSchema> {
+    private fetchImpl;
+    name: string;
+    description: string;
+    constructor(fetchImpl?: typeof fetch);
+    protected execute(input: CategoryListInput, accessToken: string): Promise<any>;
+}
+export {};
+//# sourceMappingURL=CategoryListTool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CategoryListTool.d.ts","sourceRoot":"","sources":["../../../../src/tools/category-list-tool/CategoryListTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAG9D,QAAA,MAAM,uBAAuB;;;;;;;;;;;;EAqB3B,CAAC;AAEH,KAAK,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAajE;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,kBAAkB,CACtD,OAAO,uBAAuB,CAC/B;IAKa,OAAO,CAAC,SAAS;IAJ7B,IAAI,SAAwB;IAC5B,WAAW,SACiU;gBAExT,SAAS,GAAE,OAAO,KAAmB;cAIzC,OAAO,CACrB,KAAK,EAAE,iBAAiB,EACxB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,GAAG,CAAC;CA2ChB"}