波场指南

TronSave MCP服务器:让AI智能体购买波场能量(2026)

作者 TronSave 发布于 10 分钟阅读
本页目录

更新于2026年11月2日——已对照线上服务器1.3.0版本核实(新增OAuth登录)。

简短回答:TronSave在https://mcp.tronsave.io/mcp运行着一个线上MCP服务器。截至2026年11月2日(1.3.0版本),它为AI助手提供了53个工具,覆盖TronSave市场的各项功能。其中18个无需登录即可使用,包括报价、价格表,以及从您自己钱包支付的订单。您的私钥完全不会经过它:所有签名都在您的钱包中完成。

借助它,助手可以为租赁报价、读取订单簿、下单、取消和延长订单、配置自动购买和自动出售,以及管理API密钥和提醒通知。

一段话说清什么是MCP

Model Context Protocol(模型上下文协议)是一种为AI助手提供一组可调用工具的标准方式。模型不必再根据文档去猜测API的用法,而是由服务器发布带类型的工具定义,客户端直接调用。实际效果就是把“讲讲如何购买波场(TRON)能量”变成“帮我买65,000能量,租期1小时,但先查一下价格”。

TronSave提供两种相互独立的集成。MCP服务器是完整版,面向桌面助手和智能体框架。WebMCP集成则是网页应用向浏览器内智能体提供的一小组工具,并且刻意设计为只读。由于两者的安全模型不同,下文将分别介绍。

端点

网络 端点
主网 POST https://mcp.tronsave.io/mcp
测试网 POST https://mcp.tronsave.io/testnet/mcp
主网,OAuth登录 POST https://mcp.tronsave.io/oauth/mcp
测试网,OAuth登录 POST https://mcp.tronsave.io/oauth/testnet/mcp

网络由您连接的端点决定——不存在可能填错的网络参数。四个端点都响应标准的MCP initialize握手,并提供相同的工具集,因此您可以先在测试网上开发智能体,之后只需改一个URL即可迁移到主网。

在读取JSON配置的客户端中,全部设置就只有这些:

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

1.3.0新增:OAuth登录。Claude、Claude Code和Cursor等应用可以改为连接/oauth/mcp。应用会打开TronSave登录页面,您在其中输入API密钥或用TronLink签名,无需把凭证粘贴到配置文件里。各应用的分步设置请参阅:如何将TronSave连接到Claude Code、Cursor和Claude。

需要登录吗?

查询市场数据不需要。本指南最初介绍的1.0.0版服务器每次调用都需要会话;公开市场工具在1.1.0版加入,自1.2.0版起,每个工具都声明了三种访问级别之一(在其_meta["io.tronsave/auth"]字段中),您可以随时用tronsave_get_session_status查看自己当前的状态:

访问级别 工具数 可使用的功能
公开,无需登录 18 报价、最低价格、订单簿、价格表、市场概览、系统信息、账户资源、下单建议、闪电解质押报价、公开订单列表,以及从您钱包链上支付的create_order。
API密钥 9 内部账户工具:余额、充值地址、内部订单和延期,均从您已充值的余额中支付。
钱包签名 26 个人资料、订单更新和取消、自动购买和自动出售设置、API密钥、通知、推荐返佣、卖家统计以及批量内部订单。

API密钥可通过tronsave_login {apiKey}发送,也可作为客户端请求头Authorization: ApiKey <key>发送。钱包签名方式的流程如下:

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

请注意第2步。服务器下发一条消息;由您在自己的钱包中签名,只回传签名。切勿向服务器发送私钥——协议从不要求提供私钥,任何索要私钥的工具或客户端都不是TronSave的。

API密钥方式更简单,适合无界面的后台任务,但只能使用内部账户工具,而不是平台的全部工具。

公开的链上订单仍然需要您的钱包:使用paymentMethod=onchain调用tronsave_create_order时,需要您亲自签名一笔TRX转账,转到报价中给出的充值地址。服务器从不代您签名。

两类工具

类别 数量 后端 覆盖范围
tronsave_* 46 GraphQL市场接口 市场数据、链上订单,以及签名会话工具:取消和更新订单、自动购买、自动出售、API密钥、通知。
tronsave_internal_* 7 REST,API密钥账户 估价、下单、历史记录、订单详情、订单簿和延期——全部限定于您已充值的内部余额。

这种划分关系到智能体如何花钱。内部账户工具使用您预先充值的余额,这天然就是一个支出上限:通过这类工具操作的智能体,最多只能花掉您充值的金额。平台上的变更操作则需要通过您的签名会话。

53个工具涵盖哪些功能?

领域 工具
会话与认证 get_sign_message, login, logout, get_session_status
市场数据(公开) get_market_overview, get_price_table, get_system_info, get_account_resources, suggest_create_order
价格与深度 get_min_price, list_order_books, estimate_buy_resource, internal_order_book, internal_order_estimate
账户 get_user_info, get_user_permissions, get_internal_account, get_deposit_address, list_internal_transactions
订单(平台) create_order, get_order, list_orders, cancel_order, update_order, list_delegations
订单(内部) internal_order_create, internal_order_history, internal_order_details, bulk_create_internal_orders
延期 list_extendable_delegates, list_extendable_receivers, internal_extend_delegates, internal_create_extend_request
自动购买 list_auto_buy_settings, create_auto_buy_setting, update_auto_buy_setting, delete_auto_buy_setting
出售 sell_order_manual, register_auto_sell, update_auto_sell_setting, get_user_auto_setting, get_seller_stats
闪电解质押 list_flash_unstake_orders, estimate_flash_unstake, get_flash_unstake_request
提醒与计划 list_notifications, mark_notifications_read, get_telegram_notify_setting, update_telegram_notify_setting, get_referral, get_agency_bot
API密钥 generate_api_key, revoke_api_key

(所有名称都带有tronsave_前缀;为节省表格宽度已省略。)在智能体开始反复购买之前,值得先了解延期工具——延长现有的代理通常比重新下单更便宜。

在放手让智能体操作之前,有两个工具需要特别注意。revoke_api_key会立即让之后所有使用旧密钥的请求失效,delete_auto_buy_setting会永久停止某条规则之后的所有执行。文档明确说明了这两个副作用——再次运行工具也无法撤销。

智能体应该如何购买?

服务器发布了自己的操作手册:一个buy_resource提示词、一个account_overview提示词,以及资源tronsave://guide/agent中的完整指南。它规定的购买流程分为四步:

  1. tronsave_estimate_buy_resource返回单价、总价(estimateTrx,单位为SUN)以及可用数量。
  2. 向用户展示接收地址、数量、租期、单价和以TRX计的总价,并获得明确同意。
  3. 使用第1步得到的价格和支付金额调用tronsave_create_order。
  4. 用tronsave_get_order或tronsave_list_orders确认订单。

错误以{"error":{"code","message","retryable","hint"}}格式返回。智能体应遵循hint提示;当retryable为false时绝不重复写操作;超时后重试前先检查订单状态。

总价请直接使用estimateTrx,不要自己用单价去乘:租期为一天或更长的租赁是按天计价的,因此价格表中的30天价格其实是日费率。

最容易踩坑的时效规则

这是最重要的一条操作细节:市场价格和可用量可能在波场的每个区块之间发生变化,大约每3秒一次。在创建或更新订单之前,请立即重新估价或读取订单簿,绝不要复用几秒钟以前的报价。

这一点对AI智能体比对普通代码更重要,因为模型在读取价格和采取行动之间可能要推理好几秒。一个先报价、再思考、再解释计划、最后才下单的智能体,用的已经是过时的数字。如果由您编写提示词,请把“下单前重新检查价格”写成明确指令,而不是默认它会这样做。

同时要分清两个约定:所有价格单位均为SUN(1 TRX = 1,000,000 SUN),所有时长单位均为秒。

浏览器端:WebMCP

TronSave网页应用还通过实验性的navigator.modelContext API,单独向浏览器内的AI智能体提供一组小得多的工具。这里的设计刻意保守。正式版应用提供六个工具(2026年10月):

  • 概览——介绍TronSave是什么、主要页面,以及如何以编程方式访问API。
  • 资源价格——当前预估的最低单价(SUN)以及指定数量的预估TRX费用。只读。
  • 市场概览——可用能量和带宽与总供应量的对比,以及卖家获得的APY。只读。
  • USDT转账费用——若干笔USDT转账所需的能量和带宽、没有它们时燃烧的TRX,以及改为租赁1小时能量的费用。只读。
  • 打开页面——在客户端跳转到已知页面。从不签名或发送交易。
  • 准备USDT转账——打开转账USDT工具并预填收款地址和金额。它不会发送任何东西:由您核对表单并在自己的钱包中签名。

浏览器工具集中没有任何动用资金或签名的工具——这是刻意划定的界线,而非疏漏。任何花钱的操作都需要您在钱包中明确确认。该集成还会进行特性检测,在不支持该API的浏览器上完全不起作用;页面卸载时也会撤回其工具,不会留下过时的工具列表。

合理的安全模型

如果要让智能体访问会花钱的功能,最好审慎划定边界:

  • 从测试网端点开始。工具相同,不消耗真实TRX。
  • 任何写操作前先确认。服务器自带的说明要求智能体在调用任何非只读工具之前先询问用户。
  • 自主任务优先使用内部账户类工具。已充值的余额就是智能体可花费金额的硬性上限。
  • 使用专用API密钥,需要时可以撤销,不影响其他任何东西。
  • 大额操作保持手动签名。签名按设计始终留在您的钱包中,不要想办法绕过这一点。

常见问题(FAQ)

哪些AI客户端可以使用?

任何能通过HTTP连接远程服务器的MCP客户端——包括Claude Desktop和Claude Code,以及支持MCP的智能体框架。服务器使用标准协议,因此客户端无需任何TronSave专用组件。Claude Code、Cursor和Claude的设置方法(含OAuth登录)请参阅:如何将TronSave连接到Claude Code、Cursor和Claude。

智能体如何自行发现这个服务器?

通过TronSave发布的发现文件——llms.txt,以及位于/.well-known/下的API目录、MCP服务器卡片和agent-skills清单。它们会把智能体引导到这个端点,无需任何人手动粘贴URL。

我需要API密钥吗?还是有钱包就够了?

查询报价和市场数据两者都不需要:有18个工具是公开的。API密钥可解锁内部账户工具,钱包签名可解锁账户管理功能,例如订单更新、自动购买、自动出售和API密钥。您可以直接通过服务器生成和撤销密钥。

服务器可以替我签名交易吗?

不可以,这正是设计初衷。签名始终在客户端完成。服务器只下发待签名的消息并接收签名结果——从不接触您的私钥。

可以不花真实TRX先试用吗?

可以。连接测试网端点而不是主网端点即可。集成的其他方面完全相同。

不登录能获取市场数据吗?

能。在线上服务器上(1.3.0版本,2026年11月2日核实),报价、最低价格、订单簿、价格表、市场概览以及从您自己钱包支付的链上订单都无需登录。本指南最初介绍的1.0.0版服务器每次调用都需要会话。

智能体可以改用x402支付吗?

在波场上暂时还不行。截至2026年10月28日,x402的TRON绑定仍是一项未定稿的提案;详见波场上的x402:AI智能体现在能用USDT支付吗?目前智能体通过用户钱包签名的普通TRX转账支付,或从预充值的内部余额中支付。

与SDK相比如何?

官方SDK适用于您自己编写和掌控的代码,REST API是两者的底层。MCP则是把能力交给由助手自行决定调用什么。对于确定性的后端流水线,请使用SDK;对于探索、运维辅助或需要根据情况做出反应的智能体,MCP更合适。它们访问的都是同一个市场。

总结

当您在运行批量付款流水线或关注能量价格时,一个能读取TronSave订单簿并下单的AI助手确实很有用。这个集成的设计思路是正确的——签名留在客户端,浏览器工具无法花钱,内部余额类工具天然设有上限。请从测试网端点开始,教会智能体在下单前重新检查价格,并在您信任它之前,让不可撤销的工具远离它。

本博客由TronSave发布,文中介绍的MCP服务器也由TronSave运营。工具名称、数量和行为基于服务器1.3.0版本(2026年11月2日核实),可能会有变化——请调用tools/list获取当前工具集。让AI智能体使用可动用资金的工具存在风险;请从测试网开始,并严格限定凭证权限。本文不构成投资建议。

TronSave
TronSave

TronSave 团队在 tronsave.io 运营波场能量与带宽市场,这些指南基于在波场主网上的实际测试撰写。

相关文章

我们使用 Google Analytics 了解哪些指南对读者有帮助。只有在您允许分析时才会设置 Cookie。本博客不投放广告。 隐私