Quick Start
Claude Desktop / Claude Code config
{
"mcpServers": {
"ordinals": {
"command": "npx",
"args": ["ordinals-mcp@latest"],
"env": {
"HIRO_API_KEY": "your-key",
"ORDISCAN_API_KEY": "your-key"
}
}
}
}24 Tools
Inscriptions
get_inscriptionMetadata by ID or numbersearch_inscriptionsFilter by address, mime, rarity, blockget_inscription_contentRaw content (text, images)get_inscription_transfersFull transfer historyget_inscription_traitsCollection trait info
Address
get_address_inscriptionsAll inscriptions for addressget_brc20_balancesBRC-20 token balancesget_rune_balancesRune balancesget_address_rare_satsRare satoshis held
Runes
get_rune_infoEtching details, supply, termslist_runesPaginated rune listingget_rune_holdersTop holders by balanceget_rune_activityMints, transfers, burnsget_rune_market_infoPrice, market cap, volumeget_rune_unlock_dateName availability check
BRC-20
get_brc20_tokenToken details & supplyget_brc20_activityDeploy, mint, transfer eventsget_brc20_holdersTop token holders
Collections & Market
get_collection_infoStats, floor, volumeget_collection_inscriptionsInscriptions in collectionget_collection_listingsMagic Eden listings
Sats & Transactions
get_sat_infoRarity, epoch, inscriptionsget_tx_inscriptionsInscriptions in a TXget_tx_runesRune transfers in a TX
Architecture
Multi-API Fallback
Cache
→
Hiro
→
Ordiscan
→
Stale Cache
Automatic failover across providers. Never miss a query.
Intelligent Caching
| Sat rarity | 24h |
| Inscription metadata | 5 min |
| Rune etching info | 5 min |
| Collection info | 2 min |
| Balances | 1 min |
| Marketplace listings | 30s |
Rate Limiting
| Hiro | 500 RPM |
| Ordiscan | Daily |
| Magic Eden | 30 RPM |
Per-API token buckets with 80% safety margin.
Data Sources
Hiro
PrimaryInscriptions, BRC-20, Runes
Ordiscan
SecondaryRare sats, collections, alkanes
Magic Eden
MarketplaceListings, floor prices, sales