Ordinals MCP Server

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. It runs locally over stdio via the published package.

People connecting finance tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-03-31 · ★ 2 · #189 OF 283 MAINTAINED FINANCE · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install Ordinals

before you install - you'll need

Set HIRO_API_KEY, ORDISCAN_API_KEY before connecting.

Claude Code

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

Claude Desktop / Cursor / VS Code - add to config

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

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package ordinals-mcp - unscoped; check the name against the project README before installing

registry namespace io.github.ExpertVagabond is GitHub-verified and matches the repo owner

03 · What Ordinals can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v0.1.1 · 2026-02-14

ordinals-mcp v0.1.1 · Added landing page at ordinals-mcp.pages.dev · Added logo and website badge to README · Updated homepage URL in package metadata · Install · npx ordinals-mcp@latest

04 · Who maintains Ordinals

ordinals is maintained by expertvagabond. We track 15 MCP servers from expertvagabond - 15 actively maintained, 11 combined GitHub stars, oldest repo from Sep 2025. Full record: all servers from expertvagabond.

raycast Raycast workflow automation MCP server with 9 tools ★ 5

05 · Facts

repository: github.com/expertvagabond/ordinals-mcp
category: finance - ranked #189 of 283 actively-maintained finance servers as of 2026-08-25.
registry: io.github.ExpertVagabond/ordinals (active, first published 2026-02-14)
packages: npm:ordinals-mcp

06 · Ordinals FAQ

What is Ordinals?

Is Ordinals still maintained?

Yes - as of 2026-08-25, its last commit was 2026-03-31. We re-verify nightly.

How do I install Ordinals?

Run `npx -y ordinals-mcp`. The README documents 2 environment variables (HIRO_API_KEY, ORDISCAN_API_KEY) to set first. Set HIRO_API_KEY, ORDISCAN_API_KEY before connecting. You can also paste the ready-made client config above.

Does Ordinals run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Ordinals

Alternatives to Ordinals

Maintained finance servers if Ordinals isn't the fit.

Pairs well with

Servers that cover what Ordinals doesn't - only shown when the pairing reason fits the companion.

More finance MCP servers · Document to JSON – PDF Invoice/Statement/Contract Parser · Spectra MCP Server · FinStack MCP · Frihet ERP · Fullbleed PDF Engine

More TypeScript MCP servers · Yieldagentx402 · Nuxt I18n MCP · Workix · Harmonyos · u-he Preset Randomizer · see all