Lightyear MCP

Tool catalog

Use these tools from your AI agent. Sign in to top up & track usage →

39 tools registered. Pricing is in USD cents per call. Tools at are introspection / metadata and bypass billing entirely.

Tool Source Latency Cost Available
cdi_get_address_entity
Classify a wallet as `eoa | contract | wrapper | vault | lending | strategy | marketplace_router | …`, with an integer confidence score (0..100; locked under CDI #130) and the source attribution (e.g. `manual:cryptopunks`, `manual:yuga`, heuristic clustering tag).
cdi ~1s Typical upstream call (CDI / on-chain RPC / Bids API). available
cdi_get_collection
Collection-level composite bundle: stats + floor listings + top bids in one round-trip.
cdi ~1s Typical upstream call (CDI / on-chain RPC / Bids API). available
cdi_get_collection_lending_stats
Collection-level loan stats — lifetime (originated / repaid / foreclosed + foreclosure rate), currently-active (active loans, outstanding WETH principal, % of supply collateralised, weighted-avg APR), and the top-5 borrowers + top-5 lenders by outstanding principal.
cdi ~1s Typical upstream call (CDI / on-chain RPC / Bids API). available
cdi_get_collection_pnl_leaderboard
Top wallets by realized + unrealized PnL on one collection.
cdi ~1s Typical upstream call (CDI / on-chain RPC / Bids API). available
cdi_get_connected_wallets
CryptoPunks-specific connected-wallets lookup — given a wallet, surface other wallets it has transferred punks to/from or co-held punks with, ranked by `sharedTokens` count.
cdi ~1s Typical upstream call (CDI / on-chain RPC / Bids API). available
cdi_get_entity_profile
Return the curated entity cluster (SEED_CLUSTER) that contains a given wallet, or null when the wallet is not part of any manually-verified cluster.
cdi <1s Pure compute or a single cached read. available
cdi_get_events
Generic event history (sale / bid / transfer / listing / claim) for a collection, newest first.
cdi ~1s Typical upstream call (CDI / on-chain RPC / Bids API). available
cdi_get_floor_history
Time-series floor price for a CryptoPunks-class collection.
cdi ~1s Typical upstream call (CDI / on-chain RPC / Bids API). available
cdi_get_floor_listings_enriched
Top-N floor listings each enriched with token metadata + most recent sale.
cdi ~1s Typical upstream call (CDI / on-chain RPC / Bids API). available
cdi_get_punk_state
Composite per-punk state: current owner (with depositor/stash attribution), wrap status, active listing, top covering bid, last sale.
cdi <1s Pure compute or a single cached read. available
cdi_get_wallet_loans
A wallet's borrow + lend activity across the indexed lending protocols (Gondi today).
cdi ~1s Typical upstream call (CDI / on-chain RPC / Bids API). available
cdi_get_wallet_profile
Per-wallet holdings + activity for one collection (or all).
cdi ~1s Typical upstream call (CDI / on-chain RPC / Bids API). available
cdi_list_entities
Enumerate the curated SEED_CLUSTERS — operator-attested wallet clusters and named individuals (e.g. 'SethS', 'PunksOTC', 'MoMA', 'pnkstr', 'Centre Pompidou').
cdi <1s Pure compute or a single cached read. available
lightyear_get_account_status
Current freemium account state for the SIWE-authenticated caller.
lightyear n/a Free available
lightyear_get_call_history
Paginated billed-call history for the SIWE-authenticated caller's wallet.
lightyear n/a Free available
lightyear_get_tool_costs
Lists every registered tool with its current cost (in USD cents), latency class, and breaker availability.
lightyear n/a Free available
punks_browse_traits
List CryptoPunk traits with collection-wide counts + rarity (e.g.
punks n/a available
punks_browse_types
List the 5 CryptoPunk type categories (Male / Female / Zombie / Ape / Alien) with the count of punks in each.
punks n/a available
punks_compute_merkle_root
Compute the Merkle root for an arbitrary set of CryptoPunk IDs (matches the on-chain Solady MerkleProofLib encoding used by the Stash bidding contract).
punks n/a available
punks_filter_punks
Filter the 10,000 CryptoPunks by type/trait combinations (AND or OR).
punks n/a available
punks_get_bid_recommendation
Recommend a competitive BID PRICE RANGE for a CryptoPunk trait selection — what a buyer should BID (NOT a fair-market valuation; in market microstructure "offer/ask" is the sell side, "bid" is the buy side).
punks 2–5s Multi-RPC composites or full-collection scans. available
punks_get_bids_for_merkle_root
Get pending bids on a specific Merkle root (i.e. bids targeting a defined trait selection or punk subset).
punks ~1s Typical upstream call (CDI / on-chain RPC / Bids API). available
punks_get_bids_for_punk
Get pending EIP-712 bids that cover a specific CryptoPunk — includes single-punk bids, subset roots, superset roots, and collection-wide bids.
punks ~1s Typical upstream call (CDI / on-chain RPC / Bids API). available
punks_get_collection_concentration
Lender-grade concentration metrics for a collection's loan book — cumulative shares (top-1 / top-2 / top-5) on BOTH borrower and lender sides, HHI lower-bound (sum-of-squares of top-5 shares), risk flags when concentration crosses attention-grabbing thresholds (top borrower > 25%, top-2 > 50%, etc.).
punks n/a available
punks_get_entity_mtm
Cluster-level MTM summary for an entity — resolves the slug via cdi_list_entities, fans out punks_get_wallet_exposure across every wallet in the cluster, sums holdings + active Gondi loans, prices unrealised exposure at the current floor.
punks n/a available
punks_get_floor_extremes
Ranked floor-history extremes for a CryptoPunks-class collection in ONE call — e.g. the 10 cheapest USD-floor days over the last 900 days — instead of pulling every day and sorting client-side.
punks n/a 10¢ available
punks_get_floor_price
Get the current collection-wide floor ask from the native CryptoPunks marketplace (excludes restricted onlySellTo and zero-value listings).
punks 2–5s Multi-RPC composites or full-collection scans. available
punks_get_image
Get a render URL for a CryptoPunk's upscaled 1024x1024 PNG (from cryptopunks.app).
punks n/a available
punks_get_listings
Get every active listing on the native CryptoPunks marketplace, optionally filtered by price range AND/OR trait selection (types / includedTraits / excludedTraits + matchMode — same shape as punks_filter_punks).
punks 2–5s Multi-RPC composites or full-collection scans. available
punks_get_market_context
Multi-mode pricing for a CryptoPunk (or trait selection) in ONE call: fair-market value PLUS live market dynamics PLUS three intent-specific price anchors — `hold_mode` (defensible to buy-and-hold), `speculative_bid` (sub-floor bid sized to the current regime, with a 30-day fill probability), and `aggressive_takeout` (best ask + buffer = own it today).
punks n/a 50¢ available
punks_get_punk_details
Get the type + traits + rarity percentages + permalink for one or more specific CryptoPunk IDs.
punks n/a available
punks_get_recent_wrapped_transfers
Get the collection-wide recent feed of WRAPPED-punk transfers, newest first, each typed `wrap` / `unwrap` / `transfer`.
punks ~1s Typical upstream call (CDI / on-chain RPC / Bids API). available
punks_get_stash_stats
Aggregate Stash ecosystem stats — deployed Stash count, total ETH + WETH held, available liquidity, active bid count + notional, distribution histogram (0–1 / 1–10 / 10–100 / 100–1k / 1k+ ETH buckets), p50/p90/p99 percentiles, top-10 Stashes by liquidity.
punks n/a available
punks_get_wallet_exposure
Wallet-level lending + holdings composite.
punks n/a available
punks_get_wrap_transfers
Get the wrap / unwrap / transfer history of a CryptoPunk's WRAPPED form (WPunk), newest first.
punks ~1s Typical upstream call (CDI / on-chain RPC / Bids API). available
punks_prepare_bid
Generate a Punks Terminal deep-link that pre-populates the BidFromMerkleDialog with the merkle root, bid amount, and expiration.
punks n/a available
punks_resolve_merkle_root
Reverse-engineer a Merkle root back to its punk IDs and inferred trait selection.
punks ~1s Typical upstream call (CDI / on-chain RPC / Bids API). available
punks_value_portfolio
Fair-market valuation for a PORTFOLIO of CryptoPunks (1–100 deduped token IDs).
punks ~1s Typical upstream call (CDI / on-chain RPC / Bids API). 50¢ available
punks_value_token
Fair-market valuation for ONE specific CryptoPunk — what is this punk WORTH on the open market?
punks ~1s Typical upstream call (CDI / on-chain RPC / Bids API). 10¢ available
Showing 39 of 39 tools