Guías de TRON

Servidor MCP de TronSave: deja que un agente de IA compre energía TRON (2026)

Por TronSave Publicado 13 min de lectura
En esta página

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:

  1. tronsave_estimate_buy_resource devuelve el precio unitario, el total (estimateTrx, en SUN) y cuánto hay disponible.
  2. 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.
  3. tronsave_create_order con el precio y el monto de pago del paso 1.
  4. Confirma con tronsave_get_order o tronsave_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.

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.

TronSave
TronSave

El equipo de TronSave desarrolla el mercado de energía y ancho de banda de TRON en tronsave.io y escribe estas guías a partir de pruebas reales en la red principal de TRON.

Artículos relacionados

Usamos Google Analytics para saber qué guías ayudan a los lectores. Solo instala cookies si permites la analítica. El blog no muestra anuncios. Privacidad