Is the ordinals MCP server free to use?

Yes. ordinals is listed on AllMCPs as a free, open Model Context Protocol server you can install into Claude Desktop, Cursor, or any MCP-compatible client.

Is the ordinals MCP server free to use?

Yes. ordinals is listed on AllMCPs as a free, open Model Context Protocol server you can install into Claude Desktop, Cursor, or any MCP-compatible client.

Ordinals

Bitcoin Ordinals MCP Server — inscriptions, runes, BRC-20, collections & rare sats

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Install Config Generator

Choose your client

claude_desktop_config.json

{
  "mcpServers": {
    "ordinals": {
      "command": "npx",
      "args": [
        "-y",
        "ordinals-mcp@latest"
      ]
    }
  }
}

💡 Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

Capabilities & Tool Schemas (24)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Ordinals.

get_inscription

Full inscription details by ID or number

search_inscriptions

Search inscriptions with filters (type, mime, date range)

get_inscription_content

Raw content of an inscription

get_inscription_transfers

Transfer history for an inscription

get_inscription_traits

Traits and attributes of an inscription

get_address_inscriptions

All inscriptions held by a Bitcoin address

Documentation Overview

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

Terminal

npx ordinals-mcp@latest

Or install globally:

Terminal

npm install -g ordinals-mcp
ordinals-mcp

Configure

Add to your MCP config (claude_desktop_config.json or ~/.mcp.json):

config.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

Code

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

bash

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

Related MCP Servers

View all in Finance & Fintech View all alternatives

Frequently Asked Questions about Ordinals

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "ordinals": { "command": "npx", "args": ["-y", "ordinals"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/ordinals?style=directory)](https://allmcps.com/mcp/ordinals)

HTML Embed

<a href="https://allmcps.com/mcp/ordinals"><img src="https://allmcps.com/api/badge/ordinals?style=directory" alt="Ordinals on AllMCPs" /></a>

Technical Specs & Signals

CategoryFinance & Fintech

5/5 checks healthy over the last 6h

49Quality signal: Fair · 49/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools25/30

Adoption & activity2/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to get the verified badge and attach your website.

Free dofollow backlink: after claiming, verify your product site and place a dofollow AllMCPs badge — we recheck it stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💰 Finance & Fintech →Best MCP servers for Finance & Fintech →Alternatives to Ordinals →Install in Claude Desktop Install in Cursor Install in VS Code

Ordinals

Bitcoin Ordinals MCP Server — inscriptions, runes, BRC-20, collections & rare sats

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Install Config Generator

Choose your client

claude_desktop_config.json

{
  "mcpServers": {
    "ordinals": {
      "command": "npx",
      "args": [
        "-y",
        "ordinals-mcp@latest"
      ]
    }
  }
}

💡 Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

Capabilities & Tool Schemas (24)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Ordinals.

get_inscription

Full inscription details by ID or number

search_inscriptions

Search inscriptions with filters (type, mime, date range)

get_inscription_content

Raw content of an inscription

get_inscription_transfers

Transfer history for an inscription

get_inscription_traits

Traits and attributes of an inscription

get_address_inscriptions

All inscriptions held by a Bitcoin address

Documentation Overview

ordinals-mcp

The only alternative (ordiscan-mcp) has 25 npm downloads and covers a fraction of the surface. This server is the production-grade option.

Install

Terminal

npx ordinals-mcp@latest

Or install globally:

Terminal

npm install -g ordinals-mcp
ordinals-mcp

Configure

Add to your MCP config (claude_desktop_config.json or ~/.mcp.json):

config.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

Code

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

bash

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

Related MCP Servers

View all in Finance & Fintech View all alternatives

Frequently Asked Questions about Ordinals

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "ordinals": { "command": "npx", "args": ["-y", "ordinals"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/ordinals?style=directory)](https://allmcps.com/mcp/ordinals)

HTML Embed

<a href="https://allmcps.com/mcp/ordinals"><img src="https://allmcps.com/api/badge/ordinals?style=directory" alt="Ordinals on AllMCPs" /></a>

Technical Specs & Signals

CategoryFinance & Fintech

5/5 checks healthy over the last 6h

49Quality signal: Fair · 49/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools25/30

Adoption & activity2/15

Community engagement0/10

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to get the verified badge and attach your website.

Free dofollow backlink: after claiming, verify your product site and place a dofollow AllMCPs badge — we recheck it stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💰 Finance & Fintech →Best MCP servers for Finance & Fintech →Alternatives to Ordinals →Install in Claude Desktop Install in Cursor Install in VS Code