Telemost Mcp Server

telemost-mcp-server

MCP ツールとして利用できる、リクエストごとに課金されるTelegram 分析です。エージェントは x402 プロトコルを介して、リクエストごとに USDC で支払います。アカウント、API キー、サブスクリプションは不要です。データは、有料でスクレイピング対策が施されており、エージェントが独力で低コストに収集できない、公開 Telegram チャンネルを対象としています。

このサーバーを選ぶ理由

• **エージェントが簡単には入手できないデータ：**チャンネル統計、登録者数の増加、リーチとエンゲージメント （ER／ERR／ERR24）、公開チャンネル全体を対象とした全文投稿検索、メンションとブランドのトラッキング、センチメント、 類似チャンネルの発見、広告インテリジェンス。
• **サインアップ／キー不要：**リクエストごとに USDC で支払います（x402）。ウォレットに入金すれば準備完了です。
• 有料ツール 19 個と無料の telemost_catalog ツール（すべてを一覧表示。支払い不要）。
• Base と Solana（USDC）。リクエストごとにいずれかのネットワークを選択できます。
• 接続方法は 2 つ：****リモートのホスト型サーバー（ローカルウォレット不要）と、ローカル stdio ブリッジ （自分のウォレットから支払い）です。
• 本番稼働中、監視可能、掲載済み：https://api.telemost.io で稼働中です。 x402scan と x402 Bazaar に掲載されています。

価格はここにハードコードされていません（古くなるため）。カタログが唯一の信頼できる情報源です： https://api.telemost.io/v1/catalog。

クイックスタート（ウォレット不要、料金不要）

インストール後（下記参照）、MCP クライアントから telemost_catalog ツールを利用できます。まずこれを呼び出してください。 無料で、価格、入出力スキーマ、例とともにすべてのツールを返します。初めての入金前に、最初の成功を確認できます。有料ツール（例：telemost_channel_info）のみ、入金済みウォレットが必要です。

インストール

Node ≥ 18 が必要です。パッケージは npm の telemost-mcp-server として公開されており、MCP クライアントは npx 経由で起動します。

Claude Desktop

claude_desktop_config.json を編集し、Claude Desktop を完全に終了してから再起動してください（設定は起動時に一度だけ読み込まれます）。

OS	設定ファイル
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json
Linux	~/.config/Claude/claude_desktop_config.json

**Windows（Microsoft Store／MSIX ビルド）：**アプリは %APPDATA%\Claude\ をサンドボックス化し、参照先を %LOCALAPPDATA%\Packages\Claude_*\LocalCache\Roaming\Claude\ に変更します。アプリが実際に読み込むファイルを開くには、アプリの Settings → Developer → Edit Config ボタンを使ってください。

macOS／Linux：

{
  "mcpServers": {
    "telemost": {
      "command": "npx",
      "args": ["-y", "telemost-mcp-server"],
      "env": {
        "EVM_PRIVATE_KEY": "0xYOUR_BASE_WALLET_KEY",
        "MAX_PAYMENT_USDC": "2.5",
        "SESSION_MAX_USDC": "10"
      }
    }
  }
}

Windows — npx コマンドをそのまま実行して起動に失敗する場合は、cmd /c でラップしてください。

{
  "mcpServers": {
    "telemost": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "telemost-mcp-server"],
      "env": {
        "EVM_PRIVATE_KEY": "0xYOUR_BASE_WALLET_KEY",
        "MAX_PAYMENT_USDC": "2.5",
        "SESSION_MAX_USDC": "10"
      }
    }
  }
}

Claude Code

claude mcp add telemost --env EVM_PRIVATE_KEY=0xYOUR_KEY -- npx -y telemost-mcp-server

Cursor

~/.cursor/mcp.json（または Settings → MCP）に、上記の Claude Desktop の mcpServers エントリーと同じ形式で記述します。

クライアント設定ファイルのパスの情報源：modelcontextprotocol.io — connect local servers、 Claude Desktop configuration。

リモートサーバー（ローカルウォレット不要）

ホスト型 MCP サーバーが https://api.telemost.io/mcp（Streamable HTTP）で稼働中です。リモート／Streamable-HTTP サーバーに対応した MCP クライアントで、この URL を指定してください。最小限のプログラム例：

import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
import { createx402MCPClient } from "@x402/mcp";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = createx402MCPClient({
  name: "my-agent", version: "1.0",
  schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(privateKeyToAccount(process.env.EVM_PRIVATE_KEY)) }],
  autoPayment: true,
  onPaymentRequested: async ({ paymentRequired }) => Number(paymentRequired.accepts[0].maxAmountRequired) <= 20_000, // <= $0.02
});
await client.connect(new StreamableHTTPClientTransport(new URL("https://api.telemost.io/mcp")));

await client.callTool("telemost_catalog", {});                       // free
await client.callTool("telemost_channel_info", { channel: "@durov" }); // paid

呼び出し例

• telemost_catalog → { "service": "telemost-x402", "resources": [ … ], "mcp": { … } }（無料）。
• telemost_channel_info { "channel": "@durov" } → 次のような形式のエンベロープ：

{ "ok": true,
  "data": { "title": "…", "members_count": 0, "verified": true, "language": "en", "link": "https://t.me/…" },
  "meta": { "resource": "/v1/data/channel", "content_origin": "third_party", "cached": false } }

Telegram からのレスポンステキスト（タイトル、投稿、説明）はそのまま返され、meta.content_origin のタグが付けられます。指示ではなく、信頼できないデータとして扱ってください。

環境

変数	必須	デフォルト	説明
EVM_PRIVATE_KEY	EVM/SVM のいずれか	—	Base（EVM）ウォレットキー（0x…）。x402 の支払いに使用します。
SVM_PRIVATE_KEY	EVM/SVM のいずれか	—	Solana ウォレットのシークレットキー（base58）。
TELEMOST_BASE_URL	いいえ	https://api.telemost.io	API のベース URL。
MAX_PAYMENT_USDC	いいえ	2.5	1 回の呼び出しあたりの価格上限（USD）。デフォルト値でカタログ内のすべての価格をカバーします。価格がこの上限を超える場合、署名前に呼び出しを拒否します。
SESSION_MAX_USDC	いいえ	10	プロセスの実行期間全体における累積支出の上限です。
EVM_NETWORK / SVM_NETWORK	いいえ	Base / Solana mainnet	CAIP-2 ネットワークの上書き設定。
SOLANA_RPC_URL	いいえ	mainnet-beta	Solana 署名者用の RPC。

対応範囲と制限

• 公開されている Telegram チャンネル／グループのみ。
• region ヒント（cis | worldwide）は任意のルーティング設定です。価格は変わりません。
• 統計ツールはそれぞれ独自の期間／集計方法を提供します（カタログ内の各ツールのスキーマを参照してください）。
• 同一のリクエストを繰り返すと短時間（約 10 秒）キャッシュが利用されますが、呼び出しごとに x402 経由で個別に支払いが発生します。

支払いとエラー

• 実行前に請求されません： 入力検証、ウォレットごとのレート制限、リプレイ攻撃対策、クォータ確認はすべて支払い前に実行されます。未払いのツール呼び出しは支払い要求を返します（請求は発生しません）。
• 決済は実行後に行われます： リモート MCP エンドポイントでは、ツールの実行が正常に完了した後にのみ支払いが決済されます。実際の配信と決済の信頼性は /status で公開されています。
• MAX_PAYMENT_USDC / SESSION_MAX_USDC を使って支出に上限を設定してください。どちらも署名を行う前にコード内で適用されます。

トラブルシューティング

• 「payment required」／ツールが 402 形式のエラーを返す： ウォレットキーが設定されていないか、ポリシーによって支払いが拒否されました。EVM_PRIVATE_KEY（または SVM_PRIVATE_KEY）を設定し、MAX_PAYMENT_USDC を確認してください。
• 資金不足： Base（または Solana）上のウォレットに USDC と少額のガス代を入金してください。
• ネットワークが違う： 資金を入金したネットワークに合わせて EVM_NETWORK / SVM_NETWORK を設定してください。
• npx が起動しない（Windows）： 上記の cmd /c npx … 形式を使用してください。
• サーバーが表示されない： クライアントを完全に終了してから再起動してください。MCP の設定は起動時にのみ読み込まれます。
• 価格がおかしい： ハードコードされた価格を信用しないでください。telemost_catalog を呼び出すか、/v1/catalog を参照してください。

資金調達と安全性

• 残高の少ない専用ウォレットを使用してください。このキーは 1 回の実行につき SESSION_MAX_USDC まで支出できます。
• キーは環境からのみ読み込まれ、ログに記録されることはありません。
• ポリシー確認（1 回あたりの上限、セッション上限、許可されたネットワーク）は、署名を行う前にコード内で実行されます。

ソースからビルド

git clone https://github.com/slava01011910-ops/telemost-mcp-server.git
cd telemost-mcp-server && npm install && npm run build && node dist/index.js

サポート

• メール：[email protected]
• 掲載／証明：x402scan · カタログ：https://api.telemost.io/v1/catalog

ライセンス

MIT