Mcp Gauge

io.github.CHANGCHINFU由 GitHub 账号 CHANGCHINFU 发布v1.0.5更新于 Oct 24, 2026

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

已验证Streamable HTTP可网页运行网页搜索与抓取金融数据与分析

概览

AI 生成的概览

远程 MCP 服务器,让助手查询官方公共数据信号、校验比特币锚定的记录哈希,并通过 x402 以 USDC 按次付费。

可以做什么
免费查看 180 多个信号的覆盖范围与新鲜度,并在付费前了解价格。在服务端校验记录哈希,并交叉核对多腿互织线的方向一致性。获取某个信号或端点的真实 x402 支付挑战。查询可用支付渠道及其当前状态。付费查询返回带比特币锚定凭证的官方事实,包括单信号核验和多源组合包。
适用场景
适合需要以官方公共数据(USGS、NOAA、SEC EDGAR、EPA 等)为依据作答并附可验证凭证的场景,或在采信某个被引用的记录哈希前确认其真实性。
运行要求
远程端点为 api.truthbear.co,使用 streamable HTTP;README 另记录了通过 npx 本地运行的 npm 方式。免费工具无需账号或密钥。付费工具需要 EVM_PRIVATE_KEY,对应持有 USDC 的 Base 主网钱包(无需 ETH),可选 GAUGE_BASE_URL 和 GAUGE_MAX_USDC。
安装前请注意
付费工具每次调用会在 Base 主网自动花费 USDC;README 建议使用余额较少的专用一次性钱包并设置单次上限。EVM_PRIVATE_KEY 是钱包私钥,须视为高度敏感信息。调用会把支付授权和查询发送给第三方服务器。比特币时间戳只证明记录集在盖章时间前已存在,并不证明数据采集日期。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Mcp Gauge,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.CHANGCHINFU%2Fmcp-gauge/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "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

来源:README.md,提交 b0b840f

工具

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.

输入参数record_hash必填

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.

输入参数fullentityindustrysignal_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.

输入参数dimpathentitysignal_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.

输入参数path

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.

输入参数line必填entity必填

版本历史

1
  1. v1.0.5最新Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分