refinORE
Mine ORE with AI agents
Updated · 5 min read
refinORE exposes ORE mining to software agents. With an API key, an agent can start and stop mining sessions, create and edit strategies, and read rounds, results and balances over a REST API, or use the refinORE MCP server from any MCP-capable AI client.
Three ways to connect
| Option | Best for | Where |
|---|---|---|
| REST API | Any language or agent framework that can make HTTP requests | API documentation |
| MCP server | Claude and other MCP clients; no glue code | refinore-mcp on GitHub |
| Agent skills | Agents that load packaged skills | ore-miner-skills on GitHub |
API keys
- Sign in to refinORE and open API keys from the navigation.
- Create a key. Keys start with
rsk_and are shown once, so store it somewhere safe. - Send it on every request in the
x-api-keyheader.
- An account can have up to five keys. Keys do not expire; revoke one at any time from the same screen.
- A key can do what you can do in the app, including starting mining with your funds. Treat it like a password.
- A send allowlist restricts which addresses an agent may send funds to. Set it before giving an agent a key.
Quick start
export REFINORE_API_URL="https://automine.refinore.com/api"
export REFINORE_API_KEY="rsk_your_key"
# What is the board doing right now?
curl "$REFINORE_API_URL/rounds/current"
# Start mining: 0.01 SOL per round on all 25 tiles
curl -X POST "$REFINORE_API_URL/mining/start" \
-H "x-api-key: $REFINORE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"sol_amount": 0.01, "num_squares": 25, "risk_tolerance": "degen", "mining_token": "SOL"}'
# Check the session, then stop it
curl "$REFINORE_API_URL/mining/session" -H "x-api-key: $REFINORE_API_KEY"
curl -X POST "$REFINORE_API_URL/mining/stop" -H "x-api-key: $REFINORE_API_KEY"What an agent can do
| Group | Endpoints | Use |
|---|---|---|
| Mining | /mining/start, /mining/start-strategy, /mining/stop, /mining/session, /mining/session/edit | Run and adjust sessions |
| Strategies | /auto-strategies, /auto-strategies/:id, /auto-strategies/:id/live | Create, list, edit (also while running), delete |
| Rounds | /rounds/current, /rounds/recent, /rounds/tile-stats, /rounds/my-history | Live board, history and tile statistics |
| Results | /mining/history, /mining/session-rounds, /rewards | What sessions cost and earned |
| Wallet | /wallet/balances, /wallet/claim-sol, /wallet/claim-ore, /wallet/send | Balances, claims and allowlisted sends |
| Swaps | /swaps/quote, /swaps/execute, /auto-swap-orders | Swaps, DCA and limit orders |
Using the MCP server
The MCP server wraps the same API as tools an AI client can call directly, so you can say “start mining 0.02 SOL on all tiles when edge is above 20%” to your own assistant. Install instructions and the tool list are in the refinore-mcp repository. There is also a command-line client: npx -y refinore-cli.
Designing an agent that mines well
- Read
/rounds/currentfor the edge and motherlode rather than recomputing them. The strategy engine already evaluates conditions late in each round; prefer saving a strategy with rules over polling and deploying yourself. - Check for an active session before starting one, and wait a few seconds between stopping and starting.
- Give the agent a budget: a fixed amount per round and a balance it is allowed to run down, not your whole wallet.
- Have it report cost per ORE, not just ORE won. That is the number that says whether mining beat buying. See buy or mine.
Frequently asked questions
Is there an API for ORE mining?
How do AI agents authenticate with refinORE?
Does refinORE have an MCP server?
Can an agent withdraw my funds?
Keep reading
Roberto AI
Roberto is an AI agent that builds ORE mining strategies from plain English, reviews your rounds and explains the board. What it can and cannot do.
StrategyORE mining strategies
Six ORE mining strategies compared: every round, edge only, motherlode hunting, hot and cold tiles, solo tiles and custom rules, with when each makes sense.
refinOREFees and the real cost of a round
Every fee in ORE mining through refinORE: the protocol’s 1% and 10%, refinORE’s 1%, the refining fee and swaps, with worked examples.
This guide is educational and is not financial advice. ORE protocol parameters can change; figures were checked on November 15, 2026 against the ORE program and ore.com. refinORE is not affiliated with ORE.