cryptopunks-mcp-server

Get basic information about a specific CryptoPunk: owner address, type, attributes, current asking price, current bid, and whether it is for sale. NOTE: the type field from this endpoint may be unreliable for non-human punks (Aliens, Apes, Zombies). Use get_punk_metadata or get_punk_traits for accurate type data.

Get full details for a specific CryptoPunk including owner, for-sale price, active bid, all attributes, and optionally the complete transaction history (transfers, sales, bids, offers). When include_history is true, history is fetched via the reliable POST endpoint.

Get lightweight metadata for a CryptoPunk: type, type name, attributes array, and attribute count. This is the most reliable endpoint for accurate type classification (Male/Female/Alien/Ape/Zombie).

Get the URL for a 1024×1024 PNG image of a specific CryptoPunk. Supports transparent background, custom hex background color, and optional overlays (for-sale, has-bid, transfer indicators). Returns a URL string — fetch it to retrieve the image binary.

Get the traits (attributes) for a specific CryptoPunk: type, type name, attributes array, and count. Returns accurate type data for all punk types including Aliens, Apes, and Zombies.

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.

Get the current floor price of CryptoPunks — the lowest active asking price across the entire collection. Returns value in ETH. For full details on the floor punk itself, use get_floor_punk instead.

Get the specific CryptoPunk currently listed at the floor price — the cheapest punk for sale right now, with its full details including index, owner, price, and attributes.

Get the most recent sales across the CryptoPunks collection. Returns buyer, seller, sale price in wei and USD, timestamp, and transaction hash. Count is capped at 50.

Get the all-time highest sales in the CryptoPunks collection, ordered by sale value descending.

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.

Get all CryptoPunks that currently have an active native bid placed directly on them via the CryptoPunks marketplace contract. Note: these are on-chain native bids, different from off-chain collection bids (use get_collection_bids for those).

Get global CryptoPunks market statistics: current floor price, total supply, number listed for sale, number with bids, total volume, and other aggregate market data. This is the best endpoint for a market overview.

Get trait distribution statistics across the entire 10,000 CryptoPunks collection — how many punks have each attribute, enabling rarity analysis.

Get the top CryptoPunks holders leaderboard ranked by number of punks owned.

Get recent transaction history for multiple CryptoPunks in a single request. Useful for comparing activity across a set of punks. Maximum 50 punk indices per call.

Get comprehensive portfolio data for any Ethereum wallet or ENS name: owned punks, punks for sale, active bids placed and received, full buy/sell history, realized PnL, and total trading volume. This is the most information-dense endpoint in the API.

Get collection bids from bids.cryptopunks.app — EIP-712 signed bids that cover sets of punks. Returns summarized bid metadata (UUID, bidder, amount, punk count, status) to avoid payload overflow. For full punk lists and proofs, use get_bid_proofs with a specific bid UUID.

Get the highest collection bids ordered by bid amount descending. Returns summarized bid metadata. Tip: try status 'pending' if default returns empty results.

Get all collection bids ordered by creation date (most recent first). Returns summarized bid metadata. Higher limit than get_collection_bids — up to 1000.

Get a specific collection bid by its UUID, including full details, signature, status, and covered punk count. For Merkle proofs, use get_bid_proofs with the same UUID.

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.

Get the Merkle proofs for every punk index covered by a specific collection bid. Required for on-chain settlement when accepting a collection bid. Use the bid UUID from any of the collection bid listing tools.

Generate a Merkle root for a set of CryptoPunk indices. Pure computation, no wallet required. Used as the first step in constructing a collection bid.

Generate a Merkle proof for a single punk within a set of punk indices. Pure computation, no wallet required. Used to prove a specific punk is included in a collection bid for on-chain settlement.

Verify that a Merkle proof is valid for a given punk index and Merkle root. Pure computation, no wallet required.

Generate Merkle proofs for multiple target punks within a set in a single request. Pure computation, no wallet required. More efficient than calling generate_merkle_proof repeatedly.

Verify Merkle proofs for multiple punks against a single Merkle root. Pure computation, no wallet required. Returns a result per punk index.