Actualizado: 2 de noviembre de 2026 — verificado contra el servidor en vivo, versión 1.3.0 (añade inicio de sesión con OAuth).
Respuesta corta: TronSave opera un servidor MCP en vivo en https://mcp.tronsave.io/mcp. El 2 de noviembre de 2026 (versión 1.3.0) ofrecía a un asistente de IA 53 herramientas para el mercado de TronSave. 18 de ellas funcionan sin iniciar sesión, entre ellas las cotizaciones, la tabla de precios y una orden pagada desde tu propia billetera. Tu clave privada nunca se le acerca: cada firma ocurre en tu billetera.
Con él, un asistente puede cotizar un alquiler, leer el libro de órdenes, crear, cancelar y extender órdenes, configurar la compra y la venta automáticas, y administrar claves API y alertas.
Qué es MCP, en un párrafo
El Model Context Protocol es una forma estándar de darle a un asistente de IA un conjunto de herramientas que puede invocar. En lugar de que el modelo adivine cómo funciona una API a partir de la documentación, el servidor publica definiciones de herramientas tipadas y el cliente las llama. En la práctica, es lo que convierte “explícame cómo comprar energía TRON” en “cómprame 65.000 de energía por una hora, pero revisa primero el precio”.
TronSave ofrece dos integraciones distintas. El servidor MCP es la completa, pensada para asistentes de escritorio y frameworks de agentes. La integración WebMCP es un conjunto pequeño y deliberadamente de solo lectura de herramientas que la aplicación web ofrece a los agentes que funcionan en el navegador. Las explicamos por separado más abajo porque sus modelos de seguridad no son iguales.
Endpoints
| Red | Endpoint |
|---|---|
| Mainnet | POST https://mcp.tronsave.io/mcp |
| Testnet | POST https://mcp.tronsave.io/testnet/mcp |
| Mainnet, inicio de sesión con OAuth | POST https://mcp.tronsave.io/oauth/mcp |
| Testnet, inicio de sesión con OAuth | POST https://mcp.tronsave.io/oauth/testnet/mcp |
La red se elige según el endpoint al que te conectes: no hay ningún parámetro de red que puedas equivocar. Los cuatro responden a un handshake MCP initialize estándar y anuncian el mismo conjunto de herramientas, así que puedes desarrollar un agente contra la testnet y pasarlo a mainnet cambiando una sola URL.
En un cliente que lee una configuración JSON, esa es toda la configuración necesaria:
{
"mcpServers": {
"tronsave": {
"url": "https://mcp.tronsave.io/mcp"
}
}
}
Novedad en 1.3.0: inicio de sesión con OAuth. Aplicaciones como Claude, Claude Code y Cursor pueden conectarse a /oauth/mcp en su lugar. La aplicación abre una página de inicio de sesión de TronSave donde introduces una clave API o firmas con TronLink, así que nunca pegas credenciales en un archivo de configuración. Configuración paso a paso para cada aplicación: Cómo conectar TronSave a Claude Code, Cursor y Claude.
¿Necesitas iniciar sesión?
No para los datos de mercado. El servidor 1.0.0 que describía esta guía al principio exigía una sesión para cada llamada; las herramientas públicas de mercado llegaron en la versión 1.1.0 y, desde la 1.2.0, cada herramienta declara uno de tres niveles de acceso (en su campo _meta["io.tronsave/auth"]). Puedes comprobar tu estado en cualquier momento con tronsave_get_session_status:
| Nivel de acceso | Herramientas | Qué desbloquea |
|---|---|---|
| Público, sin iniciar sesión | 18 | Cotizaciones, precio mínimo, libro de órdenes, tabla de precios, resumen del mercado, información del sistema, recursos de la cuenta, sugerencias de órdenes, cotizaciones de flash unstake, lista pública de órdenes y create_order pagada on-chain desde tu billetera. |
| Clave API | 9 | Las herramientas de la cuenta interna: saldo, dirección de depósito, órdenes internas y extensiones, pagadas con tu saldo depositado. |
| Firma de billetera | 26 | Tu perfil, actualización y cancelación de órdenes, configuración de compra y venta automáticas, claves API, notificaciones, referidos, estadísticas de vendedor y órdenes internas masivas. |
La clave API se envía con tronsave_login {apiKey} o como encabezado del cliente Authorization: ApiKey <key>. La vía de firma de billetera funciona así:
1. tronsave_get_sign_message -> { message, timestamp }
2. (sign `message` in your own wallet, client-side)
3. tronsave_login { signature: "<signature>_<timestamp>" }
-> { sessionId, walletAddress, ... }
4. the login is bound to this MCP connection; never put a session id in tool arguments
Fíjate en el paso 2. El servidor emite un mensaje; tú lo firmas en tu billetera y devuelves solo la firma. Nunca envíes una clave privada al servidor: el protocolo nunca la pide, y cualquier herramienta o cliente que lo haga no es de TronSave.
La vía de la clave API es más sencilla y sirve para tareas sin interfaz, pero te limita a las herramientas de la cuenta interna en lugar del conjunto completo de la plataforma.
Una orden pública on-chain sigue necesitando tu billetera: tronsave_create_order con paymentMethod=onchain requiere una transferencia de TRX que firmas tú mismo, a la dirección de depósito indicada en la cotización. El servidor nunca firma por ti.
Dos familias de herramientas
| Familia | Cantidad | Basada en | A qué llega |
|---|---|---|---|
tronsave_* |
46 | Mercado GraphQL | Datos de mercado, órdenes on-chain y herramientas de sesión con firma: cancelar y actualizar órdenes, compra automática, venta automática, claves API, notificaciones. |
tronsave_internal_* |
7 | REST, cuenta con clave API | Estimación, creación, historial, detalles, libro de órdenes y extensión, todo limitado a tu saldo interno depositado. |
Esta división importa para la forma en que un agente gasta dinero. Las herramientas de la cuenta interna usan un saldo que depositaste por adelantado, lo que funciona como un tope natural de gasto: un agente que trabaja con esa familia solo puede gastar lo que tú hayas fondeado. Las modificaciones en la plataforma, en cambio, pasan por tu sesión con firma.
¿Qué cubren las 53 herramientas?
| Área | Herramientas |
|---|---|
| Sesión y autenticación | get_sign_message, login, logout, get_session_status |
| Datos de mercado (públicos) | get_market_overview, get_price_table, get_system_info, get_account_resources, suggest_create_order |
| Precios y profundidad | get_min_price, list_order_books, estimate_buy_resource, internal_order_book, internal_order_estimate |
| Cuenta | get_user_info, get_user_permissions, get_internal_account, get_deposit_address, list_internal_transactions |
| Órdenes (plataforma) | create_order, get_order, list_orders, cancel_order, update_order, list_delegations |
| Órdenes (internas) | internal_order_create, internal_order_history, internal_order_details, bulk_create_internal_orders |
| Extensión | list_extendable_delegates, list_extendable_receivers, internal_extend_delegates, internal_create_extend_request |
| Compra automática | list_auto_buy_settings, create_auto_buy_setting, update_auto_buy_setting, delete_auto_buy_setting |
| Venta | sell_order_manual, register_auto_sell, update_auto_sell_setting, get_user_auto_setting, get_seller_stats |
| Flash unstake | list_flash_unstake_orders, estimate_flash_unstake, get_flash_unstake_request |
| Alertas y programas | list_notifications, mark_notifications_read, get_telegram_notify_setting, update_telegram_notify_setting, get_referral, get_agency_bot |
| Claves API | generate_api_key, revoke_api_key |
(Todos los nombres llevan el prefijo tronsave_; lo omitimos en la tabla por espacio.) Conviene conocer las herramientas de extensión antes de que un agente empiece a comprar de forma repetida: extender una delegación existente suele salir más barato que crear una orden nueva.
Dos de ellas merecen una advertencia antes de dejar suelto a un agente. revoke_api_key rompe de inmediato todas las solicitudes futuras que usen la clave anterior, y delete_auto_buy_setting detiene para siempre todas las ejecuciones futuras de una regla. Ambas están documentadas con exactamente esos efectos secundarios y no se revierten volviendo a ejecutar la herramienta.
¿Cómo debería comprar un agente?
El servidor publica su propio manual: un prompt buy_resource, un prompt account_overview y una guía completa como el recurso tronsave://guide/agent. El flujo de compra que indica tiene cuatro pasos:
tronsave_estimate_buy_resourcedevuelve el precio unitario, el total (estimateTrx, en SUN) y cuánto hay disponible.- Muestra al usuario el receptor, la cantidad, la duración, el precio unitario y el total en TRX, y obtén un sí explícito.
tronsave_create_ordercon el precio y el monto de pago del paso 1.- Confirma con
tronsave_get_orderotronsave_list_orders.
Los errores llegan como {"error":{"code","message","retryable","hint"}}. Un agente debe seguir la pista (hint), nunca repetir una escritura cuando retryable es false y revisar el estado de la orden antes de reintentar tras un timeout.
Usa estimateTrx para el total en lugar de multiplicar tú mismo un precio unitario: los alquileres de un día o más tienen precio por día, así que un precio a 30 días de la tabla de precios es una tarifa diaria.
La regla de frescura que te va a morder
Este es el detalle operativo más importante: los precios y la disponibilidad del mercado pueden cambiar de un bloque de TRON al siguiente, aproximadamente cada 3 segundos. Vuelve a ejecutar tu estimación o lectura del libro de órdenes justo antes de crear o actualizar una orden, y nunca reutilices una cotización de más de unos segundos de antigüedad.
Esto pesa más con un agente de IA que con código común, porque un modelo puede pasar varios segundos razonando entre leer un precio y actuar. Un agente que cotiza, piensa, explica su plan y luego hace la orden trabaja con un número desactualizado. Si escribes el prompt, convierte “vuelve a revisar el precio justo antes de ordenar” en una instrucción explícita en lugar de darlo por hecho.
Dos convenciones que conviene tener claras de paso: todos los precios están en SUN (1 TRX = 1.000.000 SUN) y todas las duraciones están en segundos.
El lado del navegador: WebMCP
La aplicación web de TronSave expone por separado un conjunto de herramientas mucho más pequeño a los agentes de IA en el navegador mediante la API experimental navigator.modelContext. Aquí el diseño es conservador a propósito. La aplicación en producción ofrece seis herramientas (octubre de 2026):
- Resumen: qué es TronSave, sus páginas clave y cómo acceder a la API de forma programática.
- Precio del recurso: el precio unitario mínimo estimado actual en SUN más el costo estimado en TRX para una cantidad. Solo lectura.
- Resumen del mercado: energía y ancho de banda disponibles frente a la oferta total, y el APY que ganan los vendedores. Solo lectura.
- Costo de transferencia de USDT: la energía y el ancho de banda que necesita cierto número de transferencias de USDT, el TRX que se quema sin ellos y el costo de alquilar la energía por una hora en su lugar. Solo lectura.
- Abrir página: navegación del lado del cliente a una página conocida. Nunca firma ni envía una transacción.
- Preparar transferencia de USDT: abre la herramienta Transfer USDT con el destinatario y el monto ya completados. No envía nada: tú revisas el formulario y firmas en tu propia billetera.
En el conjunto del navegador no hay herramientas que muevan dinero ni que firmen: es un límite deliberado, no un descuido. Todo lo que implique gastar requiere una interacción explícita tuya con la billetera. Además, la integración detecta si la función existe, así que en un navegador sin esa API no hace absolutamente nada, y retira sus herramientas cuando la página se desmonta en lugar de dejar anunciado un conjunto obsoleto.
Un modelo de seguridad sensato
Si le das a un agente acceso a algo que gasta dinero, vale la pena definir los límites con cuidado:
- Empieza con el endpoint de testnet. Las mismas herramientas, sin TRX real.
- Confirma antes de cualquier escritura. Las propias instrucciones del servidor indican a los agentes que pregunten al usuario antes de llamar a cualquier herramienta que no sea de solo lectura.
- Prefiere la familia de la cuenta interna para el trabajo autónomo. Un saldo fondeado es un techo firme para lo que un agente puede gastar.
- Usa una clave API dedicada que puedas revocar sin afectar nada más.
- Mantén la firma manual para todo lo grande. La firma se queda en tu billetera por diseño; no intentes eliminar eso.
Preguntas frecuentes (FAQ)
¿Qué clientes de IA pueden usarlo?
Cualquier cliente MCP que pueda conectarse a un servidor remoto por HTTP, entre ellos Claude Desktop y Claude Code, además de frameworks de agentes con soporte para MCP. El servidor habla el protocolo estándar, así que el cliente no necesita nada específico de TronSave. Configuración para Claude Code, Cursor y Claude, incluido el inicio de sesión con OAuth: Cómo conectar TronSave a Claude Code, Cursor y Claude.
¿Cómo lo encontraría un agente por su cuenta?
A través de los archivos de descubrimiento que publica TronSave: llms.txt, un catálogo de API, una tarjeta del servidor MCP y un manifiesto de agent skills bajo /.well-known/. Dirigen al agente a este endpoint sin que nadie tenga que pegar una URL.
¿Necesito una clave API o basta con una billetera?
Ninguna de las dos para cotizaciones y datos de mercado: 18 herramientas son públicas. Una clave API desbloquea las herramientas de la cuenta interna, y una firma de billetera desbloquea la gestión de la cuenta, como actualizar órdenes, la compra automática, la venta automática y las claves API. Puedes generar y revocar claves a través del propio servidor.
¿Puede el servidor firmar transacciones por mí?
No, y esa es la idea. La firma siempre ocurre del lado del cliente. El servidor emite un mensaje para firmar y acepta la firma resultante: nunca maneja tu clave.
¿Puedo probarlo sin gastar TRX real?
Sí. Conéctate al endpoint de testnet en lugar del de mainnet. Todo lo demás de la integración es idéntico.
¿Los datos de mercado están disponibles sin iniciar sesión?
Sí. En el servidor en vivo (versión 1.3.0, verificado el 2 de noviembre de 2026), las cotizaciones, el precio mínimo, el libro de órdenes, la tabla de precios, el resumen del mercado y las órdenes on-chain pagadas desde tu propia billetera funcionan sin iniciar sesión. El servidor 1.0.0 que describía esta guía al principio exigía una sesión para cada llamada.
¿Puede un agente pagar con x402?
Todavía no en TRON. Al 28 de octubre de 2026, el binding de x402 para TRON sigue siendo una propuesta abierta; consulta x402 en TRON: ¿ya pueden los agentes de IA pagar con USDT? Hoy un agente paga con una transferencia normal de TRX firmada en la billetera del usuario, o con un saldo interno prepagado.
¿Cómo se compara con los SDK?
Los SDK oficiales son para código que tú escribes y controlas, y la API REST está debajo de ambos. MCP sirve para dar capacidades a un asistente que decide qué llamar. Para un pipeline de backend determinista, usa un SDK; para explorar, asistir en operaciones o tener un agente que reaccione a condiciones, MCP encaja mejor. Todos acceden al mismo mercado.
En resumen
Un asistente de IA que puede leer el libro de órdenes de TronSave y hacer una orden es algo realmente útil cuando gestionas un pipeline de pagos o sigues los precios de la energía. La integración está construida con los instintos correctos: la firma se queda del lado del cliente, las herramientas del navegador no pueden gastar y la familia del saldo interno te da un tope natural. Empieza con el endpoint de testnet, enseña a tu agente a volver a revisar los precios antes de ordenar y mantén las herramientas irreversibles fuera de su alcance hasta que confíes en él.
Conecta un agente: apunta tu cliente MCP a https://mcp.tronsave.io/testnet/mcp para experimentar, luego cambia al endpoint de mainnet y observa cómo cotiza en el mercado de energía en vivo.
TronSave publica este blog y opera el servidor MCP descrito aquí. Los nombres, la cantidad y el comportamiento de las herramientas corresponden a la versión 1.3.0 del servidor (verificada el 2 de noviembre de 2026) y pueden cambiar: llama a tools/list para ver el conjunto actual. Dar a un agente de IA acceso a herramientas que gastan fondos conlleva riesgos; empieza en la testnet y limita bien las credenciales. Esto no es asesoramiento financiero.


