How do I use ordinals-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@ordinals-mcp What's the floor price of the NodeMonkes collection?" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

ordinals-mcp

Q: Which integrations are available for this server?

Provides tools for querying Bitcoin Ordinals data, including inscriptions, runes, BRC-20 tokens, collections, rare sats, and marketplace information, by aggregating multiple APIs.

by ExpertVagabond

Overview Schema Related Servers Score Discussions

TypeScript

Remote

ordinals-mcp

npm version License: MIT Node Tools

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):

{
  "mcpServers": {
    "ordinals": {
      "command": "npx",
      "args": ["-y", "ordinals-mcp@latest"],
      "env": {
        "HIRO_API_KEY": "your-key",
        "ORDISCAN_API_KEY": "your-key"
      }
    }
  }
}

At least one of HIRO_API_KEY or ORDISCAN_API_KEY is required. Both are free:

Provider	Rate Limit	Get Key
Hiro (primary)	500 RPM	platform.hiro.so
Ordiscan (fallback)	--	ordiscan.com/docs/api
Magic Eden (optional)	--	docs.magiceden.io

Tools (24)

Inscriptions (5)

Tool	Description	Key Params
`get_inscription`	Full inscription details by ID or number	`id`
`search_inscriptions`	Search inscriptions with filters (type, mime, date range)	`query`, `filters`
`get_inscription_content`	Raw content of an inscription	`id`
`get_inscription_transfers`	Transfer history for an inscription	`id`
`get_inscription_traits`	Traits and attributes of an inscription	`id`

Address Queries (4)

Tool	Description	Key Params
`get_address_inscriptions`	All inscriptions held by a Bitcoin address	`address`
`get_brc20_balances`	BRC-20 token balances for an address	`address`
`get_rune_balances`	Rune balances for an address	`address`
`get_address_rare_sats`	Rare satoshis held by an address	`address`

Runes (6)

Tool	Description	Key Params
`get_rune_info`	Detailed rune metadata (etching, supply, holders)	`rune`
`list_runes`	List all runes with pagination and sorting	`offset`, `limit`
`get_rune_holders`	Top holders of a specific rune	`rune`
`get_rune_activity`	Recent activity (mints, transfers, burns) for a rune	`rune`
`get_rune_market_info`	Market data -- floor price, volume, listings	`rune`
`get_rune_unlock_date`	Unlock/availability date for time-locked runes	`rune`

BRC-20 (3)

Tool	Description	Key Params
`get_brc20_token`	Token details (supply, limit, holders, deploy info)	`ticker`
`get_brc20_activity`	Recent activity for a BRC-20 token	`ticker`
`get_brc20_holders`	Top holders of a BRC-20 token	`ticker`

Collections (3)

Tool	Description	Key Params
`get_collection_info`	Collection metadata, floor price, volume	`slug`
`get_collection_inscriptions`	Inscriptions within a collection	`slug`
`get_collection_listings`	Active marketplace listings for a collection	`slug`

Sats & Transactions (3)

Tool	Description	Key Params
`get_sat_info`	Sat rarity, name, and inscription history	`sat_number`
`get_tx_inscriptions`	Inscriptions in a Bitcoin transaction	`txid`
`get_tx_runes`	Rune operations in a Bitcoin transaction	`txid`

Why This One?

24 tools, full coverage. Inscriptions, runes, BRC-20, collections, rare sats, and marketplace data. No other Ordinals MCP covers all six categories.
Multi-API with automatic failover. Aggregates Hiro (primary, 500 RPM), Ordiscan (fallback), and Magic Eden (marketplace). If one API rate-limits, requests automatically route to the next.
Intelligent caching. TTLs tuned per data type -- sat rarity (24h), inscription metadata (5m), collection info (2m), balances (1m), marketplace listings (30s). Stale cache serves as last resort during outages.

Architecture

Request --> Cache (TTL + ETag)
  |--> HIT: return cached
  |--> MISS:
      |--> Hiro (primary, 500 RPM)
      |     |--> Success: cache + return
      |     |--> Rate limited: Ordiscan (fallback) --> Stale cache (last resort)
      |--> Magic Eden (marketplace-specific)

Environment Variables

Variable	Required	Description
`HIRO_API_KEY`	Yes*	Hiro API key (free)
`ORDISCAN_API_KEY`	Yes*	Ordiscan API key (free)
`MAGIC_EDEN_API_KEY`	No	Higher marketplace rate limits
`CACHE_TTL_SECONDS`	No	Default cache TTL (default: 300)

*At least one required.

Development

git clone https://github.com/ExpertVagabond/ordinals-mcp.git
cd ordinals-mcp
npm install
npm run build
npm run inspector    # MCP Inspector for testing

License

MIT -- Purple Squirrel Media

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

1Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ExpertVagabond/ordinals-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server