cryptopunks-mcp-server

Instructions

Implementation Reference

• src/handlers.ts:384-392 (handler)

  The handler implementation for the get_collection_bids_for_punk tool, which calls api.getBidsForPunk and summarizes the result.

  case "get_collection_bids_for_punk": {
    const raw = await api.getBidsForPunk(args.punk_index, {
      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:213-222 (schema)

  The MCP tool registration and input schema definition for get_collection_bids_for_punk.

  get_collection_bids_for_punk: {
    description:
      "Get all collection bids that cover a specific CryptoPunk. Returns summarized bid metadata. For Merkle proofs needed for on-chain settlement, use get_bid_proofs with the bid UUID.",
    inputSchema: z.object({
      punk_index: punkIndex,
      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),
    }),
  },