mcp-comexstat

Implementation Reference

• src/ComexstatClient.ts:568-581 (handler)

  Core handler function that executes the tool logic: makes a GET request to the Comexstat API endpoint `/tables/countries/${countryId}` to fetch country details including ID, name, and ISO codes.

  async getCountryDetails(countryId: string): Promise<{
    data: {
      id: string;
      country: string;
      coPaisIson3: string; // ISO numeric code
      coPaisIsoa3: string; // ISO alpha-3 code
    };
    success: boolean;
    message: string | null;
    processo_info: any;
    language: string;
  }> {
    return this.get(`/tables/countries/${countryId}`);
  }

• src/ComexstatMCP.ts:389-404 (registration)

  MCP tool registration for 'getCountryDetails', including input schema validation with Zod and the thin wrapper handler that calls the client method and formats the response.

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

• src/ComexstatMCP.ts:391-393 (schema)

  Input schema definition using Zod for the 'countryId' parameter.

  {
    countryId: z.string(),
  },