Ordiscan MCP Server

by ordiscan

10 stars
303 downloads
Not rated
GitHub

About

An MCP server for getting information about Ordinals and Runes on Bitcoin

Details

Author
ordiscan
GitHub stars
10
Downloads
303
Categories
Other, AI

- Access Ordinals and Runes data on Bitcoin
- Integrates with MCP‑compatible clients (e.g., Claude Desktop)
- Requires only an API key and Node.js to run

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Ordiscan MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Configure the server in your Claude Desktop configuration file (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json; Windows: %APPDATA%/Claude/claude_desktop_config.json) with the npx command ordiscan-mcp@latest and an ORDISCAN_API_KEY environment variable. Obtain a free API key from ordiscan.com/docs/api.

inscriptions_list

Get a list of the oldest or newest inscriptions

inscription_info

Get inscription info

inscription_traits

Get the traits of an inscription

inscribe

Generate a link to prepare for the inscription of the content

sat_info

Get sat info

runes_list

Get a list of the oldest or newest runes

rune_info

Get rune info

mint_rune

Generate a link that lets the user mint a specific rune

rune_market_info

Get the latest price of a rune

rune_name_unlock

Get the unlock date/block for a specific rune name

inscription_collection_info

Get info about an Ordinals collection

owned_inscriptions

Get all inscription IDs owned by a Bitcoin address

runes_balance

Get the rune balances of a Bitcoin address

brc20_balance

Get the BRC-20 balances of a Bitcoin address

rare_sat_balance

Get the rare sats for a Bitcoin address

tx_inscriptions

Get inscriptions in a transaction

tx_runes

Get runes in a transaction

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "ordiscan mcp server": {
            "ordiscan": {
                "command": "npx",
                "args": [
                    "ordiscan-mcp@latest"
                ],
                "env": {
                    "ORDISCAN_API_KEY": "YOUR_API_KEY"
                }
            }
        }
    }
}

McpServers

{
    "ordiscan": {
        "command": "npx",
        "args": [
            "ordiscan-mcp@latest"
        ],
        "env": {
            "ORDISCAN_API_KEY": "YOUR_API_KEY"
        }
    }
}

Ordiscan MCP Server

A model context protocol server for getting information about Ordinals and Runes on Bitcoin

https://github.com/user-attachments/assets/9dddacdf-add0-4a96-8444-5e0803e695a7

Installation

To use with Claude Desktop, add the server config:

- On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "ordiscan": {
      "command": "npx",
      "args": [
        "ordiscan-mcp@latest"
      ],
      "env": {
        "ORDISCAN_API_KEY": "YOUR_API_KEY"
      }
    },

}
}

Note that you need an Ordiscan API key, which you can obtain for free here.

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.