Ordinals
Let your coding agent query Bitcoin Ordinals inscriptions, runes, BRC-20 tokens, collections, and rare sats without hand-rolling Hiro, Ordiscan, and Magic Eden API calls.
Overview
Ordinals is an MCP server for the Build phase that queries Bitcoin Ordinals inscriptions, runes, BRC-20, collections, and rare sats via indexer APIs.
What is this MCP server?
- Covers inscriptions, runes, BRC-20, collections, and rare sat lookups in one MCP server
- stdio npm package ordinals-mcp at version 0.1.2
- Hiro API key for up to 500 RPM on platform.hiro.so
- Optional Ordiscan and Magic Eden keys for broader coverage and higher limits
- Package version 0.1.2 via npm identifier ordinals-mcp
- stdio transport
- Hiro free tier documented at 500 RPM
Community signal: 2 GitHub stars.
What problem does it solve?
Agents cannot inspect Ordinals, runes, or BRC-20 state unless you stitch together multiple Bitcoin API docs and error formats by hand.
Who is it for?
Indie builders prototyping Bitcoin Ordinals features, collection trackers, or research agents who already have or can sign up for free Hiro and Ordiscan API keys.
Skip if: Teams that need non-Bitcoin chains only, full custody wallets, or production trading without their own compliance and key management.
What do I get? / Deliverables
After registration, your agent calls MCP tools backed by Hiro, Ordiscan, and optional Magic Eden keys to answer on-chain and collection questions in chat.
- Agent-callable tools for Ordinals, runes, BRC-20, collections, and rare sats
- Configured stdio MCP server with indexer API credentials
- Faster Ordinals research and feature scaffolding without custom HTTP clients
Recommended MCP Servers
Journey fit
Ordinals data access is wired during product build when you add Bitcoin NFT, rune, or BRC-20 features to an app or agent workflow. Third-party Bitcoin indexer APIs are classic integration work: keys, rate limits, and typed tool responses in MCP.
How it compares
MCP integration for Bitcoin Ordinals indexers, not an agent skill that teaches trading strategy.
Common Questions / FAQ
Who is io.github.ExpertVagabond/ordinals for?
Solo and small-team builders adding Ordinals, runes, or BRC-20 read APIs to agents or apps during the build phase.
When should I use io.github.ExpertVagabond/ordinals?
Use it when you are integrating Bitcoin inscription and token metadata into an MCP-enabled coding workflow and want one server instead of three REST clients.
How do I add io.github.ExpertVagabond/ordinals to my agent?
Install the ordinals-mcp npm package, set HIRO_API_KEY and ORDISCAN_API_KEY (and optionally MAGIC_EDEN_API_KEY), add the stdio server entry in Claude Code or Cursor MCP config, and restart the client.