mcpbeat Sign in

Lightyear CryptoPunks MCP Server

by lightyear-technologies-limited Your server? Claim it
answering

Lightyear CryptoPunks is answering right now. Last checked 7 min ago. It exposes 11 tools.

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

Uptime history 52 days of history · worst day 64%
52 days agonow
90.1%
Uptime 24h
82 of 91 checks
11
Tools
read from the server
398 ms
Response time
average over 24h
open, no key
Access
streamable-http

Lightyear CryptoPunks does not always answer

Over the last week it answered 91.7% of our checks. We check every 15 minutes, so you hear about the next outage within the hour — not from your users.

Three servers free · no card

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 7 min ago.

run in your terminal
claude mcp add cryptopunks --transport http https://punks.lightyear.build/api/mcp
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "cryptopunks": {
      "url": "https://punks.lightyear.build/api/mcp"
    }
  }
}
~/.codex/config.toml
[mcp_servers.cryptopunks]
url = "https://punks.lightyear.build/api/mcp"
.cursor/mcp.json
{
  "mcpServers": {
    "cryptopunks": {
      "url": "https://punks.lightyear.build/api/mcp"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "cryptopunks": {
      "url": "https://punks.lightyear.build/api/mcp"
    }
  }
}

Available tools 11

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

bids
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_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).
browse
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).
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).
bid
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).
compute
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).
filter
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).
floor
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).
listings
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).
punk
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).
resolve
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).

Endpoints

URLTransportStateLatencyChecked
https://punks.lightyear.build/api/mcp streamable-http answering 419 ms 7 min ago

Alternatives to Lightyear CryptoPunks

same job, measured the same way
Finance MCP
by adididitagain

Live stock, crypto, SEC filings, insider trades, FX and macro data for LLM agents.

75 installs/wk local only
Agent Toolbelt
by rccola990-cloud

MCP tools for AI agents: fetch any URL as clean text, live crypto prices, review & bid drafting.

20 installs/wk local only
Coinrebate
by halffee

Compliance-filtered crypto exchange fee comparison and rebate-link routing for AI agents.

270 installs/wk 12 tools answering
Agent Data Pro
by orionsmithers

Research articles and live crypto prices for AI agents via x402 on Base.

4 tools answering
Fxabsolute
by varsansri

Five years of 1-minute forex, index and crypto candles, plus a live bridge to a trader's chart.

32 installs/wk local only
Spawnpay
by robocular

Crypto wallets, payments, and referral earnings for AI agents on Base L2

25 installs/wk local only
Arbitron
by arbitron

Funding rates, cross-venue spreads and listings for crypto perpetual futures. Read-only.

answering
AIsa Finance
by aisa

Prices, fundamentals, filings, crypto and prediction markets, for agents.

answering

Lightyear CryptoPunks — questions

Answers built from our own checks of this server.

What can Lightyear CryptoPunks do?
It exposes 11 tools, read directly from the server on our last check. Among them: browse_traits, browse_types, compute_merkle_root, filter_punks, get_bid_recommendation, get_bids_for_merkle_root and 5 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →
What is Lightyear CryptoPunks mostly used for?
Its tools cluster around browse and bids. That is what this server is built to work with — the grouping comes from the actual tool names, not from a category we assigned.
Is Lightyear CryptoPunks working right now?
We send a real MCP handshake every 15 minutes. Over the last 24 hours 82 of 91 checks got a reply (90.1%), average response time 398 ms. The bar chart above shows every period we have measured.
How do I connect Lightyear CryptoPunks?
Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.
Does Lightyear CryptoPunks need an API key?
No. Lightyear CryptoPunks completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 11 of them are readable on this page. This is what we observed, not what the docs claim.
How fast is Lightyear CryptoPunks?
It answers our handshake in 398 ms on average, which is faster than 43% of all working MCP servers we measure. The comparison comes from our own checks across the whole registry, every 15 minutes.