# TON Developer MCP

> Connect AI assistants to the TON blockchain via the Model Context Protocol. Query balances, deploy contracts, and search the full TON documentation without leaving your IDE.

## Servers

- [TON Docs MCP](https://docs.ton.org/mcp): Remote HTTP server. Read-only access to the full TON documentation. No installation required.
- [TON MCP Alpha](https://www.npmjs.com/package/@ton/mcp): Local server via `npx -y @ton/mcp@alpha`. Live blockchain access — balances, transactions, contract deployment, Jetton and NFT operations.

## Available Tools

- `search_ton_docs` — Search TON documentation
- `query_docs_filesystem_ton_docs` — Read documentation pages by path (ripgrep, cat, head, tree)
- `get_balance` — Get wallet or contract balance
- `get_transactions` — Fetch transaction history for an address
- `send_ton` — Send TON to an address
- `send_jetton` — Send Jetton tokens to an address
- `get_jetton_balance` — Get Jetton balance for a wallet
- `get_swap_quote` — Get a swap quote between tokens
- `get_nfts` — List NFTs owned by a wallet
- `send_nft` — Transfer an NFT to another address
- `agentic_deploy_subwallet` — Deploy an agentic sub-wallet on-chain

## Setup

Add the TON skills bundle (recommended — documentation and wallets in one install):

```bash
npx skills add ton-org/skills
```

Or configure manually for Claude Code:

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

For Cursor and Windsurf (`~/.codeium/windsurf/mcp_config.json`):

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

## Documentation

- [TON Docs MCP](https://docs.ton.org/mcp): Full reference for the TON MCP server — tools, authentication, and usage examples.
- [TON Documentation](https://docs.ton.org): Complete TON blockchain developer documentation — FunC, Tolk, TL-B, smart contracts, wallets.
- [TON API Reference](https://docs.ton.org/v3/documentation/ton-documentation): API and SDK reference for building on TON.
- [FunC Language Guide](https://docs.ton.org/develop/func/overview): Smart contract language reference for TON.

## Ecosystem

- [Agentic Wallets](https://agents.ton.org): Create and manage on-chain agent wallets on TON.
- [Agent Dashboard](https://agents.ton.org/dashboard): Monitor and control agentic wallet activity.
- [TON Website](https://ton.org): Official TON blockchain website.
- [TON GitHub](https://github.com/ton-blockchain): Open-source repositories for the TON protocol.