# Quick start: Create an agentic wallet (/overview/ai/quick-start)



## Overview [#overview]

The easiest way to get started with AI on TON is creating an [agentic wallet](/overview/ai/wallets).

This guide explains how to do the following:

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

<Aside>
  - Agentic wallets are self-custody wallets designed for autonomous AI agents on TON. They are implemented as [smart contracts](/overview/learn-more/glossary#smart-contract).
  - 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][skills-spec].
</Aside>

## Prerequisites [#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](/overview/wallets/tonkeeper) or [wallet.ton.org](/overview/wallets/web).
* 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 [#1-install-skills]

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

```bash
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**.

<Aside>
  Alternatively, you can [configure the MCP client manually](/overview/ai/mcp#configure-the-client-manually). Use this approach when the agent does not support skills or when finer control over server configuration is needed.
</Aside>

## 2. Create an agentic wallet [#2-create-an-agentic-wallet]

To create a 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](https://agents.ton.org/).
3. On the dashboard, connect your regular TON wallet by clicking <kbd>Connect</kbd>.
4. In the **Initial TON deposit** field, set the amount of Toncoin to deposit from the main wallet.
5. Deploy the agentic wallet by clicking <kbd>Deploy + First Fund</kbd>.
6. Once the deployment is complete, copy the wallet's address from the dashboard.
7. 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](#manage-wallets) form the dashboard.

## 3. Fund the wallet [#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](https://agents.ton.org/): click <kbd>Fund</kbd> 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 [#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.

## 5. Manage wallets [#5-manage-wallets]

You can see all agentic wallets and manage them from the [web dashboard](https://agents.ton.org/):

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

## Next steps [#next-steps]

Learn more about TON MCP server and ways to use it: [@ton/mcp](/overview/ai/mcp).

Learn more about agentic wallets: [Agentic wallets](/overview/ai/wallets).

[skills-spec]: https://agentskills.io/specification