MCP 服务器

refinore-mcp

An MCP server that enables AI agents to autonomously manage ORE mining on the Solana blockchain via the refinORE platform. It provides tools for starting mining sessions, monitoring rewards, and managing multi-token balances through natural language commands.

README

refinore-mcp

Mine ORE on Solana with AI. An MCP server that gives Cursor, Claude Desktop, Windsurf, and any MCP client full control over refinORE's autonomous ORE mining platform.

What is refinORE?

refinORE is an autonomous mining platform for ORE — a proof-of-work token on the Solana blockchain. Unlike traditional crypto mining that requires GPUs, ORE mining happens on-chain through a grid-based game where miners deploy SOL, USDC, ORE, stORE, or SKR across squares to earn rewards.

refinORE automates the entire process: deploying funds, selecting optimal tiles, managing risk, and harvesting rewards — all from a clean API.

What is refinore-mcp?

refinore-mcp is a Model Context Protocol (MCP) server that exposes refinORE's complete mining API as tools your AI agent can call directly. Instead of copy-pasting between a mining dashboard and your editor, just tell your AI:

"Start mining ORE with 0.05 SOL on 20 squares"

And it does it.

Works with Cursor, Claude Desktop, Windsurf, Cline, and any MCP-compatible client.

Quick Start

1. Get your API key

2. Add to your MCP client

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "refinore": {
      "command": "npx",
      "args": ["-y", "refinore-mcp"],
      "env": {
        "REFINORE_API_KEY": "rsk_your_key_here"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project or ~/.cursor/mcp.json globally:

{
  "mcpServers": {
    "refinore": {
      "command": "npx",
      "args": ["-y", "refinore-mcp"],
      "env": {
        "REFINORE_API_KEY": "rsk_your_key_here"
      }
    }
  }
}

Windsurf

Add to your Windsurf MCP configuration:

{
  "mcpServers": {
    "refinore": {
      "command": "npx",
      "args": ["-y", "refinore-mcp"],
      "env": {
        "REFINORE_API_KEY": "rsk_your_key_here"
      }
    }
  }
}

3. Start mining

Ask your AI agent:

"What's my refinORE wallet address?"
"Start mining ORE with 0.02 SOL on 10 squares"
"Check my mining session status"
"What are my current balances?"
"Show me the current round info"

Features

🔨 12 MCP tools covering every refinORE API endpoint
⛏️ Full mining control — start, stop, monitor sessions
📊 Real-time data — balances, rewards, round info, history
🤖 Strategy automation — create and launch reusable mining strategies
💎 Multi-token support — SOL, USDC, ORE, stORE, SKR
🛡️ Risk management — low, medium, high risk tolerance settings
📈 Staking info — stORE balances, APR, pending rewards
⚡ Zero config — just set your API key and go
🔒 Secure — API key stays in your local environment, never transmitted to third parties

Tools Reference

Account

Tool	Description
`get_account_info`	Get your refinORE account info including Solana wallet address and deposit instructions. Call this first to discover your wallet.

Mining

Tool	Description
`start_mining`	Start a new ORE mining session. Configure wallet, amount, squares, token, risk, and tile strategy.
`stop_mining`	Stop an active mining session. Optionally specify a session ID.
`get_mining_session`	Get current active mining session status, stats, and round info.
`get_mining_history`	Get past mining rounds with results and earnings.

Wallet & Rewards

Tool	Description
`get_balances`	Get SOL, ORE, USDC, stORE, and SKR balances for a wallet.
`get_rewards`	Get unclaimed SOL, unrefined ORE, and bonus ORE rewards.

Round Info

Tool	Description
`get_current_round`	Get current round number, time remaining, total deployed, motherlode, and EV. No auth required.

Strategies

Tool	Description
`list_strategies`	List all saved auto-mining strategies.
`create_strategy`	Create a new strategy with name, amount, squares, token, and risk settings.
`start_strategy`	Launch an auto-mining session using a saved strategy.

Staking

Tool	Description
`get_staking_info`	Get stORE balance, current APR, and pending staking rewards for a wallet.

Tool Parameters

start_mining

Parameter	Type	Default	Description
`wallet_address`	string	required	Your Solana wallet address
`sol_amount`	number	`0.01`	Amount to deploy per round
`num_squares`	number	`15`	Number of grid squares to mine
`mining_token`	enum	`"SOL"`	`SOL`, `USDC`, `ORE`, `stORE`, or `SKR`
`risk_tolerance`	enum	`"medium"`	`low`, `medium`, or `high`
`tile_selection_mode`	enum	`"optimal"`	`optimal`, `random`, or `custom`

create_strategy

Parameter	Type	Description
`name`	string	Name for the strategy
`solAmount`	number	Amount to deploy per round
`numSquares`	number	Number of grid squares
`miningToken`	string	Token to mine with
`riskTolerance`	string	Risk level

Example Conversations

Check your setup

You: What's my refinORE account info?

AI: Your wallet address is 7xK...abc. You have 0.5 SOL and 12.3 ORE. To deposit, send SOL to your wallet address.

Start mining

You: Start mining with 0.05 SOL on 20 squares, high risk

AI: Mining session started! Session ID: abc-123. Deploying 0.05 SOL across 20 squares with high risk tolerance and optimal tile selection.

Monitor progress

You: How's my mining going?

AI: Your session is active — round 4,217. You've earned 0.003 ORE so far this session. Time remaining in current round: 2m 15s.

Create a strategy

You: Create a conservative strategy called "Safe Miner" with 0.01 SOL on 10 squares

AI: Strategy "Safe Miner" created with ID strat-456. 0.01 SOL, 10 squares, SOL token, low risk. You can start it anytime with start_strategy.

Configuration

Environment Variables

Variable	Required	Default	Description
`REFINORE_API_KEY`	Yes	—	Your refinORE API key (starts with `rsk_`)
`REFINORE_API_URL`	No	`https://automine.refinore.com/api`	API base URL (for custom deployments)

Getting an API Key

Go to automine.refinore.com
Create an account or sign in
Navigate to account settings
Generate a new API key
Copy the key (starts with rsk_)

How ORE Mining Works

ORE is a proof-of-work token on Solana. Unlike Bitcoin mining that requires specialized hardware, ORE mining is accessible to everyone through on-chain transactions.

refinORE adds a game-theory layer: each round, miners deploy tokens across a grid of squares. When the round ends, one square is selected as the motherlode — miners on that square earn outsized rewards. The strategy is in choosing which squares to deploy on, how much to risk, and when to mine.

With refinore-mcp, your AI agent handles all of this autonomously. It can:

Analyze current round conditions
Deploy with optimal tile selection
Monitor sessions and adjust strategy
Track rewards and balances
Create and manage reusable strategies

Development

# Clone the repo
git clone https://github.com/JussCubs/refinore-mcp.git
cd refinore-mcp

# Install dependencies
npm install

# Build
npm run build

# Run locally
REFINORE_API_KEY=rsk_your_key node dist/index.js

Local MCP config (for development)

{
  "mcpServers": {
    "refinore": {
      "command": "node",
      "args": ["/path/to/refinore-mcp/dist/index.js"],
      "env": {
        "REFINORE_API_KEY": "rsk_your_key_here"
      }
    }
  }
}