Quick start with agentic wallets

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.

Create an agentic wallet

To create the first agentic wallet, follow this flow:

1. Ask the agent to create an agentic wallet.
2. The agent will generate private keys and suggest opening the web dashboard.
3. On the dashboard, connect your TON wallet by clicking Connect.
4. In the Initial Gram deposit field, enter the amount of Gram to deposit from the main wallet.
5. Deploy the agentic wallet by clicking Deploy + First Fund.
6. Once the deployment is complete, copy the wallet's address from the dashboard.
7. Provide the address to your AI agent and ask it 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 from the dashboard.

Fund the wallet

There are three ways to fund an agentic wallet:

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

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

Use the wallet with AI

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

• Get wallet balances
• Send Gram and jettons
• Swap assets, manage NFTs, buy and 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 Gram to UQB.._WALLET_ADDRESS — Sign and send a transfer from the agentic wallet.
• Swap 5 Gram 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 Gram and jetton balances. Do not use this data for any calculations, as it becomes outdated quickly.
• Get my last transactions — List the most recent events initiated by the wallet.
• Import agentic wallet — Reinstate a wallet previously managed by another agent.

Manage wallets

You can see all agentic wallets and manage them from the web dashboard:

• Monitor transactions
• Fund and withdraw funds
• Grant and revoke access
• Rotate operator keys without redeploying the wallets