TON MCP — les agents déplacent enfin la valeur entre chaînes

Agent DeFAI sur TON : pourquoi lire la blockchain ne suffit pas

Votre agent IA sait répondre aux questions sur TON — solde d'un wallet, statut d'un contrat, historique de transactions. L'utilisateur écrit : « J'ai 500 USDT sur TON, je veux ouvrir une position sur Base ». Et l'agent s'arrête. Il voit tout, mais ne peut rien faire. Entre « lire la blockchain » et « déplacer de la valeur », il y a un gouffre qu'un MCP read-only classique ne franchit pas. Un agent qui ne fait que lire, c'est un dashboard avec un chat. Le DeFAI (DeFi + AI) commence là où l'agent déplace la valeur au lieu de simplement la regarder.

Le deuxième mur, c'est la confiance. La plupart des « wallets intelligents pour agents » sont custodiaux : pour que l'agent puisse envoyer quoi que ce soit, quelqu'un doit détenir la clé et signer. Pour un bot autonome, cela signifie qu'une clé privée ou une clé operator est stockée là où vous ne la contrôlez pas. En production, avec l'argent d'autrui, c'est inacceptable.

TONNode est un serveur MCP hébergé pour TON (site tonnode.io) avec exactement 16 outils : lecture, swap, cross-chain et génération de wallet. Point clé : les outils de swap, de cross-chain et de wallet sont strictement non-custodiaux. Le serveur ne signe jamais et ne détient jamais de fonds ni de clés privées — il renvoie des messages TonConnect non signés, que le wallet de l'utilisateur signe lui-même. C'est cela, le MCP cross-chain pour TON sans compromis sur le contrôle des clés.

Pour qu'une action soit sûre, il faut deux choses :

• L'agent prépare la transaction, mais ne la signe pas. La signature vient du wallet de l'utilisateur via TonConnect. Le serveur ne touche pas aux clés.
• L'agent sait travailler au-delà d'une seule chaîne. En crypto, la valeur vit dans plusieurs réseaux à la fois, et « TON uniquement », cela ne couvre que la moitié du problème.

TONNode fait les deux. Voyons maintenant comment assembler un vrai agent DeFAI à partir de ces outils.

Swap non-custodial : get_swap_quote et build_swap_tx via Omniston

Le swap dans TONNode, ce sont deux outils aux responsabilités séparées : d'abord la cotation, puis la construction.

• get_swap_quote — une cotation ferme pour l'échange GRAM⇄jetton via le protocole Omniston, qui agrège la liquidité de STON.fi et DeDust. L'agent obtient donc d'emblée le meilleur prix des deux plus gros DEX, au lieu de deviner où c'est le plus avantageux.
• build_swap_tx — construit une transaction de swap non signée, prête pour TonConnect. C'est précisément cette étape qui incarne le non-custodial : le serveur remet le message, et c'est le wallet de l'utilisateur qui le signe.

L'analogie est simple. get_swap_quote, c'est le panneau d'affichage du bureau de change. build_swap_tx, c'est le bordereau rempli que vous lisez et signez vous-même. Le guichetier (le serveur) ne met pas la main dans votre portefeuille.

En dialogue avec l'agent, cela ressemble à ceci :

Utilisateur : échange 100 GRAM contre des USDT, montre-moi le taux avant de confirmer

Agent → get_swap_quote (GRAM → USDT, 100)
Agent : vous recevrez ≈ X USDT au taux Y (route Omniston). Je construis la transaction ?

Utilisateur : oui

Agent → build_swap_tx
Agent : c'est prêt, signez dans votre wallet ↓ (TonConnect)

Un détail important pour afficher des montants corrects : les jettons sont stockés en unités brutes (raw), et la conversion dépend des decimals. Pour l'USDT, decimals = 6 ; pour la plupart des jettons, c'est 9. Avant d'afficher un solde ou un montant, l'agent doit appeler get_jetton_info (métadonnées du jetton : nom, symbole, decimals, émission) et get_jetton_balance (solde du jetton ; le jetton-wallet est calculé on-chain). Sinon l'agent affichera « 50000000 » au lieu de « 50 ».

Les clés ne quittent l'appareil de l'utilisateur à aucune étape. Pour le détail de ce schéma, voir l'analyse du swap non-custodial pour agents.

MCP cross-chain pour TON : escrow HTLC atomique et route vers 6 réseaux EVM

Passons à ce qu'aucun autre MCP pour TON ne propose : le swap cross-chain de TON vers des réseaux EVM sans bridge custodial. TONNode le fait via un escrow HTLC atomique (Hashed TimeLock Contract).

La mécanique ressemble à un échange via un coffre à deux serrures :

1. Les fonds sont verrouillés dans un contrat d'escrow sur les deux chaînes, sous le même hash d'un secret.
2. Tant que le secret n'est pas révélé, l'argent ne bouge nulle part.
3. La révélation du secret déverrouille les deux côtés en même temps : soit l'échange passe entièrement, soit il ne passe pas du tout. Il n'existe pas d'état intermédiaire « l'argent est parti mais rien n'est revenu ».
4. Si la contrepartie ne répond plus, les fonds reviennent à leur propriétaire à l'expiration du timeout.

Les réseaux pris en charge sont exactement ceux-ci, et TON est toujours la source :

• Ethereum
• Arbitrum
• Base
• BNB Chain
• Polygon
• Avalanche

TRON n'est pas encore pris en charge — il faut le dire honnêtement à l'utilisateur, pour que l'agent ne promette pas l'impossible.

Le point clé du non-custodial ici : build_crosschain_swap_tx renvoie à la fois la transaction d'escrow HTLC non signée et le secret — le secret reste chez l'utilisateur/l'agent, pas sur le serveur. La révélation du secret est une étape explicite distincte, après vérification on-chain que tout est prêt. La mécanique complète est détaillée dans l'article sur le swap cross-chain TON → Ethereum.

Cinq outils cross-chain : cotation, construction, suivi, révélation, refund

Un échange cross-chain n'est pas un bouton unique, c'est une machine à états. Chaque état a son outil :

1. get_crosschain_quote — cotation de l'échange cross-chain : combien l'utilisateur recevra sur le réseau cible, les frais, la route.
2. build_crosschain_swap_tx — transaction d'escrow HTLC non signée + le secret. Le wallet de l'utilisateur signe la transaction, le secret reste chez lui.
3. track_crosschain_swap — les phases de l'échange sur les deux chaînes : les fonds sont-ils verrouillés dans l'escrow côté TON, le verrouillage miroir est-il apparu côté EVM, le secret est-il révélé, le règlement est-il terminé.
4. disclose_crosschain_secret — révèle le secret pour le règlement, mais seulement après vérification on-chain que tout est prêt. C'est la protection contre une révélation prématurée du secret, qui ferait perdre le contrôle de l'échange.
5. build_crosschain_refund — construit la transaction de retour des fonds depuis l'escrow si l'échange est bloqué et que le timeout a expiré.

Le cycle de vie complet d'un échange

Voici le flux que l'agent déroule, de la cotation jusqu'au règlement ou au remboursement :

get_crosschain_quote        → cotation TON → Base
build_crosschain_swap_tx    → tx d'escrow HTLC non signée + secret
   (l'utilisateur signe l'escrow avec son wallet)
track_crosschain_swap       → on attend que la contrepartie soit prête
disclose_crosschain_secret  → on révèle le secret, le règlement s'exécute
   ── en cas de blocage ──
build_crosschain_refund     → retour des fonds depuis l'escrow

Notez que le refund fait partie du design : ce n'est pas une rustine ajoutée après coup. C'est précisément build_crosschain_refund qui rend la construction sûre pour un agent autonome : même si quelque chose tourne mal, les fonds ne restent pas coincés — il existe un chemin de retour déterministe. Ces cinq outils transforment le « bridge qui fait peur » en un processus prévisible, étape par étape.

Où est le moat de TONNode : non-custodial + cross-chain + hébergé

Comparons honnêtement avec le package officiel. @ton/mcp de la TON Foundation est un wallet-agent custodial avec un schéma split-key : l'agent détient la clé operator, l'utilisateur la clé owner, et l'agent signe lui-même. Il sait faire beaucoup de choses — lecture, envoi de GRAM/jettons/NFT, swap via un agrégateur DEX, gestion des NFT et du DNS, création et import de wallets-agents — et il est officiel. Ce sont de vraies forces, inutile de les minimiser.

Mais deux limites comptent :

• Il est custodial — la clé operator est chez l'agent, donc l'agent peut dépenser de façon autonome. Pratique pour certains scénarios, risque inacceptable pour d'autres.
• Il est TON uniquement — pas de cross-chain.

TONNode se distingue sur trois axes :

	@ton/mcp officiel	TONNode
Modèle de clés	Custodial (split-key, signe lui-même)	Non-custodial (renvoie des messages TonConnect non signés)
Cross-chain	Non, TON uniquement	TON → 6 réseaux EVM, HTLC atomique
Déploiement	Local / HTTP / serverless	Local (npx) et endpoint hébergé

Le non-custodial n'est pas une case à cocher, c'est un moat architectural. Le serveur ne signe jamais et ne détient jamais de fonds ni de clés privées. Même generate_wallet (crée un nouveau wallet TON en version v3r2 / v4 / v5r1 / highload_v3) remet la mnémonique et les clés à l'utilisateur — le serveur ne les stocke pas. La comparaison détaillée des deux approches est dans MCP custodial contre non-custodial.

Un petit détail de terminologie pour éviter toute confusion : GRAM est le nouveau nom du Toncoin (le renommage a eu lieu en juin 2026) ; le réseau, lui, s'appelle toujours TON.

Comment se connecter et assembler son agent DeFAI

Vous pouvez commencer gratuitement et en local, sans carte bancaire ni inscription. Le package @tonnode/mcp est open source (MIT) et fonctionne via le protocole natif ADNL de TON, sans couche HTTP intermédiaire.

Config locale et hébergée

Config locale (jeu d'outils public, lecture complète) — ajoutez simplement ceci à la config de votre client MCP :

{
  "mcpServers": {
    "ton": { "command": "npx", "args": ["-y", "@tonnode/mcp"] }
  }
}

Endpoint hébergé (débit garanti, clé personnelle) :

{
  "mcpServers": {
    "ton": {
      "type": "http",
      "url": "https://mcp.tonnode.io/mcp",
      "headers": { "Authorization": "Bearer tn_live_…" }
    }
  }
}

Cette config convient à n'importe quel client MCP : Claude, Cursor, ChatGPT/Codex.

Le squelette d'un agent DeFAI

Le squelette d'un agent DeFAI bâti sur les outils TONNode — le flux typique « ouvrir une position sur une autre chaîne » :

Vérifier ce que possède l'utilisateur :
  get_balance          → solde GRAM
  get_jetton_info      → decimals du jetton (USDT = 6, en général 9)
  get_jetton_balance   → solde USDT/jetton (wallet calculé on-chain)

Si l'utilisateur veut un échange à l'intérieur de TON :
  get_swap_quote → build_swap_tx → signature dans le wallet

Si l'utilisateur veut sortir de la valeur vers Base/Ethereum/… :
  get_crosschain_quote
  → build_crosschain_swap_tx (signature, le secret reste chez l'utilisateur)
  → track_crosschain_swap (on attend que ce soit prêt)
  → disclose_crosschain_secret (règlement)
  → build_crosschain_refund (en cas de blocage)

Ensuite, tout repose sur le prompt système — le client route les appels tout seul :

Tu es un assistant DeFAI pour TON. Règles :
1. Avant d'afficher tout montant de jetton, appelle get_jetton_info (decimals)
   et get_jetton_balance.
2. Pour un swap : d'abord get_swap_quote, montre le taux, puis build_swap_tx.
   Ne demande jamais de clés privées — la transaction est signée par
   le wallet de l'utilisateur via TonConnect.
3. Pour le cross-chain : get_crosschain_quote → build_crosschain_swap_tx →
   track_crosschain_swap → disclose_crosschain_secret.
   La source est toujours TON, la cible est l'un des 6 réseaux EVM
   (Ethereum, Arbitrum, Base, BNB Chain, Polygon, Avalanche) ;
   TRON n'est pas pris en charge.
4. Si l'échange est bloqué, propose build_crosschain_refund.

L'assemblage pas à pas d'un agent de trading est traité à part — comment construire un agent de trading sur TON.

Les tarifs

Tous les plans donnent accès à la totalité des 16 outils ; vous ne payez que pour le débit :

• Hobby — gratuit pour toujours, 60 requêtes/min
• Pro — 29 $/mois, 300 requêtes/min
• Scale — 199 $/mois, 1200 requêtes/min

La clé Hobby gratuite est délivrée dès la connexion, sans carte bancaire. Les plans Pro/Scale se paient en GRAM ou en USDT sur le réseau TON via TonConnect, ou en BTC/ETH/SOL et autres via une facture xRocket dans Telegram ; la clé est délivrée automatiquement une fois le paiement réglé.

---

Un MCP read-only fait de l'agent un observateur. Le swap non-custodial et le cross-chain en font un exécutant — sans confisquer les clés de l'utilisateur. Lire TON, beaucoup savent le faire ; déplacer de la valeur de TON vers six réseaux EVM sans remettre ses clés, pour l'instant, seul TONNode le fait. C'est cela, le DeFAI sur TON : l'agent déplace la valeur, et le contrôle reste chez son propriétaire.

Récupérez votre clé Hobby gratuite et branchez votre premier agent dès maintenant → tonnode.io/dashboard?plan=hobby

Pour aller plus loin : la liste complète des outils sur tonnode.io/mcp, les limites et les tarifs sur tonnode.io/pricing.