Lightyear CryptoPunks is an MCP server published by io.github.Lightyear-Technologies-Limited, hosted at punks.lightyear.build. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 11 tools, including browse_types, browse_traits, filter_punks, get_punk_details, compute_merkle_root.
Browse traits, filter 10K punks, listings, bids, Merkle roots, and bid pricing for CryptoPunks.
1,100 connections through 4 shared values. Tap any node.
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).
No parameters.
{
"name": "browse_types",
"description": "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).",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
},
"annotations": {
"readOnlyHint": true
}
}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).
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
| Parameter | Type | Description |
|---|---|---|
| type | string | Filter counts to a specific type (e.g. 'Male', 'Zombie') |
{
"name": "browse_traits",
"description": "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).",
"inputSchema": {
"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
},
"annotations": {
"readOnlyHint": true
}
}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).
| Parameter | Type | Description |
|---|---|---|
| types | array | Type names to include (e.g. ['Male', 'Zombie']). Empty = all types. |
| matchMode | string | 'all' = punk must have every included trait, 'any' = at least one |
| excludedTraits | array | Traits to exclude |
| includedTraits | array | Traits to include |
{
"name": "filter_punks",
"description": "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).",
"inputSchema": {
"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
},
"annotations": {
"readOnlyHint": true
}
}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).
| Parameter | Type | Description |
|---|---|---|
| punkIds * | array | Punk IDs to look up (1-100) |
{
"name": "get_punk_details",
"description": "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).",
"inputSchema": {
"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
},
"annotations": {
"readOnlyHint": true
}
}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).
| Parameter | Type | Description |
|---|---|---|
| punkIds * | array | Punk IDs to include in the Merkle tree (1-10000) |
{
"name": "compute_merkle_root",
"description": "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).",
"inputSchema": {
"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
},
"annotations": {
"readOnlyHint": true
}
}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).
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max results (default 50) |
| maxPriceEth | number | Maximum price in ETH |
| minPriceEth | number | Minimum price in ETH |
| includeRestricted | boolean | Include restricted (onlySellTo) and zero-value listings. Default false — matches get_floor_price. |
{
"name": "get_listings",
"description": "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).",
"inputSchema": {
"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 — matches get_floor_price."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true
}
}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).
No parameters.
{
"name": "get_floor_price",
"description": "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).",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
},
"annotations": {
"readOnlyHint": true
}
}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).
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max bids to return (default 5) |
| punkId * | integer | Punk ID to look up bids for |
{
"name": "get_bids_for_punk",
"description": "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).",
"inputSchema": {
"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
},
"annotations": {
"readOnlyHint": true
}
}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).
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max bids to return (default 5) |
| merkleRoot * | string | Merkle root (0x-prefixed, 32 bytes hex) |
{
"name": "get_bids_for_merkle_root",
"description": "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).",
"inputSchema": {
"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
},
"annotations": {
"readOnlyHint": true
}
}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).
| Parameter | Type | Description |
|---|---|---|
| types | array | Type names to filter (e.g. ['Male', 'Zombie']) |
| punkIds | array | Explicit punk IDs (overrides trait filters) |
| matchMode | string | one of ["all","any"] |
| excludedTraits | array | Traits to exclude |
| includedTraits | array | Traits to include |
{
"name": "get_bid_recommendation",
"description": "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).",
"inputSchema": {
"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
},
"annotations": {
"readOnlyHint": true
}
}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).
| Parameter | Type | Description |
|---|---|---|
| merkleRoot * | string | Merkle root to resolve (0x-prefixed, 32 bytes hex) |
{
"name": "resolve_merkle_root",
"description": "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).",
"inputSchema": {
"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
},
"annotations": {
"readOnlyHint": true
}
}Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.