cryptopunks-mcp-server

Instructions

Implementation Reference

• src/api.ts:119-121 (handler)

  The implementation of getPunkHistory, which calls the POST endpoint for transaction history.

  export async function getPunkHistory(punkIndex: number) {
    return post(DATA_BASE, `/api/punks/${punkIndex}/details`, {});
  }

• src/tools.ts:74-78 (registration)

  Tool definition for get_punk_history.

  get_punk_history: {
    description:
      "Get the full transaction history for a specific CryptoPunk from initial claim through all transfers, offers, bids, and sales. Each event includes type, from/to addresses with ENS, amount in wei and USD, timestamp, and transaction hash. Uses the POST endpoint for reliable history retrieval.",
    inputSchema: z.object({ punk_index: punkIndex }),
  },

• src/handlers.ts:238-242 (handler)

  The handler logic that invokes the API client for get_punk_history.

  case "get_punk_history": {
    const result = await api.getPunkHistory(args.punk_index);
    return ok(result);
  }