Skip to main content
Glama
deenesjakoruzh
ashishwarkhade

Telegraph MCP Server

by ashishwarkhade
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

@telegraph/mcp-server

MCP-Server, der Telegraph Protocol KI-Inferenz-APIs als Tools mit automatischen x402-Mikrozahlungen bereitstellt.

Verbinden Sie jeden MCP-kompatiblen Agenten (Claude Desktop, Cursor, ElizaOS, LangChain, OpenClaw, Goose usw.) mit dem Netzwerk von KI-Minern von Telegraph — Wettervorhersage, Deepfake-Erkennung, LLM-Inferenz, KI-Text-Erkennung, Signalüberwachung — ohne einen einzigen Krypto-Code im Agenten. Der MCP-Server übernimmt die Verwahrung des privaten Schlüssels, die Signierung von Zahlungen und die Abwicklung von Transaktionen intern.

Miner können Bittensor-Subnetze, gehostete Modelle oder jede private API sein, die über YAML integriert ist. Einige Tool- und Feldnamen enthalten aus Legacy-Gründen noch subnet — lesen Sie es als „Miner".

Dokumentation

Dokument

Beschreibung

Architektur

MCP-Protokoll, Tool-Kategorien, x402-Autozahlung, Client-Integrationen

Fehlerbehebung

Häufige Probleme und Lösungen

Related MCP server: telegraph-mcp

Schnellstart

Option A — npx (kein Klonen, empfohlen sobald veröffentlicht)

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

Option B — aus dem Quellcode

# 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

Veröffentlicht auf npm als telegraph-protocol-mcp und gelistet im MCP Registry als io.github.telegraphprotocol/telegraph. Betreuer: siehe PUBLISHING.md.

Architektur

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        │
└─────────────────────────────────────────────────┘

Konfiguration

Alles über Umgebungsvariablen (.env-Datei oder inline):

Variable

Erforderlich

Standard

Beschreibung

TELEGRAPH_NODE_URL

Ja

http://localhost:7044

Telegraph-Node-URL

TELEGRAPH_ENGINE_URL

Ja

http://localhost:8080

Engine-Server-URL

TELEGRAPH_DAEMON_URL

Ja

http://localhost:8081

Daemon-API-URL

TELEGRAPH_EVM_PRIVATE_KEY

Ja*

—

EVM privater Schlüssel (0x-präfixiertes Hex)

TELEGRAPH_SOLANA_PRIVATE_KEY

Nein*

—

Solana privater Schlüssel (base58)

EVM_NETWORK

Nein

eip155:*

EVM CAIP-2 Netzwerk

SVM_NETWORK

Nein

solana:*

Solana CAIP-2 Netzwerk

REFRESH_INTERVAL_MS

Nein

300000

Miner-Tool-Aktualisierungsintervall (ms). 0 zum Deaktivieren.

*Mindestens ein privater Schlüssel erforderlich.

Verfügbare Tools

Node-Tools (keine Zahlung)

Tool

Beschreibung

tg_node_status

Node-Status, öffentlicher Schlüssel, Chain-Info

tg_node_subnets_health

Miner-Integritätsprüfung

tg_node_list_subnets

Vollständiger Miner-Katalog mit Metadaten, Schemas, Endpunkten

Engine-Tools

Tool

Zahlung

Beschreibung

tg_engine_list_subnets

Kostenlos

Liste der Miner, an die die Engine weiterleiten kann

tg_engine_ask

x402

Automatisch weitergeleitete Inferenz (LLM wählt den besten Miner für Ihre Anfrage)

tg_engine_ask_subnet

x402

Direkte Inferenz durch einen bestimmten Miner anhand der ID

Daemon-Tools (keine Zahlung)

Tool

Beschreibung

tg_daemon_health

Daemon-Integritätsprüfung

tg_daemon_categories

Signalkategorien (POLITICS, ECONOMICS, TECHNOLOGY, CLIMATE, HEALTH, CRYPTO, SPORTS, …)

tg_daemon_questions

Gesammelte Signale mit Filtern abfragen (Kategorie, Quelle, Zeit, Interesse)

Dynamische Miner-Tools (automatisch erkannt, x402-Zahlung)

Tools für jeden Miner-Endpunkt werden automatisch aus dem Live-Integrationsregister des Telegraph-Nodes generiert. Der Live-Satz ändert sich on-chain, behandeln Sie dies daher als eine Momentaufnahme, nicht als die Quelle der Wahrheit (rufen Sie tg_node_list_subnets für den aktuellen Katalog auf):

Miner

Tools

Zeus (18) — Wetter

tg_zeus_predict

ItsAI (32) — KI-Text-Erkennung

tg_itsai_text_detector_detect

Sapling (33) — KI-Inhaltserkennung

tg_sapling_ai_detector_detect

BitMind (34) — Deepfake

tg_bitmind_detect_image, tg_bitmind_detect_video, tg_bitmind_preprocess_video, tg_bitmind_get_video_upload_url

OpenAI (102) — LLM / Bilder

tg_openai_chat, tg_openai_responses, tg_openai_embed, tg_openai_images_generate, tg_openai_moderate

Diese aktualisieren sich automatisch. Neue, on-chain registrierte Miner erscheinen innerhalb von 5 Minuten. Abgemeldete Miner werden bereinigt. Der Agent sieht immer nur aktuell gültige Tools.

Einige Tool- und Feldnamen enthalten aus Legacy-Gründen subnet — Telegraph begann mit der Integration von Bittensor-Subnetzen. Heute ist ein Miner jeder Anbieter, der über YAML integriert ist, ob Subnetz oder nicht.

Wie x402-Zahlungen funktionieren

Wenn ein Agent ein kostenpflichtiges Tool aufruft (z. B. tg_engine_ask):

  1. Der MCP-Server sendet eine Anfrage an Telegraph

  2. Telegraph gibt HTTP 402 mit Zahlungsanforderungen im Antwort-Header zurück

  3. @x402/fetch fängt die 402 ab, signiert eine EIP-3009 TransferWithAuthorization mit Ihrem privaten Schlüssel, hängt die Signatur als PAYMENT-Header an und wiederholt den Vorgang

  4. Telegraph überprüft die Zahlung on-chain über den PayAI-Vermittler und gibt das Ergebnis zurück

Der Agent und das LLM sehen niemals den Zahlungsablauf, den privaten Schlüssel oder die Blockchain-Transaktion. Es ist vollständig transparent — der Agent sieht nur ein Tool, das Ergebnisse zurückgibt.

Integrationsanleitungen

Claude Desktop

Bearbeiten Sie ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%\Claude\claude_desktop_config.json (Windows).

Mit npx (am einfachsten — kein Klonen oder Bauen):

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

Oder mit Verweis auf einen lokalen Build:

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

Starten Sie Claude Desktop neu. Die Telegraph-Tools erscheinen in der Tool-Liste. Versuchen Sie zu fragen: „Wie ist das Wetter in Lahore?“ oder „Erklären Sie mit der Telegraph-Engine, was Bitcoin ist.“

Cursor

Fügen Sie in Cursor-Einstellungen → MCP → Neuen MCP-Server hinzu hinzu:

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

In Ihrer Eliza-Charakterdatei oder MCP-Plugin-Konfiguration:

{
  "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+ unterstützt MCP über das Paket @elizaos/plugin-mcp. Aktivieren Sie es in der Plugin-Liste Ihres Charakters:

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

LangChain / LangGraph

LangChain unterstützt MCP über 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 unterstützt MCP nativ über Konfiguration. Fügen Sie zu openclaw.config.json hinzu:

{
  "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 unterstützt MCP-Server über sein Erweiterungssystem. Konfiguration in ~/.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

In der config.json von 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"
          }
        }
      }
    ]
  }
}

Generisch / Jeder MCP-Client

Der Server verwendet MCP stdio transport — den Standard für lokale MCP-Server. Jeder Client, der das MCP-Protokoll über stdio unterstützt, kann ihn verwenden:

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

Dynamische Tool-Erkennung

Subnetz-Tools sind nicht fest codiert. Beim Start und alle 5 Minuten:

  1. Ruft Live-Integrationen von GET /miner-dispatcher/integrations auf dem Telegraph-Node ab

  2. Vergleicht mit den derzeit registrierten Tools

  3. Fügt neue Subnetze hinzu → registriert Tools automatisch

  4. Entfernt veraltete Subnetze → löscht Tools

  5. Sendet notifications/tools/list_changed an verbundene Clients

Das bedeutet:

  • Neue Subnetze erscheinen automatisch innerhalb von 5 Minuten nach der On-Chain-Registrierung — kein MCP-Neustart erforderlich

  • Entfernte Subnetze werden bereinigt — Agenten rufen keine nicht existierenden Tools auf

  • Agenten haben immer eine genaue Ansicht dessen, was im Netzwerk verfügbar ist

Sicherheit

  • Verwenden Sie eine Burner-Wallet. Verwenden Sie niemals Ihre Haupt-Wallet. Laden Sie nur das USDC auf, das für die Inferenz benötigt wird.

  • Der private Schlüssel bleibt im MCP-Prozess. Wird niemals dem Agenten oder LLM ausgesetzt.

  • Der MCP-Server läuft lokal über stdio — keine Netzwerkexposition.

  • Zahlungen erfolgen pro Aufruf: typischerweise 0,01 $ pro Inferenzanfrage.

Entwicklung

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