cryptopunks-mcp-server

Instructions

Implementation Reference

• src/api.ts:149-152 (handler)

  The API function that makes the network request to fetch recent sales.

  export async function getRecentSales(count = 20) {
    const clamped = Math.min(count, 50);
    return get(DATA_BASE, "/api/punks", { action: "recent-sales", count: String(clamped) });
  }

• src/tools.ts:94-107 (registration)

  The tool definition and schema registration for get_recent_sales.

  get_recent_sales: {
    description:
      "Get the most recent sales across the CryptoPunks collection. Returns buyer, seller, sale price in wei and USD, timestamp, and transaction hash. Count is capped at 50.",
    inputSchema: z.object({
      count: z
        .number()
        .int()
        .min(1)
        .max(50)
        .optional()
        .default(20)
        .describe("Number of recent sales to return (max 50)"),
    }),
  },

• src/handlers.ts:283-286 (handler)

  The tool execution handler in src/handlers.ts which calls the API function.

  case "get_recent_sales": {
    const result = await api.getRecentSales(args.count ?? 20);
    return ok(result);
  }