ordiscan

Ordiscan MCP Server is a model context protocol service that provides information about Ordinals and Runes on Bitcoin. It exposes capabilities to fetch and contextualize data related to ordinal inscriptions and rune metadata, enabling supported clients to request relevant contextual information during conversations. To use it, configure your MCP client (e.g., Claude Desktop) to load the server by adding the ordiscan entry to your MCP configuration, supplying your Ordiscan API key. Once the server is running, you can send queries through the MCP interface to retrieve ordinal/rune details, such as inscription status, metadata, and related attributes, which can be incorporated into model-assisted responses.

The server is invoked via npx with the ordiscan-mcp package. You will need an API key from Ordiscan (free tier available) and include it in the environment when starting the server. After configuration, clients can rely on the server to provide up-to-date ordinal and rune information as part of the model’s context while composing replies.

Prerequisites:

• Node.js and npm installed on your system.
• Access to the internet to fetch the ordiscan-mcp package from npm.

Installation steps:

1. Install dependencies (project root):

npm install

2. Build the server (if the package provides a build step):

npm run build

3. Run the MCP server via npx with proper configuration. Set your Claude/MCP config to include the ordiscan server (as shown in the README):

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

4. (Optional) For development with auto-rebuild, you can run:

npm run watch

5. Ensure the MCP server is reachable by your client (Claude Desktop or other MCP-compliant client) by placing the configuration in the appropriate path (macOS key: ~/Library/Application Support/Claude/claude_desktop_config.json or Windows: %APPDATA%/Claude/claude_desktop_config.json).

Note: Replace YOUR_API_KEY with a valid Ordiscan API key. The exact commands may vary slightly depending on your environment and the packaging of ordiscan-mcp.

Tips and common notes:

• You must obtain an Ordiscan API key to access the service; without it the MCP server will not be able to fetch data.
• In Claude Desktop, ensure the config file path is correct for your OS so the server is loaded at startup.
• The npm_package name to install via npx is ordiscan-mcp; use the latest tag to keep features up to date.
• If you encounter network or API authentication errors, verify that ORDISCAN_API_KEY is correctly set in the environment where the MCP server runs.
• If building locally, use npm run build prior to starting the server to ensure all assets are prepared.
• This MCP server relies on external Ordiscan endpoints; latency or API changes on Ordiscan’s side may affect response times or available data.