{
  "markdown": "# a0nexus-bitcoin-mcp\n\n**Live crypto + energy predictive data + AI forecasts, right inside Claude (and any MCP-capable AI app).**\n\nThis is a [Model Context Protocol](https://modelcontextprotocol.io) server that gives\nyour AI assistant real-time predictive intelligence — Bitcoin network, mempool, and fees;\nEthereum gas; **best-time-to-transact** timing on both chains; AI Bitcoin price\n**forecasts**; and Texas (ERCOT) **electricity price forecasting** including the cheapest\nupcoming window to run load — all as tools it can call mid-conversation. Data comes from\nthe [a0nexus.com](https://a0nexus.com) Predictive Intelligence API.\n\n**Live Bitcoin fees/network/mempool, Ethereum gas, and current ERCOT power prices are\nfree** and need no wallet — install it and ask \"what's the current Bitcoin fee?\", \"what's\nETH gas right now?\", or \"what's Texas power costing?\" right away. The differentiated tools\n(forecasts, fee forecast, confirmation ETA, mempool depth, intelligence brief) are\n**pay-per-call**: each request is settled with a few cents of USDC on Base via\n[x402](https://x402.org) (HTTP 402) — **no account, no signup, no subscription.** You only\nenable paid tools if you want them.\n\nInstall it with a single `npx` line (below). Node 18+ required.\n\n## Tools\n\n### Free (no wallet needed)\n\n| Tool | What it returns |\n| --- | --- |\n| `get_current_fees` | Current recommended Bitcoin fee rates (sat/vB) by confirmation target. |\n| `get_network_snapshot` | Chain height, best block hash, peers, sync state, mempool summary. |\n| `get_mempool_snapshot` | Current mempool size, fee-rate histogram, and congestion. |\n| `get_eth_gas_current` | **Ethereum** gas now (gwei): base fee + slow/standard/fast tiers + congestion. |\n| `get_ercot_price_current` | **Texas power** now ($/MWh) on the ERCOT grid + cheap/normal/expensive level. Arg: `hub`. |\n| `get_status` | Service status, active payment mode, and component health. |\n| `get_pricing` | Per-endpoint pricing and the payment network in use. |\n\n### Paid (require a funded Base wallet — see [Paid tools](#paid-tools))\n\n| Tool | What it returns |\n| --- | --- |\n| `get_broadcast_timing` | **Best time to broadcast** (Bitcoin) — send now vs. wait, and the sat/vB you'd save. Args: `target` (blocks, default 6), `vsize` (vB, optional → total sats saved). |\n| `get_eth_gas_timing` | **Best time to send** (Ethereum) — send now vs. wait, and the gwei/ETH you'd save. Args: `blocks` (default 5), `gas_limit` (optional). |\n| `get_eth_gas_forecast` | Ethereum base-fee forecast (gwei), N blocks ahead. Args: `blocks` (default 5). |\n| `get_ercot_cheapest_window` | **Cheapest window to run load** (Texas grid) — when to charge/compute in the next 24h + savings vs the daily average. Args: `window_hours` (default 2), `horizon_hours` (default 24), `hub`. |\n| `get_ercot_price_forecast` | ERCOT electricity price forecast ($/MWh) for the next N hours. Args: `hours` (default 12), `hub`. |\n| `get_fee_forecast` | Forecast of Bitcoin transaction fees by confirmation target. |\n| `get_tx_confirmation` | Confirmation status / ETA for a transaction. Args: `txid`. |\n| `get_latest_forecast` | Latest published AI price forecast. Args: `symbol` (e.g. `BTCUSD`), `timeframe` (e.g. `1h`, `4h`, `1d`). |\n| `run_custom_forecast` | Run a bespoke Kronos forecast. Args: `symbol`, `timeframe`, `horizon`, `sample_count`, `lookback`. |\n| `get_intelligence` | Aggregated Bitcoin intelligence brief. Optional arg: `timeframe`. |\n\n## Install\n\nAdd the server to your AI app's MCP config. All three use the same one-line `npx`\ncommand — no clone, no build, no global install.\n\n### Claude Desktop\n\nEdit `claude_desktop_config.json`\n(macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`,\nWindows: `%APPDATA%\\Claude\\claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"a0nexus-bitcoin\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"a0nexus-bitcoin-mcp\"],\n      \"env\": {\n        \"BTCI_API_URL\": \"https://a0nexus.com\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\nAdd an `.mcp.json` at your project root:\n\n```json\n{\n  \"mcpServers\": {\n    \"a0nexus-bitcoin\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"a0nexus-bitcoin-mcp\"],\n      \"env\": {\n        \"BTCI_API_URL\": \"https://a0nexus.com\"\n      }\n    }\n  }\n}\n```\n\n### Cursor\n\nEdit `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (per-project):\n\n```json\n{\n  \"mcpServers\": {\n    \"a0nexus-bitcoin\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"a0nexus-bitcoin-mcp\"],\n      \"env\": {\n        \"BTCI_API_URL\": \"https://a0nexus.com\"\n      }\n    }\n  }\n}\n```\n\nRestart the app. Your assistant can now fetch live Bitcoin fees and network status for\nfree immediately — try asking *\"what's the current Bitcoin fee?\"*\n\n## Paid tools\n\nThe free tools work with **no wallet at all**. To unlock the paid tools, add two\nenvironment variables to the `env` block above:\n\n```json\n\"env\": {\n  \"BTCI_API_URL\": \"https://a0nexus.com\",\n  \"BTCI_MCP_PAYMENT\": \"real\",\n  \"BTCI_MCP_PRIVATE_KEY\": \"0x……\"\n}\n```\n\n- `BTCI_MCP_PAYMENT`: set to `real` to pay actual USDC. (Leave it unset, or `none`, for\n  free-only operation.)\n- `BTCI_MCP_PRIVATE_KEY`: the private key of a **Base** wallet holding a little USDC.\n  Each paid call spends that endpoint's price (a few cents). Fund it with only what you're\n  comfortable spending — call `get_pricing` to see exact per-endpoint costs.\n- `BTCI_MCP_NETWORK` (optional): `base` (default) or `base-sepolia` for testnet.\n\nTreat the private key like any secret: use a dedicated low-balance wallet, and never\ncommit it to source control.\n\n## How it works\n\nPaid endpoints use the **x402** standard: the server requests a resource, the API replies\n`HTTP 402 Payment Required` with a price, the client signs a USDC transfer on **Base** and\nretries, and the API returns live data. It's true pay-per-call metering — **no account,\nno signup, no monthly bill.** You pay only for the calls your assistant actually makes.\n\nLearn more and see live pricing at **[a0nexus.com](https://a0nexus.com)**.\n\n## License\n\nMIT\n",
  "bytes": 6009,
  "sha": "367d317f2920b20475c32b9314ed00318d0dddc816f26671ad72a7bbfbb17087",
  "repo_slug": "a0nexus-bit/a0nexus-bitcoin-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_a0nexus_bit_a0nexus_bitcoin_mc_7ec41add/readme"
}