Polymarket Changes

Instructions

Implementation Reference

• src/tools/pm.ts:216-263 (handler)

  The handler function for the 'pm_changes' tool. It calls the API at '/api/v1/pm/changes' with 'since' (ISO 8601 timestamp) and optional 'limit' parameters, then returns the count and data. This is both the handler and the schema definition since the tool is registered inline via server.registerTool.

  server.registerTool(
    "pm_changes",
    {
      title: "Polymarket Changes",
      description:
        "Get recent changes to Polymarket data since a given timestamp. " +
        "Cost: $0.01 per query. Source: Polymarket on-chain data.",
      inputSchema: {
        since: z
          .string()
          .describe("ISO 8601 timestamp to get changes since (e.g. 2026-03-01T00:00:00Z)"),
        limit: z
          .number()
          .int()
          .min(1)
          .max(100)
          .optional()
          .describe("Maximum results (default 50)"),
      },
    },
    async ({ since, limit }) => {
      const res = await apiGet<PmQueryResponse>("/api/v1/pm/changes", {
        since,
        limit: limit ?? 50,
      });
  
      if (!res.ok) {
        return {
          content: [
            {
              type: "text" as const,
              text: `API error (${res.status}): ${JSON.stringify(res.data)}`,
            },
          ],
          isError: true,
        };
      }
  
      const { count, data } = res.data;
      const warn = stalenessWarning(res);
      const summary = `${warn}Found ${count} Polymarket change(s) since ${since}.`;
      const json = JSON.stringify(data, null, 2);
  
      return {
        content: [{ type: "text" as const, text: `${summary}\n\n${json}` }],
      };
    },
  );

• src/tools/pm.ts:223-234 (schema)

  The input schema for 'pm_changes', defined inline with Zod: 'since' (required ISO 8601 string) and 'limit' (optional number, 1-100, default 50).

  inputSchema: {
    since: z
      .string()
      .describe("ISO 8601 timestamp to get changes since (e.g. 2026-03-01T00:00:00Z)"),
    limit: z
      .number()
      .int()
      .min(1)
      .max(100)
      .optional()
      .describe("Maximum results (default 50)"),
  },

• src/index.ts:29-54 (registration)

  The export and registration of the registerPmTools function which registers all Polymarket tools including 'pm_changes' on the MCP server.

  import { registerPmResolutionTools } from "./tools/pm_resolution.js";
  import { registerEconTools } from "./tools/econ.js";
  import { registerPmMicroTools } from "./tools/pm_micro.js";
  
  function createMcpServer() {
    const server = new McpServer({
      name: "verilex-data",
      version: "0.3.3",
    });
  
    registerNpiTools(server);
    registerSecTools(server);
    registerPacerTools(server);
    registerWeatherTools(server);
    registerOtcTools(server);
    registerTrademarkTools(server);
    registerPatentTools(server);
    registerCompanyTools(server);
    registerCryptoTools(server);
    registerSanctionsTools(server);
    registerWhaleTools(server);
    registerLabelTools(server);
    registerHolderTools(server);
    registerDexTools(server);
    registerContractTools(server);
    registerPmTools(server);

• src/client.ts:44-76 (helper)

  The apiGet helper used by the pm_changes handler to make HTTP GET requests to the Verilex API.

  export async function apiGet<T = unknown>(
    path: string,
    params?: Record<string, string | number | undefined>,
  ): Promise<ApiResponse<T>> {
    const url = buildUrl(path, params);
  
    const headers: Record<string, string> = {
      Accept: "application/json",
      "User-Agent": "verilex-mcp-server/0.1.0",
    };
  
    // Forward x402 payment token if present in env (for paid endpoints)
    const paymentToken = process.env.VERILEX_PAYMENT_TOKEN;
    if (paymentToken) {
      headers["X-Payment-Token"] = paymentToken;
    }
  
    const res = await fetch(url, { headers });
    const data = (await res.json()) as T;
  
    const stale = res.headers.get("X-Data-Stale");
    const lastUpdated = res.headers.get("X-Data-Last-Updated");
    const ageSeconds = res.headers.get("X-Data-Age-Seconds");
  
    return {
      ok: res.ok,
      status: res.status,
      data,
      stale: stale === "true",
      lastUpdated: lastUpdated ?? undefined,
      ageSeconds: ageSeconds ? Number(ageSeconds) : undefined,
    };
  }

• src/client.ts:35-41 (helper)

  The stalenessWarning helper used by the pm_changes handler to append stale-data warnings.

  export function stalenessWarning(res: ApiResponse): string {
    if (!res.stale) return "";
    const parts = ["[STALE DATA]"];
    if (res.lastUpdated) parts.push(`Last updated: ${res.lastUpdated}`);
    if (res.ageSeconds != null) parts.push(`Age: ${res.ageSeconds}s`);
    return parts.join(" ") + "\n\n";
  }