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

Integration options
OptionBest forWhere
REST APIAny language or agent framework that can make HTTP requestsAPI documentation
MCP serverClaude and other MCP clients; no glue coderefinore-mcp on GitHub
Agent skillsAgents that load packaged skillsore-miner-skills on GitHub

API keys

  1. Sign in to refinORE and open API keys from the navigation.
  2. Create a key. Keys start with rsk_ and are shown once, so store it somewhere safe.
  3. Send it on every request in the x-api-key header.
  • 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"
See the API documentation for request and response details.

What an agent can do

Endpoint groups
GroupEndpointsUse
Mining/mining/start, /mining/start-strategy, /mining/stop, /mining/session, /mining/session/editRun and adjust sessions
Strategies/auto-strategies, /auto-strategies/:id, /auto-strategies/:id/liveCreate, list, edit (also while running), delete
Rounds/rounds/current, /rounds/recent, /rounds/tile-stats, /rounds/my-historyLive board, history and tile statistics
Results/mining/history, /mining/session-rounds, /rewardsWhat sessions cost and earned
Wallet/wallet/balances, /wallet/claim-sol, /wallet/claim-ore, /wallet/sendBalances, claims and allowlisted sends
Swaps/swaps/quote, /swaps/execute, /auto-swap-ordersSwaps, 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/current for 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?

Yes. refinORE has a REST API at https://automine.refinore.com/api with API-key authentication. It covers mining sessions, strategies, rounds, results, wallet actions and swaps.

How do AI agents authenticate with refinORE?

With an API key that starts with rsk_, sent in the x-api-key header. Keys are created in the app and an account can have up to five.

Does refinORE have an MCP server?

Yes. The refinore-mcp server exposes mining, strategy and wallet tools to MCP-capable clients such as Claude.

Can an agent withdraw my funds?

An agent can send funds only to addresses on your send allowlist. Configure the allowlist before sharing a key.

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.