Verilex Data

Instructions

Implementation Reference

• src/tools/contracts.ts:212-233 (handler)

  The handler function for the `contract_stats` tool, which fetches data from the `/api/v1/contracts/stats` endpoint and returns it as a formatted JSON string.

    async () => {
      const res = await apiGet<ContractStatsResponse>("/api/v1/contracts/stats");
  
      if (!res.ok) {
        return {
          content: [
            {
              type: "text" as const,
              text: `API error (${res.status}): ${JSON.stringify(res.data)}`,
            },
          ],
          isError: true,
        };
      }
  
      return {
        content: [
          { type: "text" as const, text: JSON.stringify(res.data, null, 2) },
        ],
      };
    },
  );

• src/tools/contracts.ts:203-211 (registration)

  The registration of the `contract_stats` tool with the McpServer instance.

  server.registerTool(
    "contract_stats",
    {
      title: "Contracts Dataset Statistics",
      description:
        "Get statistics about the government contracts dataset: total awards, " +
        "agencies covered, date range, and data source information. Free endpoint.",
      inputSchema: {},
    },

• src/tools/contracts.ts:21-26 (schema)

  The TypeScript interface defining the structure of the response for the `contract_stats` tool.

  interface ContractStatsResponse {
    dataset: string;
    source: string;
    update_frequency: string;
    stats: Record<string, unknown>;
  }