Back to Browse

A0nexus Bitcoin MCP Server

FinanceLow Risk10.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

Crypto (BTC/ETH) + ERCOT electricity data & forecasts as MCP tools. Pay-per-call via x402.

About

Crypto (BTC/ETH) + ERCOT electricity data & forecasts as MCP tools. Pay-per-call via x402.

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (2 strong, 4 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.

11 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

file_system

Check that this permission is expected for this type of plugin.

Shell Command Execution

Runs commands on your machine. Be cautious — only use if you trust this plugin.

What You'll Need

Set these up before or after installing:

Base URL of the a0nexus API.Optional

Environment variable: BTCI_API_URL

Set to 'real' to enable the paid tools (otherwise only the free tools work).Optional

Environment variable: BTCI_MCP_PAYMENT

Base wallet private key used to pay for paid tools when BTCI_MCP_PAYMENT=real.Required

Environment variable: BTCI_MCP_PRIVATE_KEY

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-a0nexus-bit-a0nexus-bitcoin-mcp": {
      "env": {
        "BTCI_API_URL": "your-btci-api-url-here",
        "BTCI_MCP_PAYMENT": "your-btci-mcp-payment-here",
        "BTCI_MCP_PRIVATE_KEY": "your-btci-mcp-private-key-here"
      },
      "args": [
        "-y",
        "a0nexus-bitcoin-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

a0nexus-bitcoin-mcp

Live crypto + energy predictive data + AI forecasts, right inside Claude (and any MCP-capable AI app).

This is a Model Context Protocol server that gives your AI assistant real-time predictive intelligence — Bitcoin network, mempool, and fees; Ethereum gas; best-time-to-transact timing on both chains; AI Bitcoin price forecasts; and Texas (ERCOT) electricity price forecasting including the cheapest upcoming window to run load — all as tools it can call mid-conversation. Data comes from the a0nexus.com Predictive Intelligence API.

Live Bitcoin fees/network/mempool, Ethereum gas, and current ERCOT power prices are free and need no wallet — install it and ask "what's the current Bitcoin fee?", "what's ETH gas right now?", or "what's Texas power costing?" right away. The differentiated tools (forecasts, fee forecast, confirmation ETA, mempool depth, intelligence brief) are pay-per-call: each request is settled with a few cents of USDC on Base via x402 (HTTP 402) — no account, no signup, no subscription. You only enable paid tools if you want them.

Install it with a single npx line (below). Node 18+ required.

Tools

Free (no wallet needed)

ToolWhat it returns
get_current_feesCurrent recommended Bitcoin fee rates (sat/vB) by confirmation target.
get_network_snapshotChain height, best block hash, peers, sync state, mempool summary.
get_mempool_snapshotCurrent mempool size, fee-rate histogram, and congestion.
get_eth_gas_currentEthereum gas now (gwei): base fee + slow/standard/fast tiers + congestion.
get_ercot_price_currentTexas power now ($/MWh) on the ERCOT grid + cheap/normal/expensive level. Arg: hub.
get_statusService status, active payment mode, and component health.
get_pricingPer-endpoint pricing and the payment network in use.

Paid (require a funded Base wallet — see Paid tools)

ToolWhat it returns
get_broadcast_timingBest 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).
get_eth_gas_timingBest time to send (Ethereum) — send now vs. wait, and the gwei/ETH you'd save. Args: blocks (default 5), gas_limit (optional).
get_eth_gas_forecastEthereum base-fee forecast (gwei), N blocks ahead. Args: blocks (default 5).
get_ercot_cheapest_windowCheapest 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.
get_ercot_price_forecastERCOT electricity price forecast ($/MWh) for the next N hours. Args: hours (default 12), hub.
get_fee_forecastForecast of Bitcoin transaction fees by confirmation target.
get_tx_confirmationConfirmation status / ETA for a transaction. Args: txid.
get_latest_forecastLatest published AI price forecast. Args: symbol (e.g. BTCUSD), timeframe (e.g. 1h, 4h, 1d).
run_custom_forecastRun a bespoke Kronos forecast. Args: symbol, timeframe, horizon, sample_count, lookback.
get_intelligenceAggregated Bitcoin intelligence brief. Optional arg: timeframe.

Install

Add the server to your AI app's MCP config. All three use the same one-line npx command — no clone, no build, no global install.

Claude Desktop

Edit claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json, Windows: %APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "a0nexus-bitcoin": {
      "command": "npx",
      "args": ["-y", "a0nexus-bitcoin-mcp"],
      "env": {
        "BTCI_API_URL": "https://a0nexus.com"
      }
    }
  }
}

Claude Code

Add an .mcp.json at your project root:

{
  "mcpServers": {
    "a0nexus-bitcoin": {
      "command": "npx",
      "args": ["-y", "a0nexus-bitcoin-mcp"],
      "env": {
        "BTCI_API_URL": "https://a0nexus.com"
      }
    }
  }
}

Cursor

Edit ~/.cursor/mcp.json (global) or .cursor/mcp.json (per-project):

{
  "mcpServers": {
    "a0nexus-bitcoin": {
      "command": "npx",
      "args": ["-y", "a0nexus-bitcoin-mcp"],
      "env": {
        "BTCI_API_URL": "https://a0nexus.com"
      }
    }
  }
}

Restart the app. Your assistant can now fetch live Bitcoin fees and network status for free immediately — try asking "what's the current Bitcoin fee?"

Paid tools

The free tools work with no wallet at all. To unlock the paid tools, add two environment variables to the env block above:

"env": {
  "BTCI_API_URL": "https://a0nexus.com",
  "BTCI_MCP_PAYMENT": "real",
  "BTCI_MCP_PRIVATE_KEY": "0x……"
}
  • BTCI_MCP_PAYMENT: set to real to pay actual USDC. (Leave it unset, or none, for free-only operation.)
  • BTCI_MCP_PRIVATE_KEY: the private key of a Base wallet holding a little USDC. Each paid call spends that endpoint's price (a few cents). Fund it with only what you're comfortable spending — call get_pricing to see exact per-endpoint costs.
  • BTCI_MCP_NETWORK (optional): base (default) or base-sepolia for testnet.

Treat the private key like any secret: use a dedicated low-balance wallet, and never commit it to source control.

How it works

Paid endpoints use the x402 standard: the server requests a resource, the API replies HTTP 402 Payment Required with a price, the client signs a USDC transfer on Base and retries, and the API returns live data. It's true pay-per-call metering — no account, no signup, no monthly bill. You pay only for the calls your assistant actually makes.

Learn more and see live pricing at a0nexus.com.

License

MIT

Reviews

No reviews yet

Be the first to review this server!