Truth Bear - Official Government Data with Cryptographic Proof (GAUGE)

mcp-gauge — 面向 AI Agent 的可验证事实，通过 x402 按次付费

让 AI Agent 执行操作前先核实官方事实。 提供来自 USGS、NOAA、SEC EDGAR、EPA 等来源的 180 多项信号；每次响应都包含多源交叉验证，以及通过 OpenTimestamps 锚定到 Bitcoin 的防篡改凭证（证明记录集的存在时间不晚于时间戳时间，而非证明其在数据当天已被收集）。无需 API 密钥，无需注册。通过 x402 使用 Base 上的 USDC 按次付费。

快速开始

Claude Desktop

将以下内容添加到配置文件中（macOS：~/Library/Application Support/Claude/claude_desktop_config.json；Windows：%APPDATA%\Claude\claude_desktop_config.json）：

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

Cursor

将以下内容添加到项目根目录下的 .cursor/mcp.json（或全局配置文件）：

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

Claude Code

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

其他 MCP 宿主

任何支持 stdio 传输的 MCP 客户端都可使用。命令：npx -y mcp-gauge-x402，在环境变量中设置 EVM_PRIVATE_KEY 即可使用付费工具。

替代方案：从 GitHub 安装（无需 npm 账号）：

npx -y github:CHANGCHINFU/mcp-gauge

从源代码安装

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

付款设置

	不设置 EVM_PRIVATE_KEY	设置 EVM_PRIVATE_KEY
免费工具	是	是
付费工具	否（工具可见，但调用会失败）	是（通过 x402 自动付款）

工作原理： 当你的 Agent 调用付费工具时，GAUGE 服务会返回 x402 付款质询。MCP 客户端会自动使用 Base 上的 USDC 付款（EIP-3009 免 Gas 费，无需 ETH），然后重试请求。每次响应都会附带凭证。

钱包安全：

• 使用余额较少的专用临时钱包，切勿使用主钱包
• 私钥不会离开你的设备（由 x402-fetch 在本地处理）
• 只需存入足以满足预期使用量的 USDC
• 网络：Base 主网（Coinbase L2）

工具

免费（无需钱包）

工具	功能
gauge_catalog	浏览 180 多项可用信号
gauge_preview	覆盖范围、定价菜单、捆绑内容
gauge_sample	包含 Bitcoin 凭证的完整示例记录
gauge_river_free	带凭证的 USGS 美国河流水位读数
gauge_anchor	查询任意 record_hash 的 Bitcoin 证明

付费 — 单一来源核验

工具	功能
verify_signal	核实 180 多项信号中的一条官方事实。附带锚定到 Bitcoin 的凭证（证明其存在时间不晚于时间戳时间）。
gauge_flood_risk	verify_signal 的水文学／空气／降水别名
gauge_resolution_as_of	预测市场结算 — 官方事实 + 证据 + 凭证

付费 — 3 源交叉验证捆绑工具

工具	交叉核验内容
gauge_region	空气质量 + 降水 + 河流水位
gauge_crop_drought	干旱严重程度 + 高温/GDD + 卫星作物健康状况
gauge_grid_stress	需求压力 + 可再生能源产出 + 能源通胀
gauge_route_disruption	海况 + 海浪成因 + 实时 AIS 船舶交通
gauge_filing_check	SEC 8-K 事件 + 逾期申报 + 内部人士买入/卖出
gauge_stablecoin_lifecycle	锚定偏离 + 赎回加速 + 协议敞口
gauge_rwa_lifecycle	发行方生命周期 + 赎回压力 + 下游敞口
gauge_lrt_lifecycle	相对净值折价 + 提款队列 + 抵押品连锁影响
gauge_defi_lending	利用率 + 坏账压力 + 传染效应
gauge_depin_network	网络活跃度 + 奖励流失 + 下游敞口

价格由实时 x402 挑战设定（使用 gauge_preview 查看当前价格）。如果使用自己的 x402 客户端调用 API，请将 maxValue 设为至少 $0.25 —— 默认的 $0.10 会导致客户端在本地拒绝捆绑工具。

环境变量

键	必填	说明
EVM_PRIVATE_KEY	付费工具必填	Base 主网钱包私钥（0x...）。需要 USDC，无需 ETH。
GAUGE_BASE_URL	否	API 端点。默认：https://api.truthbear.co
GAUGE_MAX_USDC	否	每次调用的 USDC 原子单位上限（6 位小数）。默认：350000

零信任验证

每条付费记录都带有 record_hash（规范 SHA-256）。每日 Merkle 根会通过 OpenTimestamps 写入 Bitcoin。该时间戳证明这组记录最迟在 stamped_at 时已存在。可随时重新验证：

• gauge_anchor 工具（免费）
• 在 GAUGE API 上调用 POST /verify 或 /proof/:record_hash
• 下载证明数据，并使用官方 ots CLI 验证

常见问题

我需要 ETH 支付 Gas 吗？ 不需要。x402 使用 EIP-3009（无需 Gas 的 USDC 转账）。你只需要 Base 上的 USDC。

如果我没有设置私钥，会怎样？ 你仍然可以使用全部 5 个免费工具。付费工具会列出，但调用时会返回错误。

我的私钥会发送到服务端吗？ 不会。私钥保留在你的设备上。x402-fetch 在本地签署付款，只向 GAUGE 服务发送签名后的授权。

如果数据不可用，会怎样？ 工具会如实返回失败，且不收费。只有在获得结果时才会扣费。

我可以不通过你们的服务端验证收据吗？ 可以。通过 gauge_anchor 下载 OpenTimestamps 证明，并使用标准 ots CLI 工具对照任意 Bitcoin 节点验证——它证明这组记录最迟在时间戳所示时间已存在，但不证明这些记录是在数据所属日期采集的。

链接

• 网站：truthbear.co
• 前台：gauge-frontdesk.zeabur.app
• API 发现：https://api.truthbear.co/.well-known/x402、/llms.txt
• Smithery：smithery.ai/servers/a98741263/mcp-gauge
• GitHub：CHANGCHINFU/mcp-gauge

MIT · AEML-DS Vanished-Data Exchange