AurAgrid
OfficialProvides Bitcoin network fee and mempool data from AurAgrid's Bitcoin Core node, including fee estimates for 1–144 blocks, mempool size and minimum fee, and last-block fee percentiles.
Provides Lightning Network statistics from AurAgrid's LND node, including node and channel counts, capacity, channel-size and fee percentiles; also enables L402 payments over Lightning for paid data endpoints.
AurAgrid
A small data oracle for software agents, paid per hour over Lightning (L402).
Paid: Bitcoin fee/mempool data and Lightning Network statistics, computed by AurAgrid's own Bitcoin Core and LND nodes.
Free: delayed copies of those two, plus U.S. public-domain feeds: EIA grid demand and generation mix, Strategic Petroleum Reserve stocks, LNG exports, NOAA marine weather and USGS earthquakes.
Every response carries provenance (source, terms, attribution, as_of,
retrieved_at) and a stale flag. There is no simulated or sample data: a feed
that has no fresh enough data answers 503.
Endpoints
Base URL: https://84.12.79.124. The live list, with prices and status, is
always at /agent-manifest.json.
Endpoint | Access | Data |
| 50 sats / hour | Fee estimates for 1-144 blocks, mempool size and min fee, last-block fee percentiles (1 min) |
| 100 sats / hour | Nodes, channels, capacity, channel-size and fee percentiles (hourly) |
| 5,000 sats / 30 days | Both paid feeds on one token |
| free |
|
| free | Previous UTC day's final |
| free | Hourly U.S. demand and generation by fuel for the Lower 48, EIA regions and balancing authorities (EIA-930) |
| free | Weekly SPR and commercial crude stocks (EIA) |
| free | Monthly U.S. LNG exports by terminal and destination (EIA) |
| free | M2.5+ past 24 h, M4.5+ past 7 days (USGS) |
| free | Latest NOAA NDBC buoy and coastal station observations |
Free endpoints need no account and are limited to 30 requests per minute per IP.
Terms: /terms.
curl -s --compressed https://84.12.79.124/api/v1/energy/grid | jq .data.lower48Related MCP server: x402-api
Verifying responses
Successful data responses are signed by the oracle's Lightning node key
(038041ef6643bb59d9ec73568a952183b261683968cb4000b547302fa464cf8228):
X-AurAgrid-Signature-V2 covers the method, path, a SHA-256 of the body, the
X-AurAgrid-Timestamp and your optional X-AurAgrid-Nonce. The scheme and a
verifier are in attestation.py; client.py and the MCP server use it when you
pin the key (verify_signature=attestation.make_verifier(PUBKEY) /
AURAGRID_SIGNING_PUBKEY). Pin the key from a trusted source, not from a response.
Paying (L402)
A paid endpoint answers 402 with WWW-Authenticate: L402 macaroon="…", invoice="…".
Pay the invoice, then repeat the request with Authorization: L402 <macaroon>:<preimage>.
The token is valid for an hour (30 days for the bundle), so reuse it.
client.py does this safely against your own LND node: it requires a per-payment
cap, supports a session budget, and checks the invoice against the free price
quote and the preimage against the payment hash.
export AURAGRID_URL=https://84.12.79.124
export LND_REST_URL=https://127.0.0.1:8084 LND_TLS_CERT=~/.lnd/tls.cert LND_MACAROON_PATH=~/agent.macaroon
export AURAGRID_MAX_SATS=200
python client.py /api/v1/batch/btc-feesThe oracle serves HTTPS only, with a Let's Encrypt certificate for the IP address (renewed automatically; no domain). The client refuses to send L402 tokens (bearer credentials) over plain http to anything but loopback.
MCP server
auragrid_sdk/mcp_server.py exposes one FastMCP tool per endpoint. The free tools
work without any setup. The paid tools pay through client.py only when
AURAGRID_MAX_SATS and the LND variables above are set.
fastmcp run auragrid_sdk/mcp_server.pyHow it runs
upstream sources ──> fetcher.py ──> var/feeds.db ──> FastAPI (127.0.0.1:8000) ──> Aperture L402 (HTTPS :443)
(EIA, NOAA, USGS, (schedule, (SQLite snapshot (reads snapshots only) (prices, free-tier
bitcoind, LND) retries) store) rate limits)fetcher.pyandjobs.py: what is fetched, how often, freshness limits. A failed fetch never overwrites the last good snapshot.app/main.py: the API, catalog, manifest, terms and retired routes (410).pricing.yaml(access:) andaperture.base.yaml: which feeds are free, paid or retired, and paid prices.gen_aperture.pygenerates Aperture's config from them.deploy/: systemd units and setup steps.RESEARCH.md: sources, licensing terms, demand and pricing rationale.
Development
/home/ubuntu/miniconda/envs/auragrid_env/bin/python -m unittest discover -s tests -t .The tests are offline. Live checks: python eia_grid_feed.py --check (needs
EIA_API_KEY) and python fetcher.py --once.
Data sources and attribution
U.S. Energy Information Administration (EIA): public domain. EIA does not endorse AurAgrid.
NOAA National Data Buoy Center: public domain. NOAA does not endorse AurAgrid.
U.S. Geological Survey: public domain. Credit: U.S. Geological Survey.
Bitcoin and Lightning data: computed by AurAgrid's own nodes from public network data.
Available Tools
4 toolsfetchB
Fetch a feed. Paid feeds are bought over L402 only within the configured per-payment cap and budget.
Inputs: feed (required).
get_quoteC
Current price of a paid feed (sats, USD, token lifetime). Free; never pays.
Inputs: feed (required).
get_sampleB
Free real data for a feed: the feed itself if free, else its delayed/daily copy. No payment.
Inputs: feed (required).
list_feedsA
List every AurAgrid feed: free or paid, price in sats and USD, update interval, source, free sample.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool maps to a distinct step in the feed lifecycle: browse (list_feeds), preview (get_sample), price-check (get_quote), and retrieve/purchase (fetch). The only mild overlap is get_quote versus list_feeds, which already reports prices, and get_sample versus fetch for free feeds, but descriptions make the free/paid boundary clear.
Three of four tools follow a verb_noun snake_case pattern (list_feeds, get_sample, get_quote), with 'fetch' as a bare verb that deviates slightly. The convention is still predictable and readable across the set.
Four tools is a tight, well-scoped surface for a feed marketplace: catalog, sample, quote, and paid fetch each earn their place with no redundancy. Nothing in the described purpose suggests a missing tool or an excess one.
The surface covers discovery, preview, pricing, and L402 purchase end-to-end, which is the core lifecycle. Minor gaps exist around budget/account status inspection and purchase history, but fetch's cap/budget behavior implies that context is configured rather than queried.
Maintenance
Related MCP Connectors
Bitcoin intelligence API. Pay per call via L402 Lightning (10-200 sats). No accounts needed.
Bitcoin MCP: fees, tx proofs, address checks. Pay per call by x402, Lightning or a prepaid pass.
Pay-per-call crypto data over x402 (USDC on Base). Hosted, no wallet or key held by the server.
Bitcoin full node data via MCP: fees, mempool, txs, whales, SEC. $0.001/call USDC on Base.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceBitcoin data for AI agents. Pay-per-query via x402 micropayments. No API keys. No subscriptions. No tokens.MIT
- AlicenseAqualityBmaintenanceEight crypto and DeFi data tools for AI agents: prices, gas, one ParaSwap route quote, GoPlus token security and top-holder samples, DefiLlama yields, Hyperliquid/dYdX funding, and observed wallet balances. Inspect prices free; pay 0.001–0.008 USDC per call on Base through x402. No API key or subscription.887 npmMIT
- AlicenseBqualityDmaintenanceProvides live Bitcoin network data (fees, mempool, hashrate) and AI-powered price/fee forecasts via MCP tools, with free access to basic data and pay-per-call for advanced features.1782 npmMIT

btcmatic-mcp-serverofficial
AlicenseAqualityDmaintenanceMCP server that gives autonomous agents pay-per-call Bitcoin context (self-custody radar, fee percentiles, price change windows, condition frequencies) paid in sats over Lightning via L402 invoices, with no account or API key required.7MIT