Poworacle

io.github.CloudCorpRecordsPublished by GitHub account CloudCorpRecordsv0.1.0Updated Nov 7, 2026

Proof-of-work mining oracle: solo-mining odds, cost of production, network state, hardware, news.

VerifiedSTDIODesktop onlyFinanceData & Analytics

Overview

AI-generated overview

Keyless MCP client that forwards six proof-of-work mining tools to the public BackPow endpoint: solo-mining odds, cost of production, network state, hardware…

What you can do
  • Estimate solo-mining odds and electricity cost for a coin and hashrate
  • Compare cost of production against spot price and margin
  • Read live network state: difficulty, hashrate, block height and reward
  • Browse tracked PoW coins by algorithm or profitability
  • Rank mining hardware by net USD per day at a given electricity rate
  • Fetch recent PoW mining and network news, optionally per coin
When to use it
Useful when questions involve proof-of-work mining economics: whether solo mining is worth it, what a coin costs to produce, how a network is currently performing, which hardware pays off, or recent mining news.
Requirements
Runs locally over stdio via npx or Docker; needs network access to the public BackPow endpoint. No account or API key. Optional environment variables BACKPOW_MCP_URL and BACKPOW_TIMEOUT_MS adjust the endpoint and per-call timeout.
Before you install
Every tool call is forwarded to a third-party endpoint, so the coin, hashrate and electricity-rate inputs you supply leave your machine. Results are read-only data; figures such as hardware prices may be model estimates rather than observed listings, and news items are quoted third-party content.

Installation

In SourceWeft

  1. Open Poworacle in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

poworacle

Live proof-of-work mining data as MCP tools: how long a solo miner would wait for a block, what it costs to produce one coin, the current state of a network, which hardware earns what, and recent mining news.

poworacle is a keyless forwarding client. It serves six tools over stdio MCP (and as CLI subcommands) and forwards each call to the public BackPow MCP endpoint at https://mcp.backpow.com/mcp — no API key, no account, nothing to configure. The upstream server is stateless, so each call is a single Streamable HTTP POST carrying a tools/call JSON-RPC request; the upstream result's content is returned verbatim. Upstream JSON-RPC errors come back as backpow error: <message>, an unparseable response as backpow error: malformed response, and a transport failure (including a timeout) as backpow unreachable.

Two environment variables adjust the client (both are this rebuild's own knobs, not upstream requirements):

VariableDefaultPurpose
BACKPOW_MCP_URLhttps://mcp.backpow.com/mcpEndpoint override
BACKPOW_TIMEOUT_MS30000Per-call timeout, AbortController-enforced

Tools

ToolAnswers
calculate_solo_mining_oddsMean time to a block and Poisson odds over 1/7/30/90/365 days for a given coin and hashrate, plus the electricity cost of the attempt
get_cost_of_productionAll-in electricity cost of mining one unit on the most efficient tracked hardware, against spot price and margin
get_coin_oracleLive difficulty, hashrate, block height and reward for one chain, with a measurement-confidence block
list_pow_coinsPaginated catalogue of tracked PoW networks, filterable by algorithm or profitability
get_hardware_benchmarksHardware matched to the coins it can mine, ranked by net USD per day at a given electricity rate
get_pow_newsRecent PoW mining and network news, optionally filtered to one coin

Ambiguity and missing measurements are refused upstream rather than guessed or substituted, and those errors pass through unchanged apart from the backpow error: rendering.

CLI

bash
npx @reneturcios/poworacle get_coin_oracle '{"coin_id":"Kaspa"}'npx @reneturcios/poworacle calculate_solo_mining_odds '{"coin_id":"Bitcoin","hashrate":100,"hashrate_unit":"TH/s"}'npx @reneturcios/poworacle list_pow_coins '{"algorithm":"SHA-256"}'npx @reneturcios/poworacle --version

Each tool subcommand takes one JSON argument string. Exit codes: 0 on success, 1 when the tool result is an error, 2 on a usage error (unknown command, extra arguments, or a non-object JSON argument).

MCP

bash
npx @reneturcios/poworacle mcp

MCP client configuration:

json
{  "mcpServers": {    "poworacle": {      "command": "npx",      "args": ["-y", "@reneturcios/poworacle", "mcp"]    }  }}

Docker

bash
docker run -i ghcr.io/cloudcorprecords/poworacle          # stdio MCP server (CMD defaults to "mcp")docker run --rm ghcr.io/cloudcorprecords/poworacle get_pow_news '{"coin_id":"Bitcoin"}'

Development

bash
npm installnpm run build      # tsc -> dist/ (dist/cli.js is the bin)npm test           # tsx --test test/*.test.ts (fake fetch only, no network)npm run dev        # tsx src/cli.ts — run the CLI from source

License

MIT — see LICENSE.

Source: README.md at commit d3c9f58

Tools

6

calculate_solo_mining_odds

Solo mining odds

Probability of a solo miner finding a block, computed as a Poisson process over live network difficulty and hashrate, plus the electricity cost of the attempt. Returns mean time to a block, the chance of at least one block over 1/7/30/90/365 days, and lucky-vs-unlucky waiting times (5th, 50th and 95th percentile) — variance dominates at small hashrates, so the average alone is misleading. Use for questions like "how long would it take to solo mine a Bitcoin block with 100 TH/s", "what are my odds solo mining Kaspa", or "is solo mining worth it with this rig". For pooled mining economics or whether a coin is profitable at all, use get_cost_of_production. For raw network state without a miner, use get_coin_oracle.

Parameterscoin_idrequiredhashraterequiredpower_wattshashrate_unitrequiredelectricity_cost_usd_kwh

get_cost_of_production

Cost of production

Cost of Production (CoP) for one Proof of Work coin: the all-in electricity cost of mining one unit on the most efficient hardware BackPow tracks for that algorithm, compared against spot price. Returns CoP in USD, spot, gross margin, whether miners are currently above or below water, the reference machine and tariff behind the figure, and a 30-day trend including whether the reference machine changed (which indicates the efficiency frontier moved). Accepts a custom electricity rate. Use for "is mining X profitable", "what does it cost to produce one Monero", "are miners underwater", or "break-even electricity price". For a specific rig rather than a coin, use get_hardware_benchmarks. For block-finding probability, use calculate_solo_mining_odds.

Parameterscoin_idrequiredelectricity_cost_usd_kwh

get_coin_oracle

Live network state

Current network state for one Proof of Work chain, measured by BackPow's stratum collector nodes: difficulty, derived network hashrate, block height, block reward, protocol block-time target versus the latest observed interval, and the source pool. Every response carries a confidence block — how many independent pool operators agreed, whether the reward figure is live or a static fallback, and how old the observation is. Networks whose collectors are stalled or unreachable return an error rather than zeros. Use for "what is Kaspa's current difficulty", "network hashrate of Monero", "current block reward". For economics use get_cost_of_production; for mining probability use calculate_solo_mining_odds.

Parameterscoin_idrequired

list_pow_coins

Browse PoW networks

Paginated index of the Proof of Work networks BackPow tracks, with algorithm, network rate, collector status and canonical page URL. Optionally filtered by algorithm or restricted to coins currently mining above cost. Returns the distinct algorithm list so valid filter values are discoverable. Use to find which networks exist for an algorithm, to browse the catalogue, or to resolve an ambiguous coin reference. Results are paginated: request a larger limit or a later offset rather than expecting the full catalogue in one response.

Parameterslimitoffsetsort_byalgorithmprofitable_only

get_hardware_benchmarks

Mining hardware economics

Mining hardware matched to the coins it can mine, ranked by net USD per day at a given electricity rate. Covers ASICs, GPUs and CPUs, with hashrate and power draw per coin, gross revenue, net profit, and market price including whether that price is an observed listing or a model estimate. Use for "what should I mine with an RTX 4090", "best ASIC for Scrypt", "is an Antminer S21 still profitable", or "how much does a Bitaxe make". Coins are ranked by profitability, not alphabetically, and results are capped — ask for a higher limit rather than assuming the list is complete. For a coin's economics independent of any particular rig, use get_cost_of_production.

Parameterstypelimitqueryrequiredcoin_idelectricity_cost_usd_kwh

get_pow_news

PoW mining news

Recent news items about Proof of Work mining and network events, optionally filtered to one coin. Items are aggregated from third-party feeds and are returned as quoted external content with their publisher and a relevance score, not as BackPow statements of fact. Use when a question turns on recent events — a halving, a difficulty swing, a pool outage, a chain upgrade. For numbers rather than narrative, use get_coin_oracle or get_cost_of_production.

Parameterslimitcoin_idinclude_low_signal

Version history

1
  1. v0.1.0LatestNov 4, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts