Ordinals
This is a comprehensive Bitcoin Ordinals integration that aggregates Hiro, Ordiscan, and Magic Eden APIs into 24 tools. You get full coverage of inscriptions (search, content, transfers, traits), runes (info, holders, activity, market data), BRC-20 tokens, collections, and rare satoshis. It handles address queries across all these primitives and includes transaction-level inspection for both inscriptions and rune operations. The server implements intelligent caching with tuned TTLs per data type and automatic failover between providers when rate limits hit. Reach for this when you need Claude to interact with the Ordinals ecosystem beyond basic lookups, especially for market analysis, collection tracking, or wallet inspection across multiple token standards.
- GitHub stars
- 2
- tools
- 24
- auth
- Secret needed
- transport
- STDIO
- env vars
- 3
- last updated
- Feb 14, 2026
Tools
24 toolsPublic tool metadata for what this MCP can expose to an agent.
get_inscriptionFull inscription details by ID or number
Full inscription details by ID or number
No parameter schema in public metadata yet.
search_inscriptionsSearch inscriptions with filters (type, mime, date range)
Search inscriptions with filters (type, mime, date range)
No parameter schema in public metadata yet.
get_inscription_contentRaw content of an inscription
Raw content of an inscription
No parameter schema in public metadata yet.
get_inscription_transfersTransfer history for an inscription
Transfer history for an inscription
No parameter schema in public metadata yet.
get_inscription_traitsTraits and attributes of an inscription
Traits and attributes of an inscription
No parameter schema in public metadata yet.
get_address_inscriptionsAll inscriptions held by a Bitcoin address
All inscriptions held by a Bitcoin address
No parameter schema in public metadata yet.
get_brc20_balancesBRC-20 token balances for an address
BRC-20 token balances for an address
No parameter schema in public metadata yet.
get_rune_balancesRune balances for an address
Rune balances for an address
No parameter schema in public metadata yet.
get_address_rare_satsRare satoshis held by an address
Rare satoshis held by an address
No parameter schema in public metadata yet.
get_rune_infoDetailed rune metadata (etching, supply, holders)
Detailed rune metadata (etching, supply, holders)
No parameter schema in public metadata yet.
list_runesList all runes with pagination and sorting
List all runes with pagination and sorting
No parameter schema in public metadata yet.
get_rune_holdersTop holders of a specific rune
Top holders of a specific rune
No parameter schema in public metadata yet.
get_rune_activityRecent activity (mints, transfers, burns) for a rune
Recent activity (mints, transfers, burns) for a rune
No parameter schema in public metadata yet.
get_rune_market_infoMarket data -- floor price, volume, listings
Market data -- floor price, volume, listings
No parameter schema in public metadata yet.
get_rune_unlock_dateUnlock/availability date for time-locked runes
Unlock/availability date for time-locked runes
No parameter schema in public metadata yet.
get_brc20_tokenToken details (supply, limit, holders, deploy info)
Token details (supply, limit, holders, deploy info)
No parameter schema in public metadata yet.
get_brc20_activityRecent activity for a BRC-20 token
Recent activity for a BRC-20 token
No parameter schema in public metadata yet.
get_brc20_holdersTop holders of a BRC-20 token
Top holders of a BRC-20 token
No parameter schema in public metadata yet.
get_collection_infoCollection metadata, floor price, volume
Collection metadata, floor price, volume
No parameter schema in public metadata yet.
get_collection_inscriptionsInscriptions within a collection
Inscriptions within a collection
No parameter schema in public metadata yet.
get_collection_listingsActive marketplace listings for a collection
Active marketplace listings for a collection
No parameter schema in public metadata yet.
get_sat_infoSat rarity, name, and inscription history
Sat rarity, name, and inscription history
No parameter schema in public metadata yet.
get_tx_inscriptionsInscriptions in a Bitcoin transaction
Inscriptions in a Bitcoin transaction
No parameter schema in public metadata yet.
get_tx_runesRune operations in a Bitcoin transaction
Rune operations in a Bitcoin transaction
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
HIRO_API_KEYsecretHiro API key (free at platform.hiro.so) — 500 RPM
ORDISCAN_API_KEYsecretOrdiscan API key (free at ordiscan.com/docs/api)
MAGIC_EDEN_API_KEYsecretMagic Eden API key (optional, higher rate limits)
Readme
ordinals-mcp
The most complete Bitcoin Ordinals MCP server. 24 tools covering inscriptions, runes, BRC-20 tokens, collections, rare sats, and marketplace data. Aggregates Hiro, Ordiscan, and Magic Eden APIs with intelligent caching and automatic failover.
The only alternative (ordiscan-mcp) has 25 npm downloads and covers a fraction of the surface. This server is the production-grade option.
Install
npx ordinals-mcp@latest
Or install globally:
npm install -g ordinals-mcp
ordinals-mcp
Configure
Add to your MCP config (claude_desktop_config.json or ~/.mcp.json):
Details
- Repository
- github.com/expertvagabond/ordinals-mcp
- Category
- Finance & Commerce
- Package
ordinals-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active
More from expertvagabond
Related Finance & Commerce MCP servers
View all
GhostSwapghostswap1/ghostswap-agentsGhostSwap — non-custodial crypto swaps across 1,600+ coins.0stars
CausalLayer MCPsmq9sn5jck-coder/causallayer-mcpDeterministic AI liability attribution with Bitcoin-anchored proof certificates.2stars
SocialAPIssocialapishub/mcp-serverFacebook & Instagram data for AI agents: pages, posts, groups, ads, Marketplace, profiles, reels.0stars
Mycase Mcpoktopeak/mycase-mcpConnect Claude to MyCase: cases, contacts, documents, tasks, calendar, calls, time, billing, staff.2stars
Sf Mcpsignal-found/sf-mcpReddit outreach at scale — find prospects, send 1000s of DMs/day, and manage your CRM via AI agents.0starsFaultKey · CausalLayersmq9sn5jck-coder/causallayer-mcpDeterministic AI-liability attribution: signed, Bitcoin-anchored vendor/deployer/user fault split.2stars