cryptopunks-mcp-server

Instructions

Implementation Reference

• src/handlers.ts:293-305 (handler)

  The handler logic for the 'get_all_offers' tool, which calls api.getOfferedPunks and includes error handling for upstream HTTP 500 responses.

  case "get_all_offers": {
    // Bug 4 fix: the upstream API returns HTTP 500 for this endpoint.
    // Catch and return a helpful error directing users to alternatives.
    try {
      const result = await api.getOfferedPunks();
      return ok(result);
    } catch (e) {
      const message = e instanceof Error ? e.message : String(e);
      if (message.includes("500")) {
        return err(
          "The upstream CryptoPunks API returned HTTP 500 for the 'offered' endpoint — this is a known server-side issue. " +
          "Alternatives: use get_market_stats for aggregate offer data (count of listed punks, floor price), " +
          "or get_floor_punk for the cheapest current listing."

• src/tools.ts:115-119 (registration)

  Registration and schema definition for the 'get_all_offers' tool.

  get_all_offers: {
    description:
      "Get all CryptoPunks currently listed for sale. KNOWN ISSUE: this endpoint may return HTTP 500 from the upstream API server. If it fails, use get_market_stats as an alternative for aggregate offer data, or get_floor_punk for the cheapest listing.",
    inputSchema: z.object({}),
  },