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

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

• 🔨 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

Mining

Wallet & Rewards

Round Info

Strategies

Staking

Tool Parameters

start_mining

create_strategy

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

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