Skip to main content
Glama
deenesjakoruzh
ashishwarkhade

Telegraph MCP Server

by ashishwarkhade
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
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, интеграции с клиентами

Устранение неполадок

Часто встречающиеся проблемы и решения

Быстрый старт

Вариант 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):

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

  1. Загружает актуальные интеграции из GET /miner-dispatcher/integrations на узле Telegraph

  2. Сравнивает с текущими зарегистрированными инструментами

  3. Добавляет новые подсети → автоматически регистрирует инструменты

  4. Удаляет устаревшие подсети → удаляет инструменты

  5. Отправляет 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 installed

-
license - not tested
-
quality - not tested
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ashishwarkhade/Telegraph-MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server