MCP.Market

Ordinals MCP server

by ExpertVagabond·io.github.ExpertVagabond/ordinals·v0.1.2·2 stars
No reviews yet

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

B75/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B75/100

full report

Adoption
Growing

2 stars38 downloads/wk

Reviews

Write one

Nobody has reviewed Ordinals yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Ordinals tools (24)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

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

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

Public scan report

scanner v0.1.10 · 2026-09-28 · same rubric, same numbers if you re-run it

1 medium
  • Code scan2 source files scanned20/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 15 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Findings (1)

  • mediumeval / new Function usedexec.eval
    build/index.js: …ode, sch); const makeValidate = new Function(`${names_1.default.self}`, `${names_1.de…
Overall 75/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Ordinals compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
75/100
higher than 45% of 48,255 servers
Tools
24
the typical server has 7
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
2
more than 75% of 28,688 servers
Downloads a week
38
more than 29% of 12,191 servers with a package

What its tools let an agent do: 24 read

Install Ordinals in Claude Code, Cursor or VS Code

Runs npx -y ordinals-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add ordinals -- npx -y ordinals-mcp
Add to Cursor

What the publisher says

From the Ordinals repository's README, as published. We do not edit it. Read it on GitHub

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 (claudedesktopconfig.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 HIROAPIKEY or ORDISCANAPIKEY is required. Both are free:

Tools (24)

Inscriptions (5)

Address Queries (4)

Runes (6)

BRC-20 (3)

Collections (3)

Sats & Transactions (3)

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Ordinals: common questions

Is Ordinals MCP server safe?
Mostly: it is graded B (75/100). Read the Ordinals safety report
How do I install Ordinals?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Ordinals need an API key?
Yes. The registry entry asks for HIRO_API_KEY, ORDISCAN_API_KEY, MAGIC_EDEN_API_KEY.
Is Ordinals maintained?
The last commit was 52 days ago (2026-09-13). The latest release is v0.1.2.
How does Ordinals compare with other MCP servers?
safety score 75/100 (higher than 45% of 48,255 servers); tools 24 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

More from ExpertVagabond →