MCP server

Lightyear CryptoPunks

io.github.Lightyear-Technologies-Limited/cryptopunks

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

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

At a glance

Type

MCP server

Publisher

Not verified

Status

Working at last check

Tools

11

Token cost

About 2,220 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http cryptopunks https://punks.lightyear.build/api/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.cryptopunks]
url = "https://punks.lightyear.build/api/mcp"

Gemini CLI

{"mcpServers":{"cryptopunks":{"httpUrl":"https://punks.lightyear.build/api/mcp"}}}

Cursor

{"mcpServers":{"cryptopunks":{"url":"https://punks.lightyear.build/api/mcp"}}}

VS Code

{"servers":{"cryptopunks":{"type":"http","url":"https://punks.lightyear.build/api/mcp"}}}

Antigravity

agy mcp add cryptopunks https://punks.lightyear.build/api/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"cryptopunks","server_url":"https://punks.lightyear.build/api/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"cryptopunks","server_url":"https://punks.lightyear.build/api/mcp"}

Tools

• browse_traits Browses the web · ~158 tokens
  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 Browses the web · ~103 tokens
  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).
• compute_merkle_root ~174 tokens
  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_punks ~236 tokens
  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_bid_recommendation ~293 tokens
  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
• get_bids_for_merkle_root ~201 tokens
  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 ~191 tokens
  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_floor_price ~141 tokens
  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_listings ~326 tokens
  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_punk_details ~172 tokens
  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_merkle_root ~225 tokens
  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;

Browse

• GitHub tools
• GitHub and code hosting
• Stocks and markets
• Crypto and blockchains

Related MCP servers

• Singularity Layer MCP
  MCP for Singularity Layer - discover listings, manage assets, run payment flows, and use agents
• BezBaseina
  Latvian property portal: search rentals, sales & nightly stays; market stats; owner tools via OAuth.
• AgentLux
  Hosted AgentLux MCP server for marketplace, identity, creator, services, and social flows.
• Sellular
  Track where your product is listed, score its AI search visibility, and audit a domain's SEO.
• Himalayas Remote Jobs
  Remote jobs: job search, salary data and application tracking, or post a job and hire candidates
• CodeTrendy
  Search the CodeTrendy directory of websites and tools. Read-only, no API key.
• Marktplaats & 2dehands
  Search Marktplaats & 2dehands (NL/BE classifieds), vet sellers, compare prices, use your account.
• Makeroo
  Search the Makeroo product directory and submit your product from your own agent.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.Lightyear-Technologies-Limited/cryptopunks.svg)](https://aptlynx.net/servers/io.github.Lightyear-Technologies-Limited/cryptopunks)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents