io.github.ExpertVagabond/ordinals

NPM · ORDINALS-MCP · SCANNED AUG 3

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

Available components

+24 this week 70 70 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security87

No malware found by supply-chain analysis.Pass
Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.Partial
No install/post-install scripts declared.Pass
Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency45

Source repository is publicly reachable at the declared URL. View diagnostics → Pass
Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 140 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability81

AI-judged instruction clarity (excellent).Pass
Tool/resource definitions use about 1623 tokens (~67/item across 24 items; 24 tools + 0 resources), lean.Pass
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management27

Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage100

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
100% of tool parameters carry a description.Pass

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · ordinals-mcp

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add expertvagabond-ordinals -- npx -y ordinals-mcp

# add to Codex CLI

codex mcp add expertvagabond-ordinals -- npx -y ordinals-mcp

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "expertvagabond-ordinals": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "ordinals-mcp"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add expertvagabond-ordinals --command npx --arg -y --arg ordinals-mcp

# ~/.hermes/config.yaml

mcp_servers:
  expertvagabond-ordinals:
    command: "npx"
    args: ["-y", "ordinals-mcp"]

// mcp.json

{
  "mcpServers": {
    "expertvagabond-ordinals": {
      "command": "npx",
      "args": [
        "-y",
        "ordinals-mcp"
      ]
    }
  }
}

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

2 Aug 26 +26
- Malware scan: unverified → pass ▲ security
- Schema quality: unverified → excellent ▲ functional
- Stability: unverified → 0.23 ▲ functional
1 Aug 26 +16
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
31 Jul 26 −18
- Malware scan: pass → unverified ▼ security
27 Jul 26 46

First indexed and scored.

Show 2 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 95 packages

95 packages in the resolved dependency tree · 95 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 24 exposed · ~1,623 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

get_address_inscriptions ~80

Get all Ordinals inscriptions owned by a Bitcoin address. Returns inscription IDs, numbers, content types, and sat rarity.

Input Output Examples

Name	Type	Req	Description
address	string	yes	Bitcoin address (bc1p..., bc1q..., 1..., 3...)
limit	number	—	Results per page (max 60)
offset	number	—	Pagination offset

No output schema declared.

No examples provided.

get_address_rare_sats ~79

Get rare satoshis held by a Bitcoin address. Returns sat ordinal number, rarity level (uncommon/rare/epic/legendary/mythic), and UTXO location.

Input Output Examples

Name	Type	Req	Description
address	string	yes	Bitcoin address
limit	number	—	Results per page
offset	number	—	Pagination offset

No output schema declared.

No examples provided.

get_brc20_activity ~91

Get BRC-20 token activity (deploy, mint, transfer events). Filter by ticker, address, or operation type.

Input Output Examples

Name	Type	Req	Description
address	string	—	Filter by Bitcoin address
limit	number	—	Results per page
offset	number	—	Pagination offset
operation	string	—	Filter by operation type
ticker	string	—	Filter by BRC-20 ticker

No output schema declared.

No examples provided.

get_brc20_balances ~66

Get BRC-20 token balances for a Bitcoin address. Returns available, transferrable, and overall balance for each token.

Input Output Examples

Name	Type	Req	Description
address	string	yes	Bitcoin address
limit	number	—	Results per page
offset	number	—	Pagination offset

No output schema declared.

No examples provided.

get_brc20_holders ~72

Get top holders of a BRC-20 token. Returns addresses and balances sorted by amount held.

Input Output Examples

Name	Type	Req	Description
limit	number	—	Results per page
offset	number	—	Pagination offset
ticker	string	yes	BRC-20 token ticker (e.g., ordi, sats)

No output schema declared.

No examples provided.

get_brc20_token ~63

Get details for a BRC-20 token by ticker. Returns max supply, minted supply, mint limit, decimals, deploy inscription, and transaction count.

Input Output Examples

Name	Type	Req	Description
ticker	string	yes	BRC-20 token ticker (e.g., ordi, sats)

No output schema declared.

No examples provided.

get_collection_info ~57

Get details for an Ordinals collection. Returns name, description, inscription count, floor price, volume, and owner count.

Input Output Examples

Name	Type	Req	Description
slug	string	yes	Collection slug/symbol (e.g., bitcoin-puppets, nodemonkes)

No output schema declared.

No examples provided.

get_collection_inscriptions ~60

List inscriptions in an Ordinals collection. Returns inscription IDs, numbers, content types, and owners.

Input Output Examples

Name	Type	Req	Description
limit	number	—	Results per page
offset	number	—	Pagination offset
slug	string	yes	Collection slug/symbol

No output schema declared.

No examples provided.

get_collection_listings ~63

Get active marketplace listings for an Ordinals collection on Magic Eden. Returns listed inscriptions with prices in BTC.

Input Output Examples

Name	Type	Req	Description
collection_symbol	string	yes	Collection symbol on Magic Eden
limit	number	—	Results per page
offset	number	—	Pagination offset

No output schema declared.

No examples provided.

get_inscription ~61

Get detailed metadata for a Bitcoin Ordinals inscription by its ID or number. Returns owner address, content type, sat rarity, genesis info, and more.

Input Output Examples

Name	Type	Req	Description
id	string	yes	Inscription ID ({txid}i{index}) or inscription number

No output schema declared.

No examples provided.

get_inscription_content ~57

Get the raw content of a Bitcoin Ordinals inscription. Returns text content directly or base64-encoded binary data with content type.

Input Output Examples

Name	Type	Req	Description
id	string	yes	Inscription ID ({txid}i{index}) or inscription number

No output schema declared.

No examples provided.

get_inscription_traits ~50

Get trait information for a collection inscription. Returns trait types and values (e.g., background, body, eyes).

Input Output Examples

Name	Type	Req	Description
id	string	yes	Inscription ID ({txid}i{index})

No output schema declared.

No examples provided.

get_inscription_transfers ~79

Get the transfer history for a Bitcoin Ordinals inscription. Shows each transfer with block, address, transaction, and timestamp.

Input Output Examples

Name	Type	Req	Description
id	string	yes	Inscription ID ({txid}i{index}) or inscription number
limit	number	—	Results per page (max 60)
offset	number	—	Pagination offset

No output schema declared.

No examples provided.

get_rune_activity ~79

Get recent activity (mints, transfers, burns) for a Bitcoin Rune. Returns operation type, addresses, amounts, and timestamps.

Input Output Examples

Name	Type	Req	Description
limit	number	—	Results per page
name	string	yes	Rune name (e.g., UNCOMMON•GOODS or UNCOMMONGOODS)
offset	number	—	Pagination offset

No output schema declared.

No examples provided.

get_rune_balances ~61

Get Rune token balances for a Bitcoin address. Returns rune name, symbol, and balance for each rune held.

Input Output Examples

Name	Type	Req	Description
address	string	yes	Bitcoin address
limit	number	—	Results per page
offset	number	—	Pagination offset

No output schema declared.

No examples provided.

get_rune_holders ~70

Get top holders of a Bitcoin Rune. Returns addresses and balances sorted by amount held.

Input Output Examples

Name	Type	Req	Description
limit	number	—	Results per page
name	string	yes	Rune name (e.g., UNCOMMON•GOODS or UNCOMMONGOODS)
offset	number	—	Pagination offset

No output schema declared.

No examples provided.

get_rune_info ~61

Get details for a Bitcoin Rune by name. Returns symbol, divisibility, supply, premine, mint terms, and etching transaction.

Input Output Examples

Name	Type	Req	Description
name	string	yes	Rune name (e.g., UNCOMMON•GOODS or UNCOMMONGOODS)

No output schema declared.

No examples provided.

get_rune_market_info ~56

Get market data for a Bitcoin Rune. Returns price in USD, market cap, and 24h volume.

Input Output Examples

Name	Type	Req	Description
name	string	yes	Rune name (e.g., UNCOMMON•GOODS or UNCOMMONGOODS)

No output schema declared.

No examples provided.

get_rune_unlock_date ~43

Check when a rune name becomes available for etching. Returns unlock block height and estimated date.

Input Output Examples

Name	Type	Req	Description
name	string	yes	Rune name to check availability for

No output schema declared.

No examples provided.

get_sat_info ~61

Get information about a specific satoshi by its ordinal number. Returns rarity level, epoch, cycle, period, name, and any inscription on it.

Input Output Examples

Name	Type	Req	Description
ordinal	string	yes	Satoshi ordinal number (e.g., 1857578125803250)

No output schema declared.

No examples provided.

get_tx_inscriptions ~42

Get all Ordinals inscriptions contained in a Bitcoin transaction. Returns inscription IDs, numbers, and content types.

Input Output Examples

Name	Type	Req	Description
txid	string	yes	Bitcoin transaction ID

No output schema declared.

No examples provided.

get_tx_runes ~42

Get all Rune transfers in a Bitcoin transaction. Returns rune names, amounts, addresses, and operation types.

Input Output Examples

Name	Type	Req	Description
txid	string	yes	Bitcoin transaction ID

No output schema declared.

No examples provided.

list_runes ~58

List Bitcoin Runes with pagination. Returns rune name, symbol, supply, divisibility, mint terms, and etching info.

Input Output Examples

Name	Type	Req	Description
limit	number	—	Results per page (max 60)
offset	number	—	Pagination offset

No output schema declared.

No examples provided.

search_inscriptions ~172

Search and list Bitcoin Ordinals inscriptions with filters. Filter by address, MIME type, sat rarity, block range, inscription number range, recursive/cursed status.

Input Output Examples

Name	Type	Req	Description
address	string	—	Filter by owner Bitcoin address
cursed	boolean	—	Filter cursed inscriptions
from_block	number	—	Start block height
from_number	number	—	Start inscription number
limit	number	—	Results per page (max 60)
mime_type	string	—	Filter by MIME type (e.g., image/png, text/plain)
offset	number	—	Pagination offset
rarity	string	—	Filter by sat rarity
recursive	boolean	—	Filter recursive inscriptions
to_block	number	—	End block height
to_number	number	—	End inscription number

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 3 Aug