Telemost Mcp Server

telemost-mcp-server

按次付费的 Telegram 分析 MCP 工具。你的 Agent 通过 x402 协议按次使用 USDC 付费——无需账户、API 密钥或订阅。数据涵盖付费且具有反抓取机制的数据源中的公开 Telegram 频道，Agent 无法以低成本自行收集这些数据。

为什么选择此服务

• **Agent 不易获取的数据：**频道统计数据、订阅者增长、触达量和互动率（ER / ERR / ERR24）、跨公开频道的全文帖子搜索、提及和品牌追踪、情感分析、相似频道发现、广告情报。
• **无需注册 / 密钥：**按次使用 USDC 付费（x402）。为钱包充值即可。
• 19 个付费工具 + 一个免费 telemost_catalog 工具（列出所有工具，无需付费）。
• Base + Solana（USDC）。每次调用可选择任一网络。
• 两种连接方式：****远程托管服务（无需本地钱包）和本地 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（配置只会在启动时读取一次）。

操作系统	配置文件
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	单次调用的价格上限（USD）；默认值涵盖目录中的所有价格。如果价格超过此上限，将在签名前拒绝调用。
SESSION_MAX_USDC	否	10	进程生命周期内的累计支出上限。
EVM_NETWORK / SVM_NETWORK	否	Base / Solana 主网	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，并准备少量 Gas。
• 网络错误： 将 EVM_NETWORK / SVM_NETWORK 设置为已充值资金的网络。
• npx 无法启动（Windows）： 使用上文的 cmd /c npx … 形式。
• 未显示服务： 完全退出并重新打开客户端——MCP 配置只会在启动时读取。
• 价格看起来不对： 切勿相信硬编码的价格；请调用 telemost_catalog 或读取 /v1/catalog。

充值与安全

• 使用余额较少的专用钱包——此密钥每次运行最多可支出 SESSION_MAX_USDC。
• 密钥仅从环境中读取，绝不会记录到日志中。
• 策略检查（单次调用上限、会话上限、允许的网络）都会在任何签名前通过代码执行。

从源代码构建

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