TON MCP gratis: conecta tu agente de IA a TON sin tarjeta

Le pides a Claude o a Cursor «revisa el saldo de esta wallet de TON y muéstrame las últimas transacciones», y el agente lo intenta de verdad. Llama a un liteserver público de la config global, recibe not ready, reintenta y se come un timeout de ADNL. O va a toncenter sin clave, choca con el límite de aproximadamente una petición por segundo y recibe HTTP 429 Too Many Requests. Un agente no sabe leer TON por sí solo: necesita herramientas. Y la mayoría de los desarrolladores, llegados a este punto, dan por hecho que tocará levantar un nodo, pelearse con configuraciones y pagar por el acceso. Pues no: puedes conectar tu agente a TON gratis y sin tropezar con nada de eso, por dos vías distintas, y ninguna pide tarjeta.

La forma más rápida de que un agente pueda operar dentro de TON es MCP. Model Context Protocol es el estándar mediante el cual los agentes de IA (Claude, Cursor, ChatGPT/Codex y cualquier cliente MCP) invocan herramientas externas. En lugar de enseñarle al agente a lanzar JSON-RPC en crudo y parsear cells, le entregas un conjunto de herramientas listas como get_balance o get_jetton_balance, y él decide solo cuándo llamarlas. TONNode es un servidor MCP hosted para TON (web: tonnode.io), y con él puedes tener un TON MCP gratis por dos vías, ninguna de las cuales requiere tarjeta. Veamos las dos.

TON MCP gratis: dos vías — npx local y clave Hobby

Para conectar tu agente a TON gratis tienes dos opciones:

1. Ejecución local vía npx sobre la config pública: sin clave y sin registro de ningún tipo. El paquete se descarga y se ejecuta en tu máquina.
2. Clave Hobby gratuita: inicias sesión en la web, la clave se emite al instante, sin tarjeta, 60 peticiones por minuto a través del endpoint hosted.

La diferencia entre ambas no está en el conjunto de herramientas, sino en dónde corre el proceso y de dónde sale la capacidad de peticiones. Empecemos por la más simple.

Vía 1: ejecución local con npx sobre la config pública (sin clave)

Es literalmente un bloque en la configuración de tu cliente MCP. Nada de instalación previa: npx descarga el paquete por su cuenta.

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

Y ya está. Al arrancar el cliente se levanta un proceso local de @tonnode/mcp, se conecta a TON por el protocolo nativo y le entrega al agente el set completo de herramientas de lectura. No hace falta clave, no hace falta tarjeta, no hace falta cuenta.

Un detalle importante bajo el capó: el paquete @tonnode/mcp es open source (MIT), está en npm y en GitHub (tonnode/mcp), y funciona sobre el protocolo nativo ADNL de TON, sin capas HTTP entre tu agente y la red. Es decir, no es un wrapper sobre la API REST de un tercero que acabará chocando con el rate limit ajeno: es un cliente directo a la red.

Dónde va esta configuración

• Claude Desktop / Claude Code: en mcpServers del archivo de configuración MCP.
• Cursor: en la configuración de servidores MCP del proyecto o global.
• ChatGPT/Codex y otros clientes MCP: en su sección de conexión de MCP.

El desglose detallado por cliente, con capturas, está en una guía aparte: cómo conectar Claude y Cursor a TON.

Qué incluye el modo gratuito: el set completo de lectura de TON

El modo local gratuito no es una demo recortada. Tienes acceso al set completo de lectura: ocho herramientas que cubren la inmensa mayoría de las tareas de un agente:

• get_masterchain_info: la «cabeza» del masterchain, el estado actual de la red con el que el agente entiende «dónde está» la cadena ahora mismo.
• get_balance: saldo de la wallet en GRAM (es el Toncoin renombrado en junio de 2026; la red sigue llamándose TON).
• get_account_state: estado de la cuenta, flags, última transacción. Útil para saber si un contrato está desplegado y si una wallet está activa.
• get_transactions: historial de transacciones de una dirección.
• run_get_method: invocación de cualquier get-method de solo lectura en cualquier contrato. Tu «lector universal» de smart contracts.
• get_jetton_balance: saldo de un jetton, incluido USDT; la dirección de la jetton wallet se calcula on-chain, no necesitas conocerla de antemano.
• get_jetton_info: metadatos del jetton: nombre, símbolo, emisión y, crítico para los cálculos, decimals. USDT tiene decimals = 6, la mayoría de los jettons = 9; sin ese número no puedes convertir unidades crudas en cantidades humanas.
• parse_address: conversión y validación de direcciones (EQ/UQ/raw); funciona offline, sin tocar la red.

Un ejemplo práctico. La clásica tarea de «muéstrame el saldo de USDT con una sola llamada» se resuelve combinando get_jetton_info (para averiguar los decimals) + get_jetton_balance. Al agente le basta un prompt en lenguaje humano:

Comprueba el saldo de USDT en la dirección UQAbc...xyz
y muéstralo con el número correcto de decimales.

El agente llamará por sí mismo a get_jetton_info, verá decimals: 6, luego a get_jetton_balance, y devolverá la cantidad correcta, sin una sola línea de código tuya. El análisis completo está en la guía de MCP para TON y hay un ejemplo dedicado de cómo consultar el saldo de USDT en TON con una sola llamada.

Vía 2: clave Hobby gratuita — 60 peticiones/min sin tarjeta

El npx local funciona muy bien para desarrollo y tareas puntuales, pero tiene un techo: pasa por los liteservers públicos de la config global de TON. Son compartidos y limitados, bajo carga responden a menudo not ready o con timeouts de ADNL, y no guardan historial profundo. Para un agente en producción que atiende a usuarios reales, es una lotería.

Aquí entra la segunda vía gratuita: el plan Hobby. Es gratis para siempre, da 60 peticiones por minuto, y la clave se emite nada más iniciar sesión, sin tarjeta. La diferencia con el modo local es que las peticiones no salen de tu máquina a través de infraestructura pública compartida, sino por el endpoint hosted de TONNode con tu clave personal: tienes un límite predecible de 60 peticiones/min asignado específicamente a ti.

La configuración para la conexión hosted es esta:

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

Hay dos diferencias respecto a la config local: type: "http" en lugar de lanzar un proceso, y la cabecera Authorization con tu clave tn_live_…. El agente no notará ninguna diferencia en su funcionamiento: las mismas herramientas, los mismos nombres, los mismos parámetros.

Un punto importante: en Hobby, igual que en el resto de planes, están disponibles las 16 herramientas de TONNode, no solo la lectura, sino también swap, cross-chain y generación de wallets. Es precisamente con la clave hosted cuando a las ocho herramientas de lectura se suman otras, como generate_wallet: la creación de una nueva wallet de TON en versiones v3r2, v4, v5r1 o highload_v3. La herramienta te devuelve la mnemónica, las claves y la dirección directamente a ti; el servidor no almacena las wallets generadas. El plan no limita la funcionalidad, sino la capacidad de peticiones. Solo pagas por throughput, si algún día lo necesitas.

Consigue tu clave Hobby (sin tarjeta): tonnode.io/dashboard?plan=hobby.

¿Local o hosted? Dónde alcanza lo gratis y dónde hace falta throughput

En resumen: lo gratis alcanza casi siempre, mientras se trate de desarrollo, prototipos y una frecuencia de llamadas baja. La diferencia entre modos no está en las herramientas, sino en la capacidad de peticiones.

Modo	Clave / tarjeta	Throughput	Para qué
npx local	No hacen falta	Liteservers públicos (compartidos, con límite)	Desarrollo, tareas puntuales
Hobby (hosted)	Clave, sin tarjeta	60 peticiones/min con tu clave	Proyectos personales, producción ligera
Pro / Scale (hosted)	Clave + pago	300 / 1200 peticiones/min	Producción con carga

El dato clave: todos los planes dan acceso a las 16 herramientas, swap y cross-chain incluidos. Pagas únicamente por capacidad de peticiones, no por «desbloquear» funciones. Pro cuesta $29/mes y da 300 peticiones/min; Scale, $199/mes y 1200 peticiones/min. El throughput de pago hace falta exactamente cuando 60 peticiones por minuto se te quedan cortas o cuando necesitas un límite propio y predecible en el endpoint hosted mcp.tonnode.io bajo carga real. El desglose completo está en la página de precios y en la página de herramientas.

Paso a paso: conectamos el agente y hacemos la primera llamada

Juntemos todo con el ejemplo de la ejecución local (para Hobby solo cambia el bloque de configuración).

Paso 1. Añade el servidor a la config de tu cliente MCP. Toma el bloque con npx -y @tonnode/mcp de arriba y pégalo en la configuración de tu cliente (Claude, Cursor, Codex; la ruta depende del cliente).

Paso 2. Reinicia el cliente. Levantará el proceso @tonnode/mcp y verá las herramientas. En la mayoría de los clientes la lista de herramientas conectadas se ve en la interfaz: comprueba que ton aparezca ahí.

Paso 3. Dale al agente una tarea en texto normal. Por ejemplo:

Averigua la cabeza actual del masterchain de TON y de paso
el saldo de la dirección UQAbc...xyz en GRAM.

El agente llamará por su cuenta a get_masterchain_info, luego a get_balance, y devolverá el resultado en lenguaje humano.

Paso 4. Las tareas más complejas, también con un solo prompt. Digamos:

¿Cuántos USDT hay en la wallet UQAbc...xyz? Devuelve la cantidad teniendo en cuenta los decimals.

Aquí el agente llamará a get_jetton_info para averiguar los decimals de USDT (=6), luego a get_jetton_balance para obtener el saldo en crudo, y lo convertirá a una cantidad humana. La jetton wallet la calculará on-chain: no necesitas pasarle su dirección.

Paso 5. Cuando choques con el límite de los liteservers públicos (verás not ready o timeouts), sustituye el bloque por la config hosted con la clave Hobby. Solo cambia la configuración; los prompts y la lógica del agente se quedan como estaban.

No custodial: por qué el acceso gratuito es seguro

Pregunta lógica: si el servidor es gratis y encima genera wallets y construye transacciones, ¿no estoy arriesgando mis claves? No, y es una decisión de arquitectura deliberada. TONNode es estrictamente no custodial.

El servidor nunca firma nada y nunca custodia fondos ni claves privadas. Las herramientas de lectura simplemente leen el estado público on-chain. Y las herramientas que cambian el estado —swap y cross-chain— no envían nada en tu nombre: devuelven mensajes TonConnect sin firmar. Los firma la wallet del usuario, en local, con su propia clave. Lo mismo con generate_wallet (disponible con clave hosted): la wallet generada y su mnemónica se te entregan a ti; el servidor no se queda con ellas.

Dicho de otro modo, el acceso gratuito no es más arriesgado que el de pago: firmar transacciones solo puede hacerlo, físicamente, el dueño de la wallet, porque el servidor no tiene claves con las que firmar nada. Es la diferencia de fondo con el modelo custodial, donde el servidor guarda una clave de operador y firma él mismo. El análisis de ambos enfoques y sus riesgos está en el artículo sobre MCP custodial vs no custodial.

Conclusión

Para que un agente de IA pueda operar dentro de TON no hace falta levantar un nodo ni sacar la tarjeta. El npx -y @tonnode/mcp local te da el set completo de lectura sin clave, ahora mismo: ideal para probar. El plan gratuito Hobby añade 60 peticiones/min predecibles con tu clave a través del endpoint hosted, también sin tarjeta, para cuando los liteservers públicos empiecen a quedarse cortos. Ambos modos son no custodiales, ambos usan exactamente las mismas herramientas, y en cualquier momento puedes pasarte al throughput de pago sin reescribir nada en la lógica de tu agente.

Consigue tu clave Hobby gratis (sin tarjeta): tonnode.io/dashboard?plan=hobby