cryptopunks-mcp-server

Instructions

Implementation Reference

• src/handlers.ts:369-376 (handler)

  The handler function in src/handlers.ts calls the API function getAllCollectionBids and processes the response through summarizeBidsResponse to prevent large payload issues.

  case "get_all_collection_bids": {
    const raw = await api.getAllCollectionBids({
      limit: args.limit ?? 100,
      status: args.status,
      chainId: args.chain_id ?? 1,
    });
    return ok(summarizeBidsResponse(raw));
  }

• src/api.ts:218-228 (helper)

  The API function in src/api.ts performs the actual HTTP GET request to the CryptoPunks bids service.

  export async function getAllCollectionBids(params?: {
    limit?: number;
    status?: string;
    chainId?: number;
  }) {
    const p: Record<string, string> = {};
    if (params?.limit) p.limit = String(Math.min(params.limit ?? 100, 1000));
    if (params?.status) p.status = params.status;
    if (params?.chainId) p.chainId = String(params.chainId);
    return get(BIDS_BASE, "/api/v1/bids/all", p);
  }

• src/tools.ts:195-203 (registration)

  The tool definition and schema registration in src/tools.ts defines the parameters for the get_all_collection_bids tool.

  get_all_collection_bids: {
    description:
      "Get all collection bids ordered by creation date (most recent first). Returns summarized bid metadata. Higher limit than get_collection_bids — up to 1000.",
    inputSchema: z.object({
      limit: z.number().int().min(1).max(1000).optional().default(100),
      status: bidStatus.optional().describe("Filter by status. Try 'pending' for active bids."),
      chain_id: z.number().int().optional().default(1),
    }),
  },