mcp-comexstat

Implementation Reference

• src/ComexstatMCP.ts:32-39 (registration)

  Registers the MCP tool 'getAvailableYears' with empty input schema. The handler fetches available years via the client and returns a JSON string in text content.

  this.server.tool("getAvailableYears", {}, async () => ({
    content: [
      {
        type: "text",
        text: JSON.stringify(await this.client.getAvailableYears()),
      },
    ],
  }));

• src/ComexstatMCP.ts:32-39 (handler)

  Inline handler function for the 'getAvailableYears' tool that calls the client method and formats the response as JSON text.

  this.server.tool("getAvailableYears", {}, async () => ({
    content: [
      {
        type: "text",
        text: JSON.stringify(await this.client.getAvailableYears()),
      },
    ],
  }));

• src/ComexstatClient.ts:140-149 (helper)

  Implements the getAvailableYears logic by calling the Comexstat API GET /general/dates/years endpoint and extracting the {min, max} data.

  async getAvailableYears(): Promise<{ min: string; max: string }> {
    const response = await this.get<{
      data: { min: string; max: string };
      success: boolean;
      message: string | null;
      processo_info: any;
      language: string;
    }>("/general/dates/years");
    return response.data;
  }

• src/ComexstatClient.ts:140-148 (schema)

  TypeScript type definitions for input/output of getAvailableYears: returns Promise<{ min: string; max: string }> and expects API response with data: { min: string; max: string }.

  async getAvailableYears(): Promise<{ min: string; max: string }> {
    const response = await this.get<{
      data: { min: string; max: string };
      success: boolean;
      message: string | null;
      processo_info: any;
      language: string;
    }>("/general/dates/years");
    return response.data;