cryptopunks-mcp-server

Instructions

Implementation Reference

• src/handlers.ts:348-357 (handler)

  The handler logic for "get_collection_bids", which fetches bids via the API and applies summarization to avoid payload overflow.

  case "get_collection_bids": {
    const raw = await api.getBids({
      bidder: args.bidder,
      status: args.status,
      limit: args.limit ?? 50,
      chainId: args.chain_id ?? 1,
    });
    // Bug 5 fix: summarize to avoid payload overflow
    return ok(summarizeBidsResponse(raw));
  }

• src/tools.ts:174-183 (schema)

  The definition and input schema for the "get_collection_bids" tool.

  get_collection_bids: {
    description:
      "Get collection bids from bids.cryptopunks.app — EIP-712 signed bids that cover sets of punks. Returns summarized bid metadata (UUID, bidder, amount, punk count, status) to avoid payload overflow. For full punk lists and proofs, use get_bid_proofs with a specific bid UUID.",
    inputSchema: z.object({
      bidder: ethAddress.optional().describe("Filter by bidder Ethereum address"),
      status: bidStatus.optional().describe("Filter by status. Try 'pending' for active bids."),
      limit: z.number().int().min(1).max(100).optional().default(50),
      chain_id: z.number().int().optional().default(1),
    }),
  },