Ordinals

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

Connector by ExpertVagabond · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 2

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/expertvagabond-ordinals

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

About

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

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools: 24 read · 0 write · 0 deleteRead-only
Secrets: 3 (API keys, tokens or passwords)
Install scripts: Not scanned yet
Runs as: Node.js package

Tools by what they do 24

Read from the source code; the running server may list different tools.

Read 24 · Look things up without changing anything.

get_address_inscriptions
get_address_rare_sats
get_brc20_activity
get_brc20_balances
get_brc20_holders
get_brc20_token
get_collection_info
get_collection_inscriptions
get_collection_listings
get_inscription
get_inscription_content
get_inscription_traits

Show 12 more tools

get_inscription_transfers
get_rune_activity
get_rune_balances
get_rune_holders
get_rune_info
get_rune_market_info
get_rune_unlock_date
get_sat_info
get_tx_inscriptions
get_tx_runes
list_runes
search_inscriptions

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

HIRO_API_KEY
MAGIC_EDEN_API_KEY
ORDISCAN_API_KEY

Tools (24)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

get_address_inscriptions
Get all Ordinals inscriptions owned by a Bitcoin address. Returns inscription IDs, numbers, content types, and sat rarity.
get_address_rare_sats
Get rare satoshis held by a Bitcoin address. Returns sat ordinal number, rarity level (uncommon/rare/epic/legendary/mythic), and UTXO location.
get_brc20_activity
Get BRC-20 token activity (deploy, mint, transfer events). Filter by ticker, address, or operation type.
get_brc20_balances
Get BRC-20 token balances for a Bitcoin address. Returns available, transferrable, and overall balance for each token.
get_brc20_holders
Get top holders of a BRC-20 token. Returns addresses and balances sorted by amount held.
get_brc20_token
Get details for a BRC-20 token by ticker. Returns max supply, minted supply, mint limit, decimals, deploy inscription, and transaction count.
get_collection_info
Get details for an Ordinals collection. Returns name, description, inscription count, floor price, volume, and owner count.
get_collection_inscriptions
List inscriptions in an Ordinals collection. Returns inscription IDs, numbers, content types, and owners.
get_collection_listings
Get active marketplace listings for an Ordinals collection on Magic Eden. Returns listed inscriptions with prices in BTC.
get_inscription
Get detailed metadata for a Bitcoin Ordinals inscription by its ID or number. Returns owner address, content type, sat rarity, genesis info, and more.
get_inscription_content
Get the raw content of a Bitcoin Ordinals inscription. Returns text content directly or base64-encoded binary data with content type.
get_inscription_traits
Get trait information for a collection inscription. Returns trait types and values (e.g., background, body, eyes).
get_inscription_transfers
Get the transfer history for a Bitcoin Ordinals inscription. Shows each transfer with block, address, transaction, and timestamp.
get_rune_activity
Get recent activity (mints, transfers, burns) for a Bitcoin Rune. Returns operation type, addresses, amounts, and timestamps.
get_rune_balances
Get Rune token balances for a Bitcoin address. Returns rune name, symbol, and balance for each rune held.

Show 9 more tools

get_rune_holders
Get top holders of a Bitcoin Rune. Returns addresses and balances sorted by amount held.
get_rune_info
Get details for a Bitcoin Rune by name. Returns symbol, divisibility, supply, premine, mint terms, and etching transaction.
get_rune_market_info
Get market data for a Bitcoin Rune. Returns price in USD, market cap, and 24h volume.
get_rune_unlock_date
Check when a rune name becomes available for etching. Returns unlock block height and estimated date.
get_sat_info
Get information about a specific satoshi by its ordinal number. Returns rarity level, epoch, cycle, period, name, and any inscription on it.
get_tx_inscriptions
Get all Ordinals inscriptions contained in a Bitcoin transaction. Returns inscription IDs, numbers, and content types.
get_tx_runes
Get all Rune transfers in a Bitcoin transaction. Returns rune names, amounts, addresses, and operation types.
list_runes
List Bitcoin Runes with pagination. Returns rune name, symbol, supply, divisibility, mint terms, and etching info.
search_inscriptions
Search and list Bitcoin Ordinals inscriptions with filters. Filter by address, MIME type, sat rarity, block range, inscription number range, recursive/cursed status.

Signals

Stars: 2
Forks: 0
Open issues: 2
Last commit: Sep 13, 2026 (1 month ago)
Last release: Feb 14, 2026 (8 months ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name: io.github.ExpertVagabond/ordinals
Version: 0.1.2
Auth: API key
Packages: npm ordinals-mcp
License: MIT
Repository: github.com/ExpertVagabond/ordinals-mcp
First seen: Oct 24, 2026
Last checked: Oct 24, 2026
Source: Official MCP Registry github-graphql

More from ExpertVagabond

Cite this page

Ordinals MCP server. Agent Mart. https://agentmart.dev/connectors/expertvagabond-ordinals (last updated 2026-10-24)