cryptopunks-mcp-server

Instructions

Implementation Reference

• src/api.ts:166-171 (handler)

  The core handler function that executes the API request for batch recent history.

  export async function getBatchRecentHistory(punkIds: number[]) {
    return get(DATA_BASE, "/api/punks", {
      action: "batch-recent-history",
      punkIds: punkIds.join(","),
    });
  }

• src/tools.ts:145-154 (schema)

  The MCP tool registration and schema definition for get_batch_recent_history.

  get_batch_recent_history: {
    description:
      "Get recent transaction history for multiple CryptoPunks in a single request. Useful for comparing activity across a set of punks. Maximum 50 punk indices per call.",
    inputSchema: z.object({
      punk_ids: z
        .array(punkIndex)
        .min(1)
        .max(50)
        .describe("Array of punk indices to fetch history for (max 50)"),
    }),

• src/handlers.ts:332-335 (registration)

  The tool dispatch logic that calls the API handler.

  case "get_batch_recent_history": {
    const result = await api.getBatchRecentHistory(args.punk_ids);
    return ok(result);
  }