@mapbox/mcp-docs-server 0.2.1 → 0.3.1

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,eAAe,EAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,eAAe,EAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,oBAAoB,EACpB,SAAS,EACT,YAAY,EACb,MAAM,cAAc,CAAC"}

package/dist/commonjs/utils/index.js

@@ -2,11 +2,17 @@
 // Copyright (c) Mapbox, Inc.
 // Licensed under the MIT License.
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getVersionInfo = exports.UserAgentPolicy = exports.httpRequest = exports.systemHttpPipeline = void 0;
+exports.withToolSpan = exports.getTracer = exports.isTracingInitialized = exports.shutdownTracing = exports.initializeTracing = exports.getVersionInfo = exports.UserAgentPolicy = exports.httpRequest = exports.systemHttpPipeline = void 0;
 var httpPipeline_js_1 = require("./httpPipeline.js");
 Object.defineProperty(exports, "systemHttpPipeline", { enumerable: true, get: function () { return httpPipeline_js_1.systemHttpPipeline; } });
 Object.defineProperty(exports, "httpRequest", { enumerable: true, get: function () { return httpPipeline_js_1.httpRequest; } });
 Object.defineProperty(exports, "UserAgentPolicy", { enumerable: true, get: function () { return httpPipeline_js_1.UserAgentPolicy; } });
 var versionUtils_js_1 = require("./versionUtils.js");
 Object.defineProperty(exports, "getVersionInfo", { enumerable: true, get: function () { return versionUtils_js_1.getVersionInfo; } });
+var tracing_js_1 = require("./tracing.js");
+Object.defineProperty(exports, "initializeTracing", { enumerable: true, get: function () { return tracing_js_1.initializeTracing; } });
+Object.defineProperty(exports, "shutdownTracing", { enumerable: true, get: function () { return tracing_js_1.shutdownTracing; } });
+Object.defineProperty(exports, "isTracingInitialized", { enumerable: true, get: function () { return tracing_js_1.isTracingInitialized; } });
+Object.defineProperty(exports, "getTracer", { enumerable: true, get: function () { return tracing_js_1.getTracer; } });
+Object.defineProperty(exports, "withToolSpan", { enumerable: true, get: function () { return tracing_js_1.withToolSpan; } });
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;;AAElC,qDAI2B;AAHzB,qHAAA,kBAAkB,OAAA;AAClB,8GAAA,WAAW,OAAA;AACX,kHAAA,eAAe,OAAA;AAEjB,qDAAmD;AAA1C,iHAAA,cAAc,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":";AAAA,6BAA6B;AAC7B,kCAAkC;;;AAElC,qDAI2B;AAHzB,qHAAA,kBAAkB,OAAA;AAClB,8GAAA,WAAW,OAAA;AACX,kHAAA,eAAe,OAAA;AAEjB,qDAAmD;AAA1C,iHAAA,cAAc,OAAA;AAEvB,2CAMsB;AALpB,+GAAA,iBAAiB,OAAA;AACjB,6GAAA,eAAe,OAAA;AACf,kHAAA,oBAAoB,OAAA;AACpB,uGAAA,SAAS,OAAA;AACT,0GAAA,YAAY,OAAA"}

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

@@ -0,0 +1,18 @@
+import { type Span } from '@opentelemetry/api';
+/**
+ * Initialize OpenTelemetry tracing. Call once at application startup.
+ * No-ops in test environments or when OTEL_TRACING_ENABLED=false.
+ */
+export declare function initializeTracing(): Promise<void>;
+/**
+ * Shutdown tracing gracefully. Call on process exit.
+ */
+export declare function shutdownTracing(): Promise<void>;
+export declare function isTracingInitialized(): boolean;
+export declare function getTracer(): import("@opentelemetry/api").Tracer;
+/**
+ * Create a span for tool execution and run the callback within its context.
+ * Automatically marks the span success or error and ends it.
+ */
+export declare function withToolSpan<T>(toolName: string, fn: (span: Span) => Promise<T>): Promise<T>;
+//# sourceMappingURL=tracing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../../src/utils/tracing.ts"],"names":[],"mappings":"AAWA,OAAO,EAKL,KAAK,IAAI,EAGV,MAAM,oBAAoB,CAAC;AA+B5B;;;GAGG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAgEvD;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAMrD;AAED,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AAED,wBAAgB,SAAS,wCAExB;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAClC,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,GAC7B,OAAO,CAAC,CAAC,CAAC,CA0BZ"}

package/dist/commonjs/utils/tracing.js

@@ -0,0 +1,142 @@
+"use strict";
+// Copyright (c) Mapbox, Inc.
+// Licensed under the MIT License.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initializeTracing = initializeTracing;
+exports.shutdownTracing = shutdownTracing;
+exports.isTracingInitialized = isTracingInitialized;
+exports.getTracer = getTracer;
+exports.withToolSpan = withToolSpan;
+const sdk_node_1 = require("@opentelemetry/sdk-node");
+const auto_instrumentations_node_1 = require("@opentelemetry/auto-instrumentations-node");
+const resources_1 = require("@opentelemetry/resources");
+const semantic_conventions_1 = require("@opentelemetry/semantic-conventions");
+const exporter_trace_otlp_http_1 = require("@opentelemetry/exporter-trace-otlp-http");
+const api_1 = require("@opentelemetry/api");
+const incubating_1 = require("@opentelemetry/semantic-conventions/incubating");
+const versionUtils_js_1 = require("./versionUtils.js");
+// Suppress OpenTelemetry diagnostic logging IMMEDIATELY to avoid polluting stdio.
+// This must happen at module load time, before any OTEL operations.
+// Use OTEL_LOG_LEVEL env var to override if needed for debugging.
+const configureOtelDiagnostics = () => {
+    const logLevel = process.env.OTEL_LOG_LEVEL
+        ? api_1.DiagLogLevel[process.env.OTEL_LOG_LEVEL.toUpperCase()]
+        : api_1.DiagLogLevel.NONE;
+    api_1.diag.setLogger({
+        verbose: () => { },
+        debug: () => { },
+        info: () => { },
+        warn: () => { },
+        error: () => { }
+    }, logLevel);
+};
+configureOtelDiagnostics();
+let sdk = null;
+let isTracingEnabled = false;
+/**
+ * Initialize OpenTelemetry tracing. Call once at application startup.
+ * No-ops in test environments or when OTEL_TRACING_ENABLED=false.
+ */
+async function initializeTracing() {
+    if (sdk || process.env.NODE_ENV === 'test' || process.env.VITEST) {
+        return;
+    }
+    if (process.env.OTEL_TRACING_ENABLED === 'false') {
+        return;
+    }
+    const versionInfo = (0, versionUtils_js_1.getVersionInfo)();
+    try {
+        const resource = (0, resources_1.resourceFromAttributes)({
+            [semantic_conventions_1.ATTR_SERVICE_NAME]: process.env.OTEL_SERVICE_NAME || versionInfo.name,
+            [semantic_conventions_1.ATTR_SERVICE_VERSION]: versionInfo.version,
+            [incubating_1.ATTR_SERVICE_INSTANCE_ID]: process.env.HOSTNAME || 'unknown',
+            'service.git.sha': versionInfo.sha,
+            'service.git.branch': versionInfo.branch,
+            'service.git.tag': versionInfo.tag
+        });
+        const exporters = [];
+        if (process.env.OTEL_EXPORTER_CONSOLE_ENABLED === 'true') {
+            const { ConsoleSpanExporter } = await import('@opentelemetry/sdk-trace-base');
+            exporters.push(new ConsoleSpanExporter());
+        }
+        const otlpEndpoint = process.env.OTEL_EXPORTER_OTLP_ENDPOINT;
+        if (otlpEndpoint) {
+            exporters.push(new exporter_trace_otlp_http_1.OTLPTraceExporter({
+                url: `${otlpEndpoint}/v1/traces`,
+                headers: process.env.OTEL_EXPORTER_OTLP_HEADERS
+                    ? JSON.parse(process.env.OTEL_EXPORTER_OTLP_HEADERS)
+                    : {}
+            }));
+        }
+        if (exporters.length === 0) {
+            return;
+        }
+        sdk = new sdk_node_1.NodeSDK({
+            resource,
+            traceExporter: exporters[0],
+            instrumentations: [
+                (0, auto_instrumentations_node_1.getNodeAutoInstrumentations)({
+                    '@opentelemetry/instrumentation-fs': { enabled: false },
+                    '@opentelemetry/instrumentation-dns': { enabled: false },
+                    '@opentelemetry/instrumentation-http': { enabled: true },
+                    '@opentelemetry/instrumentation-undici': { enabled: true }
+                })
+            ]
+        });
+        sdk.start();
+        isTracingEnabled = true;
+    }
+    catch {
+        // Silently handle initialization errors to avoid breaking MCP stdio
+        isTracingEnabled = false;
+    }
+}
+/**
+ * Shutdown tracing gracefully. Call on process exit.
+ */
+async function shutdownTracing() {
+    if (sdk) {
+        await sdk.shutdown();
+        sdk = null;
+        isTracingEnabled = false;
+    }
+}
+function isTracingInitialized() {
+    return isTracingEnabled;
+}
+function getTracer() {
+    return api_1.trace.getTracer('mapbox-mcp-docs-server');
+}
+/**
+ * Create a span for tool execution and run the callback within its context.
+ * Automatically marks the span success or error and ends it.
+ */
+async function withToolSpan(toolName, fn) {
+    const tracer = getTracer();
+    const span = tracer.startSpan(`tool.${toolName}`, {
+        kind: api_1.SpanKind.INTERNAL,
+        attributes: {
+            'tool.name': toolName,
+            'operation.type': 'tool_execution'
+        }
+    });
+    return api_1.context.with(api_1.trace.setSpan(api_1.context.active(), span), async () => {
+        try {
+            const result = await fn(span);
+            span.setStatus({ code: api_1.SpanStatusCode.OK });
+            return result;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (error instanceof Error) {
+                span.recordException(error);
+            }
+            span.setStatus({ code: api_1.SpanStatusCode.ERROR, message });
+            throw error;
+        }
+        finally {
+            span.end();
+        }
+    });
+}
+//# sourceMappingURL=tracing.js.map

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

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

package/dist/commonjs/version.json

@@ -1,6 +1,6 @@
 {
-  "sha": "8e335ea0e22638f334fabd55d5465b4ef04598de",
-  "tag": "v0.2.0-6-g8e335ea",
+  "sha": "20c45c2a9f24ce2bb1df9dee894d9182dfc71f42",
+  "tag": "v0.3.0-8-g20c45c2",
   "branch": "HEAD",
-  "version": "0.2.1"
+  "version": "0.3.1"
 }

package/dist/esm/index.js

@@ -7,6 +7,7 @@ import { parseToolConfigFromArgs, filterTools } from './config/toolConfig.js';
 import { getCoreTools } from './tools/toolRegistry.js';
 import { getAllResources } from './resources/resourceRegistry.js';
 import { getVersionInfo } from './utils/versionUtils.js';
+import { initializeTracing, shutdownTracing } from './utils/tracing.js';
 // Parse configuration from command-line arguments
 const config = parseToolConfigFromArgs();
 // Get and filter tools based on configuration
@@ -33,6 +34,7 @@ resources.forEach((resource) => {
     resource.installTo(server);
 });
 async function main() {
+    await initializeTracing();
     const transport = new StdioServerTransport();
     await server.connect(transport);
     server.server.sendLoggingMessage({
@@ -50,6 +52,7 @@ async function shutdown() {
     catch {
         // Ignore logging errors during shutdown
     }
+    await shutdownTracing();
     process.exit(0);
 }
 function exitWithError(error, code = 1) {

package/dist/esm/index.js.map

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

package/dist/esm/resources/mapbox-api-reference-resource/MapboxApiReferenceResource.d.ts

@@ -3,12 +3,16 @@ import type { ReadResourceResult, ServerNotification, ServerRequest } from '@mod
 import type { HttpRequest } from '../../utils/types.js';
 import { BaseResource } from '../BaseResource.js';
 /**
- * Resource providing Mapbox API reference documentation
+ * Resource providing Mapbox API reference documentation.
+ * Fetches the aggregated API reference index from docs.mapbox.com/api/llms.txt,
+ * which lists all Mapbox REST API endpoints grouped by service category
+ * (Maps, Navigation, Search, Accounts, etc.) with direct links to each
+ * API reference page.
  */
 export declare class MapboxApiReferenceResource extends BaseResource {
     readonly name = "Mapbox API Reference";
     readonly uri = "resource://mapbox-api-reference";
-    readonly description = "Mapbox REST API reference documentation including endpoints, parameters, rate limits, and authentication for all Mapbox APIs (Geocoding, Directions, Static Images, Tilequery, etc.)";
+    readonly description: string;
     readonly mimeType = "text/markdown";
     private httpRequest;
     constructor(params: {

package/dist/esm/resources/mapbox-api-reference-resource/MapboxApiReferenceResource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MapboxApiReferenceResource.d.ts","sourceRoot":"","sources":["../../../../src/resources/mapbox-api-reference-resource/MapboxApiReferenceResource.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACxF,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACd,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOlD;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,YAAY;IAC1D,QAAQ,CAAC,IAAI,0BAA0B;IACvC,QAAQ,CAAC,GAAG,qCAAqC;IACjD,QAAQ,CAAC,WAAW,0LACqK;IACzL,QAAQ,CAAC,QAAQ,mBAAmB;IAEpC,OAAO,CAAC,WAAW,CAAc;gBAErB,MAAM,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE;IAKnC,YAAY,CACvB,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,mBAAmB,CAAC,aAAa,EAAE,kBAAkB,CAAC,GAC7D,OAAO,CAAC,kBAAkB,CAAC;CA2C/B"}
+{"version":3,"file":"MapboxApiReferenceResource.d.ts","sourceRoot":"","sources":["../../../../src/resources/mapbox-api-reference-resource/MapboxApiReferenceResource.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACxF,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACd,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD;;;;;;GAMG;AACH,qBAAa,0BAA2B,SAAQ,YAAY;IAC1D,QAAQ,CAAC,IAAI,0BAA0B;IACvC,QAAQ,CAAC,GAAG,qCAAqC;IACjD,QAAQ,CAAC,WAAW,SAIkE;IACtF,QAAQ,CAAC,QAAQ,mBAAmB;IAEpC,OAAO,CAAC,WAAW,CAAc;gBAErB,MAAM,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE;IAKnC,YAAY,CACvB,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,mBAAmB,CAAC,aAAa,EAAE,kBAAkB,CAAC,GAC7D,OAAO,CAAC,kBAAkB,CAAC;CAwB/B"}

package/dist/esm/resources/mapbox-api-reference-resource/MapboxApiReferenceResource.js

@@ -1,15 +1,21 @@
 // Copyright (c) Mapbox, Inc.
 // Licensed under the MIT License.
-import { docCache } from '../../utils/docCache.js';
 import { BaseResource } from '../BaseResource.js';
-import { parseDocSections, filterSectionsByCategory, sectionsToMarkdown } from '../utils/docParser.js';
+import { fetchCachedText } from '../../utils/docFetcher.js';
 /**
- * Resource providing Mapbox API reference documentation
+ * Resource providing Mapbox API reference documentation.
+ * Fetches the aggregated API reference index from docs.mapbox.com/api/llms.txt,
+ * which lists all Mapbox REST API endpoints grouped by service category
+ * (Maps, Navigation, Search, Accounts, etc.) with direct links to each
+ * API reference page.
  */
 export class MapboxApiReferenceResource extends BaseResource {
     name = 'Mapbox API Reference';
     uri = 'resource://mapbox-api-reference';
-    description = 'Mapbox REST API reference documentation including endpoints, parameters, rate limits, and authentication for all Mapbox APIs (Geocoding, Directions, Static Images, Tilequery, etc.)';
+    description = 'Mapbox REST API reference index organized by service (Maps, Navigation, Search, Accounts). ' +
+        'Lists all API endpoints with links to detailed reference pages covering parameters, ' +
+        'rate limits, authentication, and response formats (Geocoding, Directions, Static Images, ' +
+        'Tilequery, Matrix, Isochrone, Optimization, Styles, Uploads, Datasets, and more).';
     mimeType = 'text/markdown';
     httpRequest;
     constructor(params) {
@@ -18,30 +24,13 @@ export class MapboxApiReferenceResource extends BaseResource {
     }
     async readCallback(uri, _extra) {
         try {
-            const LLMS_TXT_URL = 'https://docs.mapbox.com/llms.txt';
-            let content = docCache.get(LLMS_TXT_URL);
-            if (!content) {
-                const response = await this.httpRequest(LLMS_TXT_URL, {
-                    headers: {
-                        Accept: 'text/markdown, text/plain;q=0.9, */*;q=0.8'
-                    }
-                });
-                if (!response.ok) {
-                    throw new Error(`Failed to fetch Mapbox documentation: ${response.statusText}`);
-                }
-                content = await response.text();
-                docCache.set(LLMS_TXT_URL, content);
-            }
-            // Parse and filter for API sections only
-            const allSections = parseDocSections(content);
-            const apiSections = filterSectionsByCategory(allSections, 'apis');
-            const apiContent = sectionsToMarkdown(apiSections);
+            const content = await fetchCachedText('https://docs.mapbox.com/api/llms.txt', this.httpRequest);
             return {
                 contents: [
                     {
                         uri: uri.href,
                         mimeType: this.mimeType,
-                        text: `# Mapbox API Reference\n\n${apiContent}`
+                        text: content
                     }
                 ]
             };

package/dist/esm/resources/mapbox-api-reference-resource/MapboxApiReferenceResource.js.map

@@ -1 +1 @@
-{"version":3,"file":"MapboxApiReferenceResource.js","sourceRoot":"","sources":["../../../../src/resources/mapbox-api-reference-resource/MapboxApiReferenceResource.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,kCAAkC;AASlC,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAE/B;;GAEG;AACH,MAAM,OAAO,0BAA2B,SAAQ,YAAY;IACjD,IAAI,GAAG,sBAAsB,CAAC;IAC9B,GAAG,GAAG,iCAAiC,CAAC;IACxC,WAAW,GAClB,sLAAsL,CAAC;IAChL,QAAQ,GAAG,eAAe,CAAC;IAE5B,WAAW,CAAc;IAEjC,YAAY,MAAoC;QAC9C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IACxC,CAAC;IAEM,KAAK,CAAC,YAAY,CACvB,GAAQ,EACR,MAA8D;QAE9D,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,kCAAkC,CAAC;YACxD,IAAI,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YACzC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE;oBACpD,OAAO,EAAE;wBACP,MAAM,EAAE,4CAA4C;qBACrD;iBACF,CAAC,CAAC;gBAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,IAAI,KAAK,CACb,yCAAyC,QAAQ,CAAC,UAAU,EAAE,CAC/D,CAAC;gBACJ,CAAC;gBAED,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAChC,QAAQ,CAAC,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACtC,CAAC;YAED,yCAAyC;YACzC,MAAM,WAAW,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;YAC9C,MAAM,WAAW,GAAG,wBAAwB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YAClE,MAAM,UAAU,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAC;YAEnD,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;wBACvB,IAAI,EAAE,6BAA6B,UAAU,EAAE;qBAChD;iBACF;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,wBAAwB,CAAC;YACpE,MAAM,IAAI,KAAK,CAAC,yCAAyC,YAAY,EAAE,EAAE;gBACvE,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"MapboxApiReferenceResource.js","sourceRoot":"","sources":["../../../../src/resources/mapbox-api-reference-resource/MapboxApiReferenceResource.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,kCAAkC;AASlC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D;;;;;;GAMG;AACH,MAAM,OAAO,0BAA2B,SAAQ,YAAY;IACjD,IAAI,GAAG,sBAAsB,CAAC;IAC9B,GAAG,GAAG,iCAAiC,CAAC;IACxC,WAAW,GAClB,6FAA6F;QAC7F,sFAAsF;QACtF,2FAA2F;QAC3F,mFAAmF,CAAC;IAC7E,QAAQ,GAAG,eAAe,CAAC;IAE5B,WAAW,CAAc;IAEjC,YAAY,MAAoC;QAC9C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IACxC,CAAC;IAEM,KAAK,CAAC,YAAY,CACvB,GAAQ,EACR,MAA8D;QAE9D,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,eAAe,CACnC,sCAAsC,EACtC,IAAI,CAAC,WAAW,CACjB,CAAC;YAEF,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;wBACvB,IAAI,EAAE,OAAO;qBACd;iBACF;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,wBAAwB,CAAC;YACpE,MAAM,IAAI,KAAK,CAAC,yCAAyC,YAAY,EAAE,EAAE;gBACvE,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF"}

package/dist/esm/resources/mapbox-examples-resource/MapboxExamplesResource.d.ts

@@ -3,12 +3,14 @@ import type { ReadResourceResult, ServerNotification, ServerRequest } from '@mod
 import type { HttpRequest } from '../../utils/types.js';
 import { BaseResource } from '../BaseResource.js';
 /**
- * Resource providing Mapbox examples and playgrounds
+ * Resource providing links to Mapbox interactive examples and playgrounds.
+ * Extracts the examples/playground/demo sections from the root llms.txt
+ * catalog, which lists API playgrounds, demo apps, and open-code projects.
  */
 export declare class MapboxExamplesResource extends BaseResource {
     readonly name = "Mapbox Examples";
     readonly uri = "resource://mapbox-examples";
-    readonly description = "Mapbox code examples, API playgrounds, and interactive demos for testing and learning";
+    readonly description: string;
     readonly mimeType = "text/markdown";
     private httpRequest;
     constructor(params: {

package/dist/esm/resources/mapbox-examples-resource/MapboxExamplesResource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MapboxExamplesResource.d.ts","sourceRoot":"","sources":["../../../../src/resources/mapbox-examples-resource/MapboxExamplesResource.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACxF,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACd,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOlD;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,YAAY;IACtD,QAAQ,CAAC,IAAI,qBAAqB;IAClC,QAAQ,CAAC,GAAG,gCAAgC;IAC5C,QAAQ,CAAC,WAAW,2FACsE;IAC1F,QAAQ,CAAC,QAAQ,mBAAmB;IAEpC,OAAO,CAAC,WAAW,CAAc;gBAErB,MAAM,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE;IAKnC,YAAY,CACvB,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,mBAAmB,CAAC,aAAa,EAAE,kBAAkB,CAAC,GAC7D,OAAO,CAAC,kBAAkB,CAAC;CA2C/B"}
+{"version":3,"file":"MapboxExamplesResource.d.ts","sourceRoot":"","sources":["../../../../src/resources/mapbox-examples-resource/MapboxExamplesResource.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACxF,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACd,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAQlD;;;;GAIG;AACH,qBAAa,sBAAuB,SAAQ,YAAY;IACtD,QAAQ,CAAC,IAAI,qBAAqB;IAClC,QAAQ,CAAC,GAAG,gCAAgC;IAC5C,QAAQ,CAAC,WAAW,SAG2D;IAC/E,QAAQ,CAAC,QAAQ,mBAAmB;IAEpC,OAAO,CAAC,WAAW,CAAc;gBAErB,MAAM,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE;IAKnC,YAAY,CACvB,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,mBAAmB,CAAC,aAAa,EAAE,kBAAkB,CAAC,GAC7D,OAAO,CAAC,kBAAkB,CAAC;CA6B/B"}

package/dist/esm/resources/mapbox-examples-resource/MapboxExamplesResource.js

@@ -1,15 +1,19 @@
 // Copyright (c) Mapbox, Inc.
 // Licensed under the MIT License.
-import { docCache } from '../../utils/docCache.js';
 import { BaseResource } from '../BaseResource.js';
+import { fetchCachedText } from '../../utils/docFetcher.js';
 import { parseDocSections, filterSectionsByCategory, sectionsToMarkdown } from '../utils/docParser.js';
 /**
- * Resource providing Mapbox examples and playgrounds
+ * Resource providing links to Mapbox interactive examples and playgrounds.
+ * Extracts the examples/playground/demo sections from the root llms.txt
+ * catalog, which lists API playgrounds, demo apps, and open-code projects.
  */
 export class MapboxExamplesResource extends BaseResource {
     name = 'Mapbox Examples';
     uri = 'resource://mapbox-examples';
-    description = 'Mapbox code examples, API playgrounds, and interactive demos for testing and learning';
+    description = 'Mapbox interactive API playgrounds, demo applications, and code examples. ' +
+        'Includes playground URLs for Directions, Search Box, Static Images, ' +
+        'Isochrone, Matrix APIs, and demo apps for real estate, store locator, etc.';
     mimeType = 'text/markdown';
     httpRequest;
     constructor(params) {
@@ -18,21 +22,8 @@ export class MapboxExamplesResource extends BaseResource {
     }
     async readCallback(uri, _extra) {
         try {
-            const LLMS_TXT_URL = 'https://docs.mapbox.com/llms.txt';
-            let content = docCache.get(LLMS_TXT_URL);
-            if (!content) {
-                const response = await this.httpRequest(LLMS_TXT_URL, {
-                    headers: {
-                        Accept: 'text/markdown, text/plain;q=0.9, */*;q=0.8'
-                    }
-                });
-                if (!response.ok) {
-                    throw new Error(`Failed to fetch Mapbox documentation: ${response.statusText}`);
-                }
-                content = await response.text();
-                docCache.set(LLMS_TXT_URL, content);
-            }
-            // Parse and filter for example sections only
+            const content = await fetchCachedText('https://docs.mapbox.com/llms.txt', this.httpRequest);
+            // Extract playground/demo/example sections from the catalog index
             const allSections = parseDocSections(content);
             const exampleSections = filterSectionsByCategory(allSections, 'examples');
             const exampleContent = sectionsToMarkdown(exampleSections);

package/dist/esm/resources/mapbox-examples-resource/MapboxExamplesResource.js.map

@@ -1 +1 @@
-{"version":3,"file":"MapboxExamplesResource.js","sourceRoot":"","sources":["../../../../src/resources/mapbox-examples-resource/MapboxExamplesResource.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,kCAAkC;AASlC,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAE/B;;GAEG;AACH,MAAM,OAAO,sBAAuB,SAAQ,YAAY;IAC7C,IAAI,GAAG,iBAAiB,CAAC;IACzB,GAAG,GAAG,4BAA4B,CAAC;IACnC,WAAW,GAClB,uFAAuF,CAAC;IACjF,QAAQ,GAAG,eAAe,CAAC;IAE5B,WAAW,CAAc;IAEjC,YAAY,MAAoC;QAC9C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IACxC,CAAC;IAEM,KAAK,CAAC,YAAY,CACvB,GAAQ,EACR,MAA8D;QAE9D,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,kCAAkC,CAAC;YACxD,IAAI,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YACzC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE;oBACpD,OAAO,EAAE;wBACP,MAAM,EAAE,4CAA4C;qBACrD;iBACF,CAAC,CAAC;gBAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,IAAI,KAAK,CACb,yCAAyC,QAAQ,CAAC,UAAU,EAAE,CAC/D,CAAC;gBACJ,CAAC;gBAED,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAChC,QAAQ,CAAC,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACtC,CAAC;YAED,6CAA6C;YAC7C,MAAM,WAAW,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;YAC9C,MAAM,eAAe,GAAG,wBAAwB,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;YAC1E,MAAM,cAAc,GAAG,kBAAkB,CAAC,eAAe,CAAC,CAAC;YAE3D,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;wBACvB,IAAI,EAAE,wBAAwB,cAAc,EAAE;qBAC/C;iBACF;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,wBAAwB,CAAC;YACpE,MAAM,IAAI,KAAK,CAAC,oCAAoC,YAAY,EAAE,EAAE;gBAClE,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"MapboxExamplesResource.js","sourceRoot":"","sources":["../../../../src/resources/mapbox-examples-resource/MapboxExamplesResource.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,kCAAkC;AASlC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAE/B;;;;GAIG;AACH,MAAM,OAAO,sBAAuB,SAAQ,YAAY;IAC7C,IAAI,GAAG,iBAAiB,CAAC;IACzB,GAAG,GAAG,4BAA4B,CAAC;IACnC,WAAW,GAClB,4EAA4E;QAC5E,sEAAsE;QACtE,4EAA4E,CAAC;IACtE,QAAQ,GAAG,eAAe,CAAC;IAE5B,WAAW,CAAc;IAEjC,YAAY,MAAoC;QAC9C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IACxC,CAAC;IAEM,KAAK,CAAC,YAAY,CACvB,GAAQ,EACR,MAA8D;QAE9D,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,eAAe,CACnC,kCAAkC,EAClC,IAAI,CAAC,WAAW,CACjB,CAAC;YAEF,kEAAkE;YAClE,MAAM,WAAW,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;YAC9C,MAAM,eAAe,GAAG,wBAAwB,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;YAC1E,MAAM,cAAc,GAAG,kBAAkB,CAAC,eAAe,CAAC,CAAC;YAE3D,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;wBACvB,IAAI,EAAE,wBAAwB,cAAc,EAAE;qBAC/C;iBACF;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,wBAAwB,CAAC;YACpE,MAAM,IAAI,KAAK,CAAC,oCAAoC,YAAY,EAAE,EAAE;gBAClE,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF"}

package/dist/esm/resources/mapbox-guides-resource/MapboxGuidesResource.d.ts

@@ -3,12 +3,15 @@ import type { ReadResourceResult, ServerNotification, ServerRequest } from '@mod
 import type { HttpRequest } from '../../utils/types.js';
 import { BaseResource } from '../BaseResource.js';
 /**
- * Resource providing Mapbox guides and tutorials
+ * Resource providing Mapbox guides, tutorials, and help articles.
+ * Fetches from docs.mapbox.com/help/llms.txt which contains the full
+ * Mapbox Help Center index: troubleshooting guides, how-to tutorials,
+ * glossary, account setup, billing, and platform-specific walkthroughs.
  */
 export declare class MapboxGuidesResource extends BaseResource {
     readonly name = "Mapbox Guides";
     readonly uri = "resource://mapbox-guides";
-    readonly description = "Mapbox guides, tutorials, and how-tos including Studio Manual, map design guides, and best practices";
+    readonly description: string;
     readonly mimeType = "text/markdown";
     private httpRequest;
     constructor(params: {

package/dist/esm/resources/mapbox-guides-resource/MapboxGuidesResource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MapboxGuidesResource.d.ts","sourceRoot":"","sources":["../../../../src/resources/mapbox-guides-resource/MapboxGuidesResource.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACxF,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACd,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOlD;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,YAAY;IACpD,QAAQ,CAAC,IAAI,mBAAmB;IAChC,QAAQ,CAAC,GAAG,8BAA8B;IAC1C,QAAQ,CAAC,WAAW,0GACqF;IACzG,QAAQ,CAAC,QAAQ,mBAAmB;IAEpC,OAAO,CAAC,WAAW,CAAc;gBAErB,MAAM,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE;IAKnC,YAAY,CACvB,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,mBAAmB,CAAC,aAAa,EAAE,kBAAkB,CAAC,GAC7D,OAAO,CAAC,kBAAkB,CAAC;CA2C/B"}
+{"version":3,"file":"MapboxGuidesResource.d.ts","sourceRoot":"","sources":["../../../../src/resources/mapbox-guides-resource/MapboxGuidesResource.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACxF,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACd,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD;;;;;GAKG;AACH,qBAAa,oBAAqB,SAAQ,YAAY;IACpD,QAAQ,CAAC,IAAI,mBAAmB;IAChC,QAAQ,CAAC,GAAG,8BAA8B;IAC1C,QAAQ,CAAC,WAAW,SAGgD;IACpE,QAAQ,CAAC,QAAQ,mBAAmB;IAEpC,OAAO,CAAC,WAAW,CAAc;gBAErB,MAAM,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE;IAKnC,YAAY,CACvB,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,mBAAmB,CAAC,aAAa,EAAE,kBAAkB,CAAC,GAC7D,OAAO,CAAC,kBAAkB,CAAC;CAwB/B"}

package/dist/esm/resources/mapbox-guides-resource/MapboxGuidesResource.js

@@ -1,15 +1,19 @@
 // Copyright (c) Mapbox, Inc.
 // Licensed under the MIT License.
-import { docCache } from '../../utils/docCache.js';
 import { BaseResource } from '../BaseResource.js';
-import { parseDocSections, filterSectionsByCategory, sectionsToMarkdown } from '../utils/docParser.js';
+import { fetchCachedText } from '../../utils/docFetcher.js';
 /**
- * Resource providing Mapbox guides and tutorials
+ * Resource providing Mapbox guides, tutorials, and help articles.
+ * Fetches from docs.mapbox.com/help/llms.txt which contains the full
+ * Mapbox Help Center index: troubleshooting guides, how-to tutorials,
+ * glossary, account setup, billing, and platform-specific walkthroughs.
  */
 export class MapboxGuidesResource extends BaseResource {
     name = 'Mapbox Guides';
     uri = 'resource://mapbox-guides';
-    description = 'Mapbox guides, tutorials, and how-tos including Studio Manual, map design guides, and best practices';
+    description = 'Mapbox Help Center documentation: troubleshooting guides, how-to tutorials, ' +
+        'glossary, account and billing setup, and walkthroughs for common developer tasks. ' +
+        'Use this for conceptual guidance and step-by-step instructions.';
     mimeType = 'text/markdown';
     httpRequest;
     constructor(params) {
@@ -18,30 +22,13 @@ export class MapboxGuidesResource extends BaseResource {
     }
     async readCallback(uri, _extra) {
         try {
-            const LLMS_TXT_URL = 'https://docs.mapbox.com/llms.txt';
-            let content = docCache.get(LLMS_TXT_URL);
-            if (!content) {
-                const response = await this.httpRequest(LLMS_TXT_URL, {
-                    headers: {
-                        Accept: 'text/markdown, text/plain;q=0.9, */*;q=0.8'
-                    }
-                });
-                if (!response.ok) {
-                    throw new Error(`Failed to fetch Mapbox documentation: ${response.statusText}`);
-                }
-                content = await response.text();
-                docCache.set(LLMS_TXT_URL, content);
-            }
-            // Parse and filter for guide sections only
-            const allSections = parseDocSections(content);
-            const guideSections = filterSectionsByCategory(allSections, 'guides');
-            const guideContent = sectionsToMarkdown(guideSections);
+            const content = await fetchCachedText('https://docs.mapbox.com/help/llms.txt', this.httpRequest);
             return {
                 contents: [
                     {
                         uri: uri.href,
                         mimeType: this.mimeType,
-                        text: `# Mapbox Guides\n\n${guideContent}`
+                        text: content
                     }
                 ]
             };

package/dist/esm/resources/mapbox-guides-resource/MapboxGuidesResource.js.map

@@ -1 +1 @@
-{"version":3,"file":"MapboxGuidesResource.js","sourceRoot":"","sources":["../../../../src/resources/mapbox-guides-resource/MapboxGuidesResource.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,kCAAkC;AASlC,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EACL,gBAAgB,EAChB,wBAAwB,EACxB,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAE/B;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,YAAY;IAC3C,IAAI,GAAG,eAAe,CAAC;IACvB,GAAG,GAAG,0BAA0B,CAAC;IACjC,WAAW,GAClB,sGAAsG,CAAC;IAChG,QAAQ,GAAG,eAAe,CAAC;IAE5B,WAAW,CAAc;IAEjC,YAAY,MAAoC;QAC9C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IACxC,CAAC;IAEM,KAAK,CAAC,YAAY,CACvB,GAAQ,EACR,MAA8D;QAE9D,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,kCAAkC,CAAC;YACxD,IAAI,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YACzC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE;oBACpD,OAAO,EAAE;wBACP,MAAM,EAAE,4CAA4C;qBACrD;iBACF,CAAC,CAAC;gBAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,IAAI,KAAK,CACb,yCAAyC,QAAQ,CAAC,UAAU,EAAE,CAC/D,CAAC;gBACJ,CAAC;gBAED,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAChC,QAAQ,CAAC,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACtC,CAAC;YAED,2CAA2C;YAC3C,MAAM,WAAW,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;YAC9C,MAAM,aAAa,GAAG,wBAAwB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;YACtE,MAAM,YAAY,GAAG,kBAAkB,CAAC,aAAa,CAAC,CAAC;YAEvD,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;wBACvB,IAAI,EAAE,sBAAsB,YAAY,EAAE;qBAC3C;iBACF;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,wBAAwB,CAAC;YACpE,MAAM,IAAI,KAAK,CAAC,kCAAkC,YAAY,EAAE,EAAE;gBAChE,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"MapboxGuidesResource.js","sourceRoot":"","sources":["../../../../src/resources/mapbox-guides-resource/MapboxGuidesResource.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,kCAAkC;AASlC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,OAAO,oBAAqB,SAAQ,YAAY;IAC3C,IAAI,GAAG,eAAe,CAAC;IACvB,GAAG,GAAG,0BAA0B,CAAC;IACjC,WAAW,GAClB,8EAA8E;QAC9E,oFAAoF;QACpF,iEAAiE,CAAC;IAC3D,QAAQ,GAAG,eAAe,CAAC;IAE5B,WAAW,CAAc;IAEjC,YAAY,MAAoC;QAC9C,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IACxC,CAAC;IAEM,KAAK,CAAC,YAAY,CACvB,GAAQ,EACR,MAA8D;QAE9D,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,eAAe,CACnC,uCAAuC,EACvC,IAAI,CAAC,WAAW,CACjB,CAAC;YAEF,OAAO;gBACL,QAAQ,EAAE;oBACR;wBACE,GAAG,EAAE,GAAG,CAAC,IAAI;wBACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;wBACvB,IAAI,EAAE,OAAO;qBACd;iBACF;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,wBAAwB,CAAC;YACpE,MAAM,IAAI,KAAK,CAAC,kCAAkC,YAAY,EAAE,EAAE;gBAChE,KAAK,EAAE,KAAK;aACb,CAAC,CAAC;QACL,CAAC;IACH,CAAC;CACF"}

package/dist/esm/resources/mapbox-reference-resource/MapboxReferenceResource.d.ts

@@ -3,12 +3,16 @@ import type { ReadResourceResult, ServerNotification, ServerRequest } from '@mod
 import type { HttpRequest } from '../../utils/types.js';
 import { BaseResource } from '../BaseResource.js';
 /**
- * Resource providing Mapbox reference documentation
+ * Resource providing the complete Mapbox documentation catalog.
+ * Fetches the root llms.txt which is now a structured index of every
+ * Mapbox product and documentation section, each with a link to its
+ * own llms.txt file. Use this to discover what documentation is available
+ * and find URLs to pass to get_document_tool for deeper exploration.
  */
 export declare class MapboxReferenceResource extends BaseResource {
     readonly name = "Mapbox Reference";
     readonly uri = "resource://mapbox-reference";
-    readonly description = "Mapbox reference documentation including tilesets, data products, accounts, pricing, and other reference materials";
+    readonly description: string;
     readonly mimeType = "text/markdown";
     private httpRequest;
     constructor(params: {

package/dist/esm/resources/mapbox-reference-resource/MapboxReferenceResource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MapboxReferenceResource.d.ts","sourceRoot":"","sources":["../../../../src/resources/mapbox-reference-resource/MapboxReferenceResource.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACxF,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACd,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOlD;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,YAAY;IACvD,QAAQ,CAAC,IAAI,sBAAsB;IACnC,QAAQ,CAAC,GAAG,iCAAiC;IAC7C,QAAQ,CAAC,WAAW,wHACmG;IACvH,QAAQ,CAAC,QAAQ,mBAAmB;IAEpC,OAAO,CAAC,WAAW,CAAc;gBAErB,MAAM,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE;IAKnC,YAAY,CACvB,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,mBAAmB,CAAC,aAAa,EAAE,kBAAkB,CAAC,GAC7D,OAAO,CAAC,kBAAkB,CAAC;CA8C/B"}
+{"version":3,"file":"MapboxReferenceResource.d.ts","sourceRoot":"","sources":["../../../../src/resources/mapbox-reference-resource/MapboxReferenceResource.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8CAA8C,CAAC;AACxF,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACd,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD;;;;;;GAMG;AACH,qBAAa,uBAAwB,SAAQ,YAAY;IACvD,QAAQ,CAAC,IAAI,sBAAsB;IACnC,QAAQ,CAAC,GAAG,iCAAiC;IAC7C,QAAQ,CAAC,WAAW,SAKsD;IAC1E,QAAQ,CAAC,QAAQ,mBAAmB;IAEpC,OAAO,CAAC,WAAW,CAAc;gBAErB,MAAM,EAAE;QAAE,WAAW,EAAE,WAAW,CAAA;KAAE;IAKnC,YAAY,CACvB,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,mBAAmB,CAAC,aAAa,EAAE,kBAAkB,CAAC,GAC7D,OAAO,CAAC,kBAAkB,CAAC;CAwB/B"}

package/dist/esm/resources/mapbox-reference-resource/MapboxReferenceResource.js

@@ -1,15 +1,22 @@
 // Copyright (c) Mapbox, Inc.
 // Licensed under the MIT License.
-import { docCache } from '../../utils/docCache.js';
 import { BaseResource } from '../BaseResource.js';
-import { parseDocSections, filterSectionsByCategory, sectionsToMarkdown } from '../utils/docParser.js';
+import { fetchCachedText } from '../../utils/docFetcher.js';
 /**
- * Resource providing Mapbox reference documentation
+ * Resource providing the complete Mapbox documentation catalog.
+ * Fetches the root llms.txt which is now a structured index of every
+ * Mapbox product and documentation section, each with a link to its
+ * own llms.txt file. Use this to discover what documentation is available
+ * and find URLs to pass to get_document_tool for deeper exploration.
  */
 export class MapboxReferenceResource extends BaseResource {
     name = 'Mapbox Reference';
     uri = 'resource://mapbox-reference';
-    description = 'Mapbox reference documentation including tilesets, data products, accounts, pricing, and other reference materials';
+    description = 'Complete catalog of all Mapbox products and documentation. ' +
+        'Lists every product section (Maps SDKs, Navigation APIs, Search APIs, ' +
+        'Studio, Style Spec, Tilesets, Data products, Help Center, Atlas, Unity, etc.) ' +
+        "with links to each product's own llms.txt index. Use this to discover " +
+        'what documentation exists and find the right URLs to fetch full docs.';
     mimeType = 'text/markdown';
     httpRequest;
     constructor(params) {
@@ -18,30 +25,13 @@ export class MapboxReferenceResource extends BaseResource {
     }
     async readCallback(uri, _extra) {
         try {
-            const LLMS_TXT_URL = 'https://docs.mapbox.com/llms.txt';
-            let content = docCache.get(LLMS_TXT_URL);
-            if (!content) {
-                const response = await this.httpRequest(LLMS_TXT_URL, {
-                    headers: {
-                        Accept: 'text/markdown, text/plain;q=0.9, */*;q=0.8'
-                    }
-                });
-                if (!response.ok) {
-                    throw new Error(`Failed to fetch Mapbox documentation: ${response.statusText}`);
-                }
-                content = await response.text();
-                docCache.set(LLMS_TXT_URL, content);
-            }
-            // Parse and filter for reference sections only
-            const allSections = parseDocSections(content);
-            const referenceSections = filterSectionsByCategory(allSections, 'reference');
-            const referenceContent = sectionsToMarkdown(referenceSections);
+            const content = await fetchCachedText('https://docs.mapbox.com/llms.txt', this.httpRequest);
             return {
                 contents: [
                     {
                         uri: uri.href,
                         mimeType: this.mimeType,
-                        text: `# Mapbox Reference\n\n${referenceContent}`
+                        text: content
                     }
                 ]
             };