MCP 服务器
TEnergy 在 https://mcp.tenergy.me 运行 Model Context Protocol 服务器（Streamable HTTP）。连接时它会请您登录 TEnergy（首次登录即创建账户），并批准智能体可以执行的操作和消费上限；之后智能体可以查看余额、获取报价并购买能量。无需账户查看价格和市场，请使用 https://mcp.tenergy.me/public。
| 地址 | 网络 | 访问方式 |
|---|---|---|
https://mcp.tenergy.me | 主网 | 登录，或 ak_live_ 密钥 |
https://mcp.tenergy.me/nile | Nile 测试网 | 登录 Nile 控制台，或 ak_test_ 密钥 |
https://mcp.tenergy.me/public | 主网 | 无需账户：仅价格和链上数据工具 |
https://mcp.tenergy.me/nile/public | Nile 测试网 | 无需账户：仅价格和链上数据工具 |
连接
Claude 应用或 claude.ai
- 打开 Settings → Connectors → Add → Add custom connector。
- 名称填
TEnergy，地址填https://mcp.tenergy.me（Nile 测试网：https://mcp.tenergy.me/nile）。认证方式保持 Claude 自动识别的 “Sign in now”。 - 点击 Add。Claude 会先显示它自己的“完成连接器连接？”页面，点击 继续。
- 登录 TEnergy（首次登录会自动创建账户），选择权限和消费上限，点击 允许。
您可以随时在控制台的“已连接的代理”中修改上限或撤销访问。
终端中的 Claude Code
需要先安装 Claude Code 命令行工具；在 Claude 桌面应用中请使用上面的步骤。
claude mcp add --transport http tenergy https://mcp.tenergy.me
然后在 Claude Code 中输入 /mcp 并选择 Authenticate。
其他支持登录的客户端
添加自定义连接器（或 MCP 服务器），地址填 https://mcp.tenergy.me；客户端会打开同一个 TEnergy 登录页面。
使用 API 密钥代替登录
支持自定义请求头的客户端可以发送密钥：Authorization: ApiKey <key>:<secret>。服务器用该密钥为每次调用签名，密钥本身永远不会交给模型。
Claude Code：
claude mcp add --transport http tenergy https://mcp.tenergy.me/ --header "Authorization: ApiKey ak_live_...:..."
Cursor — mcp.json：
{"mcpServers":{"tenergy":{"url":"https://mcp.tenergy.me/","headers":{"Authorization":"ApiKey ak_live_...:..."}}}}
VS Code — .vscode/mcp.json：
{"servers":{"tenergy":{"type":"http","url":"https://mcp.tenergy.me/","headers":{"Authorization":"ApiKey ak_live_...:..."}}}}
工具
| 工具 | 需要账户 | 作用 |
|---|---|---|
get_prices、get_address_resources | 否 | 价格表；接收地址的能量和带宽 |
get_market、get_market_summary、get_price_history | 否 | 各服务商实时价格、当日汇总、价格历史 |
get_chain_parameters、get_energy_fee_history | 否 | 网络能量价格及其历史 |
estimate_contract_call、suggest_order_size、calculate_savings | 否 | 合约调用所需能量、批量转账的订单规模、相比燃烧 TRX 的节省 |
explain_concept | 否 | 能量、带宽、委托等概念 |
get_x402_quote | 否 | 主网：以 Base 上的 USDC 支付的 x402 报价，为 TRON 地址租用能量；由您自己的 x402 客户端付款，本工具不签名 |
estimate_transfer | 是 | 向接收地址转一笔 USDT 的费用 |
get_account | 是 | 当前连接所属的账户：Account ID（acc_…）与显示名称 |
get_balance、get_deposit_addresses | 是 | 预充值余额（附账户 ID 与显示名称）；充值地址 |
create_quote、create_order | 是（消费权限） | 锁定价格 120 秒；购买 |
get_order、list_orders | 是 | 状态和历史 |
提示词：cheapest_energy_for_transfer、size_batch_order、explain_failed_transaction。资源：tenergy://docs/quickstart、tenergy://llms.txt、tenergy://facts/energy。
无需账户付款（HTTP 402，TRX）
没有密钥的智能体也能购买能量。不带凭证调用 POST https://api.tenergy.me/v1/orders 会返回 HTTP 402，JSON 正文（protocol: "tenergy-trx-transfer"，version: 1）说明如何用普通 TRX 转账付款：
| 字段 | 含义 |
|---|---|
pay_to、network、chain、asset | 公布的 1 小时付款地址；TRON 主网（Nile API 上为 Nile）；TRX |
price_sun_per_unit、fee_bps | 每单位能量的价格，已含服务费；price_steps 按数量给出价格 |
min_amount、max_amount | 当前一笔转账可购买的能量范围 |
rules | 能量 = 转入 TRX ÷ 到账时的价格，向下取整；接收方为发送方或备注中的地址；低于最小值的付款和余数不退还 |
transaction | 仅当请求正文含 payer（以及 amount 或 amount_sun，可选 receiver）时返回：未签名的转账，签名后直接广播 |
status_url | GET /v1/transfers/{txid}：awaiting_transfer、pending、order（附订单状态）、no_order、not_ours |
此 TRX 报价不是 x402（x402 没有 TRON 或 TRX 方案）。带有任何凭证的请求照常校验，不会收到此 402。
使用 Base 上的 USDC 付款（x402）
持有 Base 上 USDC 的代理可以改用标准 x402 v2 付款。在匿名 POST /v1/orders 中传入 amount 和 receiver，或调用 GET https://tenergy.me/x402?amount=65000&receiver=T...：402 响应将包含 PAYMENT-REQUIRED 头和 accepts[]。
| 字段 | 值 |
|---|---|
scheme、network | exact、eip155:8453（Base） |
asset | USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913（EIP-3009） |
amount | 该能量数量对应的 USDC 金额（6 位小数），已含服务费 |
maxTimeoutSeconds | 120：请在此时间内带签名重试 |
extra.intentId | 状态：GET /v1/x402/intents/{id} |
带上 PAYMENT-SIGNATURE 头重试同一请求（任何 x402 客户端都会自动完成）。我们通过 Coinbase facilitator 结算，为 receiver 下单，并返回订单和 PAYMENT-RESPONSE 头。不带 receiver 时价格仅供参考。能量租期 1 小时；一次付款可购买的数量在 TRX 报价的 min_amount–max_amount 范围内。