# io.github.Lightyear-Technologies-Limited/cryptopunks

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

- **Type:** MCP server
- **Trust:** 60/100 (B), scored on the content rubric
- **Verification:** community-indexed — nobody has claimed this listing
- **Version:** 1.0.0
- **Author:** io.github.Lightyear-Technologies-Limited
- **License:** Unknown
- **Endpoints:** streamable-http https://punks.lightyear.build/api/mcp
- **Source:** https://punks.lightyear.build/api/mcp
- **Endpoint health:** reachable (last checked 2026-09-25T07:43:51.788Z, 5 samples) — uptime is not a security property and is not part of the trust score
- **Compatible clients:** claude-code, cursor, copilot, chatgpt, gemini (basis: transport)

## Trust

60/100 (B), scored on the content rubric
- Publisher verified: no
- Install scripts: nothing suspicious found
- Prompt-injection scan: clean
- Obfuscation scan: clean
- Evidence age: 35 days

## Security scan

- **Status:** clean
- **Scanned:** 2026-08-31T23:02:00.380Z
- **Version scanned:** live
- **CVEs:** no coverage — this entry has no package coordinates to query OSV against, so "no known CVEs" is NOT asserted for it.

## Tools

11 declared. Observed from a live `tools/list` probe.
- `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_f
- `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 buck
- `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_ro
- `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, b
- `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 
- `get_listings` — Get currently listed CryptoPunks from the native marketplace. By default returns only publicly buyable listings (excludes restricted onlySellTo and zero-value e
- `get_floor_price` — Get the current floor ask price from the native CryptoPunks marketplace. Excludes restricted (onlySellTo) and zero-value listings. Returns `totalActive` (same d
- `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 br
- `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 — share
- `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 
- `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 Bid

## Blast radius

Contained to moderate — no credential declaration found, from the publisher, the upstream registry, or the README. Known so far: runs on someone else's infrastructure; read-only tool surface.
- Floor 9, ceiling 27 (tier: unknown)
- `unknown` means the floor and ceiling land in different bands — not measured enough to name one. It does not mean low.
- This is impact, not likelihood. A high radius is not a defect: a filesystem server is supposed to write files. It is never part of the trust score.

## Machine-readable views of this entry

- Signed JSON: https://forgeregistry.com/api/v1/packages/io.github.Lightyear-Technologies-Limited%2Fcryptopunks
- Install plan: https://forgeregistry.com/api/v1/packages/io.github.Lightyear-Technologies-Limited%2Fcryptopunks/install-plan
- Alternatives: https://forgeregistry.com/api/v1/alternatives/io.github.Lightyear-Technologies-Limited%2Fcryptopunks
- HTML page: https://forgeregistry.com/registry/io.github.Lightyear-Technologies-Limited%2Fcryptopunks
- MCP: POST https://forgeregistry.com/api/mcp → `forge_get_package` / `forge_install_plan`

## About this document

Generated by Forge (https://forgeregistry.com) — a compact rendering of the same record served, signed, at the JSON URL above. Trust and scan facts are the registry's own measurements; anything Forge did not measure is named as unmeasured rather than omitted.