MCP Server
Lightyear CryptoPunks
io.github.Lightyear-Technologies-Limited/cryptopunks
What this MCP does
Browses CryptoPunks traits and metadata, filters punk sets, and retrieves marketplace listings, bids, floor prices, Merkle roots, and bid recommendations.
Capabilities
Tools
11
tools
browse_traits
List all CryptoPunk traits with their counts. Optionally filter by type to see how many punks of that type have each trait. Rate limit: 10 per 10 min (read bucket â shared with browse_types, get_punk_details, get_listings, get_floor_price, get_bids_for_punk, get_bids_for_merkle_root).
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'type': {'type': 'string', 'description': "Filter counts to a specific type (e.g. 'Male', 'Zombie')"}}, 'additionalProperties': False}
browse_types
List all CryptoPunk type categories with their counts. Rate limit: 10 per 10 min (read bucket â shared with browse_traits, get_punk_details, get_listings, get_floor_price, get_bids_for_punk, get_bids_for_merkle_root).
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
compute_merkle_root
Compute the Merkle root for a set of CryptoPunk IDs. The root matches the on-chain Solady MerkleProofLib encoding used by the Stash contract. Rate limit: 5 per 10 min (compute bucket â shared with filter_punks, resolve_merkle_root).
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['punkIds'], 'properties': {'punkIds': {'type': 'array', 'items': {'type': 'integer', 'maximum': 9999, 'minimum': 0}, 'maxItems': 10000, 'minItems': 1, 'description': 'Punk IDs to include in the Merkle tree (1-10000)'}}, 'additionalProperties': False}
filter_punks
Filter CryptoPunks by type and traits. Returns matching punk IDs and their Merkle root. Rate limit: 5 per 10 min (compute bucket â shared with compute_merkle_root, resolve_merkle_root).
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'types': {'type': 'array', 'items': {'type': 'string'}, 'description': "Type names to include (e.g. ['Male', 'Zombie']). Empty = all types."}, 'matchMode': {'enum': ['all', 'any'], 'type': 'string', 'default': 'all', 'description': "'all' = punk must have every included trait, 'any' = at least one"}, 'excludedTraits': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Traits to exclude'}, 'includedTraits': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Traits to include'}}, 'additionalProperties': False}
get_bid_recommendation
Analyze market data and recommend a bid price range for a CryptoPunk trait selection. Combines floor price, competing bids, and set composition into actionable guidance. `composition` lists only the traits that define the selection; use `absentTraits` for a full exclusion list when needed. Rate limit: 1 per 1 min (recommend bucket).
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'types': {'type': 'array', 'items': {'type': 'string'}, 'description': "Type names to filter (e.g. ['Male', 'Zombie'])"}, 'punkIds': {'type': 'array', 'items': {'type': 'integer', 'maximum': 9999, 'minimum': 0}, 'description': 'Explicit punk IDs (overrides trait filters)'}, 'matchMode': {'enum': ['all', 'any'], 'type': 'string', 'default': 'all'}, 'excludedTraits': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Traits to exclude'}, 'includedTraits': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Traits to include'}}, 'additionalProperties': False}
get_bids_for_merkle_root
Get pending EIP-712 bids matching a specific Merkle root. Useful for seeing competition on a trait-based bid set. Rate limit: 10 per 10 min (read bucket â shared with browse_types, browse_traits, get_punk_details, get_listings, get_floor_price, get_bids_for_punk).
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['merkleRoot'], 'properties': {'limit': {'type': 'integer', 'default': 5, 'maximum': 20, 'minimum': 1, 'description': 'Max bids to return (default 5)'}, 'merkleRoot': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{64}$', 'description': 'Merkle root (0x-prefixed, 32 bytes hex)'}}, 'additionalProperties': False}
get_bids_for_punk
Get pending EIP-712 bids that include a specific CryptoPunk. Returns bids from the CryptoPunks Bids API. Rate limit: 10 per 10 min (read bucket â shared with browse_types, browse_traits, get_punk_details, get_listings, get_floor_price, get_bids_for_merkle_root).
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['punkId'], 'properties': {'limit': {'type': 'integer', 'default': 5, 'maximum': 20, 'minimum': 1, 'description': 'Max bids to return (default 5)'}, 'punkId': {'type': 'integer', 'maximum': 9999, 'minimum': 0, 'description': 'Punk ID to look up bids for'}}, 'additionalProperties': False}
get_floor_price
Get the current floor ask price from the native CryptoPunks marketplace. Excludes restricted (onlySellTo) and zero-value listings. Returns `totalActive` (same denominator as get_listings). Rate limit: 10 per 10 min (read bucket â shared with browse_types, browse_traits, get_punk_details, get_listings, get_bids_for_punk, get_bids_for_merkle_root).
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_listings
Get currently listed CryptoPunks from the native marketplace. By default returns only publicly buyable listings (excludes restricted onlySellTo and zero-value entries); pass `includeRestricted: true` to include private bundle sales. Optionally filter by price range. Returns `totalActive` (publicly buyable listings, same denominator as get_floor_price) and `matchedCount` (after your filters). Rate limit: 10 per 10 min (read bucket â shared with browse_types, browse_traits, get_punk_details, get_floor_price, get_bids_for_punk, get_bids_for_merkle_root).
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'default': 50, 'maximum': 200, 'minimum': 1, 'description': 'Max results (default 50)'}, 'maxPriceEth': {'type': 'number', 'description': 'Maximum price in ETH'}, 'minPriceEth': {'type': 'number', 'description': 'Minimum price in ETH'}, 'includeRestricted': {'type': 'boolean', 'default': False, 'description': 'Include restricted (onlySellTo) and zero-value listings. Default false â\x80\x94 matches get_floor_price.'}}, 'additionalProperties': False}
get_punk_details
Get metadata for specific CryptoPunks: type, traits with rarity percentages, and permalink. Rate limit: 10 per 10 min (read bucket â shared with browse_types, browse_traits, get_listings, get_floor_price, get_bids_for_punk, get_bids_for_merkle_root).
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['punkIds'], 'properties': {'punkIds': {'type': 'array', 'items': {'type': 'integer', 'maximum': 9999, 'minimum': 0}, 'maxItems': 100, 'minItems': 1, 'description': 'Punk IDs to look up (1-100)'}}, 'additionalProperties': False}
resolve_merkle_root
Reverse-engineer a Merkle root back to its punk IDs and inferred trait selection. ONLY works for roots that already have at least one bid in the CryptoPunks Bids API â this tool looks bids up by root, then derives trait config from the resulting punk set. Returns `resolved: false` for unknown roots; constructing a root locally and passing it here will not work. Rate limit: 5 per 10 min (compute bucket â shared with filter_punks, compute_merkle_root).
Read only
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['merkleRoot'], 'properties': {'merkleRoot': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{64}$', 'description': 'Merkle root to resolve (0x-prefixed, 32 bytes hex)'}}, 'additionalProperties': False}
History
Recent tool changes
Added
resolve_merkle_root
Sept. 17, 2026, 12:43 p.m.
Added
get_bid_recommendation
Sept. 17, 2026, 12:43 p.m.
Added
get_bids_for_merkle_root
Sept. 17, 2026, 12:43 p.m.
Added
get_bids_for_punk
Sept. 17, 2026, 12:43 p.m.
Added
get_floor_price
Sept. 17, 2026, 12:43 p.m.
Added
get_listings
Sept. 17, 2026, 12:43 p.m.
Added
compute_merkle_root
Sept. 17, 2026, 12:43 p.m.
Added
get_punk_details
Sept. 17, 2026, 12:43 p.m.
Added
filter_punks
Sept. 17, 2026, 12:43 p.m.
Added
browse_traits
Sept. 17, 2026, 12:43 p.m.
Added
browse_types
Sept. 17, 2026, 12:43 p.m.
Discover
Similar MCP servers
apex-x1
xyz.apexfaucet/apex-x1
Provides X1 and Arc token screening, liquidity and exit-risk checks, wallet and bridge data, non-custodial token operations, comm…
AgentLux
io.github.agentlux/agentlux
Operates an agent avatar marketplace with item generation, purchases, creator earnings, public profiles, social activity, and ERC…
API Acre
com.apiacre/api-acre
Offers paid APIs for EVM blockchain inspection, data transformation and validation, geocoding, weather, currency conversion, and …
agentic-commerce
io.bosonprotocol/agentic-commerce
Enables on-chain commerce through Boson Protocol, including product offers, buyer and seller accounts, voucher exchanges, escrow-…
Wever Pay Open Exchange Public Beta
com.weverpay/public-testnet-alpha
Runs a Base Sepolia testnet exchange for agent participants, supporting wallets, USDC balances, signed offers, authorized purchas…
Real Real Genuine
io.github.richardjhobbs/rrg-marketplace
Enables browsing fashion brands and listings, submitting designs, purchasing digital or physical products, referrals, vouchers, l…
Opensea
io.github.pipeworx-io/opensea
Provides OpenSea NFT marketplace data for collections, NFTs, ownership, collection statistics, traits, and sales.
Loyal Spark
io.github.aspekt19/loyal-spark
Creates and operates token-based loyalty programs on Base, including minting, rewards, vouchers, customer balances, analytics, of…