ordinals

Name: ordinals
Author: ExpertVagabond

ExpertVagabond

Bitcoin Ordinals MCP server — 24 tools for inscriptions, runes, BRC-20, collections, marketplace data, and rare sats. Published on npm.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add ordinals --env HIRO_API_KEY='<HIRO_API_KEY>' --env ORDISCAN_API_KEY='<ORDISCAN_API_KEY>' --env MAGIC_EDEN_API_KEY='<MAGIC_EDEN_API_KEY>' -- npx -y ordinals-mcp

~/.codex/config.toml

[mcp_servers.ordinals]
command = "npx"
args = ["-y", "ordinals-mcp"]
env = { HIRO_API_KEY = "<HIRO_API_KEY>", ORDISCAN_API_KEY = "<ORDISCAN_API_KEY>", MAGIC_EDEN_API_KEY = "<MAGIC_EDEN_API_KEY>" }

# codex mcp add ordinals --env HIRO_API_KEY='<HIRO_API_KEY>' --env ORDISCAN_API_KEY='<ORDISCAN_API_KEY>' --env MAGIC_EDEN_API_KEY='<MAGIC_EDEN_API_KEY>' -- npx -y ordinals-mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "ordinals": {
      "command": "npx",
      "args": [
        "-y",
        "ordinals-mcp"
      ],
      "env": {
        "HIRO_API_KEY": "<HIRO_API_KEY>",
        "ORDISCAN_API_KEY": "<ORDISCAN_API_KEY>",
        "MAGIC_EDEN_API_KEY": "<MAGIC_EDEN_API_KEY>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "ordinals": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "ordinals-mcp"
      ],
      "env": {
        "HIRO_API_KEY": "<HIRO_API_KEY>",
        "ORDISCAN_API_KEY": "<ORDISCAN_API_KEY>",
        "MAGIC_EDEN_API_KEY": "<MAGIC_EDEN_API_KEY>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "ordinals": {
      "command": "npx",
      "args": [
        "-y",
        "ordinals-mcp"
      ],
      "env": {
        "HIRO_API_KEY": "<HIRO_API_KEY>",
        "ORDISCAN_API_KEY": "<ORDISCAN_API_KEY>",
        "MAGIC_EDEN_API_KEY": "<MAGIC_EDEN_API_KEY>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "ordinals": {
      "command": "npx",
      "args": [
        "-y",
        "ordinals-mcp"
      ],
      "env": {
        "HIRO_API_KEY": "<HIRO_API_KEY>",
        "ORDISCAN_API_KEY": "<ORDISCAN_API_KEY>",
        "MAGIC_EDEN_API_KEY": "<MAGIC_EDEN_API_KEY>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "ordinals": {
      "command": "npx",
      "args": [
        "-y",
        "ordinals-mcp"
      ],
      "env": {
        "HIRO_API_KEY": "<HIRO_API_KEY>",
        "ORDISCAN_API_KEY": "<ORDISCAN_API_KEY>",
        "MAGIC_EDEN_API_KEY": "<MAGIC_EDEN_API_KEY>"
      }
    }
  }
}

Environment variables

HIRO_API_KEY
ORDISCAN_API_KEY
MAGIC_EDEN_API_KEY

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related