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 分