Independent Reserve

You can run this MCP server to fetch real-time Independent Reserve cryptocurrency data inside your AI assistants. It exposes simple tools to query current prices and market data, and it automatically reconnects when the connection drops so you can rely on up-to-date information during conversations.

How to use

After you start the MCP server, you can ask your AI assistant for real-time price data and market depth. The server provides two primary tools you can call:

• get_ticker(primary_currency, secondary_currency): Retrieve the latest ticker data including price, bid, ask, and volume for a currency pair.
• get_order_book(primary_currency, secondary_currency): Retrieve the current order book with buy and sell side data for a currency pair.

You can ask about any supported pair like BTC/USD or ETH/AUD. If you expect follow-up questions, you can stay subscribed to a specific pair for a short time to avoid repeated reconnections.

How to install

Prerequisites you need on your machine

• Python 3.8 or newer
• pip (Python package manager)

Install dependencies and run the MCP server locally

pip install -r requirements.txt

Prepare configuration for API keys (optional for public data)

cp .env.example .env

Edit credentials in the .env file if you need private data features later

# Open .env and fill in keys as needed

Start the MCP server using Python

python server.py

Configuration and usage notes

Environment variables shown to enable authentication or private data features can be supplied when starting the server. The example keys are IR_API_KEY and IR_API_SECRET and are optional for public data.

Connecting Claude Desktop

To connect Claude Desktop to your local MCP server, add a local stdio MCP configuration so Claude can launch the server process and communicate with it.

Place this configuration in your Claude Desktop config file. Replace the path with the absolute path to where you keep the server on your machine.

{
  "mcpServers": {
    "independentreserve": {
      "command": "python",
      "args": [
        "/path/to/your/independentreserve-mcp/server.py"
      ],
      "env": {
        "IR_API_KEY": "your_api_key_if_needed",
        "IR_API_SECRET": "your_api_secret_if_needed"
      }
    }
  }
}

Restart Claude Desktop after saving the config. Claude will start the local MCP server and you can begin asking about Independent Reserve data.

Next steps and improvements

Authentication for private channels, smarter subscription handling, enhanced error handling, and additional data endpoints like recent trades are planned improvements.

Available tools

get_ticker

Fetches the latest ticker information for a given currency pair, returning price, bid, ask, and volume.

get_order_book

Fetches the current live order book for a given currency pair, showing current buys and sells.