Quick start: Create an agentic wallet

Overview

The easiest way to get started with AI on TON is creating an agentic wallet.

This guide explains how to do the following:

Install skills for TON MCP server (@ton/mcp)
Prompt an AI agent to create an agentic wallet on TON
Manage agentic wallets

Agentic wallets are self-custody wallets designed for autonomous AI agents on TON. They are implemented as smart contracts.
TON MCP server is a middleware acting as a bridge between an AI model and TON Blockchain.
Skills are instructions on how to launch and use TON MCP independently: no manual configuration is required. This approach works best with agents that support the skills specification.

Prerequisites

Before starting, meet the following prerequisites:

Install an autonomous AI agent such as Claude Code or Codex.
Create a wallet on TON — for example, using Tonkeeper or wallet.ton.org.
Fund the wallet with Toncoin. The recommended network is mainnet.

Your regular wallet on TON will be the owner of the agentic wallet.

1. Install skills

To install skills for @ton/mcp, run the following command:

npx skills add ton-connect/kit/packages/mcp

There are two options available:

Run the command anywhere and select the Global scope during installation.
Run it in the agent's folder and select Project.

Alternatively, you can configure the MCP client manually. Use this approach when the agent does not support skills or when finer control over server configuration is needed.

2. Create an agentic wallet

To create a first agentic wallet, follow this flow:

Ask the agent to create an agentic wallet.
The agent will generate private keys and suggest opening the web dashboard.
On the dashboard, connect your regular TON wallet by clicking Connect.
In the Initial TON deposit field, set the amount of Toncoin to deposit from the main wallet.
Deploy the agentic wallet by clicking Deploy + First Fund.
Once the deployment is complete, copy the wallet's address from the dashboard.
Provide the address to your AI agent and ask to import the wallet.

After importing the wallet, the agent will be able to sign transactions using its operator key.

Note that you can create multiple agentic wallets and manage them form the dashboard.

3. Fund the wallet

There are three ways to fund an agentic wallet:

During creation: use the Initial TON deposit field on the deployment page.
From the web dashboard: click Fund to transfer Toncoin, jettons, or NFTs.
Directly: use a wallet app like Tonkeeper to transfer assets to the agentic wallet address.

To check the balance, ask the agent: What is my agent balance?

4. Use the wallet with AI

Once setup is complete, you can ask the AI agent to manage assets and wallets:

Get wallet balances
Send Toncoin and jettons
Swap assets, manage NFTs, buy/sell Backed's xStocks
Create and import more agentic wallets
List wallets and switch between them
Rotate operator keys

For example, use prompts like this:

Send 1 TON to UQB.._WALLET_ADDRESS — Sign and send a transfer from the agentic wallet.
Swap 5 TON for USDT — Get a quote and execute a swap.
Resolve the contract address of this DNS domain: DOMAIN_NAME.ton — Obtain the wallet address of the domain owner.
Show my NFTs— Query all NFTs owned by the wallet.
Check my balance — Get current Toncoin and jetton balances. Do not use this data for any calculations, as it becomes outdated quickly.
Get my last transactions — List of several latest events initiated by the wallet.
Import agentic wallet — Reinstate a wallet previously managed by another agent.