TON Developer MCP

Connect your AI assistant to TON blockchain — query balances, deploy contracts, and search the full documentation without leaving your IDE.

Skills

Install the whole monorepo in one shot, or pick individual skill packs below. The cards describe documentation and wallets (paths such as ton-org/skills/docs and ton-org/skills/wallets).

Full bundle

To let your AI agent use TON — copy the command below, paste it into your terminal, and run it.

bash

npx skills add ton-org/skills

What's in the bundle

docs

Documentation

Orientation and answers grounded in official material: TL-B, TVM, FunC / Tolk, staking and validator topics at a high level, protocol architecture, and how to read the docs stack. In the repo this surfaces as the documentation skill line (`ton-org/skills/docs` and related prompts)—installed once with the root command above alongside wallets.

documentation

tl-b

reference

Try asking

1
“What are best practices for writing secure FunC contracts?”
2
“Explain the TON sharding model.”
3
“How does the Jetton standard work?”
4
“What is the difference between basechain and masterchain?”

wallets

Wallets & chain

Operational skills for live chain data: balances and history, send / receive / swap flows, Jettons and NFTs, and agentic wallet workflows. Creating an agentic wallet is mandatory before you rely on balance or transfer prompts—the tooling expects that onboarding first. Packaged under the wallets slice of the monorepo (`ton-org/skills/wallets`).

chain

wallets

agentic

Try asking

1
Required
“Create an agentic wallet for me.”
2
“What is the TON balance of my address?”
3
“Show the last 10 transactions for this address.”
4
“Swap 0.5 TON for USDT.”

Install selected skills only

docs — documentation & reference skillswallets — chain, agentic wallet, swaps

bash

npx skills add ton-org/skills

bash

npx skills add ton-org/skills/docs

bash

npx skills add ton-org/skills/wallets

bash

# Select at least one topic using the checkboxes above.

MCP

Servers

ton-docs

Documentation MCP

Remote HTTP server — no local install. Search and read the official TON documentation (`ton_search_docs` and related tools). Point your IDE at `https://docs.ton.org/mcp`.

http

docs.ton.org

read-only

@ton/mcp

Chain MCP (alpha)

Runs locally via `npx -y @ton/mcp@alpha`: live balances, transaction history, sends, contract deploy, Jettons and NFTs. Pair with the docs server when you want both reference material and chain access.

npx

chain

alpha

Include in config

TON Docs MCP — remote HTTPTON chain MCP — local via npx -y @ton/mcp@alpha.

To let your AI agent use TON — pick your IDE below, copy the snippet, and follow the two steps.

The snippet updates automatically when you toggle servers above — no JavaScript required.

Claude CodeCursorWindsurfVS Code

Run in your terminal:

bash

claude mcp add --transport http ton-docs https://docs.ton.org/mcp
claude mcp add ton -- npx -y @ton/mcp@alpha

bash

claude mcp add --transport http ton-docs https://docs.ton.org/mcp

bash

claude mcp add ton -- npx -y @ton/mcp@alpha

bash

# Enable at least one server using the checkboxes above.

Verify the connection

Ask your assistant to list available tools — you should see:

output

ton-docs · search_ton_docs
ton     · get_balance, send_ton, get_transactions, …

output

ton-docs · search_ton_docs

output

ton · get_balance, send_ton, get_transactions, …

output

# No servers selected — turn on docs and/or chain MCP above.

Add to Cursor MCP settings (Settings → MCP → Add server):

json

{
  "mcpServers": {
    "ton-docs": {
      "url": "https://docs.ton.org/mcp"
    },
    "ton": {
      "command": "npx",
      "args": ["-y", "@ton/mcp@alpha"]
    }
  }
}

json

{
  "mcpServers": {
    "ton-docs": {
      "url": "https://docs.ton.org/mcp"
    }
  }
}

json

{
  "mcpServers": {
    "ton": {
      "command": "npx",
      "args": ["-y", "@ton/mcp@alpha"]
    }
  }
}

json

{ "mcpServers": {} }

Verify the connection

Ask your assistant to list available tools — you should see:

output

ton-docs · search_ton_docs
ton     · get_balance, send_ton, get_transactions, …

output

ton-docs · search_ton_docs

output

ton · get_balance, send_ton, get_transactions, …

output

# No servers selected — turn on docs and/or chain MCP above.

Add to ~/.codeium/windsurf/mcp_config.json:

json

{
  "mcpServers": {
    "ton-docs": {
      "url": "https://docs.ton.org/mcp"
    },
    "ton": {
      "command": "npx",
      "args": ["-y", "@ton/mcp@alpha"]
    }
  }
}

json

{
  "mcpServers": {
    "ton-docs": {
      "url": "https://docs.ton.org/mcp"
    }
  }
}

json

{
  "mcpServers": {
    "ton": {
      "command": "npx",
      "args": ["-y", "@ton/mcp@alpha"]
    }
  }
}

json

{ "mcpServers": {} }

Verify the connection

Ask your assistant to list available tools — you should see:

output

ton-docs · search_ton_docs
ton     · get_balance, send_ton, get_transactions, …

output

ton-docs · search_ton_docs

output

ton · get_balance, send_ton, get_transactions, …

output

# No servers selected — turn on docs and/or chain MCP above.

Add to .vscode/mcp.json in your project:

json

{
  "servers": {
    "ton-docs": {
      "type": "http",
      "url": "https://docs.ton.org/mcp"
    },
    "ton": {
      "command": "npx",
      "args": ["-y", "@ton/mcp@alpha"]
    }
  }
}

json

{
  "servers": {
    "ton-docs": {
      "type": "http",
      "url": "https://docs.ton.org/mcp"
    }
  }
}

json

{
  "servers": {
    "ton": {
      "command": "npx",
      "args": ["-y", "@ton/mcp@alpha"]
    }
  }
}

json

{ "servers": {} }

Verify the connection

Ask your assistant to list available tools — you should see:

output

ton-docs · search_ton_docs
ton     · get_balance, send_ton, get_transactions, …

output

ton-docs · search_ton_docs

output

ton · get_balance, send_ton, get_transactions, …

output

# No servers selected — turn on docs and/or chain MCP above.