Skip to main content
Glama
deenesjakoruzh
ashishwarkhade

Telegraph MCP Server

by ashishwarkhade
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

@telegraph/mcp-server

Servidor MCP que expone las API de inferencia de IA del Protocolo Telegraph como herramientas con micropagos automáticos x402.

Conecta cualquier agente compatible con MCP (Claude Desktop, Cursor, ElizaOS, LangChain, OpenClaw, Goose, etc.) a la red de mineros de IA de Telegraph — predicción meteorológica, detección de deepfakes, inferencia de LLM, detección de texto generado por IA, monitoreo de señales — sin necesidad de código criptográfico en el agente. El servidor MCP gestiona internamente la custodia de la clave privada, la firma de pagos y la liquidación de transacciones.

Los mineros pueden ser subredes de Bittensor, modelos alojados o cualquier API privada integrada mediante YAML. Algunos nombres de herramientas y campos aún contienen subnet por razones heredadas — léase como "minero".

Documentación

Documento

Descripción

Arquitectura

Protocolo MCP, categorías de herramientas, pago automático x402, integraciones con clientes

Solución de problemas

Problemas comunes y soluciones

Inicio rápido

Opción A — npx (sin clonar, recomendado una vez publicado)

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

Opción B — desde el código fuente

# 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

Publicado en npm como telegraph-protocol-mcp y listado en el Registro MCP como io.github.telegraphprotocol/telegraph. Mantenedores: consulte PUBLISHING.md.

Arquitectura

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

Configuración

Todo mediante variables de entorno (archivo .env o en línea):

Variable

Obligatoria

Valor por defecto

Descripción

TELEGRAPH_NODE_URL

Sí

http://localhost:7044

URL del nodo Telegraph

TELEGRAPH_ENGINE_URL

Sí

http://localhost:8080

URL del servidor Engine

TELEGRAPH_DAEMON_URL

Sí

http://localhost:8081

URL de la API del Daemon

TELEGRAPH_EVM_PRIVATE_KEY

Sí*

—

Clave privada EVM (hex con prefijo 0x)

TELEGRAPH_SOLANA_PRIVATE_KEY

No*

—

Clave privada Solana (base58)

EVM_NETWORK

No

eip155:*

Red EVM CAIP-2

SVM_NETWORK

No

solana:*

Red Solana CAIP-2

REFRESH_INTERVAL_MS

No

300000

Intervalo de actualización de herramientas mineras (ms). 0 para deshabilitar.

*Se requiere al menos una clave privada.

Herramientas disponibles

Herramientas del Nodo (sin pago)

Herramienta

Descripción

tg_node_status

Estado del nodo, clave pública, información de la cadena

tg_node_subnets_health

Verificación de salud de la integración del minero

tg_node_list_subnets

Catálogo completo de mineros con metadatos, esquemas, endpoints

Herramientas del Engine

Herramienta

Pago

Descripción

tg_engine_list_subnets

Gratis

Lista los mineros a los que el Engine puede enrutar

tg_engine_ask

x402

Inferencia enrutada automáticamente (el LLM elige el mejor minero para tu consulta)

tg_engine_ask_subnet

x402

Inferencia directa a través de un minero específico por ID

Herramientas del Daemon (sin pago)

Herramienta

Descripción

tg_daemon_health

Verificación de salud del Daemon

tg_daemon_categories

Categorías de señales (POLITICS, ECONOMICS, TECHNOLOGY, CLIMATE, HEALTH, CRYPTO, SPORTS, …)

tg_daemon_questions

Consultar señales recopiladas con filtros (categoría, fuente, tiempo, interés)

Herramientas dinámicas de mineros (auto-descubiertas, pago x402)

Las herramientas para cada endpoint de minero se generan automáticamente a partir del registro de integraciones en vivo del nodo Telegraph. El conjunto en vivo cambia en la cadena, así que trátelo como una instantánea, no como la fuente de verdad (llame a tg_node_list_subnets para el catálogo actual):

Minero

Herramientas

Zeus (18) — Clima

tg_zeus_predict

ItsAI (32) — Detección de texto IA

tg_itsai_text_detector_detect

Sapling (33) — Detección de contenido IA

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 / imágenes

tg_openai_chat, tg_openai_responses, tg_openai_embed, tg_openai_images_generate, tg_openai_moderate

Estas se actualizan automáticamente. Los nuevos mineros registrados en la cadena aparecen en un plazo de 5 minutos. Los mineros dados de baja se eliminan. El agente siempre ve solo las herramientas actualmente válidas.

Algunos nombres de herramientas y campos contienen subnet por razones heredadas — Telegraph comenzó integrando subredes de Bittensor. Hoy en día un minero es cualquier proveedor integrado mediante YAML, sea subred o no.

Cómo funcionan los pagos x402

Cuando un agente llama a una herramienta de pago (por ejemplo, tg_engine_ask):

  1. El servidor MCP envía la solicitud a Telegraph

  2. Telegraph devuelve HTTP 402 con los requisitos de pago en el encabezado de respuesta

  3. @x402/fetch intercepta el 402, firma una TransferWithAuthorization EIP-3009 usando tu clave privada, adjunta la firma como un encabezado PAYMENT y reintenta

  4. Telegraph verifica el pago en la cadena a través del facilitador PayAI y devuelve el resultado

El agente y el LLM nunca ven el flujo de pago, la clave privada ni la transacción en la cadena de bloques. Es completamente transparente — el agente solo ve una herramienta que devuelve resultados.

Guías de integración

Claude Desktop

Edite ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows).

Usando npx (lo más simple — sin clonar ni compilar):

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

O apuntando a una compilación local:

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

Reinicie Claude Desktop. Las herramientas de Telegraph aparecerán en la lista de herramientas. Pruebe preguntando "¿Qué tiempo hace en Lahore?" o "Usa el motor de Telegraph para explicar qué es Bitcoin."

Cursor

Agregue en Configuración de Cursor → MCP → Agregar nuevo servidor MCP:

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

En su archivo de personaje de Eliza o configuración del plugin 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+ soporta MCP a través del paquete @elizaos/plugin-mcp. Actívelo en la lista de plugins de su personaje:

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

LangChain / LangGraph

LangChain soporta MCP mediante 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 soporta MCP de forma nativa mediante configuración. Agregue a 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 soporta servidores MCP a través de su sistema de extensiones. Configuración en ~/.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

En el config.json de 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"
          }
        }
      }
    ]
  }
}

Genérico / Cualquier cliente MCP

El servidor utiliza transporte MCP stdio — el estándar para servidores MCP locales. Cualquier cliente que soporte el protocolo MCP sobre stdio puede usarlo:

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

Descubrimiento dinámico de herramientas

Las herramientas de subred no están codificadas de forma fija. Al inicio y cada 5 minutos:

  1. Obtiene las integraciones en vivo de GET /miner-dispatcher/integrations en el nodo Telegraph

  2. Compara con las herramientas actualmente registradas

  3. Agrega nuevas subredes → registra herramientas automáticamente

  4. Elimina subredes obsoletas → borra herramientas

  5. Envía notifications/tools/list_changed a los clientes conectados

Esto significa:

  • Las nuevas subredes aparecen automáticamente en un plazo de 5 minutos desde el registro en la cadena — sin necesidad de reiniciar MCP

  • Las subredes eliminadas se limpian — los agentes no llamarán a herramientas inexistentes

  • Los agentes siempre tienen una visión precisa de lo que está disponible en la red

Seguridad

  • Use una billetera desechable. Nunca use su billetera principal. Financie solo con los USDC necesarios para la inferencia.

  • La clave privada permanece en el proceso MCP. Nunca se expone al agente ni al LLM.

  • El servidor MCP se ejecuta localmente sobre stdio — sin exposición a la red.

  • Los pagos son por llamada: típicamente $0.01 por solicitud de inferencia.

Desarrollo

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