CHANGCHINFU/mcp-gauge

**Check official facts before your AI agent acts.** 180+ signals from USGS, NOAA, SEC EDGAR, EPA, and more — each response includes multi-source cross-validation and a tamper-proof receipt anchored to Bitcoin via OpenTimestamps (proving the record set existed no later than the stamp time, not that it was collected on the data day). No API key, no signup. Pay per call in USDC on Base via x402.
Quick start
Claude Desktop
Add to your config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):
Cursor
Add to .cursor/mcp.json in your project root (or global config):
Claude Code
Other MCP hosts
Any MCP client that supports stdio transport works. Command: npx -y mcp-gauge-x402, set EVM_PRIVATE_KEY in env for paid tools.
> **Alternative: install from GitHub** (no npm account needed):
>
From source
Payment setup
| | Without EVM_PRIVATE_KEY | With EVM_PRIVATE_KEY |
|---|---|---|
| Free tools | Yes | Yes |
| Paid tools | No (tools visible but calls fail) | Yes (auto-pays via x402) |
**How it works:** When your agent calls a paid tool, the GAUGE server returns an x402 payment challenge. The MCP client automatically pays in USDC on Base (EIP-3009 gasless — no ETH needed) and retries the request. The receipt is included in every response.
**Wallet safety:**
- Use a **dedicated burner wallet** with a small USDC balance — never your main wallet
- The private key never leaves your machine (processed locally by x402-fetch)
- Fund with just enough USDC for your expected usage
- Network: **Base mainnet** (Coinbase L2)
Tools
Free (no wallet needed)
| Tool | What it does |
|---|---|
| gauge_catalog | Browse 180+ available signals |
| gauge_preview | Coverage, pricing menu, bundle contents |
| gauge_sample | Full sample record with Bitcoin receipt |
| gauge_river_free | US river gauge reading (USGS) with receipt |
| gauge_anchor | Look up Bitcoin proof for any record_hash |
Paid — single-source verification
| Tool | What it does |
|---|---|
| verify_signal | Check one official fact from 180+ signals. Bitcoin-anchored receipt (proves it existed no later than the stamp time). |
| gauge_flood_risk | Hydrology / air / precipitation alias of verify_signal |
| gauge_resolution_as_of | Prediction-market settlement — official fact + evidence + receipt |
Paid — 3-source cross-validation bundles
| Tool | What it cross-checks |
|---|---|
| gauge_region | Air quality + precipitation + river level |
| gauge_crop_drought | Drought severity + heat/GDD + satellite crop health |
| gauge_grid_stress | Demand pressure + renewable output + energy inflation |
| gauge_route_disruption | Sea state + wave cause + live AIS vessel traffic |
| gauge_filing_check | SEC 8-K events + late filing + insider buy/sell |
| gauge_stablecoin_lifecycle | Peg drift + redemption acceleration + protocol exposure |
| gauge_rwa_lifecycle | Issuer lifecycle + redemption pressure + downstream exposure |
| gauge_lrt_lifecycle | Discount-to-NAV + withdrawal queue + collateral cascade |
| gauge_defi_lending | Utilization + bad-debt pressure + contagion |