Skip to main content
Glama
deenesjakoruzh
ashishwarkhade

Telegraph MCP Server

by ashishwarkhade
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

@telegraph/mcp-server

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

任意のMCP対応エージェント（Claude Desktop、Cursor、ElizaOS、LangChain、OpenClaw、Gooseなど）をTelegraphのAIマイナーネットワーク（天気予報、ディープフェイク検出、LLM推論、AIテキスト検出、シグナル監視など）に接続します。エージェント側の暗号コードは一切不要です。MCPサーバーが秘密鍵の管理、支払い署名、トランザクション決済を内部で処理します。

マイナーはBittensorサブネット、ホスト型モデル、YAMLで統合された任意のプライベートAPIのいずれかです。一部のツール名やフィールド名にはレガシーな理由で subnet と表記されていますが、「マイナー」と読み替えてください。

ドキュメント

ドキュメント

説明

アーキテクチャ

MCPプロトコル、ツールカテゴリ、x402自動支払い、クライアント統合

トラブルシューティング

よくある問題と解決策

Related MCP server: telegraph-mcp

クイックスタート

オプション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 Registry に 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

エンジンサーバーのURL

TELEGRAPH_DAEMON_URL

はい

http://localhost:8081

デーモン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つの秘密鍵が必要です。

利用可能なツール

ノードツール（支払い不要）

ツール

説明

tg_node_status

ノードのステータス、公開鍵、チェーン情報

tg_node_subnets_health

マイナー統合のヘルスチェック

tg_node_list_subnets

メタデータ、スキーマ、エンドポイントを含むマイナー完全カタログ

エンジンツール

ツール

支払い

説明

tg_engine_list_subnets

無料

エンジンがルーティング可能なマイナー一覧

tg_engine_ask

x402

自動ルーティング推論（LLMがクエリに最適なマイナーを選択）

tg_engine_ask_subnet

x402

特定のマイナーIDを指定した直接推論

デーモンツール（支払い不要）

ツール

説明

tg_daemon_health

デーモンのヘルスチェック

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ファシリテーターを介してオンチェーンで支払いを検証し、結果を返す

エージェントと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 → Add new MCP server に追加：

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • telegram-mcp

    jgalea
    A
    license
    C
    quality
    D
    maintenance
    Connects AI tools to Telegram via MCP, enabling reading chats, sending messages, managing groups, and more using your own account.
    54
    53 PyPI
    7
    MIT
  • telegraph-mcp by telegraphprotocol

    telegraph-mcpofficial

    telegraphprotocol
    A
    license
    Not graded
    quality
    D
    maintenance
    MCP server that exposes Telegraph Protocol's AI inference APIs as tools with automatic x402 micropayments, enabling any MCP-compatible agent to access AI miners like weather forecasting, deepfake detection, and LLM inference without handling cryptocurrency.
    7 npm
    MIT

  • morse

    Harshyadav442277
    A
    license
    Not graded
    quality
    A
    maintenance
    Enables agents and users to query the Telegraph network through a hosted MCP endpoint, with tools to ask miners, request specific miners, retrieve intents/recipes, and verify signal hashes on-chain.
    MIT