Guias de TRON

Servidor MCP da TronSave: deixe um agente de IA comprar energia TRON (2026)

Por TronSave Publicado 13 min de leitura
Nesta página

Atualizado em 2 de novembro de 2026 — conferido no servidor em produção, versão 1.3.0 (adiciona login via OAuth).

Resposta curta: a TronSave mantém um servidor MCP ativo em https://mcp.tronsave.io/mcp. Em 2 de novembro de 2026 (versão 1.3.0), ele oferecia a um assistente de IA 53 ferramentas para o mercado da TronSave. 18 delas funcionam sem login, incluindo cotações, a tabela de preços e um pedido pago com a sua própria carteira. Sua chave privada nunca chega perto dele: toda assinatura acontece na sua carteira.

Com ele, um assistente pode cotar um aluguel, ler o livro de ofertas, criar, cancelar e estender pedidos, configurar compra e venda automáticas e gerenciar chaves de API e alertas.

O que é MCP, em um parágrafo

O Model Context Protocol é uma forma padronizada de entregar a um assistente de IA um conjunto de ferramentas que ele pode chamar. Em vez de o modelo tentar adivinhar uma API a partir da documentação, o servidor publica definições tipadas das ferramentas e o cliente as chama. Na prática, é o que transforma “explique como comprar energia TRON” em “compre 65.000 de energia por uma hora para mim, mas confira o preço antes”.

A TronSave oferece duas integrações separadas. O servidor MCP é a completa, voltada para assistentes de desktop e frameworks de agentes. A integração WebMCP é um conjunto pequeno de ferramentas, propositalmente somente leitura, que o app web oferece a agentes que rodam no navegador. Elas são tratadas separadamente abaixo porque seus modelos de segurança não são iguais.

Endpoints

Rede Endpoint
Mainnet POST https://mcp.tronsave.io/mcp
Testnet POST https://mcp.tronsave.io/testnet/mcp
Mainnet, login via OAuth POST https://mcp.tronsave.io/oauth/mcp
Testnet, login via OAuth POST https://mcp.tronsave.io/oauth/testnet/mcp

A rede é definida pelo endpoint ao qual você se conecta — não existe parâmetro de rede para configurar errado. Os quatro respondem a um handshake initialize padrão do MCP e anunciam o mesmo conjunto de ferramentas, então você pode desenvolver um agente na testnet e levá-lo para a mainnet trocando uma única URL.

Em um cliente que lê uma configuração JSON, essa é toda a configuração necessária:

{
  "mcpServers": {
    "tronsave": {
      "url": "https://mcp.tronsave.io/mcp"
    }
  }
}

Novo na 1.3.0: login via OAuth. Apps como Claude, Claude Code e Cursor podem se conectar a /oauth/mcp em vez disso. O app abre uma página de login da TronSave onde você informa uma chave de API ou assina com a TronLink, então você nunca cola credenciais em um arquivo de configuração. Configuração passo a passo para cada app: Como conectar a TronSave ao Claude Code, Cursor e Claude.

Você precisa fazer login?

Não para dados de mercado. O servidor 1.0.0, descrito na primeira versão deste guia, exigia uma sessão para cada chamada; as ferramentas públicas de mercado chegaram na versão 1.1.0 e, desde a 1.2.0, cada ferramenta declara um de três níveis de acesso (no campo _meta["io.tronsave/auth"]), e você pode conferir sua situação a qualquer momento com tronsave_get_session_status:

Nível de acesso Ferramentas O que libera
Público, sem login 18 Cotações, preço mínimo, livro de ofertas, tabela de preços, visão geral do mercado, informações do sistema, recursos da conta, sugestões de pedido, cotações de flash unstake, lista pública de pedidos e create_order pago on-chain com a sua carteira.
Chave de API 9 As ferramentas da conta interna: saldo, endereço de depósito, pedidos internos e extensões, pagos com o saldo que você depositou.
Assinatura da carteira 26 Seu perfil, atualização e cancelamento de pedidos, configurações de compra e venda automáticas, chaves de API, notificações, indicações, estatísticas de vendedor e pedidos internos em lote.

A chave de API é enviada com tronsave_login {apiKey} ou como cabeçalho do cliente Authorization: ApiKey <key>. O caminho por assinatura da carteira funciona assim:

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

Repare no passo 2. O servidor emite uma mensagem; você a assina na sua carteira e devolve apenas a assinatura. Nunca envie uma chave privada ao servidor — o protocolo nunca pede uma, e qualquer ferramenta ou cliente que peça não é da TronSave.

O caminho por chave de API é mais simples e serve bem para tarefas headless, mas limita você às ferramentas da conta interna, em vez do conjunto completo da plataforma.

Um pedido público on-chain ainda precisa da sua carteira: tronsave_create_order com paymentMethod=onchain recebe uma transferência de TRX que você mesmo assina, para o endereço de depósito informado na cotação. O servidor nunca assina por você.

Duas famílias de ferramentas

Família Quantidade Base O que alcança
tronsave_* 46 Mercado GraphQL Dados de mercado, pedidos on-chain e ferramentas da sessão por assinatura: cancelar e atualizar pedidos, compra automática, venda automática, chaves de API, notificações.
tronsave_internal_* 7 REST, conta com chave de API Estimativa, criação, histórico, detalhes, livro de ofertas e extensão — tudo limitado ao seu saldo interno depositado.

Essa divisão importa para a forma como um agente gasta dinheiro. As ferramentas da conta interna usam um saldo que você depositou antecipadamente, o que funciona como um teto natural de gastos: um agente trabalhando com essa família só consegue gastar o que você depositou. Já as alterações na plataforma passam pela sua sessão de assinatura.

O que as 53 ferramentas cobrem?

Área Ferramentas
Sessão e autenticação get_sign_message, login, logout, get_session_status
Dados de mercado (públicos) get_market_overview, get_price_table, get_system_info, get_account_resources, suggest_create_order
Preços e profundidade get_min_price, list_order_books, estimate_buy_resource, internal_order_book, internal_order_estimate
Conta get_user_info, get_user_permissions, get_internal_account, get_deposit_address, list_internal_transactions
Pedidos (plataforma) create_order, get_order, list_orders, cancel_order, update_order, list_delegations
Pedidos (internos) internal_order_create, internal_order_history, internal_order_details, bulk_create_internal_orders
Extensão 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
Venda 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 e programas list_notifications, mark_notifications_read, get_telegram_notify_setting, update_telegram_notify_setting, get_referral, get_agency_bot
Chaves de API generate_api_key, revoke_api_key

(Todos os nomes têm o prefixo tronsave_; ele foi omitido na tabela para economizar espaço.) Vale conhecer as ferramentas de extensão antes que um agente comece a comprar repetidamente — estender uma delegação existente costuma sair mais barato do que criar um pedido novo.

Duas delas merecem um alerta antes de você soltar um agente. revoke_api_key quebra imediatamente todas as requisições futuras que usam a chave anterior, e delete_auto_buy_setting interrompe de forma permanente todas as execuções futuras de uma regra. As duas estão documentadas com exatamente esses efeitos colaterais — e não dá para revertê-los executando a ferramenta de novo.

Como um agente deve comprar?

O servidor publica seu próprio manual: um prompt buy_resource, um prompt account_overview e um guia completo como o recurso tronsave://guide/agent. O fluxo de compra que ele prescreve tem quatro passos:

  1. tronsave_estimate_buy_resource retorna o preço unitário, o total (estimateTrx, em SUN) e quanto está disponível.
  2. Mostre ao usuário o destinatário, a quantidade, a duração, o preço unitário e o total em TRX, e obtenha um sim explícito.
  3. tronsave_create_order com o preço e o valor de pagamento do passo 1.
  4. Confirme com tronsave_get_order ou tronsave_list_orders.

Os erros voltam como {"error":{"code","message","retryable","hint"}}. Um agente deve seguir a dica (hint), nunca repetir uma escrita quando retryable for false e conferir o estado do pedido antes de tentar de novo após um timeout.

Use estimateTrx para o total em vez de multiplicar um preço unitário por conta própria: aluguéis de um dia ou mais são cobrados por dia, então um preço de 30 dias na tabela de preços é uma taxa diária.

A regra de atualização que vai pegar você

Este é o detalhe operacional mais importante: os preços e a disponibilidade do mercado podem mudar de um bloco da TRON para o seguinte, mais ou menos a cada 3 segundos. Refaça a estimativa ou a leitura do livro de ofertas imediatamente antes de criar ou atualizar um pedido, e nunca reutilize uma cotação com mais de alguns segundos.

Isso pesa mais com um agente de IA do que com código comum, porque um modelo pode passar vários segundos raciocinando entre ler um preço e agir com base nele. Um agente que cota, pensa, explica o plano e só então faz o pedido está trabalhando com um número desatualizado. Se você está escrevendo o prompt, transforme “confira o preço de novo logo antes de fazer o pedido” em uma instrução explícita, em vez de supor que isso vai acontecer.

Duas convenções para não confundir: todos os preços estão em SUN (1 TRX = 1.000.000 SUN) e todas as durações estão em segundos.

O lado do navegador: WebMCP

O app web da TronSave expõe separadamente um conjunto bem menor de ferramentas para agentes de IA no navegador, por meio da API experimental navigator.modelContext. Aqui o design é conservador de propósito. O app em produção oferece seis ferramentas (outubro de 2026):

  • Visão geral — o que é a TronSave, suas páginas principais e como acessar a API de forma programática.
  • Preço do recurso — o preço unitário mínimo estimado atual em SUN, mais o custo estimado em TRX para uma quantidade. Somente leitura.
  • Visão geral do mercado — energia e largura de banda disponíveis em relação à oferta total, e o APY que os vendedores ganham. Somente leitura.
  • Custo de transferência de USDT — a energia e a largura de banda que um certo número de transferências de USDT exige, o TRX queimado sem elas e o custo de alugar a energia por uma hora em vez disso. Somente leitura.
  • Abrir página — navegação no lado do cliente para uma página conhecida. Nunca assina nem envia uma transação.
  • Preparar transferência de USDT — abre a ferramenta Transfer USDT com o destinatário e o valor preenchidos. Não envia nada: você revisa o formulário e assina na sua própria carteira.

Não há nenhuma ferramenta que movimente dinheiro ou assine no conjunto do navegador — é um limite deliberado, não um descuido. Qualquer coisa que gaste exige uma interação explícita sua com a carteira. A integração também usa detecção de recurso, então em um navegador sem a API ela simplesmente não faz nada, e retira suas ferramentas quando a página é desmontada, em vez de deixar um conjunto desatualizado anunciado.

Um modelo de segurança sensato

Se você vai dar a um agente acesso a algo que gasta dinheiro, vale definir os limites com cuidado:

  • Comece pelo endpoint da testnet. Mesmas ferramentas, sem TRX de verdade.
  • Confirme antes de qualquer escrita. As próprias instruções do servidor mandam os agentes perguntarem ao usuário antes de chamar qualquer ferramenta que não seja somente leitura.
  • Prefira a família da conta interna para trabalho autônomo. Um saldo depositado é um teto rígido para o que um agente pode gastar.
  • Use uma chave de API dedicada que você possa revogar sem afetar mais nada.
  • Mantenha a assinatura manual para qualquer valor alto. A assinatura fica na sua carteira por design; não tente contornar isso.

Perguntas frequentes (FAQ)

Quais clientes de IA podem usar isso?

Qualquer cliente MCP que consiga se conectar a um servidor remoto via HTTP — entre eles o Claude Desktop e o Claude Code, além de frameworks de agentes com suporte a MCP. O servidor fala o protocolo padrão, então nada específico da TronSave é necessário no cliente. Configuração para Claude Code, Cursor e Claude, incluindo login via OAuth: Como conectar a TronSave ao Claude Code, Cursor e Claude.

Como um agente encontraria isso sozinho?

Pelos arquivos de descoberta que a TronSave publica — llms.txt, um catálogo de API, um server card do MCP e um manifesto de agent skills em /.well-known/. Eles levam um agente até este endpoint sem que ninguém precise colar uma URL.

Preciso de uma chave de API ou basta uma carteira?

Nenhuma das duas, para cotações e dados de mercado: 18 ferramentas são públicas. Uma chave de API libera as ferramentas da conta interna, e uma assinatura da carteira libera o gerenciamento da conta, como atualização de pedidos, compra automática, venda automática e chaves de API. Você pode gerar e revogar chaves pelo próprio servidor.

O servidor pode assinar transações por mim?

Não, e é justamente essa a ideia. A assinatura acontece sempre no lado do cliente. O servidor emite uma mensagem para ser assinada e aceita a assinatura resultante — ele nunca manipula a sua chave.

Posso testar sem gastar TRX de verdade?

Sim. Conecte-se ao endpoint da testnet em vez do da mainnet. Todo o resto da integração é idêntico.

Os dados de mercado estão disponíveis sem login?

Sim. No servidor em produção (versão 1.3.0, conferido em 2 de novembro de 2026), cotações, preço mínimo, livro de ofertas, tabela de preços, visão geral do mercado e pedidos on-chain pagos com a sua própria carteira funcionam sem login. O servidor 1.0.0, descrito na primeira versão deste guia, exigia uma sessão para cada chamada.

Um agente pode pagar com x402?

Ainda não na TRON. Em 28 de outubro de 2026, o binding do x402 para a TRON ainda é uma proposta em aberto; veja x402 na TRON: agentes de IA já podem pagar com USDT? Hoje, um agente paga com uma transferência comum de TRX assinada na carteira do usuário ou com um saldo interno pré-pago.

Como isso se compara aos SDKs?

Os SDKs oficiais são para código que você escreve e controla, e a API REST fica por baixo de ambos. O MCP serve para entregar capacidades a um assistente que decide o que chamar. Para um pipeline de backend determinístico, use um SDK; para exploração, apoio operacional ou um agente que reage a condições, o MCP se encaixa melhor. Todos acessam o mesmo mercado.

Conclusão

Um assistente de IA que consegue ler o livro de ofertas da TronSave e fazer um pedido é algo realmente útil quando você opera um pipeline de pagamentos ou acompanha os preços da energia. A integração foi construída com os instintos certos — a assinatura fica no lado do cliente, as ferramentas do navegador não gastam nada e a família do saldo interno dá a você um limite natural. Comece pelo endpoint da testnet, ensine seu agente a conferir os preços de novo antes de fazer um pedido e mantenha as ferramentas irreversíveis fora de alcance até confiar nele.

A TronSave publica este blog e opera o servidor MCP descrito aqui. Nomes, quantidades e comportamento das ferramentas refletem a versão 1.3.0 do servidor (conferida em 2 de novembro de 2026) e podem mudar — chame tools/list para ver o conjunto atual. Dar a um agente de IA acesso a ferramentas que gastam fundos envolve riscos; comece pela testnet e limite bem as credenciais. Isto não é aconselhamento financeiro.

TronSave
TronSave

A equipe da TronSave desenvolve o mercado de energia e largura de banda da TRON em tronsave.io e escreve estes guias com base em testes reais na rede principal da TRON.

Artigos relacionados

Usamos o Google Analytics para saber quais guias ajudam os leitores. Ele só grava cookies se você permitir a análise. O blog não exibe anúncios. Privacidade