Ordinals

Bitcoin Ordinals MCP Server provides multi-API access to inscriptions, runes, BRC-20 tokens, collections, marketplace data, and rare sats. It aggregates data from multiple sources with built-in caching and rate limiting, giving AI models comprehensive access to the Bitcoin Ordinals ecosystem.

How to use

You can integrate this MCP server with an MCP client to access a wide range of ordinal data through a single, unified API surface. Use the provided MCP configuration to run the server through the client, then query inscriptions, runes, BRC-20 tokens, collections, marketplace data, and more. The server handles data aggregation, caching, and rate limiting to ensure reliable access.

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

How to use the provided MCP configuration

The following configuration enables the ordinals MCP server as a local MCP endpoint that your client can start and communicate with.

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

Supported APIs and data access

You can query a broad set of tools to work with inscriptions, addresses, runes, BRC-20 tokens, collections, marketplace data, and sats. Data is retrieved from multiple sources with automatic caching and rate limiting to ensure responsiveness and reliability.

Environment variables

At least one API key is required to run the server. The following environment variables are supported when starting the MCP server.

Available tools

get_inscription

Get inscription metadata by ID or number.

search_inscriptions

Filter inscriptions by address, mime type, rarity, block range, and other criteria.

get_inscription_content

Retrieve raw inscription content such as text or images.

get_inscription_transfers

Fetch transfer history for a specific inscription.

get_inscription_traits

Obtain trait information for collection inscriptions.

get_address_inscriptions

List all inscriptions owned by an address.

get_brc20_balances

Show BRC-20 token balances for an address.

get_rune_balances

Show Rune balances for an address.

get_address_rare_sats

Show rare sats held by an address.

get_rune_info

Fetch details about a rune including symbol, supply, and mint terms.

list_runes

List all runes with pagination.

get_rune_holders

Identify top holders of a rune.

get_rune_activity

Retrieve recent mints, transfers, and burns for a rune.

get_rune_market_info

Fetch price, market cap, and 24h volume for a rune.

get_rune_unlock_date

Determine when a rune name becomes available.

get_brc20_token

Get details about a BRC-20 token (supply, mint limit, decimals).

get_brc20_activity

Fetch deploy, mint, and transfer events for a BRC-20 token.

get_brc20_holders

Identify top holders of a BRC-20 token.

get_collection_info

Retrieve collection stats, floor price, and volume.

get_collection_inscriptions

List inscriptions within a collection.

get_collection_listings

Query active Magic Eden marketplace listings.

get_sat_info

Get sat rarity, epoch, and inscriptions information.

get_tx_inscriptions

List inscriptions in a transaction.

get_tx_runes

Show rune transfers within a transaction.