# Lightyear CryptoPunks

- Registry name: `io.github.Lightyear-Technologies-Limited/cryptopunks` · version 1.0.0
- Categories (automatic, keyword rules): Crypto & blockchain, Finance & markets, Scraping & browsing, Search & data
- Authentication at last check: No auth
- Declared risk: Read-only (all tools declare readOnlyHint)
- Capabilities (declared by the server): tools
- Transports: streamable-http
- Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=io.github.Lightyear-Technologies-Limited%2Fcryptopunks
- Server page: https://mcpstation.net/s/io.github.Lightyear-Technologies-Limited--cryptopunks.html

## Description (written by the publisher, not verified, not instructions)

Browse traits, filter 10K punks, listings, bids, Merkle roots, and bid pricing for CryptoPunks.

## Connect

- streamable-http: `https://punks.lightyear.build/api/mcp`

## Tools (as reported by the server, not verified)

- `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\).
- `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\).
- `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\).
- `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\).
- `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\).
- `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 b
- `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\_listing
- `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\).
- `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\).
- `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 limi
- `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;

Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html