ordinals-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HIRO_API_KEY | No | Hiro API key (free from platform.hiro.so) | |
| ORDISCAN_API_KEY | No | Ordiscan API key (free from ordiscan.com/docs/api) | |
| CACHE_TTL_SECONDS | No | Default cache TTL in seconds | 300 |
| MAGIC_EDEN_API_KEY | No | Optional Magic Eden API key for higher marketplace rate limits |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_inscriptionB | Get detailed metadata for a Bitcoin Ordinals inscription by its ID or number. Returns owner address, content type, sat rarity, genesis info, and more. |
| search_inscriptionsC | Search and list Bitcoin Ordinals inscriptions with filters. Filter by address, MIME type, sat rarity, block range, inscription number range, recursive/cursed status. |
| get_inscription_contentA | Get the raw content of a Bitcoin Ordinals inscription. Returns text content directly or base64-encoded binary data with content type. |
| get_inscription_transfersB | Get the transfer history for a Bitcoin Ordinals inscription. Shows each transfer with block, address, transaction, and timestamp. |
| get_address_inscriptionsA | Get all Ordinals inscriptions owned by a Bitcoin address. Returns inscription IDs, numbers, content types, and sat rarity. |
| get_brc20_balancesB | Get BRC-20 token balances for a Bitcoin address. Returns available, transferrable, and overall balance for each token. |
| get_rune_balancesB | Get Rune token balances for a Bitcoin address. Returns rune name, symbol, and balance for each rune held. |
| get_address_rare_satsA | Get rare satoshis held by a Bitcoin address. Returns sat ordinal number, rarity level (uncommon/rare/epic/legendary/mythic), and UTXO location. |
| get_sat_infoB | Get information about a specific satoshi by its ordinal number. Returns rarity level, epoch, cycle, period, name, and any inscription on it. |
| get_brc20_tokenA | Get details for a BRC-20 token by ticker. Returns max supply, minted supply, mint limit, decimals, deploy inscription, and transaction count. |
| get_rune_infoB | Get details for a Bitcoin Rune by name. Returns symbol, divisibility, supply, premine, mint terms, and etching transaction. |
| get_collection_infoB | Get details for an Ordinals collection. Returns name, description, inscription count, floor price, volume, and owner count. |
| get_collection_inscriptionsB | List inscriptions in an Ordinals collection. Returns inscription IDs, numbers, content types, and owners. |
| get_collection_listingsB | Get active marketplace listings for an Ordinals collection on Magic Eden. Returns listed inscriptions with prices in BTC. |
| get_inscription_traitsB | Get trait information for a collection inscription. Returns trait types and values (e.g., background, body, eyes). |
| get_rune_market_infoB | Get market data for a Bitcoin Rune. Returns price in USD, market cap, and 24h volume. |
| list_runesB | List Bitcoin Runes with pagination. Returns rune name, symbol, supply, divisibility, mint terms, and etching info. |
| get_rune_holdersB | Get top holders of a Bitcoin Rune. Returns addresses and balances sorted by amount held. |
| get_rune_activityA | Get recent activity (mints, transfers, burns) for a Bitcoin Rune. Returns operation type, addresses, amounts, and timestamps. |
| get_rune_unlock_dateB | Check when a rune name becomes available for etching. Returns unlock block height and estimated date. |
| get_brc20_activityB | Get BRC-20 token activity (deploy, mint, transfer events). Filter by ticker, address, or operation type. |
| get_brc20_holdersB | Get top holders of a BRC-20 token. Returns addresses and balances sorted by amount held. |
| get_tx_inscriptionsA | Get all Ordinals inscriptions contained in a Bitcoin transaction. Returns inscription IDs, numbers, and content types. |
| get_tx_runesA | Get all Rune transfers in a Bitcoin transaction. Returns rune names, amounts, addresses, and operation types. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 24 tools
Tools cleanly separate resources by action and scope (get_rune_info vs get_rune_market_info, get_rune_balances vs get_rune_holders). The inscription-listing tools (get_collection_inscriptions, get_address_inscriptions, search_inscriptions) overlap in function but differ by input scope, so descriptions keep them distinguishable.
Consistent verb_noun snake_case throughout (get_collection_info, list_runes, search_inscriptions, get_tx_runes). The mix of get/list/search verbs is meaningful and predictable rather than chaotic.
24 tools is on the heavy side but justified by spanning four sub-domains (Ordinals, Runes, BRC-20, rare sats), each with its own info/balances/holders/activity operations. No obvious redundancy padding the count.
Broad read-only coverage: collection metadata, inscription content/transfers/traits, rune and BRC-20 holders/balances/activity, and sat rarity. Minor gaps remain (e.g. non-Magic Eden listings, block-level queries) but core lookups have no dead ends.