whatisgithub

What is mcp?

tonnode/mcp — explained in plain English

Analysis updated 2026-05-18

65TypeScriptAudience · developerComplexity · 3/5Setup · easy

In one sentence

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

Mindmap

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 build with it?

USE CASE 1

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

USE CASE 2

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

USE CASE 3

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

USE CASE 4

Generate a throwaway TON wallet for programmatic or testing use.

What is it built with?

TypeScriptNode.jsMCP

How does it compare?

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 you get it running?

Difficulty · easy Time to first run · 5min

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

So what is it?

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.

Copy-paste prompts

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?

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.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.