telegraph

@telegraph/mcp-server

x402 のマイクロペイメントを自動処理し、Telegraph Protocol の AI 推論 API をツールとして公開する MCP サーバーです。

MCP 互換エージェント（Claude Desktop、Cursor、ElizaOS、LangChain、OpenClaw、Goose など）を、Telegraph の AI マイナーネットワーク（天気予報、ディープフェイク検出、LLM 推論、AI 生成テキスト検出、シグナル監視）に接続します。エージェント側に暗号資産関連のコードは必要ありません。MCP サーバーが秘密鍵の管理、決済署名、トランザクションの決済を内部で処理します。

マイナーには、Bittensor サブネット、ホスト型モデル、YAML 経由で統合された任意のプライベート API を使用できます。互換性維持のため、一部のツール名とフィールド名には引き続き subnet が使われていますが、「マイナー」と読み替えてください。

ドキュメント

ドキュメント	説明
アーキテクチャ	MCP プロトコル、ツールのカテゴリ、x402 による自動決済、クライアントとの統合
トラブルシューティング	よくある問題と解決方法

クイックスタート

オプション A — npx（クローン不要、公開後に推奨）

TELEGRAPH_NODE_URL=http://13.237.89.59:7044 \
TELEGRAPH_ENGINE_URL=http://13.237.89.59:8080 \
TELEGRAPH_DAEMON_URL=http://13.237.89.59:8081 \
TELEGRAPH_EVM_PRIVATE_KEY=0xyour_key_here \
npx -y telegraph-protocol-mcp

オプション B — ソースから実行

# 1. Clone and enter
git clone https://github.com/telegraphprotocol/telegraph-mcp
cd telegraph-mcp

# 2. Copy and edit .env
cp .env.example .env
# Edit: set TELEGRAPH_EVM_PRIVATE_KEY=0xyour_key_here

# 3. Install and build
npm install && npm run build

# 4. Run
npm start

npm では telegraph-protocol-mcp として公開され、MCP レジストリには io.github.telegraphprotocol/telegraph として登録されています。メンテナーの方は PUBLISHING.md をご覧ください。

アーキテクチャ

Agent (Claude / Cursor / Eliza / etc.)
       │
       │ MCP protocol (JSON-RPC over stdio)
       │
┌──────▼─────────────────────────────────────────┐
│  Telegraph MCP Server (runs locally)            │
│                                                 │
│  ┌─────────┐  ┌──────────┐  ┌───────────────┐  │
│  │ Node    │  │ Engine   │  │ Daemon        │  │
│  │ :7044   │  │ :8080    │  │ :8081         │  │
│  ├─────────┤  ├──────────┤  ├───────────────┤  │
│  │ Status  │  │ Subnets  │  │ Health        │  │
│  │ Health  │  │ Ask      │  │ Categories    │  │
│  │ Subnets │  │ Direct   │  │ Questions     │  │
│  │ Dynamic │  │          │  │               │  │
│  └─────────┘  └──────────┘  └───────────────┘  │
│                                                 │
│  X402 payment handled transparently:            │
│    request → 402 → sign EIP-3009 → retry        │
└─────────────────────────────────────────────────┘

設定

すべて環境変数で設定します（.env ファイルまたはインラインで指定）。

変数	必須	デフォルト	説明
TELEGRAPH_NODE_URL	はい	http://localhost:7044	Telegraph ノードの URL
TELEGRAPH_ENGINE_URL	はい	http://localhost:8080	Engine サーバーの URL
TELEGRAPH_DAEMON_URL	はい	http://localhost:8081	Daemon API の URL
TELEGRAPH_EVM_PRIVATE_KEY	はい*	—	EVM 秘密鍵（0x プレフィックス付きの 16 進数）
TELEGRAPH_SOLANA_PRIVATE_KEY	いいえ*	—	Solana 秘密鍵（base58）
EVM_NETWORK	いいえ	eip155:*	EVM CAIP-2 ネットワーク
SVM_NETWORK	いいえ	solana:*	Solana CAIP-2 ネットワーク
REFRESH_INTERVAL_MS	いいえ	300000	マイナーツールの更新間隔（ミリ秒）。無効にするには 0 を指定します。

*少なくとも 1 つの秘密鍵が必要です。

利用可能なツール

Node ツール（決済不要）

ツール	説明
tg_node_status	ノードのステータス、公開鍵、チェーン情報
tg_node_subnets_health	マイナー統合のヘルスチェック
tg_node_list_subnets	メタデータ、スキーマ、エンドポイントを含むマイナーの完全なカタログ

Engine ツール

ツール	決済	説明
tg_engine_list_subnets	無料	Engine がルーティングできるマイナーの一覧
tg_engine_ask	x402	自動ルーティングによる推論（LLM がクエリに最適なマイナーを選択）
tg_engine_ask_subnet	x402	ID で指定したマイナーを介した直接推論

Daemon ツール（決済不要）

ツール	説明
tg_daemon_health	Daemon のヘルスチェック
tg_daemon_categories	シグナルのカテゴリ（POLITICS、ECONOMICS、TECHNOLOGY、CLIMATE、HEALTH、CRYPTO、SPORTS、…）
tg_daemon_questions	フィルター（カテゴリ、ソース、時刻、関心度）を指定して収集済みシグナルを照会

動的マイナーツール（自動検出、x402 決済）

各マイナーエンドポイントのツールは、Telegraph ノードのライブ統合レジストリから自動生成されます。ライブのツールセットはオンチェーンで変化するため、これはスナップショットとして扱い、正規の情報源とは見なさないでください（最新のカタログを取得するには tg_node_list_subnets を呼び出してください）。

マイナー	ツール
Zeus (18) — 天気	tg_zeus_predict
ItsAI (32) — AI テキスト検出	tg_itsai_text_detector_detect
Sapling (33) — AI コンテンツ検出	tg_sapling_ai_detector_detect
BitMind (34) — ディープフェイク	tg_bitmind_detect_image, tg_bitmind_detect_video, tg_bitmind_preprocess_video, tg_bitmind_get_video_upload_url
OpenAI (102) — LLM／画像	tg_openai_chat, tg_openai_responses, tg_openai_embed, tg_openai_images_generate, tg_openai_moderate

これらは自動的に更新されます。 オンチェーンに登録された新しいマイナーは、5 分以内に表示されます。登録解除されたマイナーは削除されます。エージェントには、常に現在有効なツールのみが表示されます。

一部のツール名やフィールド名には、レガシーな理由から subnet が含まれています。Telegraph は当初、Bittensor サブネットの統合から始まりました。現在では、YAML 経由で統合されたプロバイダーは、サブネットであるかどうかを問わず、すべてマイナーです。

x402 決済の仕組み

エージェントが有料ツール（例：tg_engine_ask）を呼び出すと、次のように処理されます。

1. MCP サーバーがリクエストを Telegraph に送信します
2. Telegraph がレスポンスヘッダーに決済要件を含めて HTTP 402 を返します
3. @x402/fetch が 402 をインターセプトし、秘密鍵を使って EIP-3009 TransferWithAuthorization に署名して、その署名を PAYMENT ヘッダーに添付し、リクエストを再試行します
4. Telegraph が PayAI facilitator を介してオンチェーンで決済を検証し、結果を返します

エージェントと LLM に決済フロー、秘密鍵、ブロックチェーントランザクションが表示されることはありません。 すべて透過的に処理されるため、エージェントには結果を返すツールとして表示されます。

統合ガイド

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）を編集します。

npx を使用する場合（最も簡単 — クローンもビルドも不要）：

{
  "mcpServers": {
    "telegraph": {
      "command": "npx",
      "args": ["-y", "telegraph-protocol-mcp"],
      "env": {
        "TELEGRAPH_NODE_URL": "http://13.237.89.59:7044",
        "TELEGRAPH_ENGINE_URL": "http://13.237.89.59:8080",
        "TELEGRAPH_DAEMON_URL": "http://13.237.89.59:8081",
        "TELEGRAPH_EVM_PRIVATE_KEY": "0xyour_key_here"
      }
    }
  }
}

ローカルビルドを指定する場合：

{
  "mcpServers": {
    "telegraph": {
      "command": "node",
      "args": ["/path/to/telegraph-mcp/dist/index.js"],
      "env": {
        "TELEGRAPH_NODE_URL": "http://13.237.89.59:7044",
        "TELEGRAPH_ENGINE_URL": "http://13.237.89.59:8080",
        "TELEGRAPH_DAEMON_URL": "http://13.237.89.59:8081",
        "TELEGRAPH_EVM_PRIVATE_KEY": "0xyour_key_here"
      }
    }
  }
}

Claude Desktop を再起動します。Telegraph ツールがツール一覧に表示されます。「ラホールの天気は？」 や 「Telegraph エンジンを使って、ビットコインとは何か説明して。」 と尋ねてみてください。

Cursor

Cursor の「設定」→「MCP」→「新しい MCP サーバーを追加」に追加します。

{
  "mcpServers": {
    "telegraph": {
      "command": "node",
      "args": ["/path/to/telegraph-mcp/dist/index.js"],
      "env": {
        "TELEGRAPH_NODE_URL": "http://13.237.89.59:7044",
        "TELEGRAPH_ENGINE_URL": "http://13.237.89.59:8080",
        "TELEGRAPH_DAEMON_URL": "http://13.237.89.59:8081",
        "TELEGRAPH_EVM_PRIVATE_KEY": "0xyour_key_here"
      }
    }
  }
}

ElizaOS

Eliza のキャラクターファイルまたは MCP プラグイン設定に追加します。

{
  "mcp": {
    "telegraph": {
      "command": "node",
      "args": ["/path/to/telegraph-mcp/dist/index.js"],
      "env": {
        "TELEGRAPH_NODE_URL": "http://13.237.89.59:7044",
        "TELEGRAPH_ENGINE_URL": "http://13.237.89.59:8080",
        "TELEGRAPH_DAEMON_URL": "http://13.237.89.59:8081",
        "TELEGRAPH_EVM_PRIVATE_KEY": "0xyour_key_here"
      }
    }
  }
}

ElizaOS v0.25+ は @elizaos/plugin-mcp パッケージを介して MCP をサポートしています。キャラクターのプラグインリストで有効にします。

{
  "plugins": ["@elizaos/plugin-mcp"]
}

LangChain／LangGraph

LangChain は langchain-mcp-adapters を介して MCP をサポートしています。

pip install langchain-mcp-adapters

from langchain_mcp_adapters.client import MultiServerMCPClient

client = MultiServerMCPClient({
    "telegraph": {
        "command": "node",
        "args": ["/path/to/telegraph-mcp/dist/index.js"],
        "env": {
            "TELEGRAPH_NODE_URL": "http://13.237.89.59:7044",
            "TELEGRAPH_ENGINE_URL": "http://13.237.89.59:8080",
            "TELEGRAPH_DAEMON_URL": "http://13.237.89.59:8081",
            "TELEGRAPH_EVM_PRIVATE_KEY": "0xyour_key_here",
        },
        "transport": "stdio",
    }
})

tools = client.get_tools()
# Use tools with your LangChain agent

TypeScript／Node.js：

npm install @langchain/mcp-adapters

import { MultiServerMCPClient } from "@langchain/mcp-adapters";

const client = new MultiServerMCPClient({
  telegraph: {
    command: "node",
    args: ["/path/to/telegraph-mcp/dist/index.js"],
    env: {
      TELEGRAPH_NODE_URL: "http://13.237.89.59:7044",
      TELEGRAPH_ENGINE_URL: "http://13.237.89.59:8080",
      TELEGRAPH_DAEMON_URL: "http://13.237.89.59:8081",
      TELEGRAPH_EVM_PRIVATE_KEY: "0xyour_key_here",
    },
    transport: "stdio",
  },
});

const tools = await client.getTools();

OpenClaw

OpenClaw は設定を介して MCP をネイティブにサポートしています。openclaw.config.json に追加します。

{
  "mcpServers": {
    "telegraph": {
      "type": "stdio",
      "command": "node",
      "args": ["/path/to/telegraph-mcp/dist/index.js"],
      "env": {
        "TELEGRAPH_NODE_URL": "http://13.237.89.59:7044",
        "TELEGRAPH_ENGINE_URL": "http://13.237.89.59:8080",
        "TELEGRAPH_DAEMON_URL": "http://13.237.89.59:8081",
        "TELEGRAPH_EVM_PRIVATE_KEY": "0xyour_key_here"
      }
    }
  }
}

Goose

Goose は拡張機能システムを通じて MCP サーバーをサポートしています。~/.config/goose/config.yaml で設定します。

extensions:
  telegraph:
    type: mcp
    command: node
    args:
      - /path/to/telegraph-mcp/dist/index.js
    env:
      TELEGRAPH_NODE_URL: http://13.237.89.59:7044
      TELEGRAPH_ENGINE_URL: http://13.237.89.59:8080
      TELEGRAPH_DAEMON_URL: http://13.237.89.59:8081
      TELEGRAPH_EVM_PRIVATE_KEY: 0xyour_key_here

VS Code／Continue

Continue の config.json に追加します。

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "stdio",
          "command": "node",
          "args": ["/path/to/telegraph-mcp/dist/index.js"],
          "env": {
            "TELEGRAPH_NODE_URL": "http://13.237.89.59:7044",
            "TELEGRAPH_ENGINE_URL": "http://13.237.89.59:8080",
            "TELEGRAPH_DAEMON_URL": "http://13.237.89.59:8081",
            "TELEGRAPH_EVM_PRIVATE_KEY": "0xyour_key_here"
          }
        }
      }
    ]
  }
}

汎用／任意の MCP クライアント

このサーバーは MCP stdio トランスポートを使用します。これはローカル MCP サーバーの標準です。stdio 経由の MCP プロトコルをサポートする任意のクライアントで使用できます。

{
  "mcpServers": {
    "telegraph": {
      "command": "node",
      "args": ["/path/to/telegraph-mcp/dist/index.js"],
      "env": {
        "TELEGRAPH_NODE_URL": "http://13.237.89.59:7044",
        "TELEGRAPH_ENGINE_URL": "http://13.237.89.59:8080",
        "TELEGRAPH_DAEMON_URL": "http://13.237.89.59:8081",
        "TELEGRAPH_EVM_PRIVATE_KEY": "0xyour_key_here"
      }
    }
  }
}

動的ツール検出

サブネットツールはハードコードされていません。起動時および 5 分ごとに、次の処理が行われます。

1. Telegraph ノードの GET /miner-dispatcher/integrations からライブ統合を取得します
2. 現在登録されているツールとの差分を確認します
3. 新しいサブネットを追加し、ツールを自動登録します
4. 古いサブネットを削除し、ツールを削除します
5. 接続中のクライアントに notifications/tools/list_changed を送信します

つまり、次のようになります。

• 新しいサブネットは、オンチェーン登録から 5 分以内に自動的に表示されます。MCP の再起動は不要です
• 削除されたサブネットはクリーンアップされます。エージェントが存在しないツールを呼び出すことはありません
• エージェントには、ネットワークで利用可能なものが常に正確に表示されます

セキュリティ

• 使い捨てウォレットを使用してください。 メインウォレットは絶対に使用しないでください。推論に必要な分だけUSDCを入金してください。
• 秘密鍵はMCPプロセス内に保持されます。 エージェントやLLMに公開されることはありません。
• MCPサーバーはstdio経由でローカル実行されます — ネットワークに公開されることはありません。
• 支払いは呼び出しごとに発生します。推論リクエスト1回あたり通常$0.01です。

開発

npm install          # Install deps
npm run build        # Compile TypeScript
npm run dev          # Dev mode with tsx (hot reload)
npx @modelcontextprotocol/inspector dist/index.js  # Inspect tools