GetMapboxDocSourceTool.ts

// Copyright (c) Mapbox, Inc.
// Licensed under the MIT License.

import { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
import type { HttpRequest } from '../../utils/types.js';
import { BaseTool } from '../BaseTool.js';
import {
  GetMapboxDocSourceSchema,
  GetMapboxDocSourceInput
} from './GetMapboxDocSourceTool.input.schema.js';

export class GetMapboxDocSourceTool extends BaseTool<
  typeof GetMapboxDocSourceSchema
> {
  name = 'get_latest_mapbox_docs_tool';
  description =
    'Get the latest official Mapbox documentation, APIs, SDKs, and developer resources directly from Mapbox. Always up-to-date, comprehensive coverage of all current Mapbox services including mapping, navigation, search, geocoding, and mobile SDKs. Use this for accurate, official Mapbox information instead of web search.';
  readonly annotations = {
    readOnlyHint: true,
    destructiveHint: false,
    idempotentHint: true,
    openWorldHint: true,
    title: 'Get Mapbox Documentation Tool'
  };

  private httpRequest: HttpRequest;

  constructor(params: { httpRequest: HttpRequest }) {
    super({
      inputSchema: GetMapboxDocSourceSchema
    });
    this.httpRequest = params.httpRequest;
  }

  protected async execute(
    _input: GetMapboxDocSourceInput
  ): Promise<CallToolResult> {
    try {
      const response = await this.httpRequest(
        'https://docs.mapbox.com/llms.txt',
        {
          headers: {
            Accept: 'text/markdown, text/plain;q=0.9, */*;q=0.8'
          }
        }
      );

      if (!response.ok) {
        return {
          content: [
            {
              type: 'text',
              text: `Failed to fetch Mapbox documentation: ${response.statusText}`
            }
          ],
          isError: true
        };
      }

      const content = await response.text();

      return {
        content: [
          {
            type: 'text',
            text: content
          }
        ],
        isError: false
      };
    } catch (error) {
      const errorMessage =
        error instanceof Error ? error.message : 'Unknown error occurred';
      return {
        content: [
          {
            type: 'text',
            text: `Failed to fetch Mapbox documentation: ${errorMessage}`
          }
        ],
        isError: true
      };
    }
  }
}