de en es ja ko ru zh

Telegraph MCP Server

Name: Telegraph MCP Server
Author: ashishwarkhade

by ashishwarkhade

Overview Schema Related Servers Score Discussions

TypeScript

Local

@telegraph/mcp-server

MCP 서버로, Telegraph Protocol AI 추론 API를 도구로 노출하며 자동 x402 마이크로페이먼트를 지원합니다.

MCP 호환 에이전트(Claude Desktop, Cursor, ElizaOS, LangChain, OpenClaw, Goose 등)를 Telegraph의 AI 마이너 네트워크(기상 예측, 딥페이크 탐지, LLM 추론, AI 텍스트 탐지, 신호 모니터링)에 연결하며, 에이전트 측에 암호화폐 코드가 전혀 필요하지 않습니다. MCP 서버가 개인 키 관리, 결제 서명, 트랜잭션 정산을 내부적으로 처리합니다.

마이너는 Bittensor 서브넷, 호스팅된 모델, 또는 YAML을 통해 통합된 모든 비공개 API일 수 있습니다. 일부 도구 및 필드 이름은 레거시 이유로 여전히 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 레지스트리에 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`	Telegraph 노드 URL
`TELEGRAPH_ENGINE_URL`	예	`http://localhost:8080`	엔진 서버 URL
`TELEGRAPH_DAEMON_URL`	예	`http://localhost:8081`	데몬 API URL
`TELEGRAPH_EVM_PRIVATE_KEY`	예*	—	EVM 개인 키 (`0x` 접두사 16진수)
`TELEGRAPH_SOLANA_PRIVATE_KEY`	아니오*	—	Solana 개인 키 (base58)
`EVM_NETWORK`	아니오	`eip155:*`	EVM CAIP-2 네트워크
`SVM_NETWORK`	아니오	`solana:*`	Solana CAIP-2 네트워크
`REFRESH_INTERVAL_MS`	아니오	`300000`	마이너-도구 새로고침 간격 (ms). 0이면 비활성화.

*최소 하나의 개인 키가 필요합니다.

사용 가능한 도구

노드 도구 (결제 없음)

도구	설명
`tg_node_status`	노드 상태, 공개 키, 체인 정보
`tg_node_subnets_health`	마이너 통합 상태 점검
`tg_node_list_subnets`	전체 마이너 카탈로그 (메타데이터, 스키마, 엔드포인트 포함)

엔진 도구

도구	결제	설명
`tg_engine_list_subnets`	무료	엔진이 라우팅할 수 있는 마이너 목록
`tg_engine_ask`	x402	자동 라우팅 추론 (LLM이 쿼리에 가장 적합한 마이너 선택)
`tg_engine_ask_subnet`	x402	ID로 특정 마이너에 직접 추론

데몬 도구 (결제 없음)

도구	설명
`tg_daemon_health`	데몬 상태 점검
`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 설정 → MCP → 새 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

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+는 @elizaos/plugin-mcp 패키지를 통해 MCP를 지원합니다. 캐릭터의 플러그인 목록에서 활성화하세요:

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

LangChain / LangGraph

LangChain은 langchain-mcp-adapters를 통해 MCP를 지원합니다:

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

Continue의 config.json에서:

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

일반 / 모든 MCP 클라이언트

이 서버는 MCP stdio 전송을 사용합니다 — 로컬 MCP 서버의 표준입니다. stdio를 통해 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"
      }
    }
  }
}

동적 도구 발견

서브넷 도구는 하드코딩되지 않았습니다. 시작 시와 5분마다:

Telegraph 노드의 GET /miner-dispatcher/integrations에서 실시간 통합 정보 가져오기
현재 등록된 도구와 비교
새 서브넷 추가 → 도구 자동 등록
오래된 서브넷 제거 → 도구 삭제
연결된 클라이언트에 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

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

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

Related MCP Connectors

telegram-mcp
Telegram bridge for your MCP-compatible agent. Bidirectional, no LLM in our stack.
PayGate MCP — Monetization Gateway for AI Agents
Monetize any MCP server: x402 paywall, pay-per-call billing in USDC on Base, agent marketplace.
mcp
Connect AI agents to Replynodes over the Model Context Protocol.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

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