Skip to content
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -75,6 +75,7 @@
"group": "AI",
"expanded": true,
"pages": [
"ecosystem/ai/overview",
"ecosystem/ai/mcp",
"ecosystem/ai/wallets"
]
Expand Down
23 changes: 13 additions & 10 deletions ecosystem/ai/mcp.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,6 @@
---
title: "Agentic MCP server: @ton/mcp"
sidebarTitle: "Agentic MCP server"
tag: "new"
title: "AgentKit: @ton/mcp"
sidebarTitle: "@ton/mcp"
---

import { Aside } from '/snippets/aside.jsx';
Expand All @@ -22,6 +21,10 @@ To set it up, follow the [quick start guide](#quick-start).
`@ton/mcp` is currently in <Badge size="xs">alpha</Badge>. It is safe for use in mainnet, but APIs, behaviors, and [underlying wallet contracts][wallets] may change between releases. Pin a specific version for production use and check the [changelog][changelog] before upgrading.
</Aside>

<Aside type="note">
For all official TON MCP servers, their setup, and related skills, refer to [mcp.ton.org](https://mcp.ton.org/).
</Aside>

## Features

- Balance queries: check Toncoin and jetton (token) balances, view transaction history
Expand Down Expand Up @@ -136,7 +139,7 @@ To start using `@ton/mcp` in agentic wallets mode:
`@ton/mcp` supports two runtime modes:

- [Agentic wallets mode](#agentic-wallets-mode) (default) - operates with self-custody wallets for autonomous AI agents.
- [Single-wallet mode](#single-wallet) - operates with a single in-memory wallet.
- [Single-wallet mode](#single-wallet-mode) (optional) - operates with a single in-memory wallet.

### Agentic wallets mode

Expand Down Expand Up @@ -228,12 +231,12 @@ The package exports a `@ton/mcp/serverless` entry point for deployment as a serv

Serverless mode operates in [single-wallet mode](#single-wallet-mode) only and always uses the [`v5r1` TON wallet version][wallets-comparison]. It does not use the wallet registry, nor does it expose wallet management or onboarding tools.

| Header | Description |
| --------------- | -------------------------------------------------------------------------------------------------------- |
| `MNEMONIC` | Space-separated 24-word mnemonic phrase. |
| `PRIVATE_KEY` | Hex-encoded 32-byte or 64-byte private key (paired with the public key). Takes priority over `MNEMONIC`. |
| `NETWORK` | Either `mainnet` (default) or `testnet`. |
| `TONCENTER_KEY` | Optional API key for higher rate limits. |
| Header | Description |
| ------------------- | -------------------------------------------------------------------------------------------------------- |
| `MNEMONIC` | Space-separated 24-word mnemonic phrase. |
| `PRIVATE_KEY` | Hex-encoded 32-byte or 64-byte private key (paired with the public key). Takes priority over `MNEMONIC`. |
| `NETWORK` | Either `mainnet` (default) or `testnet`. |
| `TONCENTER_API_KEY` | Optional API key for higher rate limits. |
Comment thread
novusnota marked this conversation as resolved.

<CodeGroup>
```typescript title="AWS Lambda"
Expand Down
33 changes: 33 additions & 0 deletions ecosystem/ai/overview.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
---
title: "Overview of AI in TON"
sidebarTitle: "Overview"
---

There are AI products utilizing TON Blockchain, such as agents and wallet tooling. Additionally, TON documentation is AI-friendly, and enables all kinds of AI workflows.
Comment thread
novusnota marked this conversation as resolved.

## AI ecosystem

### Tooling

The main official entry point is [`@ton/mcp`](/ecosystem/ai/mcp), a TON MCP server for agents. It exposes tools for balance checks, asset queries, transfers, TON DNS resolution, swaps, and [agentic wallet](/ecosystem/ai/wallets) management. Use [`@ton/mcp`](/ecosystem/ai/mcp) when an agent needs to operate on TON through MCP or through a skills-based setup.

For the catalog of official TON MCP servers, setup guides, and related skills, see [mcp.ton.org](https://mcp.ton.org/).

Check warning on line 14 in ecosystem/ai/overview.mdx

View workflow job for this annotation

GitHub Actions / Spelling

Unknown word (mcp) Suggestions: (MCP, mlcp, MCAP, MCHP, map)
Comment thread
novusnota marked this conversation as resolved.
Outdated

### Community

The [AI Dev Wall on Telegram](https://t.me/ai_dev_wall) is a builder channel for TON AI tooling and project updates. This channel primarily features third-party, community resources.

## Documentation

TON documentation exposes several AI-facing surfaces:

- The in-site assistant can answer questions over the docs and cite relevant pages. Assistant can be invoked by a shortcut <kbd>Ctrl+K</kbd> (or <kbd>Cmd+K</kbd> on macOS), a query in the floating input field at the bottom of each page, from any selection on the page, or via a button on each code block to explain its contents.
- MCP server allows reading and querying documentation pages via MCP clients: `https://docs.ton.org/mcp`.
- The contextual menu can copy page content, open a page in external AI tools, or connect to the documentation MCP.
- The [`llms.txt`](https://docs.ton.org/llms.txt) file provides a machine-readable index of documentation pages.
- Raw Markdown is available through `.md` page routes. This is useful when a tool needs the page content without the site UI. For example, to obtain raw contents of this page, query `https://docs.ton.org/ecosystem/ai/overview.md`.

The documentation MCP and [`@ton/mcp`](/ecosystem/ai/mcp) serve different purposes:

- The documentation MCP is for reading TON Docs.
- `@ton/mcp` is for acting on TON.
1 change: 0 additions & 1 deletion ecosystem/ai/wallets.mdx
Original file line number Diff line number Diff line change
@@ -1,7 +1,6 @@
---
title: "Agentic wallet contracts"
sidebarTitle: "Agentic wallets"
tag: "new"
---

import { Aside } from '/snippets/aside.jsx';
Expand Down
Loading