Skip to main content
Glama

refinore-mcp

npm version License: MIT MCP Solana

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

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

  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" } } } }


  • Clawdbot — AI agent framework with MCP support

  • OpenClaw — Open-source AI agent tools

  • ORE — Proof-of-work token on Solana


License

MIT © JussCubs

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/JussCubs/refinore-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server