de en es ja ko ru zh

Telegraph MCP Server

Name: Telegraph MCP Server
Author: ashishwarkhade

by ashishwarkhade

Overview Schema Source Related Servers Discussions Admin

Python

Local

@telegraph/mcp-server

MCP-сервер, предоставляющий API для AI-инференса Telegraph Protocol в виде инструментов с автоматическими микроплатежами x402.

Подключает любого MCP-совместимого агента (Claude Desktop, Cursor, ElizaOS, LangChain, OpenClaw, Goose и др.) к сети AI-майнеров Telegraph — прогнозирование погоды, обнаружение дипфейков, LLM-инференс, обнаружение AI-текста, мониторинг сигналов — без необходимости писать криптокод в агенте. MCP-сервер самостоятельно управляет хранением закрытых ключей, подписыванием платежей и расчётами по транзакциям.

Майнеры могут быть подсетями Bittensor, хостируемыми моделями или любыми частными API, интегрированными через YAML. Некоторые имена инструментов и полей всё ещё содержат 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`	URL узла Telegraph
`TELEGRAPH_ENGINE_URL`	Да	`http://localhost:8080`	URL сервера Engine
`TELEGRAPH_DAEMON_URL`	Да	`http://localhost:8081`	URL API Daemon
`TELEGRAPH_EVM_PRIVATE_KEY`	Да*	—	EVM-закрытый ключ (шестнадцатеричный с префиксом `0x`)
`TELEGRAPH_SOLANA_PRIVATE_KEY`	Нет*	—	Solana-закрытый ключ (base58)
`EVM_NETWORK`	Нет	`eip155:*`	EVM-сеть CAIP-2
`SVM_NETWORK`	Нет	`solana:*`	Solana-сеть CAIP-2
`REFRESH_INTERVAL_MS`	Нет	`300000`	Интервал обновления инструментов майнеров (мс). 0 для отключения.

*Требуется хотя бы один закрытый ключ.

Доступные инструменты

Инструменты узла (без оплаты)

Инструмент	Описание
`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):

MCP-сервер отправляет запрос в Telegraph
Telegraph возвращает HTTP 402 с требованиями к оплате в заголовке ответа
@x402/fetch перехватывает 402, подписывает EIP-3009 TransferWithAuthorization с использованием вашего закрытого ключа, добавляет подпись в заголовок PAYMENT и повторяет запрос
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 Settings → 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+ поддерживает MCP через пакет @elizaos/plugin-mcp. Включите его в список плагинов вашего персонажа:

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

LangChain / LangGraph

LangChain поддерживает MCP через langchain-mcp-adapters:

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

В config.json Continue:

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

Generic / Любой MCP-клиент

Сервер использует MCP stdio transport — стандарт для локальных MCP-серверов. Любой клиент, поддерживающий протокол MCP через stdio, может его использовать:

{
  "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 минут:

Загружает актуальные интеграции из GET /miner-dispatcher/integrations на узле Telegraph
Сравнивает с текущими зарегистрированными инструментами
Добавляет новые подсети → автоматически регистрирует инструменты
Удаляет устаревшие подсети → удаляет инструменты
Отправляет notifications/tools/list_changed подключённым клиентам

Это означает:

Новые подсети появляются автоматически в течение 5 минут после регистрации в цепочке — перезапуск MCP не требуется
Удалённые подсети очищаются — агенты не будут вызывать несуществующие инструменты
Агенты всегда имеют точное представление о том, что доступно в сети

Безопасность

Используйте одноразовый кошелёк. Никогда не используйте основной кошелёк. Пополняйте только тем количеством USDC, которое необходимо для инференса.
Закрытый ключ остаётся в процессе MCP. Никогда не раскрывается агенту или LLM.
MCP-сервер работает локально через stdio — без сетевого доступа.
Платежи за каждый вызов: обычно $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

Need Help?

Related Servers

Related MCP Connectors

SignalHarness.ai A
ai.signalharness
Remote MCP server exposing 330 production AI-agent services for web/data processing, validation, AI utilities, blockchain/crypto utilities, and x402 pay-per-use access.
AI & Machine Learning Cryptocurrency Payments & Billing
31
telegram-mcp
io.github.Shreyas-Profile
Telegram bridge for your MCP-compatible agent. Bidirectional, no LLM in our stack.
Communication App Automation
2
NEXUS Agent Utilities B
io.github.ilacop8585
Paid deterministic utilities and automation services for AI agents via MCP and x402.
Autonomous Agents App Automation Payments & Billing
21
PayGate MCP — Monetization Gateway for AI Agents A
io.github.geoacpfilho
Monetize any MCP server: x402 paywall, pay-per-call billing in USDC on Base, agent marketplace.
Payments & Billing Cryptocurrency Blockchain
61

Related MCP Servers

telegram-mcp
Communication Social Media
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.
Updated 14 days ago (2026-10-05 22:01 UTC)
54
42 PyPI
7
MIT
telegraph-mcpofficial
AI & Machine Learning Blockchain
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.
Updated 3 months ago (2026-07-23 12:50 UTC)
5 npm
MIT
Agent Commerce Gateway
Blockchain Web3 & Decentralized Tech Payments & Billing
devlab-group
A
license
Not graded
quality
A
maintenance
Enables AI agents to discover, call, and pay for existing HTTP APIs over MCP with x402 paywalls, non-custodial settlement, and no code changes to the backend.
Updated 4 days ago (2026-10-16 15:50 UTC)
211 npm
53
Apache 2.0
morse
Blockchain Web3 & Decentralized Tech Search
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.
Updated 19 days ago (2026-10-01 15:07 UTC)
MIT