The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the GridPulse: U.S. Energy Data listing page.
Pay-per-call U.S. energy market data for AI agents. Agents pay per call in USDC on Algorand or Base using the x402 protocol. No signup and no API keys for buyers.
| Endpoint | Price | Returns |
|---|---|---|
GET /v1/grid-mix?region=ERCO | $0.02 | Latest hourly generation mix for a grid region (MWh by fuel, renewable and carbon-free share) |
GET /v1/retail-price?state=CT§or=RES | $0.01 | Retail electricity price by state and sector, year-over-year change, 12-month history |
GET /v1/henry-hub | $0.01 | Henry Hub natural gas spot price, 30-day stats and history |
GET /v1/seller-check?url=… | $0.01 | x402 Seller Check: 0–100 reliability score for any x402 seller (uptime probes, settlement history, age, buyer diversity) |
GET /v1/sellers/search?q=weather&maxPrice=0.05 | $0.02 | Find reliable x402 sellers for a task, ranked by Seller Check score |
GET /v1/algorand/network-health | $0.008 | Algorand block time, TPS, online stake share, health (Algorand USDC only) |
GET /v1/algorand/account?address=… | $0.01 | Spendable ALGO, can it pay fees, can it receive USDC, staking and rekey status (Algorand USDC only) |
GET /v1/algorand/asset?id=31566704 | $0.015 | ASA supply, Pera verification tier, clawback/freeze risk flags (Algorand USDC only) |
GET /v1/algorand/tx?id=… | $0.01 | Plain-English transaction explainer with decoded note (Algorand USDC only) |
GET /v1/crypto/market-pulse | $0.015 | ALGO/BTC/ETH/SOL/USDC prices cross-checked on Coinbase + Kraken (Algorand USDC only) |
Live on Algorand MainNet: https://noahs-mac-mini.tail571e99.ts.net
Free: / (landing page), /llms.txt (docs for agents), /health.
Data source: U.S. Energy Information Administration (public domain).
Entry for the Algorand Global x402 Challenge (Composite: three endpoints, one payout address).
Any x402 client works: call the endpoint, get 402 Payment Required, pay, retry. The @x402/fetch wrapper does all of this automatically.
Pay with USDC on Base (npm i @x402/fetch @x402/evm viem):
Pay with USDC on Algorand: see src/pay.ts (uses @x402/avm).
One-click (Claude Desktop): download gridpulse-mcp.mcpb, open it, and optionally enter a small spending wallet. Also listed in the official MCP Registry as io.github.noah-silver/gridpulse.
Or configure it manually:
Add GridPulse as tools (grid_mix, retail_electricity_price, henry_hub_gas_price). Each tool call pays from your own wallet via x402. Use a small, dedicated spending wallet, never your main one.
Use ALGORAND_MNEMONIC instead of (or as well as) EVM_PRIVATE_KEY to pay with USDC on Algorand.
Run each command in Terminal on the Mac mini, one at a time.
If brew isn't found, install Homebrew first from https://brew.sh.
Copy this gridpulse folder onto the Mac mini (AirDrop works), then:
.envNETWORK=testnet for now.Open http://localhost:4021 to see the landing page. http://localhost:4021/v1/henry-hub should return 402 Payment Required, which means the paywall is working. Press Ctrl+C to stop.
Pick one:
Option A: Tailscale Funnel (free, easiest). You get a permanent URL like https://mac-mini.tail1234.ts.net.
Sign in, then run:
Option B: Cloudflare Tunnel with your own domain (about $10/yr, looks more professional). Buy a domain such as gridpulse.xyz in Cloudflare, then:
Put the resulting URL in .env as PUBLIC_URL.
In .env, set NETWORK=mainnet. Then:
(pm2 startup prints one more command to copy and run.) In System Settings → Energy, turn on "Prevent automatic sleeping" and "Start up automatically after a power failure."
Create another new Pera account as the "buyer." Put about $1 of USDC and 0.3 ALGO in it. Add its 25-word phrase to .env as BUYER_MNEMONIC.
Never use the phrase of your main wallet.
Each settled payment lists that endpoint in the Bazaar and on the leaderboard.
.env is git-ignored, so your secrets stay local.@x402/* packages are pinned to 2.17.0, and network IDs are hardcoded in the legacy format that the hosted GoPlausible facilitator currently expects (x402-foundation/x402#3528). Don't upgrade until the facilitator is updated.