Ordinals

io.github.ExpertVagabond由 GitHub 帳號 ExpertVagabond 發布v0.1.2更新於 Oct 24, 2026

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

已驗證STDIO僅桌面金融資料與分析

概覽

AI 產生的概覽

比特幣 Ordinals MCP 伺服器，讓助理查詢銘文、符文、BRC-20 代幣、合集、稀有聰與市場資料。

可以做什麼
  • 依 ID 或編號查詢銘文，依條件搜尋，並讀取內容、轉移紀錄與特徵
  • 查詢某個比特幣地址持有的銘文、BRC-20 餘額、符文餘額與稀有聰
  • 瀏覽符文：中繼資料、清單、持有者、活動、市場資料與解鎖日期
  • 檢視 BRC-20 代幣與合集，包括代幣詳情、持有者、活動、地板價與在售掛單
  • 查看單一聰與交易的稀有度、銘文歷史及符文操作
適用情境
適合需要助理研究比特幣 Ordinals、符文或 BRC-20 資產、查看某地址持倉，或直接在對話中取得合集與市場行情資料的情境。
執行需求
透過 npx 或全域 npm 安裝後在本機執行（需要 Node.js）。HIRO_API_KEY 與 ORDISCAN_API_KEY 至少需提供一個；MAGIC_EDEN_API_KEY 為選用，可提高市場介面速率。另有選用的 CACHE_TTL_SECONDS。需要能連線 Hiro、Ordiscan 與 Magic Eden 的介面。
安裝前請注意
需在 MCP 設定的 env 中填入 API 金鑰（HIRO_API_KEY、ORDISCAN_API_KEY，選用 MAGIC_EDEN_API_KEY），請勿放入共用設定。查詢內容與地址會傳送給第三方介面（Hiro、Ordiscan、Magic Eden）。工具皆為唯讀查詢，但介面故障時可能回傳過期的快取資料。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Ordinals，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

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

bash
npx ordinals-mcp@latest

Or install globally:

bash
npm install -g ordinals-mcpordinals-mcp

Configure

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

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:

ProviderRate LimitGet Key
Hiro (primary)500 RPMplatform.hiro.so
Ordiscan (fallback)--ordiscan.com/docs/api
Magic Eden (optional)--docs.magiceden.io

Tools (24)

Inscriptions (5)

ToolDescriptionKey Params
get_inscriptionFull inscription details by ID or numberid
search_inscriptionsSearch inscriptions with filters (type, mime, date range)query, filters
get_inscription_contentRaw content of an inscriptionid
get_inscription_transfersTransfer history for an inscriptionid
get_inscription_traitsTraits and attributes of an inscriptionid

Address Queries (4)

ToolDescriptionKey Params
get_address_inscriptionsAll inscriptions held by a Bitcoin addressaddress
get_brc20_balancesBRC-20 token balances for an addressaddress
get_rune_balancesRune balances for an addressaddress
get_address_rare_satsRare satoshis held by an addressaddress

Runes (6)

ToolDescriptionKey Params
get_rune_infoDetailed rune metadata (etching, supply, holders)rune
list_runesList all runes with pagination and sortingoffset, limit
get_rune_holdersTop holders of a specific runerune
get_rune_activityRecent activity (mints, transfers, burns) for a runerune
get_rune_market_infoMarket data -- floor price, volume, listingsrune
get_rune_unlock_dateUnlock/availability date for time-locked runesrune

BRC-20 (3)

ToolDescriptionKey Params
get_brc20_tokenToken details (supply, limit, holders, deploy info)ticker
get_brc20_activityRecent activity for a BRC-20 tokenticker
get_brc20_holdersTop holders of a BRC-20 tokenticker

Collections (3)

ToolDescriptionKey Params
get_collection_infoCollection metadata, floor price, volumeslug
get_collection_inscriptionsInscriptions within a collectionslug
get_collection_listingsActive marketplace listings for a collectionslug

Sats & Transactions (3)

ToolDescriptionKey Params
get_sat_infoSat rarity, name, and inscription historysat_number
get_tx_inscriptionsInscriptions in a Bitcoin transactiontxid
get_tx_runesRune operations in a Bitcoin transactiontxid

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

VariableRequiredDescription
HIRO_API_KEYYes*Hiro API key (free)
ORDISCAN_API_KEYYes*Ordiscan API key (free)
MAGIC_EDEN_API_KEYNoHigher marketplace rate limits
CACHE_TTL_SECONDSNoDefault cache TTL (default: 300)

*At least one required.

Development

bash
git clone https://github.com/ExpertVagabond/ordinals-mcp.gitcd ordinals-mcpnpm installnpm run buildnpm run inspector    # MCP Inspector for testing

License

MIT -- Purple Squirrel Media

來源：README.md，提交 ec7e8cb

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.2最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分