protogrid

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

Lightyear CryptoPunks

R0· no sign-in

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

v1.0.0 · active · descriptor JSON · versions

An agent can connect right now, no human step.Remote endpoint, no authentication, reachable on the last probe.
Quality85good
Trust66of 100
Uptime, 30 days100%
Latency p50443 ms

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "cryptopunks": {
      "type": "http",
      "url": "https://punks.lightyear.build/api/mcp"
    }
  }
}
claude mcp add --transport http cryptopunks https://punks.lightyear.build/api/mcp
[mcp_servers.cryptopunks]
url = "https://punks.lightyear.build/api/mcp"
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "cryptopunks": {
      "type": "remote",
      "url": "https://punks.lightyear.build/api/mcp",
      "enabled": true
    }
  }
}
{
  "mcpServers": {
    "cryptopunks": {
      "type": "http",
      "url": "https://punks.lightyear.build/api/mcp"
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=cryptopunks&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vcHVua3MubGlnaHR5ZWFyLmJ1aWxkL2FwaS9tY3AifQ%3D%3D"
}
{
  "servers": {
    "cryptopunks": {
      "type": "http",
      "url": "https://punks.lightyear.build/api/mcp"
    }
  }
}
{
  "mcpServers": {
    "cryptopunks": {
      "httpUrl": "https://punks.lightyear.build/api/mcp"
    }
  }
}
extensions:
  "cryptopunks":
    enabled: true
    name: "cryptopunks"
    type: streamable_http
    uri: "https://punks.lightyear.build/api/mcp"
    timeout: 300

Quality 85 / 100good

protocol75 · weight 25
  • warn
    protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
  • n/a
    protocol.statelessonly applies to 2026-07-28 servers
  • pass
    protocol.transportstreamable HTTP
  • n/a
    protocol.list_ttlonly applies to 2026-07-28 servers
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygiene86 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • pass
    tools.description_lengthdescriptions are concise
  • pass
    tools.schemasevery tool has an object input schema
  • pass
    tools.annotations11 of 11 tools declare readOnlyHint or destructiveHint
  • fail
    tools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: browse_traits (destructiveHint, idempotentHint, openWorldHint); filter_punks (destructiveHint, idempotentHint, openWorldHint); get_punk_details (destructiveHint, idempotentHint, openWorldHint); …
  • pass
    tools.token_costabout 1,875 tokens to load every tool
  • pass
    tools.api_dumptools are not a one-to-one API dump
stability100 · weight 15
  • pass
    stability.changesno tool changes in 30 days
  • pass
    stability.rug_pullno tool changed its meaning under the same name
dependenciesn/a · weight 15
  • n/a
    deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

11 tools, about 1,875 tokens to load them all · tool set c651eda94174 · checked 2026-10-20 16:30 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 66 / 100

no-repository
provenance35
liveness100
freshness45
hygiene80

+reachable +uptime-100% -stale-204d -no-repository

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://punks.lightyear.build/api/mcp streamable-httpnoneyes100%443 ms2025-11-252026-10-20

Tools (11)

browse_traitsread-onlyList 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_typesread-onlyList 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_rootread-onlyCompute 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_punksread-onlyFilter 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_recommendationread-onlyAnalyze 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).
get_bids_for_merkle_rootread-onlyGet 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_punkread-onlyGet 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_priceread-onlyGet 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).
get_listingsread-onlyGet 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).
get_punk_detailsread-onlyGet 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_rootread-onlyReverse-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).

Schemas: list_tools.

Similar MCP servers

Official server.json
{
  "name": "io.github.Lightyear-Technologies-Limited/cryptopunks",
  "title": "Lightyear CryptoPunks",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://punks.lightyear.build/api/mcp",
      "type": "streamable-http"
    }
  ],
  "version": "1.0.0",
  "description": "Browse traits, filter 10K punks, listings, bids, Merkle roots, and bid pricing for CryptoPunks."
}