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.

Other Options:

• 🔨 CLI Tool: refinore-cli — npx -y refinore-cli --auto-mine (for terminal users)
• 🤖 OpenClaw Skill: ore-miner-skills — For OpenClaw/Clawdbot agents

Quick Start

1. Get your API key

Sign up at automine.refinore.com and generate an API key from your account settings.

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

• 🔨 21 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 — degen, risky, less-risky, positive-ev 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. | | edit_session | Live-edit an active manual mining session — change amount, tiles, risk, token without stopping. Changes apply next round. |

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 & Analytics

| Tool | Description | |------|-------------| | get_current_round | Get current round number, time remaining, total deployed, motherlode, and EV. No auth required. | | get_tile_stats | Get hot/cold tile statistics from the last N rounds — which tiles win most/least. No auth required. | | get_round_history | Get your personal mining round history with full deployment details, results, and winnings. Supports pagination. |

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. | | live_edit_strategy | Live-edit a strategy mid-session — change tiles, amounts, thresholds without stopping. Changes apply next round. | | delete_strategy | Delete a saved strategy by ID. |

Staking

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

DCA & Limit Orders

| Tool | Description | |------|-------------| | create_swap_order | Create a DCA or limit order for automated token swaps (e.g., DCA into ORE with SOL). | | list_swap_orders | List all active DCA and limit orders. | | delete_swap_order | Cancel/delete an active swap order by ID. | | get_swap_history | Get execution history for completed and partially-filled swap orders. |

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 | "less-risky" | degen, risky, less-risky, or positive-ev | | 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 |

live_edit_strategy

All parameters except strategy_id are optional — only send what you want to change.

| Parameter | Type | Default | Description | |-----------|------|---------|-------------| | strategy_id | string | required | ID of the strategy to edit | | sol_amount | number | — | New SOL amount per round | | num_squares | number | — | New number of tiles (1-25) | | tile_selection_mode | enum | — | optimal, random, custom, odd, or even | | custom_tiles | number[] | — | Tile indices (0-24) when mode is custom | | skip_last_winning_square | boolean | — | Skip the tile that won last round | | mining_token | enum | — | SOL, USDC, ORE, stORE, or SKR | | deployment_timing | number | — | Deploy timing in seconds (30-55) | | motherlode_threshold | number | — | Min motherlode ORE to deploy | | max_sol_deployed_threshold | number | — | Max total SOL deployed before skipping |

get_tile_stats

| Parameter | Type | Default | Description | |-----------|------|---------|-------------| | limit | number | 100 | Number of rounds to analyze (10-500) |

get_round_history

| Parameter | Type | Default | Description | |-----------|------|---------|-------------| | limit | number | 50 | Number of rounds to return (1-500) | | offset | number | 0 | Offset for pagination | | session_id | string | — | Filter to a specific session (optional) |

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.

Check hot/cold tiles

You: Which tiles are hot right now?

AI: Looking at the last 100 rounds, tiles 12, 7, and 3 are the hottest with 8, 7, and 6 wins respectively. Coldest are tiles 20 and 14 with only 1 win each.

Live-edit strategy mid-session

You: Switch my strategy to custom tiles 0, 5, 12, 18, 24 and bump to 0.02 SOL

AI: Done! Updated your strategy with custom tiles [0, 5, 12, 18, 24] and 0.02 SOL per round. Your active session will pick up these changes on the next deployment — no restart needed.

Review round history

You: Show me my last 10 rounds

AI: Here are your last 10 rounds — you won 4/10 (40% win rate). Total deployed: 0.05 SOL, total won: 0.032 SOL + 1.2 ORE. Best round was #145,901 where you hit tile 12 for 0.012 SOL.

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

1. Go to automine.refinore.com
2. Create an account or sign in
3. Navigate to account settings
4. Generate a new API key
5. 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"
      }
    }
  }
}

Links

• 🌐 refinORE Platform — automine.refinore.com
• 📦 npm Package — npmjs.com/package/refinore-mcp
• 🐙 GitHub — github.com/JussCubs/refinore-mcp
• 🐾 ClawdHub Skills — clawhub.ai/skills
• 🤖 Clawdbot — clawhub.ai

Related Projects

• Clawdbot — AI agent framework with MCP support
• OpenClaw — Open-source AI agent tools
• ORE — Proof-of-work token on Solana

License

MIT © JussCubs