refinore

Exposes refinORE mining API as MCP tools for AI agents to control ORE mining.

javascript

0

GitHub Stars

javascript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "jusscubs-refinore-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "refinore-mcp"
      ],
      "env": {
        "REFINORE_API_KEY": "rsk_your_key_here",
        "REFINORE_API_URL": "https://automine.refinore.com/api"
      }
    }
  }
}

You gain direct, AI-friendly control over refinORE’s autonomous ORE mining platform by using the refinore-mcp server. This MCP server exposes the complete mining API as callable tools, enabling your AI agent to start, stop, monitor, and optimize ORE mining from a single, secure interface without manual dashboard interactions.

How to use

You connect your MCP client (such as Claude Desktop, Cursor, or Windsurf) to the refinore-mcp server and call its available tools to manage mining sessions, check balances, and view round details. Use natural language prompts through your AI agent, for example: ask to start a mining session with a specific amount, or request the current session status. The server handles API requests behind the scenes and returns structured results you can act on.

How to install

Prerequisites: you need Node.js installed on your machine to run the MCP server locally.

Step 1. Install dependencies and build the MCP server locally.

Step 2. Run the MCP server locally with your API key.

Additional content

Environment variables you use include your API key and an optional base API URL for custom deployments. Your API key stays in your local environment and is not sent to third parties.

Example configurations for common MCP clients are provided below. You can copy these into your client’s MCP settings to enable direct control over refinORE mining from your editor or AI agent.

Configuration and usage notes

The MCP server exposes a set of tools covering account information, mining control, balances, rewards, round info, strategies, and staking. Each tool is designed to be called by your AI agent to perform specific actions.
Security: keep your API key in your local environment and avoid transmitting it to external services. The server uses this key to authorize requests from your MCP client.

Troubleshooting

If you encounter connection issues, verify that your API key is correctly set in your MCP client’s environment and that the refinore-mcp server process is running. Check that the selected client is configured to call the refinore MCP endpoint and that network access to the host is allowed.

Notes

The server is designed to work with multiple MCP clients. It forwards your CLI-style or API calls to refinORE’s mining API and returns results suitable for immediate decision-making by your AI agent.

Available tools

get_account_info

Retrieve account details including wallet address and deposit instructions.

start_mining

Begin a new mining session by configuring wallet, amount, squares, token, risk, and tile strategy.

stop_mining

Terminate an active mining session, optionally by session ID.

get_mining_session

Query the current active mining session status, statistics, and round information.

get_mining_history

Fetch past mining rounds with results and earnings.

get_balances

Fetch SOL, ORE, USDC, stORE, and SKR balances for a wallet.

get_rewards

Retrieve unclaimed SOL, unrefined ORE, and bonus ORE rewards.

get_current_round

Obtain the current round number, time remaining, total deployed, motherlode, and EV.

list_strategies

List all saved auto-mining strategies.

create_strategy

Create a new auto-mining strategy with name, amount, squares, token, and risk.

start_strategy

Launch an auto-mining session using a saved strategy.

get_staking_info

Fetch stORE balance, current APR, and pending staking rewards.