Mcp Gauge

io.github.CHANGCHINFUPublished by GitHub account CHANGCHINFUv1.0.5Updated Oct 24, 2026

Verify official facts with Bitcoin-anchored proof. 180+ signals, x402 pay-per-call.

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingFinanceData & Analytics

Overview

AI-generated overview

Remote MCP server that lets an assistant look up official public-data signals, verify Bitcoin-anchored record hashes, and pay per call in USDC via x402.

What you can do
Check coverage and freshness of 180+ signals and see pricing before paying, free of charge. Verify a record hash server-side and cross-check a multi-leg interweave line for direction agreement. Retrieve the real x402 payment challenge for a signal or endpoint. Get payment channel options and their current status. Paid lookups return official facts with a Bitcoin-anchored receipt, including single-signal checks and multi-source bundles.
When to use it
Useful when an assistant must ground answers in official public data (USGS, NOAA, SEC EDGAR, EPA and similar) and show a verifiable receipt, or when you need to check whether a cited record hash is genuine before relying on it.
Requirements
Remote endpoint at api.truthbear.co over streamable HTTP; the README also documents a local npm route via npx. Free tools need no account or key. Paid tools need an EVM_PRIVATE_KEY for a Base-mainnet wallet holding USDC (no ETH), with optional GAUGE_BASE_URL and GAUGE_MAX_USDC.
Before you install
Paid tools spend USDC on Base mainnet automatically per call; the README advises a dedicated burner wallet with a small balance and a per-call cap. EVM_PRIVATE_KEY is a wallet private key, so treat it as highly sensitive. Calls send payment authorizations and queries to a third-party server. The Bitcoin stamp proves a record set existed by the stamp time, not when the data was collected.

Installation

In SourceWeft

  1. Open Mcp Gauge in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.CHANGCHINFU%2Fmcp-gauge/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "gauge": {
      "type": "http",
      "url": "https://api.truthbear.co/mcp"
    }
  }
}

README

mcp-gauge — Verifiable facts for AI agents, pay-per-call via x402

[MCP server score] [License: MIT] [Model Context Protocol]

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):

jsonc
{  "mcpServers": {    "gauge": {      "command": "npx",      "args": ["-y", "mcp-gauge-x402"],      "env": {        "EVM_PRIVATE_KEY": "0x..."   // optional — omit for free tools only      }    }  }}

Cursor

Add to .cursor/mcp.json in your project root (or global config):

jsonc
{  "mcpServers": {    "gauge": {      "command": "npx",      "args": ["-y", "mcp-gauge-x402"],      "env": {        "EVM_PRIVATE_KEY": "0x..."   // optional — omit for free tools only      }    }  }}

Claude Code

bash
claude mcp add gauge -- npx -y mcp-gauge-x402# For paid tools, add the env:claude mcp add gauge --env EVM_PRIVATE_KEY=0x... -- npx -y mcp-gauge-x402

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):

npx -y github:CHANGCHINFU/mcp-gauge

From source

bash
git clone https://github.com/CHANGCHINFU/mcp-gauge && cd mcp-gaugenpm install && npm run buildnode dist/index.js

Payment setup

Without EVM_PRIVATE_KEYWith EVM_PRIVATE_KEY
Free toolsYesYes
Paid toolsNo (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)

ToolWhat it does
gauge_catalogBrowse 180+ available signals
gauge_previewCoverage, pricing menu, bundle contents
gauge_sampleFull sample record with Bitcoin receipt
gauge_river_freeUS river gauge reading (USGS) with receipt
gauge_anchorLook up Bitcoin proof for any record_hash

Paid — single-source verification

ToolWhat it does
verify_signalCheck one official fact from 180+ signals. Bitcoin-anchored receipt (proves it existed no later than the stamp time).
gauge_flood_riskHydrology / air / precipitation alias of verify_signal
gauge_resolution_as_ofPrediction-market settlement — official fact + evidence + receipt

Paid — 3-source cross-validation bundles

ToolWhat it cross-checks
gauge_regionAir quality + precipitation + river level
gauge_crop_droughtDrought severity + heat/GDD + satellite crop health
gauge_grid_stressDemand pressure + renewable output + energy inflation
gauge_route_disruptionSea state + wave cause + live AIS vessel traffic
gauge_filing_checkSEC 8-K events + late filing + insider buy/sell
gauge_stablecoin_lifecyclePeg drift + redemption acceleration + protocol exposure
gauge_rwa_lifecycleIssuer lifecycle + redemption pressure + downstream exposure
gauge_lrt_lifecycleDiscount-to-NAV + withdrawal queue + collateral cascade
gauge_defi_lendingUtilization + bad-debt pressure + contagion
gauge_depin_networkNetwork liveness + reward churn + downstream exposure

Prices are set by the live x402 challenge (use gauge_preview to check current pricing). If you drive the API with your own x402 client, set maxValue to at least $0.25 — the default $0.10 makes your client reject bundle tools locally.

Environment variables

KeyRequiredDescription
EVM_PRIVATE_KEYFor paid toolsBase-mainnet wallet private key (0x...). Needs USDC, no ETH.
GAUGE_BASE_URLNoAPI endpoint. Default: https://api.truthbear.co
GAUGE_MAX_USDCNoAtomic per-call cap in USDC (6 decimals). Default: 350000

Zero-trust verification

Every paid record carries a record_hash (canonical SHA-256). Daily Merkle roots are stamped to Bitcoin via OpenTimestamps. The stamp proves the record set existed no later than stamped_at. Re-check anytime:

  • gauge_anchor tool (free)
  • POST /verify or /proof/:record_hash at the GAUGE API
  • Download attestation bytes and verify with the official ots CLI

FAQ

Do I need ETH for gas? No. x402 uses EIP-3009 (gasless USDC transfer). You only need USDC on Base.

What if I don't set a private key? You can still use all 5 free tools. Paid tools will be listed but return an error when called.

Is my private key sent to the server? No. The key stays on your machine. x402-fetch signs the payment locally and sends only the signed authorization to the GAUGE server.

What happens if the data isn't available? The tool honest-fails with no charge. You only pay when you get a result.

Can I verify the receipt without your server? Yes. Download the OpenTimestamps attestation via gauge_anchor and verify with the standard ots CLI tool against any Bitcoin node — it proves the record set existed no later than the stamp time, not that it was collected on the data day.

Links

MIT · AEML-DS Vanished-Data Exchange

Source: README.md at commit b0b840f

Tools

5

verify_citation

Verify a Truth Bear record (free)

FREE. Given a record_hash from any Truth Bear record, look it up and recompute the canonical hash server-side, returning whether it is a genuine Truth Bear official record plus a plain-language reverse lookup of what exactly that hash attests. Use this to check a citation you were handed by another agent or document BEFORE relying on it. No payment, no API key.

Parametersrecord_hashrequired

find_signal

Find which signals/entities are covered (free)

FREE coverage + freshness manifest: which signal_id lines exist, how many entities each covers, and fresh/recent/stale counts - so you can check "is my entity covered and how fresh" BEFORE paying. Optional filters: industry, signal_id, entity.

Parametersfullentityindustrysignal_id

get_official_record

Get the x402 payment challenge for a paid record

Returns the REAL x402 payment challenge (accepts[]: network / asset / payTo / amount) for the paid endpoint that serves a given signal_id+entity, or any listed endpoint addressed directly by `path`. This tool does NOT deliver paid data and does NOT take payment - MCP has no payment layer. Pay at the returned url with your own x402 client (USDC on Base or Solana, gasless EIP-3009; pay from a plain EOA) and you receive the record directly, with record_hash you can verify offline. This tool only fetches the 402 challenge; it delivers no paid data and collects no payment.

Parametersdimpathentitysignal_id

purchase_options

How can I actually buy this? (free)

FREE. Ask how to pay for a listed endpoint and get every channel with its REAL status - including the ones that are wired but not open yet. Three channels exist: x402 micropayment (for an agent with a funded USDC wallet on Base), a stateless subscription Bearer token (for a person or team - no wallet, no private key, no account), and a card rail. This tool takes no payment and holds no key; it only tells you which doors exist and which are open today.

Parameterspath

verify_triangular

Cross-check a line of official series & recompute the verdict (free)

FREE. Cross-verify one GAUGE interweave line: it returns each official series ("leg") in the line with its own record_hash, current/previous values, expected direction and per-leg minMove deadband, plus a count-style state (directions_matched / direction_mismatch / inverse_consistent / not_comparable / insufficient) and N-of-M. Everything needed to recompute the verdict OFFLINE is in the response - verify each leg hash with verify_citation, then recompute dir=sign(current-previous) with the minMove deadband. Descriptive only: no forecast, no causation, no advice. No payment, no API key.

Parameterslinerequiredentityrequired

Version history

1
  1. v1.0.5LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts