Ordiscan MCP Server
About
An MCP server for getting information about Ordinals and Runes on Bitcoin
Details
- Author
- ordiscan
- GitHub stars
- 10
- Downloads
- 303
- Categories
- Other, AI
Jump to
- 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:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Ordiscan MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- 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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.




