OrdiscanMCP v1

You run the OrdiscanMCP v1 server to access Ordiscan tools via an MCP-style interface. It provides an HTTP stream transport on port 1337 with real-time stream responses, direct API access to Ordiscan, and Bearer token authentication. This setup lets your MCP client query a comprehensive set of tools for inscriptions, runes, UTXOs, collections, and more, all with robust parameter handling and clear response formatting.

How to use

Start the MCP server and configure your client to connect over HTTP or via a local stdio integration. You can connect directly to the MCP endpoint at the provided HTTP URL for real-time streaming responses, or you can launch a local stdio-based MCP subprocess as described in the setup. Use your API key with every request to authenticate using the Bearer token scheme.

How to install

Prerequisites: make sure you have Node.js installed on your system. You will also need npm to manage dependencies.

Install dependencies and build the project.

npm install

npm run build

Configure your MCP client with the following example. This enables the client to connect to the Ordiscan MCP v1 server via the remote endpoint.

{
  "mcpServers": {
    "ordiscanmcpv1": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://your-deployed-server.com/mcp"  
      ]
    }
  }
}

Start the server to begin serving MCP requests.

npm start

For development with hot-reload you can run the development command.

npm run dev

Additional setup and notes

Authentication uses a Bearer token. You can provide the API key either as a parameter in each tool call (apiKey) or through the environment variable ORD ISC AN_API_KEY. All requests must include the header Authorization: Bearer <your-api-key>. Ensure your API key is kept secure and rotated periodically.

Environment variables that are used by the server can be supplied as part of your MCP config for the stdio setup. The key variable to store your API key is ORDISCAN_API_KEY.

Security considerations

Treat your API keys as secrets. Do not hardcode them in your codebase. Use environment variables and rotate keys regularly. Implement proper error handling to avoid leaking sensitive information in error messages.

Notes

The MCP server exposes an HTTP stream transport on port 1337. You can also connect via a local stdio-based subprocess if you prefer running the solver locally with a command like npx mcp-remote ....

Available tools

ordiscan_main

General-purpose tool for rune information and status

ordiscan_utxo

Get all UTXOs owned by a Bitcoin address

ordiscan_inscriptions

Get inscription information for an address (basic)

ordiscan_inscriptions_detail

Get detailed inscription information for an address (detailed)

ordiscan_runes_balance

Get rune balances for an address

ordiscan_brc20_balance

Get BRC-20 token balances for an address

ordiscan_rare_sats

Get rare sats owned by an address

ordiscan_inscriptions_activity

Track inscription transfers for an address

ordiscan_runes_activity

Track rune transfers for an address

ordiscan_brc20_activity

Track BRC-20 token transfers for an address

ordiscan_tx_info

Get detailed information about a transaction

ordiscan_tx_inscriptions

Get inscriptions in a transaction

ordiscan_tx_inscription_transfers

Track inscription transfers in a transaction

ordiscan_tx_runes

Track rune transfers in a transaction

ordiscan_inscription_info

Get detailed information about an inscription (specific)

ordiscan_inscription_traits

Get traits for an inscription

ordiscan_inscriptions_list

Get a paginated list of all inscriptions

ordiscan_inscriptions_transfers

Track transfers of an inscription

ordiscan_collections_list

Get a paginated list of collections

ordiscan_collection_info

Get detailed information about a collection

ordiscan_collection_inscriptions

Get inscriptions in a collection

ordiscan_runes_list

Get a list of all runes

ordiscan_rune_market

Get market information for a rune

ordiscan_rune_name_unlock

Check rune name availability

ordiscan_brc20_list

Get a list of all BRC-20 tokens

ordiscan_brc20_info

Get detailed information about a BRC-20 token

ordiscan_sat_info

Get information about a specific sat

ordiscan_utxo_rare_sats

Get rare sats in a UTXO

ordiscan_utxo_sat_ranges

Get sat ranges in a UTXO