git404hub

what is mcp fr?

tonnode/mcp — explained in plain English

Analysis updated 2026-05-18

65TypeScriptAudience · developerComplexity · 3/5Setup · easy

tl;dr

An MCP server that lets AI assistants like Claude or ChatGPT check balances, view transactions, and prepare trades on the TON blockchain.

vibe map

mindmap
  root((TON MCP server))
    What it does
      Direct TON blockchain access
      No HTTP gateway needed
      Works with Claude and others
    Tools
      Balance and transaction lookups
      Swap quotes and trades
      Wallet generation
    Tech stack
      TypeScript
      Node.js
      MCP protocol
    Hosting
      Local via npx
      Hosted HTTP with API keys

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Let an AI assistant check TON wallet balances and transaction history on request.

VIBE 2

Ask an AI agent to fetch a swap quote and prepare an unsigned trade for you to sign.

VIBE 3

Set up a hosted MCP endpoint with API keys for a team or product to query TON data.

VIBE 4

Generate a throwaway TON wallet for programmatic or testing use.

what's the stack?

TypeScriptNode.jsMCP

how it stacks up fr

tonnode/mcpboring-software-inc/dither-kitcompdf/compdf-self-hosted
Stars656565
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyeasymoderate
Complexity3/52/53/5
Audiencedeveloperdeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Wallet generation returns real secret key material, so generated wallets should be treated as temporary, not for large balances.

in plain english

This project is an MCP server, a plugin format that lets AI assistants like Claude, ChatGPT, Cursor, and Codex call external tools directly. This particular server gives an AI agent direct access to The Open Network, known as TON, a blockchain, without going through a middleman web gateway. Setup is a single JSON snippet added to a supported AI client's configuration, after which the assistant connects to the TON network automatically. The server exposes a wide set of tools. Some are read only, such as checking the balance of an address, looking up token balances and metadata, viewing recent transactions, checking whether a smart contract is deployed, and calling read only methods on contracts. Others let an AI agent actually trade: getting a live swap quote between TON's native coin and other tokens, building an unsigned transaction for a wallet owner to sign themselves, and even carrying out cross chain swaps that let someone pay in TON and receive funds on other blockchains such as Ethereum or Polygon through an escrow mechanism. The README stresses that the server itself never holds a private key, never signs a transaction, and never sends funds on a user's behalf, so trading tools only prepare transactions for the wallet owner to approve. One tool can generate a brand new wallet, complete with a recovery phrase and private key. The README is direct about the risk here: because the keys are created on the server and sent back over an encrypted connection, any wallet made this way should be treated as convenient but not fully secure, and operators can disable this specific tool with a configuration flag if they do not want it available. Beyond running locally through a single command, the project also supports being hosted as a shared web service, with API keys, per key rate limits, and configuration for things like which TON liteservers to use or whether to run on the TON testnet. The README does not state what open source license the project uses.

prompts (copy fr)

prompt 1
Add the tonnode MCP server to my Claude Desktop config so I can ask about my TON wallet balance.
prompt 2
Ask the TON MCP server for a swap quote and build the unsigned transaction for me to sign.
prompt 3
Explain how the cross chain swap tools in this MCP server keep funds safe using an escrow secret.
prompt 4
Help me run the tonnode MCP server in hosted HTTP mode with API keys and rate limits.

Frequently asked questions

what is mcp fr?

An MCP server that lets AI assistants like Claude or ChatGPT check balances, view transactions, and prepare trades on the TON blockchain.

What language is mcp written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, MCP.

How hard is mcp to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is mcp for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.