How should ordinals-mcp be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this mcp.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

Crawler Summary

ordinals-mcp answer-first brief

Bitcoin Ordinals MCP Server — inscriptions, runes, BRC-20, collections, marketplace data ordinals-mcp $1 $1 $1 <p align="center"> <img src="logo.png" alt="ordinals-mcp" width="140" height="140" style="border-radius: 50%;"> </p> Bitcoin Ordinals MCP Server — multi-API access to inscriptions, runes, BRC-20 tokens, collections, marketplace data, and rare sats. A $1 server that gives AI models comprehensive access to the Bitcoin Ordinals ecosystem. Aggregates data from multiple APIs with built-in caching and Capability contract not published. No trust telemetry is available yet. Last updated 2/25/2026.

Freshness

Last checked 2/25/2026

Best For

ordinals-mcp is best for bitcoin, ordinals, inscriptions workflows where MCP compatibility matters.

Not Ideal For

Contract metadata is missing or unavailable for deterministic execution.

Evidence Sources Checked

editorial-content, GITHUB MCP, runtime-metrics, public facts pack

Card Facts Snapshot Contract Trust

Claim this agent

Agent DossierGitHubSafety: 89/100

ordinals-mcp

MCPself-declared

Public facts

Change events

Artifacts

Freshness

Feb 25, 2026

Verifiededitorial-contentNo verified compatibility signals

Capability contract not published. No trust telemetry is available yet. Last updated 2/25/2026.

Trust evidence available

Trust score

Unknown

Compatibility

MCP

Freshness

Feb 25, 2026

Vendor

Pages

Artifacts

Benchmarks

Last release

0.2.0

Executive Summary

Key links, install path, and a quick operational read before the deeper crawl record.

Verifiededitorial-content

Summary

Capability contract not published. No trust telemetry is available yet. Last updated 2/25/2026.

View Source Homepage

Setup snapshot

git clone https://github.com/ExpertVagabond/ordinals-mcp.git

1
Setup complexity is MEDIUM. Standard integration tests and API key provisioning are required before connecting this to production workloads.
2
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Evidence Ledger

Everything public we have scraped or crawled about this agent, grouped by evidence type with provenance.

Verifiededitorial-content

Vendor (1)

Vendor

Pages

profilemedium

Observed Feb 25, 2026Source link Provenance

Compatibility (1)

Protocol compatibility

MCP

contractmedium

Observed Feb 25, 2026Source link Provenance

Security (1)

Handshake status

UNKNOWN

trustmedium

Observed unknownSource link Provenance

Release & Crawl Timeline

Merged public release, docs, artifact, benchmark, pricing, and trust refresh events.

Self-declaredagent-index

Artifacts Archive

Extracted files, examples, snippets, parameters, dependencies, permissions, and artifact metadata.

Self-declaredGITHUB MCP

Extracted files

Examples

Snippets

Languages

typescript

Executable Examples

json

{
  "mcpServers": {
    "ordinals": {
      "command": "npx",
      "args": ["ordinals-mcp@latest"],
      "env": {
        "HIRO_API_KEY": "your-key",
        "ORDISCAN_API_KEY": "your-key"
      }
    }
  }
}

text

Request -> Cache (TTL + ETag)
  |-> HIT: return cached
  |-> MISS:
      |-> Hiro (primary, 500 RPM)
      |   |-> Success: cache + return
      |   |-> Rate limited:
      |       |-> Ordiscan (fallback)
      |       |-> Stale cache (last resort)
      |-> Magic Eden (marketplace-specific)

bash

npm install
npm run build          # TypeScript + esbuild bundle
npm run watch          # TypeScript watch mode
npm run inspector      # MCP Inspector for testing

Docs & README

Full documentation captured from public sources, including the complete README when available.

Self-declaredGITHUB MCP

Docs source

GITHUB MCP

Editorial quality

ready

Full README

ordinals-mcp

Bitcoin Ordinals MCP Server — multi-API access to inscriptions, runes, BRC-20 tokens, collections, marketplace data, and rare sats.

A Model Context Protocol server that gives AI models comprehensive access to the Bitcoin Ordinals ecosystem. Aggregates data from multiple APIs with built-in caching and rate limiting.

Quick Start

Claude Desktop / Claude Code

Add to your MCP config:

{
  "mcpServers": {
    "ordinals": {
      "command": "npx",
      "args": ["ordinals-mcp@latest"],
      "env": {
        "HIRO_API_KEY": "your-key",
        "ORDISCAN_API_KEY": "your-key"
      }
    }
  }
}

Get API Keys (free)

Hiro (primary, 500 RPM): platform.hiro.so
Ordiscan (secondary): ordiscan.com/docs/api
Magic Eden (marketplace, optional): docs.magiceden.io

At least one of HIRO_API_KEY or ORDISCAN_API_KEY is required.

24 Tools

Inscriptions

| Tool | Description | |------|-------------| | get_inscription | Get inscription metadata by ID or number | | search_inscriptions | Search/filter inscriptions (address, mime type, rarity, block range) | | get_inscription_content | Get raw inscription content (text, images, etc.) | | get_inscription_transfers | Get transfer history for an inscription | | get_inscription_traits | Get trait info for collection inscriptions |

Address Lookups

| Tool | Description | |------|-------------| | get_address_inscriptions | All inscriptions owned by an address | | get_brc20_balances | BRC-20 token balances for an address | | get_rune_balances | Rune balances for an address | | get_address_rare_sats | Rare satoshis held by an address |

Runes

| Tool | Description | |------|-------------| | get_rune_info | Rune details (symbol, supply, mint terms) | | list_runes | List all runes with pagination | | get_rune_holders | Top holders of a rune | | get_rune_activity | Recent mints, transfers, burns | | get_rune_market_info | Price, market cap, 24h volume | | get_rune_unlock_date | When a rune name becomes available |

BRC-20

| Tool | Description | |------|-------------| | get_brc20_token | Token details (supply, mint limit, decimals) | | get_brc20_activity | Deploy, mint, transfer events | | get_brc20_holders | Top holders of a BRC-20 token |

Collections & Marketplace

| Tool | Description | |------|-------------| | get_collection_info | Collection stats, floor price, volume | | get_collection_inscriptions | List inscriptions in a collection | | get_collection_listings | Active Magic Eden marketplace listings |

Satoshis & Transactions

| Tool | Description | |------|-------------| | get_sat_info | Sat rarity, epoch, inscriptions | | get_tx_inscriptions | Inscriptions in a transaction | | get_tx_runes | Rune transfers in a transaction |

Architecture

Multi-API with Fallback

Request -> Cache (TTL + ETag)
  |-> HIT: return cached
  |-> MISS:
      |-> Hiro (primary, 500 RPM)
      |   |-> Success: cache + return
      |   |-> Rate limited:
      |       |-> Ordiscan (fallback)
      |       |-> Stale cache (last resort)
      |-> Magic Eden (marketplace-specific)

Built-in Rate Limiting

Per-API token bucket rate limiters with 80% safety margin. Automatic wait-and-retry when approaching limits.

Intelligent Caching

| Data Type | TTL | |-----------|-----| | Sat rarity | 24 hours | | Inscription metadata | 5 minutes | | Rune etching info | 5 minutes | | Collection info | 2 minutes | | Balances | 1 minute | | Marketplace listings | 30 seconds |

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | HIRO_API_KEY | Yes* | Hiro API key (500 RPM) | | ORDISCAN_API_KEY | Yes* | Ordiscan API key | | MAGIC_EDEN_API_KEY | No | Higher marketplace rate limits | | CACHE_TTL_SECONDS | No | Default cache TTL (default: 300) | | RATE_LIMIT_BUFFER | No | Rate limit safety margin (default: 0.8) |

*At least one API key is required.

Development

npm install
npm run build          # TypeScript + esbuild bundle
npm run watch          # TypeScript watch mode
npm run inspector      # MCP Inspector for testing

License

MIT

Contract & API

Machine endpoints, protocol fit, contract coverage, invocation examples, and guardrails for agent-to-agent use.

MissingGITHUB MCP

Endpoints

Dossier API Snapshot API Contract API Trust API

Contract coverage

Status

missing

Auth

None

Streaming

Data region

Unspecified

Protocol support

MCP: self-declared

Requires: none

Forbidden: none

Guardrails

Operational confidence: low

No positive guardrails captured.

Invocation examples

curl -s "https://xpersona.co/api/v1/agents/mcp-expertvagabond-ordinals-mcp/snapshot"

curl -s "https://xpersona.co/api/v1/agents/mcp-expertvagabond-ordinals-mcp/contract"

curl -s "https://xpersona.co/api/v1/agents/mcp-expertvagabond-ordinals-mcp/trust"

Reliability & Benchmarks

Trust and runtime signals, benchmark suites, failure patterns, and practical risk constraints.

Missingruntime-metrics

Trust signals

Handshake

UNKNOWN

Confidence

unknown

Attempts 30d

unknown

Fallback rate

unknown

Runtime metrics

Observed P50

unknown

Observed P95

unknown

Rate limit

unknown

Estimated cost

unknown

Do not use if

Contract metadata is missing or unavailable for deterministic execution.

No benchmark suites or observed failure patterns are available.

Media & Demo

Every public screenshot, visual asset, demo link, and owner-provided destination tied to this agent.

Missingno-media

No screenshots, media assets, or demo links are available.

Related Agents

Neighboring agents from the same protocol and source ecosystem for comparison and shortlist building.

Self-declaredprotocol-neighbors

GITLAB_AI_CATALOGgitlab-mcp

Rank

A Model Context Protocol (MCP) server for GitLab

Traction

No public download signal

Freshness

Updated 2d ago

MCP

GITLAB_PUBLIC_PROJECTSgitlab-mcp

Rank

A Model Context Protocol (MCP) server for GitLab

Traction

No public download signal

Freshness

Updated 2d ago

MCP

GITLAB_AI_CATALOGrmcp-openapi

Rank

Expose OpenAPI definition endpoints as MCP tools using the official Rust SDK for the Model Context Protocol (https://github.com/modelcontextprotocol/rust-sdk)

Traction

No public download signal

Freshness

Updated 2d ago

MCP

GITLAB_AI_CATALOGrmcp-actix-web

Rank

An actix_web backend for the official Rust SDK for the Model Context Protocol (https://github.com/modelcontextprotocol/rust-sdk)

Traction

No public download signal

Freshness

Updated 2d ago

MCP

Machine Appendix

Contract JSON

{
  "contractStatus": "missing",
  "authModes": [],
  "requires": [],
  "forbidden": [],
  "supportsMcp": false,
  "supportsA2a": false,
  "supportsStreaming": false,
  "inputSchemaRef": null,
  "outputSchemaRef": null,
  "dataRegion": null,
  "contractUpdatedAt": null,
  "sourceUpdatedAt": null,
  "freshnessSeconds": null
}

Invocation Guide

{
  "preferredApi": {
    "snapshotUrl": "https://xpersona.co/api/v1/agents/mcp-expertvagabond-ordinals-mcp/snapshot",
    "contractUrl": "https://xpersona.co/api/v1/agents/mcp-expertvagabond-ordinals-mcp/contract",
    "trustUrl": "https://xpersona.co/api/v1/agents/mcp-expertvagabond-ordinals-mcp/trust"
  },
  "curlExamples": [
    "curl -s \"https://xpersona.co/api/v1/agents/mcp-expertvagabond-ordinals-mcp/snapshot\"",
    "curl -s \"https://xpersona.co/api/v1/agents/mcp-expertvagabond-ordinals-mcp/contract\"",
    "curl -s \"https://xpersona.co/api/v1/agents/mcp-expertvagabond-ordinals-mcp/trust\""
  ],
  "jsonRequestTemplate": {
    "query": "summarize this repo",
    "constraints": {
      "maxLatencyMs": 2000,
      "protocolPreference": [
        "MCP"
      ]
    }
  },
  "jsonResponseTemplate": {
    "ok": true,
    "result": {
      "summary": "...",
      "confidence": 0.9
    },
    "meta": {
      "source": "GITHUB_MCP",
      "generatedAt": "2026-04-17T00:19:05.510Z"
    }
  },
  "retryPolicy": {
    "maxAttempts": 3,
    "backoffMs": [
      500,
      1500,
      3500
    ],
    "retryableConditions": [
      "HTTP_429",
      "HTTP_503",
      "NETWORK_TIMEOUT"
    ]
  }
}

Trust JSON

{
  "status": "unavailable",
  "handshakeStatus": "UNKNOWN",
  "verificationFreshnessHours": null,
  "reputationScore": null,
  "p95LatencyMs": null,
  "successRate30d": null,
  "fallbackRate": null,
  "attempts30d": null,
  "trustUpdatedAt": null,
  "trustConfidence": "unknown",
  "sourceUpdatedAt": null,
  "freshnessSeconds": null
}

Capability Matrix

{
  "rows": [
    {
      "key": "MCP",
      "type": "protocol",
      "support": "unknown",
      "confidenceSource": "profile",
      "notes": "Listed on profile"
    },
    {
      "key": "bitcoin",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "ordinals",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "inscriptions",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "runes",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "brc-20",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "mcp",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "model-context-protocol",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "ai",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    },
    {
      "key": "cli",
      "type": "capability",
      "support": "supported",
      "confidenceSource": "profile",
      "notes": "Declared in agent profile metadata"
    }
  ],
  "flattenedTokens": "protocol:MCP|unknown|profile capability:bitcoin|supported|profile capability:ordinals|supported|profile capability:inscriptions|supported|profile capability:runes|supported|profile capability:brc-20|supported|profile capability:mcp|supported|profile capability:model-context-protocol|supported|profile capability:ai|supported|profile capability:cli|supported|profile"
}

Facts JSON

[
  {
    "factKey": "vendor",
    "category": "vendor",
    "label": "Vendor",
    "value": "Pages",
    "href": "https://ordinals-mcp.pages.dev",
    "sourceUrl": "https://ordinals-mcp.pages.dev",
    "sourceType": "profile",
    "confidence": "medium",
    "observedAt": "2026-02-25T03:12:45.030Z",
    "isPublic": true
  },
  {
    "factKey": "protocols",
    "category": "compatibility",
    "label": "Protocol compatibility",
    "value": "MCP",
    "href": "https://xpersona.co/api/v1/agents/mcp-expertvagabond-ordinals-mcp/contract",
    "sourceUrl": "https://xpersona.co/api/v1/agents/mcp-expertvagabond-ordinals-mcp/contract",
    "sourceType": "contract",
    "confidence": "medium",
    "observedAt": "2026-02-25T03:12:45.030Z",
    "isPublic": true
  },
  {
    "factKey": "handshake_status",
    "category": "security",
    "label": "Handshake status",
    "value": "UNKNOWN",
    "href": "https://xpersona.co/api/v1/agents/mcp-expertvagabond-ordinals-mcp/trust",
    "sourceUrl": "https://xpersona.co/api/v1/agents/mcp-expertvagabond-ordinals-mcp/trust",
    "sourceType": "trust",
    "confidence": "medium",
    "observedAt": null,
    "isPublic": true
  }
]

Change Events JSON

[]

ordinals-mcp answer-first brief

Executive Summary

Evidence Ledger

Release & Crawl Timeline

Artifacts Archive

Docs & README

ordinals-mcp

Quick Start

Claude Desktop / Claude Code

Get API Keys (free)

24 Tools

Inscriptions

Address Lookups

Runes

BRC-20

Collections & Marketplace

Satoshis & Transactions

Architecture

Multi-API with Fallback

Built-in Rate Limiting

Intelligent Caching

Environment Variables

Development

Links

License

Contract & API

Reliability & Benchmarks

Media & Demo

Related Agents