Poworacle

io.github.CloudCorpRecords由 GitHub 帳號 CloudCorpRecords 發布v0.1.0更新於 Nov 7, 2026

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

已驗證STDIO僅桌面金融資料與分析

概覽

AI 產生的概覽

免金鑰的 MCP 用戶端,把六項工作量證明挖礦工具轉送到公開的 BackPow 端點:單機挖礦機率、生產成本、網路狀態、硬體與新聞。

可以做什麼
  • 依幣種與算力估算單機挖礦機率及電力成本
  • 比較生產成本與現貨價格及利潤率
  • 讀取鏈上即時狀態:難度、算力、區塊高度與獎勵
  • 依演算法或獲利性瀏覽已追蹤的 PoW 幣種
  • 依指定電價把礦機按每日淨美元收益排序
  • 取得近期 PoW 挖礦與網路新聞,可依幣種篩選
適用情境
適合涉及工作量證明挖礦經濟性的問題:單機挖礦是否划算、某幣種的生產成本、網路目前表現、哪種硬體較賺錢,或近期挖礦新聞。
執行需求
透過 npx 或 Docker 以 stdio 在本機執行,需要能連線到公開的 BackPow 端點。不需帳號或 API 金鑰。選用環境變數 BACKPOW_MCP_URL 與 BACKPOW_TIMEOUT_MS 可調整端點與單次呼叫逾時。
安裝前請注意
每次工具呼叫都會轉送到第三方端點,因此你提供的幣種、算力與電價等輸入會離開本機。結果為唯讀資料;硬體價格等數值可能是模型估算而非實際掛牌價,新聞項目為引用的第三方內容。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Poworacle,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

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.

來源:README.md,提交 d3c9f58

工具

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.

輸入參數coin_id必填hashrate必填power_wattshashrate_unit必填electricity_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.

輸入參數coin_id必填electricity_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.

輸入參數coin_id必填

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.

輸入參數limitoffsetsort_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.

輸入參數typelimitquery必填coin_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.

輸入參數limitcoin_idinclude_low_signal

版本歷史

1
  1. v0.1.0最新Nov 4, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分