Telegraph

io.github.telegraphprotocol由 GitHub 帳號 telegraphprotocol 發布v1.0.0更新於 Oct 24, 2026

Decentralized AI inference (weather, deepfake detection, LLMs) with x402 USDC micropayments.

已驗證STDIO僅桌面金融AI 與機器學習

概覽

AI 產生的概覽

本機 MCP 伺服器，讓助理付費使用 Telegraph 去中心化 AI 推論網路，並依每次呼叫自動結算 USDC 小額付款。

可以做什麼
不需付費即可查看節點狀態、礦工健康狀態與即時礦工目錄，並列出引擎可路由的礦工。執行自動路由或指定礦工的推論，例如天氣預測、深度偽造偵測、AI 文字偵測，以及 LLM 對話、嵌入、影像生成與內容審核，依每次呼叫付費。查詢守護程序的健康狀態、訊號類別，以及依類別、來源、時間或關注度篩選的已蒐集訊號。礦工專用工具會從即時註冊表自動探索並定期重新整理，因此可用工具集會隨時間改變。
適用情境
適合希望助理透過單一介面呼叫多種 AI 推論服務（包括天氣、深度偽造與 AI 內容偵測），並以 USDC 依請求付費、而不必分別持有各家服務商帳號的情境。
執行需求
透過 stdio 在本機執行，通常使用 npx 或已建置的 Node.js 版本。需要 TELEGRAPH_NODE_URL、TELEGRAPH_ENGINE_URL 與 TELEGRAPH_DAEMON_URL，以及 TELEGRAPH_EVM_PRIVATE_KEY 或 TELEGRAPH_SOLANA_PRIVATE_KEY 其中至少一個。可選 EVM_NETWORK、SVM_NETWORK 與 REFRESH_INTERVAL_MS。需要能連線至 Telegraph 各端點的網路。
安裝前請注意
付費工具每次呼叫都會花費真實 USDC，並以你提供的私鑰簽署；README 建議使用僅存入所需金額的一次性錢包。私鑰由本機程序持有，請妥善保護環境設定。礦工工具會從遠端註冊表自動探索且隨時變動，請求與付款資訊會傳送至第三方 Telegraph 端點。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Telegraph，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Telegraph MCP server

Gives any MCP client (Claude Code, Claude Desktop, Cursor, Goose, Continue, ElizaOS, LangChain, ...) the Telegraph network: ask questions that the best-ranked miner answers, browse every intent, miner and ranking, and pay per ask in USDC from escrow or by x402. One setting, nine tools.

Quick start

You need Node 18+ and, for paid asks, the private key of a wallet made for this (never your main wallet). Free tools work without a key.

Claude Code

bash
claude mcp add telegraph -e TELEGRAPH_PRIVATE_KEY=0xyour_key -- npx -y @telegraphprotocol/telegraph-protocol-mcp

Claude Desktop, Cursor and most other clients (claude_desktop_config.json, ~/.cursor/mcp.json, ...)

json
{  "mcpServers": {    "telegraph": {      "command": "npx",      "args": ["-y", "@telegraphprotocol/telegraph-protocol-mcp"],      "env": { "TELEGRAPH_PRIVATE_KEY": "0xyour_key" }    }  }}

Then ask your agent things like "what is the BTC price?", "which miners serve weather and how do they rank?" or "how much is in my Telegraph escrow?". More client configs are in examples/.

Settings

VariableDefaultWhat it is
TELEGRAPH_PRIVATE_KEYnoneWallet that pays for asks. Without it only the free tools work. (TELEGRAPH_EVM_PRIVATE_KEY, the v1 name, also works.)
TELEGRAPH_URLhttps://devnode.telegraphprotocol.comThe node (Telegraph beta 2)
TELEGRAPH_PAYMENTautoauto: escrow first, then x402. escrow or x402: only that one
TELEGRAPH_RPC_URLpublic Sepolia RPCChain RPC, for the balance and deposit tools
TELEGRAPH_DIAMOND, TELEGRAPH_CHAIN_IDbeta 2'sThe contract that holds escrow, and its chain

Tools

ToolCostWhat it does
telegraph_ask~$0.01Ask a question (optionally an exact intent and params); the node routes it to the top live miner
telegraph_ask_minerthe miner's priceAsk one miner you choose, or call one of its endpoints directly
telegraph_find_intentsfreeSearch the 130+ intents (kinds of question)
telegraph_intentfreeOne intent's kind, params, answer fields and top miners
telegraph_find_minersfreeAn intent's miners with rank, score, price and endpoints, or a word search over all miners
telegraph_rankingfreeThe latest epoch's ranking, per intent
telegraph_accountfreeWallet USDC and ETH, and the escrow balance, debt and pending withdrawal
telegraph_depositgasMove wallet USDC into escrow (approve + depositUSDC)
telegraph_docsfreeBuilt-in guides: getting started, payments, intents and ranking, errors. Also served as MCP resources (telegraph://docs/...)

Payments

  • Escrow (used first): deposit USDC once with telegraph_deposit. Each ask carries a signature that proves intent but can't move funds. Asks are deducted at the epoch close, and a failed ask is never billed.
  • x402 (fallback): when escrow is empty, the server pays each ask from the wallet's USDC. If the ask then fails, the node credits the payment to your escrow, so it stays yours.

Details, debt and withdrawing: guides/2-payments.md.

Test funds (beta 2)

Beta 2 runs on Ethereum Sepolia. Its USDC (0xcc194e1a843B658526D0D5C431f670028582Ae17) is a test token anyone can mint with mint(yourAddress, amount) (6 decimals). Gas needs a little Sepolia ETH from a public faucet.

Security

  • Use a wallet made for this, holding only what you plan to spend.
  • The key stays in the MCP server process; the agent never sees it.
  • The server runs locally over stdio and opens no port.

Development

bash
npm install && npm run buildnode scripts/smoke.mjs                                       # free tools against the nodeTELEGRAPH_PRIVATE_KEY=0x... node scripts/smoke.mjs paid      # plus three asks (~$0.03)node scripts/smoke.mjs call telegraph_intent '{"intent":"CRYPTO_PRICE_USD"}'npx @modelcontextprotocol/inspector dist/index.js            # browse the tools

Architecture: docs/architecture.md. Problems: docs/troubleshooting.md.

來源：README.md，提交 097e3ec

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

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

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分