MERX

https://MERX.exchange

TRON人工智能代理基础设施。

](https://smithery.ai/servers/powersun/merx) ](https://www.npmjs.com/package/merx-mcp) ![License: MIT](LICENSE)

66个MCP工具。6家供应商的能源市场。USDT/USDC/USDD付款。TRON主网上的x402 v2引导程序。

文档 | API 参考 | MCP服务器

______________________________________________________________________

什么是MERX --用于AI代理的TRON基础设施
的问题 --为什么TRON在MERX之前没有代理层
平台概述 --MCP、代理支付服务、x402、GasFree、能源聚合器
快速开始 --4条路径（web、REST/SDK、Claude Code插件、MCP）
是什么让MERX与众不同 --TRON上唯一完整的代理堆栈
建筑
API概述
MCP服务器
SDK
实时数据
支付方式
常规命令和监督员
储蓄计算器
错误处理
安全
在主网上测试
与备选方案的比较
文档
许可证

______________________________________________________________________

什么是MERX

MERX是TRON上AI代理和代理网络的基础设施层。 Stripe是网络商务的基础设施，Cloudflare是开放网络的基础设施， MERX是缺失的基础设施层，它让自主AI代理发现，在TRON上进行交易和操作，而无需接触能量、带宽或低级区块链机制。

该平台公开了一个连贯的堆栈： 66工具MCP服务器, 代理付款服务 对于TRC-20稳定币， x402 v2协调员 （唯一的TRON coinbase/x402生态系统注册表中的主持人）， GasFree转账 通过 MERX部署的主网控制器， 专用TRON RPC节点, A2A 谷歌 7技能）和 ACP （BeeAI，7种功能）协议覆盖范围，以及 自然的语言策略引擎 由Anthropic Claude提供动力。

在这些试剂表面之下，有一个 6个活动的能量聚合器提供商 （CatFee、Nets、TronSave、iTRX、PowerSun、TEM）路由资源自动购买到最便宜的来源——因此当代理呼叫时 send()，MERX估计所需的能源，只购买赤字，以及广播交易。代理人从不持有TRX或考虑能量。

任何AI代理 运行在Claude、LangChain、CrewAI、Vertex AI、AutoGen、，或者，BeeAI可以通过单一渠道在TRON上发送付款和获取资源与MERX集成。

将代理插入MERX的三种方法：

MCP服务器 --66个AI代理工具。SSE在

https://merx.exchange/mcp/sse （零安装）或通过本地stdio npx merx-mcp.适用于Claude、GPT、Cursor、Windsurf和任何 MCP兼容客户端。

Claude代码插件 --Claude Code的一行安装。自动注册

MCP服务器提供6个斜线命令和一个 tron-agent-engineer 次级代理。看 Header/merx-claude插件.

REST API+SDK --为非代理提供直接编程访问

使用MCP。JavaScript(merx-sdk npm上的v2.1），Python(merx-sdk v2.1已启用 PyPI）或原始HTTP /api/v1/ （70+版本化端点）。

对于人类用户，网络平台位于 merx.exchange 仍然可用于手动能源交易、仪表板、存款和提款——但该平台主要是为代理人构建的。

______________________________________________________________________

的问题

人工智能代理将成为稳定币的主要交易用户 TRON——USDD、860亿美元+USDT、USDC的所在地，以及零售USDT的主导连锁店在东南亚、非洲和拉丁美洲，已经是最大的全球USDT原生网络。

但TRON没有为代理商设计的基础设施：

没有代理本地支付服务。 现有的TRON钱包是为

使用鼠标点击和种子短语备份的人类用户，不适用于自主需要注册地址、发送TRC-20、监视传入的程序支付，并通过REST创建发票。

能源和带宽是用户体验的死胡同。 每个智能合约都会调用TRON

需要能量。没有能量，TRX代币会作为费用燃烧——一个USDT 冷接收器的转账会消耗3-13 TRX（约1-4美元）。从a租用能源供应商将成本降至0.10美元左右 减少94% --但每一个提供商有不同的价格、不同的API、不同的持续时间等级，以及不同的故障模式。不能指望任何代理人来管理这件事。

在MERX之前，TRON上没有x402主持人。 x402协议已经

在Base、Solana、Stellar和以太坊。TRON在coinbase/x402生态系统中完全缺失注册直到MERX。希望为TRON托管的API付费的代理 USDT没有标准化的方法来做到这一点。

三种代理协议，零TRON集成。 MCP（人类学），A2A

（Google）和ACP（BeeAI）是三种主要的代理通信协议。在MERX之前，他们都没有部署生产级TRON服务器。 Claude、Vertex AI或BeeAI中的AI代理实际上看不到TRON。

MERX构建缺失的层。人工智能代理调用一个API，保持零TRX，并且在全球范围内以USDT、USDC或USDD进行支付/支付/发送/接收最大的USDT网络。

无MERX	有MERX
代理必须手动管理能量+带宽	`send()` 自动估算和调配资源
代理人必须持有TRX作为gas	GasFree转账——代理人从零TRX钱包发送稳定币
代理商必须将每个能源供应商的API	一条MERX API路线集成到6家供应商中最便宜的供应商
无法在USDT	x402 v2引导程序中为TRON托管的API付费，并提供完整的USDT/USDC/USDD支持
TRON上没有发现A2A/ACP	代理卡+清单直播，7种技能，7种能力
Agent必须为TRON	66个工具、30个提示、21个资源编写自己的MCP服务器，托管
地址监视意味着轮询RPC	`watch()` 通过ZMQ实现3秒以下的webhook交付

______________________________________________________________________

平台概述

组件	描述
MCP服务器	66个工具，30个提示，21个资源对于AI代理。SSE在 `https://merx.exchange/mcp/sse` （零安装）或本地stdio。SEP-1649服务器卡。生产中最大的TRON原生MCP服务器。
Claude Code插件	一行安装： `/plugin marketplace add Hovsteder/merx-claude-plugin`自动注册MCP，6个斜线命令，子代理。
代理支付服务	`agent.merx.exchange` --非自定义REST API。 `register`, `send`, `receive`, `watch`, `invoice`, `batch`, `schedule`, `contacts`.USDT直播；USDD/USDC下一个冲刺
x402 v2协调员	`x402.merx.exchange` --coinbase/x402生态系统注册表中唯一的TRON协助者。三种结算方案(`exact`, `exact_permit`, `exact_gasfree`)TRON主网上的USDT、USDC、USDD加上Base上的USDC。
GasFree传输服务	主网控制器 `TKjJ1r5XYqnLZmLakcP3knis7Lh6gm3qtR` 激活2026-04-08。TIP-712允许USDT/USDC/USDD转账。代理商从零TRX钱包发送稳定币。
A2A协议（谷歌）	代理卡位于 `/.well-known/agent.json`. 7技能包括 `compile_policy`基于任务的SSE流执行。与LangChain、CrewAI、Vertex AI、AutoGen、Mastra兼容。
ACP协议（BeeAI）	清单见 `/.well-known/agent-manifest.json`. 7能力匹配A2A技能。基于运行的长轮询执行。
策略引擎	自然语言→ 《会议常规》，由人类学家克劳德·十四行诗4号提供支持。可用作MCP工具、A2A技能和REST端点。
能源聚合器	实时价格比较 6活跃供应商（CatFee、Nets、TronSave、iTRX、PowerSun、TEM）。将订单发送到最便宜的来源。在试剂表面之下。
专用TRON RPC节点	`rpc.merx.exchange`，低于5ms的读取延迟，13.7ms的广播。试用1000个免费请求；带能源支出豁免的付费等级。
下的REST API	70+版本的终结点 `/api/v1/`开机自检时的识别码。标准错误格式。
WebSocket	实时TRC-20传输流和价格更新 `wss://merx.exchange/ws`.
JavaScript SDK	`merx-sdk` v2.1--AgentModule+SwapModule+4个基本模块。包括TypeScript类型。
Python SDK	`merx-sdk` v2.1--蛇壳中的同一表面。
x402中间件	`merx-x402` v2.0.0——x402 v2的单行Express集成。
文档	38页以上 merx.exchange/文档.API参考，MCP/A2A/ACP指南，x402集成。

______________________________________________________________________

快速开始

四条路径取决于您的用例。 对于AI代理，路径3和4是主表面。 路径1（网络）供人工操作员使用；路径2（REST/SDK）为用于直接程序集成。

路径1：网络平台（人类）

首选 merx.exchange.登录.存入TRX。管理能量、代理API键，以及通过仪表板进行平衡。无需代码。

路径2:REST API/SDK（程序化）

安装JavaScript SDK：

npm install merx-sdk

在您的应用程序中使用它（替换 merx_sk_your_key 使用来自的API密钥 merx.exchange):

import { MerxClient } from 'merx-sdk'

const merx = new MerxClient({ apiKey: 'merx_sk_your_key' })

// Get current prices from all providers
const prices = await merx.prices.list()
console.log(prices[0])
// { provider: "netts", price_sun: 22, available: 100000000 }

// Buy energy at best price
const order = await merx.orders.create({
  resource_type: 'ENERGY',
  amount: 65000,
  duration_sec: 300,
  target_address: 'TYourAddress...',
})
console.log(order.status)   // "FILLED"
console.log(order.cost_trx) // 1.4311

python

from merx import MerxClient

merx = MerxClient(api_key="merx_sk_your_key")

prices = merx.prices.list()
order = merx.orders.create(
    resource_type="ENERGY",
    amount=65000,
    duration_sec=300,
    target_address="TYourAddress..."
)

curl（无需SDK）：

# Public -- no auth required
curl https://merx.exchange/api/v1/prices

# Authenticated
curl -X POST https://merx.exchange/api/v1/orders \
  -H "Authorization: Bearer merx_sk_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "resource_type": "ENERGY",
    "amount": 65000,
    "duration_sec": 300,
    "target_address": "TYourAddress..."
  }'

路径3:Claude Code插件（一行安装）

如果你使用的是Claude Code，这是最快的方法。插件自动注册托管的MCP服务器提供6个斜线命令，并包括 tron-agent-engineer 专门从事TRON代理支付工作流程的子代理。

/plugin marketplace add Hovsteder/merx-claude-plugin
/plugin install merx@merx

然后运行 /merx:setup 以配置您的MERX API密钥。可用命令：

命令	它的作用
`/merx:setup`	首次设置：API密钥、连接测试、功能巡回
`/merx:prices`	所有供应商的实时TRON能源和带宽价格
`/merx:buy-energy`	通过最便宜的供应商购买能源，委托给目标地址
`/merx:balance`	MERX预付余额、最近订单、免费等级使用
`/merx:tx`	使用结构化字段查找TRON交易
`/merx:send`	通过代理支付服务发送TRC-20稳定币

来源： .

路径4:MCP适用于任何AI代理（Claude、Cursor、Windsurf、自定义）

托管（零安装） --与Claude.ai、Cursor、Windsurf和任何 SSE兼容的MCP客户端：

{
  "mcpServers": {
    "merx": {
      "url": "https://merx.exchange/mcp/sse"
    }
  }
}

22个只读工具可立即使用：价格、估算、市场分析、，链上查询、地址查找。不需要API密钥。

要解锁交易工具，请致电 set_api_key 在任何对话中：

set_api_key("merx_sk_your_key")
-> All 34 authenticated tools unlocked for this session.

要解锁写入工具（发送TRX、交换令牌），请致电 set_private_key:

set_private_key("your_64_char_hex_key")
-> Address derived automatically. All 66 tools available.
-> Key never leaves your machine.

本地（stdio） --通过环境变量设置按键的全功率：

npm install -g merx

{
  "mcpServers": {
    "merx": {
      "command": "npx merx-mcp",
      "env": {
        "MERX_API_KEY": "merx_sk_your_key",
        "TRON_PRIVATE_KEY": "your_private_key"
      }
    }
  }
}

第一条消息中提供的所有66个工具。

附加协议支持

MERX还为非MCP编排器公开了A2A和ACP——相同的后端，不同的发现表面：

A2A （LangChain、CrewAI、Vertex AI、AutoGen、Mastra）：代理卡

https://merx.exchange/.well-known/agent.json --7种技能，SSE流媒体

ACP （BeeAI）：清单在

https://merx.exchange/.well-known/agent-manifest.json --7种功能，基于运行的执行

访问级别

配置	工具	功能
无关键字	22	价格、估算、市场分析、链上查询、地址查找
+ `MERX_API_KEY`	34	+订单、余额、存款、常规订单、监视器
+ `TRON_PRIVATE_KEY`	66	+发送TRX/USDT/USDC/USDD、交换代币、批准合约、执行意图、代理付款

______________________________________________________________________

是什么让MERX与众不同

TRON上唯一完整的代理堆栈

MERX是唯一运行的TRON项目 所有三种主要代理协议 作为生产级服务：MCP（Anthropic）、A2A（谷歌，7种技能）和ACP （BeeAI，7种功能）。TronLink发布了一个核心MCP库 (@tronlink/tronlink-mcp-core v0.1.02026年3月），但它明确是构建块，而不是托管服务。MERX是TRON在 coinbase/x402生态系统合作伙伴注册表.

3秒以下收款的代理支付服务

agent.merx.exchange 非托管：代理人注册自己的TRON地址 MERX从不持有私钥或控制资金。ZMQ事件监听器匹配传入的TRC-20转账（USDT、USDC、USDD，加上任何其他代币实时），并在链上确认后约3秒内调度webhooks。 watch() 通过每个令牌过滤提供持久的24/7地址监控。 invoice() 使用支付链接和自动创建支付请求检测。 batch() 一次通话最多可发送50次转账。

x402 v2促进者，具有完整的TRON稳定币覆盖范围

x402.merx.exchange 执行标准 /verify, /settle，以及 /supported 端点，因此任何x402客户端（包括Coinbase CDP）参考实现）开箱即用。 三个结算 TRON主网上的方案: exact （直接TRC-20传输）， exact_permit 和 exact_gasfree （TIP-712允许通过MERX自己的转账 GasFreeController合同）。USDT、USDC和USDD均在主网结算通过验证txid和链上佣金收集。在15个已知的x402中 MERX是唯一支持全TRON稳定币组的公司。

GasFree零TRX发送

MERX部署了GasFreeController合同 TKjJ1r5XYqnLZmLakcP3knis7Lh6gm3qtR 2026年4月8日，主网上线，有三个经过验证的主网 permitTransfer 结算（USDT、USDC、USDD）。代理商从钱包中发送稳定币保持零TRX——控制器从每位用户的GasFree中提取价值+费用子账户，执行人支付广播费。单一最大的用户体验障碍 TRON上的代理已删除。

资源感知交易

每次写入操作（TRC-20转移、令牌交换、合约调用）都会自动执行估算所需的能源和带宽，在最佳市场购买赤字 6家供应商的价格，等待授权到达链上，然后执行。代理人从不不必要地消耗TRX。在主网上测试：与燃烧相比，使用自动资源的USDT转账可节省高达94%的费用。

精确的能量模拟

在购买能源进行掉期和合约看涨之前，MERX模拟了交易通过 triggerConstantContract 具有真实参数。没有硬编码估算——购买的精确能量。对于SunSwap V2交换，模拟返回223354能量；准确使用链上交易 223,354.

自然语言策略引擎

“我的钱包里有50万块能量。当价格跌至55太阳以下时购买。每周最多200 TRX。"

策略引擎（由Anthropic Claude Sonnet 4提供支持）解析此内容指令，生成带有触发器、预算的结构化长期订单限制和过期，为用户预览它们，并创建所有内容有一个确认。可通过MCP、A2A技能和REST端点使用。没有他们自己的Anthropic整合，任何竞争对手都无法复制这一点，例如订单基础设施和实时提供商价格馈送。

多供应商能源路由（代理表面下）

所有6家主动能源供应商（CatFee、Nets、TronSave、iTRX、， PowerSun、TEM）。订单会自动发送到最便宜的来源。如果一个供应商出现故障或产能不足，下一个最便宜的供应商会完成订单。价格涵盖了每个可用持续时间层的能源和带宽。

会议常规+代表团监督员

服务器端24/7自动化存储在PostgreSQL中。触发器类型： price_below, price_above, schedule （cron）， balance_below, delegation_expiry. 在重启过程中持续存在。客户端脱机时工作。自动续订可配置的最高价格。

完整的MCP协议

唯一使用所有三种MCP原语的TRON MCP服务器： 工具（66）、提示（30）和资源（21--14个静态+7个模板）两种运输方式：托管SSE（零安装）和本地stdio（全密钥管理）。三支持的协议版本： 2024-11-05, 2025-03-26, 2025-06-18.

______________________________________________________________________

建筑

平台概述

graph TB
    User[User / Application / AI Agent]
    Platform[MERX Platform
merx.exchange]
    PM[Price Monitor
polls every 30s]
    OE[Order Executor
routes to cheapest]
    DV[Delegation Verifier
confirms on-chain]
    TR[Treasury
balance management]
    RPC[TronGrid / GetBlock
TRON RPC]
    Providers[Energy Providers
all connected]
    TRON[TRON Blockchain]

    User -->|Web / API / SDK / MCP| Platform
    Platform --> PM
    Platform --> OE
    Platform --> DV
    Platform --> TR
    PM -->|Price polling| Providers
    OE -->|Order routing
cheapest first| Providers
    DV -->|Verify delegations| RPC
    RPC --> TRON
    Providers -->|Delegate energy
+ bandwidth| TRON

    style User fill:#1a1a2e,stroke:#B8963E,color:#F5F0E8
    style Platform fill:#0C0B09,stroke:#B8963E,color:#F5F0E8
    style TRON fill:#141310,stroke:#B8963E,color:#F5F0E8

ASCII diagram (if Mermaid does not render)

User / Application / AI Agent
    |
    | Web / REST API / SDK / MCP
    v
+----------------------------------+
|         MERX Platform            |
|         merx.exchange            |
|                                  |
|  +------------+ +-------------+  |
|  |   Price    | |   Order     |  |
|  |  Monitor   | |  Executor   |  |
|  | (every 30s)| | (cheapest)  |  |
|  +------------+ +-------------+  |
|  +------------+ +-------------+  |
|  | Delegation | |  Treasury   |  |
|  |  Verifier  | |  Manager    |  |
|  +------------+ +-------------+  |
+----------------------------------+
    |                    |
    v                    v
TronGrid / GetBlock   Energy Providers
(TRON RPC)            (all connected)
    |                    |
    v                    v
+----------------------------------+
|        TRON Blockchain           |
+----------------------------------+

关键架构原则： 所有流量都通过MERX平台。用户永远不需要TronGridneneneba API密钥。MERX管理所有RPC基础架构、缓存和服务器端故障转移。客户端上唯一保留的操作：事务使用私钥签名。私钥永远不会离开客户端进程。

资源感知事务流

此序列图显示了具有自动资源优化的真实USDT转账。数字来自生产测试。

sequenceDiagram
    participant C as Client
    participant M as MERX
    participant P as Providers
    participant T as TRON

    C->>M: POST /orders or transfer_trc20(USDT, 100, TAddr)
    M->>M: POST /estimate (trc20_transfer)
    Note over M: energy: 7,896 / bandwidth: 345
    M->>M: GET /chain/resources/TSender
    Note over M: energy: 0 / bandwidth: 0 / free BW: 600
    Note over M: Energy deficit: 7,896 (round up to 65,000 min)
Bandwidth: 345 >P: Route order: ENERGY, 65,000, 300s
    P-->>M: FILLED at 22 SUN (1.43 TRX)
    Note over M: Poll every 2s until delegation arrives
    M->>T: Verify delegation on sender address
    T-->>M: energy: 65,050 available
    Note over M: Sign TX (client-side if MCP, server-side if API)
    M->>T: Broadcast signed TX
    T-->>M: TX confirmed
    M-->>C: USDT sent. Cost: 1.43 TRX.
Burn alternative: 3.66 TRX. Savings: 87.6%

ASCII diagram (if Mermaid does not render)

Client                  MERX                    Providers               TRON
  |                       |                       |                      |
  | order / transfer      |                       |                      |
  |---------------------->|                       |                      |
  |                       | estimate energy+BW    |                      |
  |                       | energy: 7,896         |                      |
  |                       | bandwidth: 345        |                      |
  |                       |                       |                      |
  |                       | check sender resources|                      |
  |                       | energy: 0, BW: 0      |                      |
  |                       |                       |                      |
  |                       | [deficit: 7,896 -> round up to 65,000]      |
  |                       | [BW: 345  skip, burn ~0.3 TRX]|
  |                       |                       |                      |
  |                       | route to cheapest     |                      |
  |                       |---------------------->|                      |
  |                       |   FILLED 22 SUN       |                      |
  |                       |   1.43 TRX            |                      |
  |                       ||
  |                       |   energy: 65,050      ||--------------------->|
  |                       |                       |   TX confirmed       |
  |                       |

### 资源采购规则

|规则|详细信息|
|---|---|
|能量赤字>0 |四舍五入至最低65000单位。买最低限度的东西比烧小赤字更便宜。 |
|带宽不足\ **注：** 下面的工具目录表上一次经过全面审核，共有52种工具。
> 十二种新工具（代理支付服务、掉期模块、高级地位
> 订单）记录在 [merx.exchange/docs/tools/mcp-server](https://merx.exchange/docs/tools/mcp-server).
> 规范计数为 **64**，由实时MCP服务器提供服务。

### 工具类别

|类别|计数|授权|描述|
|---|---|---|---|
|价格情报|5|--|所有供应商的实时价格、市场分析、趋势、历史|
|资源估算|2|--|估算任何事务类型的能量+带宽|
|资源交易|4|neneneba API密钥|以最优惠的价格购买能源/带宽，确保任何地址的资源|
|账户管理|3| API密钥|余额、存款信息、交易历史|
|Agent Convenience |4|--|解释概念、建议持续时间、计算节省、列出提供商|
|链上查询|5|--|账户信息、TRX/TRC20余额、交易查询、区块|
|令牌操作|4|私钥|发送TRX、转移TRC20、批准令牌——所有资源都是已知的|
|智能合约|3|混合|读取合约状态，估算通话成本，使用自动资源执行|
|网络实用程序|5|--|链参数、地址工具、TRX价格、链上历史|
|DEX掉期|3|私钥|SunSwap V2报价，执行精确的能量模拟|
|入职|2|--|创建帐户+登录，无需浏览器|
|付款|4|混合|自助存款，自动存款配置，x402每次使用付费|
|意图执行|2|混合|多步骤计划：模拟或执行复杂的序列|
|常规订单|4|neneneba API键|服务器端全天候自动化：价格触发器、cron、监视器|
|会话管理|2|--|设置当前会话的API密钥和私钥|
| **总计** | **52** | | |

### 提示（30）

预构建的对话模板可在Claude Desktop提示选择器中使用，也可通过
`prompts/get` 在任何MCP客户端中。

|组|提示|示例|
|---|---|---|
|市场（5）|购买能源、购买带宽、确保资源、市场分析、比较供应商|“以最佳市场价格购买能源”|
|交易（5）|发送usdt、发送trx、发送令牌、多转账、解释交易|“发送usdt并自动优化资源”|
|钱包（4）|检查钱包、审计支出、监控委托、优化钱包|“包含余额和委托的完整钱包概览”|
|DEX（3）|交换代币、支票代币、价格检查|“通过SunSwap交换代币”|
|规划（3）|估算成本、预算计划、股权与租金|“规划一段时间的能源预算”|
|开发人员（2）| integrate-merx，setup-mcp|“如何集成merx API”|
|入职（2）|入职，资金账户|“创建账户并开始”|
|付款（2）|设置自动融资，无账户购买|“x402零注册购买”|
|模拟（2）|模拟计划，执行计划|“模拟多步骤计划”|
|监控（2）|设置常规订单，自动续订代表团|“为代表团设置自动续订”|

### 资源（21）

14个静态资源+7个URI模板。将对话作为上下文或
订阅实时更新。

|资源|URI|更新|
|---|---|---|
|能源价格| `merx://prices/energy` |每30秒|
|带宽价格| `merx://prices/bandwidth` |每30秒|
|最优惠的价格| `merx://prices/best` |每30秒|
|市场分析| `merx://market/analysis` |每5m|
|提供商列表| `merx://market/providers` |每30秒|
|提供商状态| `merx://market/providers/status` |每30秒|
|账户余额| `merx://account/balance` |关于变化|
|最近的订单| `merx://account/orders/recent` |关于变化|
|帐户统计信息| `merx://account/stats` |每5m|
|自动存款配置| `merx://account/auto-deposit` |关于变化|
|网络参数| `merx://network/parameters` |每1小时|
|TRX价格| `merx://network/trx-price` |每1m|
|令牌引用| `merx://reference/tokens` |静态|
|会议常规| `merx://standing-orders/active` |关于变化|

**URI模板：**

|模板|说明|
|---|---|
| `merx://address/{address}/overview` |完整地址状态：TRX、代币、能量、带宽|
| `merx://address/{address}/resources` |能量+带宽，免费BW跟踪|
| `merx://address/{address}/transactions` |最近交易的类型和金额|
| `merx://address/{address}/delegations` |有到期时间的活动代表团|
| `merx://token/{token}/info` |代币元数据+价格+转移能源成本|
| `merx://order/{order_id}/status` |订单详细信息，包括填充和成本明细|
| `merx://standing-order/{id}/status` |常规命令触发状态和执行|

### 示例对话

**查看价格并购买能源：**

User: What is the cheapest energy right now? Agent: [calls get_prices] Cheapest energy is 22 SUN from Netts (5-minute delegation). For 65,000 energy, that is 1.43 TRX. User: Buy it for TLyqz... Agent: [calls create_order] Done. 65,050 energy delegated via Netts. Cost: 1.43 TRX. TX: 27ab0019... (verified on-chain).


**资源感知USDT转账：**

User: Send 100 USDT to TAddr. Agent: [calls transfer_trc20] MERX estimated 7,896 energy needed, bought 65,000 at 22 SUN, waited for delegation, signed and broadcast. USDT sent. Cost: 1.43 TRX instead of 3.66 TRX. Savings: 87.6%.


**市场分析：**

User: Is now a good time to buy energy? Agent: [calls analyze_prices] Energy is at 22 SUN -- the 1st percentile of the last 7 days. 64% below the weekly average of 62 SUN. Trend: falling. Recommendation: good time to buy.


### 完整工具参考

所有66个具有身份验证要求的工具。有关输入模式和输出示例，请参见
[docs/TOOLS.md](docs/TOOLS.md).

**价格情报**

|#|工具|描述|身份验证|
|---|---|---|---|
| 1 | `get_prices` |所有供应商的当前能源和带宽价格|--|
| 2 | `get_best_price` |给定资源和数量的最便宜供应商|--|
| 3 | `analyze_prices` |市场分析，包括趋势、百分位数和建议|--|
| 4 | `get_price_history` |按提供商、资源和期间列出的历史价格快照|--|
| 5 | `compare_providers` |与所有持续时间级别并列的提供商比较|--|

**资源量估算**

|#|工具|描述|身份验证|
|---|---|---|---|
| 6 | `estimate_transaction_cost` |估计TRX/TRC20/自定义操作的能量+带宽|--|
| 7 | `check_address_resources` |任何地址的能量、带宽、空闲带宽和TRX平衡|--|

**资源交易**

|#|工具|描述|身份验证|
|---|---|---|---|
| 8 | `create_order` |购买能源或带宽，路由到最便宜的提供商| API密钥|
| 9 | `get_order` |带有填充、TX哈希和验证状态的订单详细信息| API密钥|
| 10 | `list_orders` |使用可选状态筛选器| API键列出订单|
| 11 | `ensure_resources` |声明性：确保地址上的能量/带宽最小| API密钥|

**账户管理**

|#|工具|描述|身份验证|
|---|---|---|---|
| 12 | `get_balance` |MERX账户余额（TRX、USDT、锁定）| API密钥|
| 13 | `get_deposit_info` |MERX存款地址和备忘录| API密钥|
| 14 | `get_transaction_history` |MERX账户订单历史记录（7D/30D/90D）| API密钥|

**代理人便利**

|#|工具|描述|身份验证|
|---|---|---|---|
| 15 | `explain_concept` |解释TRON概念：能量、带宽、质押、委托、sun_units |--|
| 16 | `suggest_duration` |根据用例和TX计数建议租赁期限|--|
| 17 | `calculate_savings` |计算N笔交易中租赁与焚烧的节省|--|
| 18 | `list_providers` |所有具有类型、持续时间和可用性的提供商|--|

**链上查询**

|#|工具|描述|身份验证|
|---|---|---|---|
| 19 | `get_account_info` |全链账户：TRX、能量、带宽、限制|--|
| 20 | `get_trx_balance` |任意地址的快速TRX余额|--|
| 21 | `get_trc20_balance` |TRC-20代币余额（支持交易品种或合约地址）|--|
| 22 | `get_transaction` |按ID查找交易，包括状态、能量、使用的带宽|--|
| 23 | `get_block` |按编号（或最新）阻止信息|--|

**令牌操作**

|#|工具|描述|身份验证|
|---|---|---|---|
| 24 | `transfer_trx` |发送自动带宽优化的TRX |私钥|
| 25 | `transfer_trc20` |使用自动能量+带宽转移TRC-20代币|私钥|
| 26 | `approve_trc20` |批准TRC-20汽车能源支出补贴|私钥|
| 27 | `get_token_info` |令牌元数据：名称、符号、小数、总供应量|--|

**智能合约**

|#|工具|描述|身份验证|
|---|---|---|---|
| 28 | `read_contract` |调用视图/纯合约函数（无gas，无签名）|--|
| 29 | `estimate_contract_call` |估算合约呼叫的能量+带宽|--|
| 30 | `call_contract` |使用自动资源执行状态更改合约功能|私钥|

**网络实用工具**

|#|工具|描述|身份验证|
|---|---|---|---|
| 31 | `get_chain_parameters` |TRON网络参数与MERX价格比较|--|
| 32 | `convert_address` |在base58（T…）和十六进制（41…）格式之间转换|--|
| 33 | `get_trx_price` |CoinGecko的当前TRX价格|--|
| 34 | `validate_address` |验证TRON地址格式并检查链状态|--|
| 35 | `search_transaction_history` |任何地址的链上交易历史|--|

**DEX掉期**

|#|工具|描述|身份验证|
|---|---|---|---|
| 36 | `get_swap_quote` |实际SunSwap V2报价，包括预期产量和滑点|--|
| 37 | `execute_swap` |使用精确的能量模拟执行SunSwap交换|私钥|
| 38 | `get_token_price` |代币价格通过SunSwap池+CoinGecko美元汇率|--|

**入职**

|#|工具|描述|身份验证|
|---|---|---|---|
| 39 | `create_account` |创建MERX账户，获取API密钥|——|
| 40 | `login` |登录现有MERX帐户|--|

**支付**

|#|工具|描述|身份验证|
|---|---|---|---|
| 41 | `deposit_trx` |从钱包将TRX存入MERX（用备忘录签署TX）| API密钥+私钥|
| 42 | `enable_auto_deposit` |当余额低于阈值时配置自动存款| API键|
| 43 | `pay_invoice` |支付现有的x402发票|私钥|
| 44 | `create_paid_order` |x402零注册订单：发票、付款、验证、订单|私钥|

**意图执行**

|#|工具|描述|身份验证|
|---|---|---|---|
| 45 | `execute_intent` |使用资源优化| API键执行多步骤计划|
| 46 | `simulate` |模拟多步骤计划而不执行|--|

**会议常规和监视器**

|#|工具|描述|身份验证|
|---|---|---|---|
| 47 | `create_standing_order` |使用触发器+操作| API键创建服务器端常设订单|
| 48 | `list_standing_orders` |使用状态筛选器| API键列出长期订单|
| 49 | `create_monitor` |创建持久监视器（委托、余额、价格）| API键|
| 50 | `list_monitors` |使用状态筛选器| API键列出监视器|

**会话管理**

|#|工具|描述|身份验证|
|---|---|---|---|
| 51 | `set_api_key` |设置此会话的MERX API密钥|--|
| 55 | `set_private_key` |为此会话设置TRON私钥（地址自动导出）|--|

______________________________________________________________________

## SDK

### JavaScript/TypeScript

npm install merx-sdk

import { MerxClient } from 'merx-sdk'

const merx = new MerxClient({ apiKey: 'merx_sk_your_key' })

// 4 modules: prices, orders, balance, webhooks const prices = await merx.prices.list() const best = await merx.prices.best({ resource: 'ENERGY' }) const order = await merx.orders.create({ ... }) const status = await merx.orders.get(order.id) const balance = await merx.balance.get() const webhooks = await merx.webhooks.list()


|财产|价值|
|---|---|
|包装| `merx-sdk` |
|模块| `prices`, `orders`, `balance`, `webhooks` |
|方法|16|
|TypeScript |包含完整的类型定义|
|依赖关系|零|
|Node.js | 18+|

### python

pip install merx-sdk

from merx import MerxClient

merx = MerxClient(api_key="merx_sk_your_key")

Same 4 modules, snake_case

prices = merx.prices.list() best = merx.prices.best(resource="ENERGY") order = merx.orders.create(resource_type="ENERGY", amount=65000, ...) status = merx.orders.get(order.id) balance = merx.balance.get()


|财产|价值|
|---|---|
|包装| `merx-sdk` |
|模块| `prices`, `orders`, `balance`, `webhooks` |
|方法|16|
|类型提示|完整类型注释|
|依赖关系|零|
|Python | 3.11+|

### REST API

不需要SDK。所有端点都接受JSON并返回JSON。

Get prices (public, no auth)

curl https://merx.exchange/api/v1/prices

Get best price for energy

curl https://merx.exchange/api/v1/prices/best?resource=ENERGY

Create order (authenticated)

curl -X POST https://merx.exchange/api/v1/orders \ -H "Authorization: Bearer merx_sk_your_key" \ -H "Content-Type: application/json" \ -d '{"resource_type":"ENERGY","amount":65000,"duration_sec":300,"target_address":"TAddr..."}'

Check balance

curl https://merx.exchange/api/v1/balance \ -H "Authorization: Bearer merx_sk_your_key"


______________________________________________________________________

## 实时数据

### WebSocket

连接到 `wss://merx.exchange/ws` 实时价格更新。

const ws = new WebSocket('wss://merx.exchange/ws')

ws.onopen = () => { // Subscribe to all energy price updates ws.send(JSON.stringify({ type: 'subscribe', channel: 'prices', resource: 'ENERGY' })) }

ws.onmessage = (event) => { const data = JSON.parse(event.data) // { provider: "netts", resource: "ENERGY", price_sun: 22, available: 100000000, ... } }


|财产|价值|
|---|---|
|端点| `wss://merx.exchange/ws` |
|频道| `prices`, `orders`, `balance` |
|更新频率|价格每30秒更新一次|
|心跳|每30秒|
|重新连接|建议客户端采用指数回退|

### 网络钩子

注册webhook端点以接收帐户事件的HTTP POST通知。

curl -X POST https://merx.exchange/api/v1/webhooks \ -H "Authorization: Bearer merx_sk_your_key" \ -H "Content-Type: application/json" \ -d '{"url":"https://your-app.com/webhook","events":["order.filled","deposit.received"]}'


|事件|当|
|---|---|
| `order.filled` |能源或带宽订单已由提供商填写|
| `order.failed` |在所有提供程序尝试失败后，订单失败|
| `deposit.received` |TRX存款已确认并记入余额|
| `withdrawal.completed` |TRX提款广播并在链上确认|

**安全：** 每个webhook请求都包含一个 `X-Merx-Signature` 标题包含
使用您的webhook密钥计算的HMAC-SHA256签名。验证此签名
在处理之前。以指数回退方式重试失败的交付。

______________________________________________________________________

## 支付方式

MERX支持三种支付能源和带宽的方式。

### 1.预先供资的市面汇率余额

通过MERX.exchange的仪表板或API将TRX存入您的MERX账户。
直接从您的余额进行交易。最适合高流量用户和团队。

Check balance

curl https://merx.exchange/api/v1/balance \ -H "Authorization: Bearer merx_sk_your_key"

Response

{ "available_trx": 45.20, "locked_trx": 1.43, "total_trx": 46.63 }


### 2.从代理钱包自行存款

代理人使用自己的钱包将TRX存入MERX `deposit_trx` 工具或
API该工具使用正确的备忘录构建TRX转账，并在本地签名，然后
广播。余额将在1-2分钟内入账。

deposit_trx(amount: 10) -> TX: 4bc60854f828...8ddcd509 -> 10 TRX deposited. Will be credited to your MERX balance shortly.


### 3.x402按次付费

不需要帐户。无需预存。创建发票，从任何钱包用TRX支付，
直接接受能源委托。在一个API调用或一个工具中完成流程
通过电话 `create_paid_order`.

create_paid_order(amount: 65000, duration_sec: 300, resource_type: "ENERGY", target_address: "THT49...") -> Invoice: inv_f41ffc2f... -> Payment TX: 53236a5a... -> Cost: 1.43 TRX -> Status: PENDING -> FILLED -> 65,050 energy delegated to THT49...


|方法|需要设置|最适合|最低存款|
|---|---|---|---|
|预付款余额|账户+仪表板存款|高流量用户、团队|任意金额|
|自行存款(`deposit_trx`)| API密钥+私钥|自治代理|任意数量|
|x402(`create_paid_order`)|仅限私钥|一次性购买，无账户代理|每笔订单|

看 [docs/PAYMENT-METHODS.md](docs/PAYMENT-METHODS.md) 查看详细的流程图。

______________________________________________________________________

## 常规命令和监督员

### 定期付款指令

服务器端24/7自动化存储在PostgreSQL中。在重启过程中持续存在。作品
当客户端离线时。

**触发器类型：**

|触发器|描述|示例|
|---|---|---|
| `price_below` |当最优价格降至阈值以下时开火|当价格\ Standing Order: so_a1b2c3d4
-> Status: ACTIVE
-> Trigger: ENERGY price  Action: Buy 65,000 energy (5m)
-> Budget: 15 TRX (10 executions max)

委派监控器

观看任何地址上的代表团和资源。到期前发出警报。自动续订具有可配置的最高价格。

监视器类型	说明	示例
`delegation_expiry`	能源/带宽授权到期前发出警报	到期前5分钟发出警报，最多在周日30点自动续订
`balance_threshold`	TRX余额降至阈值以下时发出警报	余额\ Monitor: mon_e5f6g7h8

-> Status: ACTIVE -> Type: delegation_expiry -> Alert: 5 minutes before expiry -> Auto-renew: Yes (max 30 SUN)


______________________________________________________________________

## 储蓄计算器

能源是TRON上昂贵的资源。这些数字显示了成本差异
在燃烧TRX（无能量）和通过MERX租用能量之间。

|资源|目的|每天免费|没有它|
|---|---|---|---|
|能源|智能合约执行（USDT转账、掉期、批准）|0（必须质押或租赁）|TRX以网络速率烧毁|
|带宽|事务序列化（每个TX都需要一些）|600字节/天|TRX以网络速率燃烧|

### 成本比较

|场景|燃烧成本（无能源）|租赁成本（MERX）|节省|
|---|---|---|---|
|1美元转账|3-13 TRX|1.43 TRX|56-89%|
|10笔USDT转账|30-130TRX|14.30TRX|52-89%|
|100 USDT转账/天| 300-1300 TRX | 143 TRX | 52-89%|
|SunSwap掉期（小）|~50 TRX|~4.91 TRX|~90%|
|合约通话（简单）|~1 TRX|~0.09 TRX|~91%|

数字假定订购时最便宜的供应商。实际燃烧成本
根据收件人地址状态（之前是否持有令牌）而有所不同。

### 运作原理

1 TRX=1000000太阳。能源以每单位太阳为单位定价。需要USDT转账
大约65000个能量单位。每单位22日，即65000 x 22=
1430000太阳=1.43 TRX。在没有能量的情况下，网络会燃烧3-13个TRX
发件人取决于收件人的帐户状态。

______________________________________________________________________

## 错误处理

所有错误都遵循API、SDK和MCP的标准格式：

{ "error": { "code": "INSUFFICIENT_BALANCE", "message": "MERX balance too low. Need 1.43 TRX, have 0.50 TRX.", "details": { "required_trx": 1.43, "available_trx": 0.50 } } }


### 常见错误代码

|代码|描述|分辨率|
|---|---|---|
| `INSUFFICIENT_BALANCE` |MERX账户余额过低|通过仪表板或 `deposit_trx` |
| `PROVIDER_UNAVAILABLE` |此订单的所有供应商均失败|请稍后重试或提高最高价格|
| `INVALID_ADDRESS` |TRON地址格式无效|检查地址以T开头，长度为34个字符|
| `DELEGATION_TIMEOUT` |能源委托未在超时内到达|请检查订单状态 `get_order` |
| `SIMULATION_FAILED` |合约调用模拟失败|检查合约地址和函数参数|
| `PRIVATE_KEY_REQUIRED` |操作需要TRON私钥|设置 `TRON_PRIVATE_KEY` env变量或调用 `set_private_key` |
| `API_KEY_REQUIRED` |操作需要MERX API密钥|集 `MERX_API_KEY` env变量或调用 `set_api_key` |
| `ORDER_MIN_AMOUNT` |金额低于最低订单金额|最低能量：65000。最小带宽：1500|

______________________________________________________________________

## 安全

### 私钥处理

- 私钥通过环境变量设置(`TRON_PRIVATE_KEY`)或
  `set_private_key` 工具在会话中。
- 密钥永远不会离开客户端进程。所有交易签名都在本地进行。
- MERX API从不接收私钥。
- 这 `set_private_key` 工具自动导出TRON地址——用户
  仅提供64个字符的十六进制密钥。

### API密钥处理

- API密钥通过MERX API进行交易操作验证。
- 可以通过环境变量设置密钥(`MERX_API_KEY`)或 `set_api_key`
  工具在会话中。
- 使用
  `create_account` 工具。

### MERX能做什么和不能做什么

|有私钥|没有私钥|
|---|---|
|签名和广播事务|只读操作|
|发送TRX和TRC-20代币|查看价格和余额|
|执行掉期交易|获取掉期报价|
|批准合同|估算成本|
|将TRX存入MERX |查看市场数据|

______________________________________________________________________

## 在主网上测试

所有功能都在TRON主网上进行了生产测试。这些不是模拟--
每个TX哈希值都是可验证的 [波场扫描](https://tronscan.org).

### 已验证交易

|类别|操作|TX哈希|状态|详细信息|
|---|---|---|---|---|
|令牌操作| `transfer_trx` | `b22813a813c3...990e7955` |成功|发送了0.1个TRX，消耗了267个带宽|
|付款| `deposit_trx` | `4bc60854f828...8ddcd509` |成功| 10 TRX已存入MERX，并附有备忘录，记入余额|
|令牌操作| `approve_trc20` | `56fc87f319b9...0bf5ffbb` |成功|USDT批准，能耗99764|
|智能合约| `call_contract` | `fc55aee3dc50...4bb5c1bf` |SUCCESS |name（）调用合约，消耗4098能量|
|DEX掉期| `execute_swap` | `61424b1e89a0...d066d21577` |成功|通过SunSwap V2，0.1 TRX->0.032 USDT，223354能量（与模拟完全相同）|
|资源交易| `create_order` | `8adac3b8a859...4e69e4ca` |充满|周日22点通过Nets获得65050能量，1.43 TRX|
|付款| `create_paid_order` | `53236a5aeba0...984dec7b` |成功|x402流量：支付1.43 TRX发票，委托65050能量|

### 主网测试的主要发现

|度量|值|
|---|---|
|USDT传输能量（典型）|65000单位|
|USDT转账成本（租用能源）|1.43 TRX|
|USDT转账成本（烧毁）|3-13 TRX|
|观察到的最大节省|94%|
|SunSwap掉期能量（0.1 TRX->USDT）|223354单位（完全模拟匹配）|
|SunSwap掉期输出| 0.1 TRX为0.032094 USDT|
|x402付款流程|发票->付款->验证->订单->填写->委托（一次通话）|
|能源委托确认|订单填写后2-6秒|

______________________________________________________________________

## 与备选方案的比较

基于公开信息的事实比较。

|功能|MERX|Sun协议|Nets MCP|TronLink MCP|PowerSun MCP|
|---|---|---|---|---|---|
|MCP工具|55|~20|~10|27|27|
|MCP提示|30|0|0|0|
|MCP资源|21|0 |0|0|
|REST API |70+端点|否|否|无|
|JavaScript SDK |是|否|否|不|否|
|Python SDK |是|否|否|不|否|
|WebSocket |是|否|否|不|否|
|Web交换|是|否|否|不|否|
|传输| stdio+SSE | stdio | stdio |stdio | SSE|
|能源供应商|全部连接|0|1|0|1|
|带宽支持|是|否|否|不|否|
|汽车资源购买|能源+BW |否|否|无|仅能源|
|精确能量模拟|是|否|否|不|否|
|意图执行|是|否|否|不|否|
|会议常规（24/7）|是|否|否|不|
|委派监视器|是|否|否|不|否|
|x402按次付费|是|否|否|不|否|
|DEX掉期|是|否|否|是|
|零安装选项|是（SSE）|否|否|是|
|需要私钥|可选|是|是|否|
|Webhooks |是|否|否|不|否|
|在主网上测试|7 TX已验证|未知|未知|已知|未知|

MERX涵盖资源经济学、交易优化和通用区块链
操作。其他服务器专注于一个领域。

______________________________________________________________________

## 文档

| | |
|---|---|
|平台| [merx.exchange](https://merx.exchange) |
|文件| [merx.exchange/文档](https://merx.exchange/docs) |
|API参考| [merx.exchange/docs/api](https://merx.exchange/docs/api) |
|MCP工具| [docs/TOOLS.md](docs/TOOLS.md) |
|MCP提示| [docs/PROMPTS.md](docs/PROMPTS.md) |
|MCP资源| [docs/RESOURCES.md](docs/RESOURCES.md) |
|配置| [docs/CONFIGURATION.md](docs/CONFIGURATION.md) |
|示例| [docs/EXAMPLES.md](docs/EXAMPLES.md) |
|比较| [docs/COMPARESON.md](docs/COMPARISON.md) |
|意向指南| [docs/INTENT-GUIDE.md](docs/INTENT-GUIDE.md) |
|会议常规| [文档/标准订单-GUIDE.md](docs/STANDING-ORDERS-GUIDE.md) |
|付款方式| [docs/PAYMENT-METHODS.md](docs/PAYMENT-METHODS.md) |
|建筑| [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) |
|变更日志| [docs/CHANGELOG.md](docs/CHANGELOG.md) |

______________________________________________________________________

## 许可证

MIT。看 [许可证](LICENSE).

Merx MCP

快速接入

详细介绍

MERX

https://MERX.exchange

目录

什么是MERX

的问题

平台概述

快速开始

路径1：网络平台（人类）

路径2:REST API/SDK（程序化）

路径3:Claude Code插件（一行安装）

路径4:MCP适用于任何AI代理（Claude、Cursor、Windsurf、自定义）

附加协议支持

访问级别

是什么让MERX与众不同

TRON上唯一完整的代理堆栈

3秒以下收款的代理支付服务

x402 v2促进者，具有完整的TRON稳定币覆盖范围

GasFree零TRX发送

资源感知交易

精确的能量模拟

自然语言策略引擎

多供应商能源路由（代理表面下）

会议常规+代表团监督员

完整的MCP协议

建筑

平台概述

资源感知事务流

Same 4 modules, snake_case

Get prices (public, no auth)

Get best price for energy

Create order (authenticated)

Check balance

Check balance

Response

{ "available_trx": 45.20, "locked_trx": 1.43, "total_trx": 46.63 }

委派监控器

目录标签

接入字段

权限和风险

来源信息

继续浏览同类 MCP