cryptopunks-mcp-server

Instructions

Implementation Reference

• src/handlers.ts:359-367 (handler)

  The handler for `get_top_collection_bids` tool, which fetches top bids from the API using `api.getTopBids`.

  case "get_top_collection_bids": {
    // Bug 6 fix: default to "pending" status since unfiltered may return empty
    const raw = await api.getTopBids({
      limit: args.limit ?? 10,
      status: args.status ?? "pending",
      chainId: args.chain_id ?? 1,
    });
    return ok(summarizeBidsResponse(raw));
  }

• src/tools.ts:185-193 (schema)

  The registration and input schema definition for `get_top_collection_bids`.

  get_top_collection_bids: {
    description:
      "Get the highest collection bids ordered by bid amount descending. Returns summarized bid metadata. Tip: try status 'pending' if default returns empty results.",
    inputSchema: z.object({
      limit: z.number().int().min(1).max(100).optional().default(10),
      status: bidStatus.optional().describe("Filter by status. Try 'pending' for active bids."),
      chain_id: z.number().int().optional().default(1),
    }),
  },