io.github.ExpertVagabond/ordinals

Registre officiel Autres

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

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package ordinals-mcp

Claude Code

claude mcp add ordinals -e 'HIRO_API_KEY=<your hiro_api_key>' -e 'ORDISCAN_API_KEY=<your ordiscan_api_key>' -e 'MAGIC_EDEN_API_KEY=<your magic_eden_api_key>' -- npx -y ordinals-mcp@0.1.2

Configuration JSON (Claude Desktop, Cursor, VS Code)

{
    "mcpServers": {
        "ordinals": {
            "command": "npx",
            "args": [
                "-y",
                "ordinals-mcp@0.1.2"
            ],
            "env": {
                "HIRO_API_KEY": "<your hiro_api_key>",
                "ORDISCAN_API_KEY": "<your ordiscan_api_key>",
                "MAGIC_EDEN_API_KEY": "<your magic_eden_api_key>"
            }
        }
    }
}

Variables d'environnement

HIRO_API_KEY secret Hiro API key (free at platform.hiro.so) — 500 RPM
ORDISCAN_API_KEY secret Ordiscan API key (free at ordiscan.com/docs/api)
MAGIC_EDEN_API_KEY secret Magic Eden API key (optional, higher rate limits)

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire

ordinals-mcp
Install
Configure
Tools (24)
Why This One?
Architecture
Environment Variables
Development
License

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

{
  "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

Questions fréquentes

Qu'est-ce que io.github.ExpertVagabond/ordinals ?

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

Comment installer io.github.ExpertVagabond/ordinals ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add ordinals -e 'HIRO_API_KEY=<your hiro_api_key>' -e 'ORDISCAN_API_KEY=<your ordiscan_api_key>' -e 'MAGIC_EDEN_API_KEY=<your magic_eden_api_key>' -- npx -y ordinals-mcp@0.1.2. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.ExpertVagabond/ordinals ?

Oui. Il attend HIRO_API_KEY, ORDISCAN_API_KEY, MAGIC_EDEN_API_KEY, à renseigner dans sa configuration.

io.github.ExpertVagabond/ordinals est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.ExpertVagabond/ordinals ?

Il est publié par ExpertVagabond. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.

Détails du serveur

Référencé dans: Registre MCP officiel
Éditeur: ExpertVagabond
Catégorie: Autres
Exécution: Local
Étoiles GitHub: ★ 2
Licence: MIT
Langage: TypeScript
Dernier commit: 13 sept. 2026
Tickets ouverts: 2
Version: 0.1.2
Publié le: 14 févr. 2026

io.github.ExpertVagabond/ordinals

Serveurs similaires

Graph Excel Read and edit Excel workbooks on SharePoint/OneDrive via Microsoft Graph, with verified...
Pareil au même Checks a name against French trademarks in force, by spelling and by sound. Free, no ac...
Orphex Analyze ad performance across platforms and execute changes after your approval.
Bryti Plan dinners with Bryti from your own assistant: the week, shopping list, pantry and re...
Autotask MCP server for Kaseya Autotask PSA — companies, tickets, projects, time entries, and more.
Repolode Choose open-source projects: side-by-side verdicts on alternatives, real downloads, mai...
Purl Save, organize and share your Purl links from any MCP client.
dotsy Build and publish static sites on dotsy with draft-first MCP tools, OAuth Connect, and ...

Autres