exchange.merxPublished by merx.exchangeOfficial publisherv1.0.5Updated Oct 25, 2026
TRON energy exchange for AI agents. 54 tools, 30 prompts, 21 resources. A2A + ACP.
MERX is a TRON energy and bandwidth exchange that lets an assistant quote, buy and use network resources, query on-chain data, and sign TRON transfers and swaps
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/exchange.merx%2Fmcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"merx-tron-resource-exchange": {
"type": "http",
"url": "https://merx.exchange/mcp/sse"
}
}
}TRON infrastructure for AI agents.
[smithery badge] [npm version] [License: MIT] [Tools] [Prompts] [Resources]
66 MCP tools. Energy market across 6 providers. USDT/USDC/USDD payments. x402 v2 facilitator on TRON mainnet.
Documentation | API Reference | MCP Server
MERX is the infrastructure layer for AI agents and agentic networks on TRON. Where Stripe is infrastructure for web commerce and Cloudflare for the open web, MERX is the missing infrastructure layer that lets autonomous AI agents discover, transact, and operate on TRON without ever touching energy, bandwidth, or low-level blockchain mechanics.
The platform exposes one coherent stack: 66-tool MCP server, agent payment service for TRC-20 stablecoins, x402 v2 facilitator (the only TRON facilitator in the coinbase/x402 ecosystem registry), GasFree transfers via a MERX-deployed mainnet controller, dedicated TRON RPC node, A2A (Google, 7 skills) and ACP (BeeAI, 7 capabilities) protocol coverage, and a natural language Policy Engine powered by Anthropic Claude.
Underneath those agent surfaces sits an energy aggregator across 6 active
providers (CatFee, Netts, TronSave, iTRX, PowerSun, TEM) that routes resource
purchases to the cheapest source automatically -- so when an agent calls
send(), MERX estimates the energy required, buys only the deficit, and
broadcasts the transaction. The agent never holds TRX or thinks about energy.
Any AI agent running in Claude, LangChain, CrewAI, Vertex AI, AutoGen, or BeeAI can send payments and acquire resources on TRON through a single integration with MERX.
Three ways to plug an agent into MERX:
MCP server -- 66 tools for AI agents. Hosted SSE at
https://merx.exchange/mcp/sse (zero install) or local stdio via
npx merx-mcp. Works with Claude, GPT, Cursor, Windsurf, and any
MCP-compatible client.
Claude Code plugin -- one-line install for Claude Code. Auto-registers
the MCP server, ships 6 slash commands and a tron-agent-engineer sub-agent.
See Hovsteder/merx-claude-plugin.
REST API + SDKs -- direct programmatic access for agents that aren't
using MCP. JavaScript (merx-sdk v2.1 on npm), Python (merx-sdk v2.1 on
PyPI), or raw HTTP against /api/v1/ (70+ versioned endpoints).
For human users, the web platform at merx.exchange remains available for manual energy trading, dashboard, deposits, and withdrawals -- but the platform is built primarily for agents.
AI agents will become the dominant transactional users of stablecoins, and TRON -- home to USDD, $86B+ USDT, USDC, and the dominant chain for retail USDT in Southeast Asia, Africa, and Latin America -- is already the largest USDT-native network in the world.
But TRON has no infrastructure designed for agents:
No agent-native payment service. Existing TRON wallets are built for human users with mouse clicks and seed-phrase backups, not for autonomous programs that need to register addresses, send TRC-20s, watch for incoming payments, and create invoices via REST.
Energy and bandwidth are a UX dead-end. Every smart contract call on TRON requires energy. Without energy, TRX tokens burn as fees -- a single USDT transfer burns 3-13 TRX (~$1-4) for cold receivers. Renting energy from a provider drops the cost to ~$0.10 -- a 94% reduction -- but every provider has a different price, different API, different duration tiers, and different failure modes. No agent can be expected to manage that.
No x402 facilitator on TRON before MERX. The x402 protocol has already processed $43.57M in agent-to-agent payments on Base, Solana, Stellar, and Ethereum. TRON was completely absent from the coinbase/x402 ecosystem registry until MERX. Agents that wanted to pay for TRON-hosted APIs in USDT had no standardized way to do it.
Three agent protocols, zero TRON integrations. MCP (Anthropic), A2A (Google), and ACP (BeeAI) are the three major agent communication protocols. Until MERX, none of them had a deployed, production-grade TRON server. AI agents in Claude, Vertex AI, or BeeAI literally could not see TRON.
MERX builds the missing layer. AI agents call one API, hold zero TRX, and get paid / pay / send / receive in USDT, USDC, or USDD on the world's largest USDT network.
Four paths depending on your use case. For AI agents, paths 3 and 4 are the primary surfaces. Path 1 (web) is for human operators; path 2 (REST/SDK) is for direct programmatic integration.
Go to merx.exchange. Sign in. Deposit TRX. Manage energy, agent API keys, and balance through the dashboard. No code required.
Install the JavaScript SDK:
Use it in your application (replace merx_sk_your_key with your API key from merx.exchange):
Python:
curl (no SDK needed):
If you're using Claude Code, this is the fastest path. The plugin auto-registers
the hosted MCP server, ships 6 slash commands, and includes a
tron-agent-engineer sub-agent specialized in agentic payment workflows on TRON.
Then run /merx:setup to configure your MERX API key. Available commands:
Source: github.com/Hovsteder/merx-claude-plugin.
Hosted (zero install) -- works with Claude.ai, Cursor, Windsurf, and any SSE-compatible MCP client:
22 read-only tools are available immediately: prices, estimation, market analysis, on-chain queries, address lookups. No API key required.
To unlock trading tools, call set_api_key in any conversation:
To unlock write tools (send TRX, swap tokens), call set_private_key:
Local (stdio) -- full power with keys set via environment variables:
All 66 tools available from the first message.
MERX also exposes A2A and ACP for non-MCP orchestrators -- same backend, different discovery surface:
MERX is the only TRON project that runs all three major agent protocols as
production-grade services: MCP (Anthropic), A2A (Google, 7 skills), and ACP
(BeeAI, 7 capabilities). TronLink published a core MCP library
(@tronlink/tronlink-mcp-core v0.1.0, March 2026) but it is explicitly a
building block, not a hosted service. MERX is the only TRON entry in the
coinbase/x402 ecosystem partner registry.
agent.merx.exchange is non-custodial: agents register their own TRON address
and MERX never holds private keys or controls funds. The ZMQ event listener
matches incoming TRC-20 transfers (USDT, USDC, USDD, plus any other token in
real time) and dispatches webhooks within ~3 seconds of on-chain confirmation.
watch() provides persistent 24/7 address monitoring with per-token filtering.
invoice() creates payment requests with payment links and automatic
detection. batch() sends up to 50 transfers in one call.
x402.merx.exchange implements the standard /verify, /settle, and
/supported endpoints, so any x402 client (including the Coinbase CDP
reference implementation) interoperates out of the box. Three settlement
schemes live on TRON mainnet: exact (direct TRC-20 transfer),
exact_permit and exact_gasfree (TIP-712 PermitTransfer through MERX's own
GasFreeController contract). USDT, USDC, and USDD all settled on mainnet
with verified txids and on-chain commission collection. Among 15 known x402
facilitators, MERX is the only one supporting the full TRON stablecoin set.
The MERX-deployed GasFreeController contract TKjJ1r5XYqnLZmLakcP3knis7Lh6gm3qtR
went live on mainnet 2026-04-08 with three verified mainnet permitTransfer
settlements (USDT, USDC, USDD). Agents send stablecoins from wallets that
hold zero TRX -- the controller pulls value+fee from a per-user GasFree
subaccount and the executor pays the broadcast gas. Single biggest UX barrier
for agents on TRON, removed.
Every write operation (TRC-20 transfer, token swap, contract call) automatically estimates energy AND bandwidth needed, buys the deficit at the best market price across 6 providers, waits for delegation to arrive on-chain, then executes. The agent never burns TRX unnecessarily. Tested on mainnet: a USDT transfer with auto-resources saves up to 94% compared to burning.
Before buying energy for swaps and contract calls, MERX simulates the exact
transaction via triggerConstantContract with real parameters. No hardcoded
estimates -- the precise energy amount is purchased. For a SunSwap V2 swap,
simulation returned 223,354 energy; the on-chain transaction used exactly
223,354.
"Keep 500,000 energy on my wallet. Buy when price drops below 55 SUN. Max 200 TRX per week."
The Policy Engine (powered by Anthropic Claude Sonnet 4) parses this instruction, generates structured standing orders with triggers, budget limits, and expiration, previews them for the user, and creates everything with one confirmation. Available through MCP, A2A skill, and REST endpoint. No competitor can replicate this without their own Anthropic integration, standing order infrastructure, and real-time provider price feeds.
All 6 active energy providers are aggregated (CatFee, Netts, TronSave, iTRX, PowerSun, TEM). Orders are routed to the cheapest source automatically. If one provider fails or runs out of capacity, the next cheapest fills the order. Prices cover both energy and bandwidth across every available duration tier.
Server-side 24/7 automation stored in PostgreSQL. Trigger types: price_below,
price_above, schedule (cron), balance_below, delegation_expiry.
Persists across restarts. Works when the client is offline. Auto-renew with
configurable max price.
The only TRON MCP server using all three MCP primitives: tools (66), prompts
(30), and resources (21 -- 14 static + 7 templates). Two transport modes:
hosted SSE (zero install) and local stdio (full key management). Three
protocol versions supported: 2024-11-05, 2025-03-26, 2025-06-18.
Key architecture principle: All traffic goes through the MERX platform. Users never need TronGrid API keys. MERX manages all RPC infrastructure, caching, and failover server-side. The only operation that stays on the client: transaction signing with a private key. Private keys never leave the client process.
This sequence diagram shows a real USDT transfer with auto-resource optimization. Numbers are from production testing.
Base URL: https://merx.exchange/api/v1
All endpoints are versioned. Errors follow a standard format:
{ "error": { "code": "...", "message": "...", "details": { ... } } }.
Idempotency-Key header supported on POST /orders and POST /withdraw.
Full API reference: merx.exchange/docs/api
MERX provides a full MCP (Model Context Protocol) server for AI agents. 66 tools across 18 categories, 30 pre-built prompts, and 21 live data resources.
Note: the tool catalog table below was last fully audited at 52 tools. Twelve newer tools (agent payment service, swap module, advanced standing orders) are documented at merx.exchange/docs/tools/mcp-server. The canonical count is 64, served by the live MCP server.
Pre-built conversation templates available in Claude Desktop prompt picker and via
prompts/get in any MCP client.
14 static resources + 7 URI templates. Attach to conversations as context or subscribe for real-time updates.
URI Templates:
Check prices and buy energy:
Resource-aware USDT transfer:
Market analysis:
All 66 tools with auth requirements. For input schemas and output examples, see docs/TOOLS.md.
Price Intelligence
Resource Estimation
Resource Trading
Account Management
Agent Convenience
On-chain Queries
Token Operations
Smart Contracts
Network Utilities
DEX Swaps
Onboarding
Payments
Intent Execution
Standing Orders and Monitors
Session Management
No SDK required. All endpoints accept JSON and return JSON.
Connect to wss://merx.exchange/ws for real-time price updates.
Register webhook endpoints to receive HTTP POST notifications for account events.
Security: Every webhook request includes an X-Merx-Signature header containing
an HMAC-SHA256 signature computed with your webhook secret. Verify this signature
before processing. Failed deliveries are retried with exponential backoff.
MERX supports three ways to pay for energy and bandwidth.
Deposit TRX to your MERX account via the dashboard at merx.exchange or via the API. Trade directly from your balance. Best for high-volume users and teams.
The agent deposits TRX to MERX from its own wallet using the deposit_trx tool or
API. The tool builds a TRX transfer with the correct memo, signs it locally, and
broadcasts. Balance is credited in 1-2 minutes.
No account needed. No pre-deposit. Create an invoice, pay with TRX from any wallet,
and receive energy delegation directly. Complete flow in one API call or one tool
call via create_paid_order.
See docs/PAYMENT-METHODS.md for detailed flow diagrams.
Server-side 24/7 automation stored in PostgreSQL. Persists across restarts. Works when the client is offline.
Trigger types:
Action types:
Example:
Watch delegations and resources on any address. Alert before expiry. Auto-renew with configurable max price.
Example:
Energy is the expensive resource on TRON. These numbers show the cost difference between burning TRX (no energy) and renting energy through MERX.
Numbers assume the cheapest available provider at time of order. Actual burn cost varies by recipient address state (whether it has held the token before).
1 TRX = 1,000,000 SUN. Energy is priced in SUN per unit. A USDT transfer needs approximately 65,000 energy units. At 22 SUN per unit, that is 65,000 x 22 = 1,430,000 SUN = 1.43 TRX. Without energy, the network burns 3-13 TRX from the sender depending on the recipient's account state.
All errors follow a standard format across API, SDKs, and MCP:
TRON_PRIVATE_KEY) or the
set_private_key tool in-session.set_private_key tool derives the TRON address automatically -- the user
only provides the 64-character hex key.MERX_API_KEY) or the set_api_key
tool in-session.create_account tool.Every capability was tested in production on TRON mainnet. These are not simulations -- every TX hash is verifiable on TronScan.
Factual comparison based on publicly available information.
MERX covers resource economics, transaction optimization, and general blockchain operations. Other servers focus on one area.
MIT. See LICENSE.
Source: README.md at commit 6bb1492
Get an executable MERX quote when resource, amount, fixed-grid duration and target_address are supplied. The response names the quoted provider. Without all four fields, returns raw provider observations labelled as non-executable analytics.
amountdurationresourcetarget_addressGet the exact executable MERX quote and quoted provider. Requires resource, amount, a fixed-grid duration, and target_address.
amountrequireddurationrequiredresourcerequiredtarget_addressrequiredMarket price analysis with trends and recommendations. No auth required.
resourceHistorical price snapshots. No auth required.
periodproviderresourceShow raw provider observations for market analytics. This tool does not identify an executable provider; use get_best_price for an executable quote.
resourceEstimate cost of a TRON transaction BEFORE sending. Aliases: estimate_cost, calculate_cost, transaction_cost, energy_cost, transfer_cost. Calculate exactly how much energy, bandwidth, and TRX a TRON transaction will cost before sending it. Use this to answer questions like "how much does a USDT transfer cost?" or "what will it cost me to send 100 USDT to address X?". Returns: energy units needed, bandwidth needed, TRX cost if you burn directly, and TRX cost if you rent energy from Merx (typically 70-80% cheaper). Supports trc20_transfer (e.g. USDT/USDC), trc20_approve, trx_transfer, and custom contract calls. No auth required.
amountoperationrequiredparameterto_addressfrom_addresstoken_addresscontract_addressfunction_selectorCheck energy, bandwidth, and TRX balance for any TRON address. No auth required.
addressrequiredBuy energy or bandwidth at the Merx market quote. Confirmed Merx funds and API key required; no commission.
amountrequiredduration_secrequiredmax_price_sunresource_typerequiredtarget_addressrequiredidempotency_keyrequiredGet order status by UUID. Aliases: get_order_status, check_order, order_status, order_details, fetch_order. Check the status and fill details of an existing order by its UUID. Returns current status (PENDING/FILLING/FILLED/PARTIAL/FAILED/CANCELLED), fill amounts, provider used, on-chain delegation tx hash if delivered. Use this to poll order progress after creating an order. Auth required (API key).
order_idrequiredList recent orders with optional status filter. Auth required.
limitstatusDeclarative resource provisioning. Checks current resources on target address and purchases only what is missing. Auth required.
duration_secenergy_minimumtarget_addressrequiredidempotency_keyrequiredbandwidth_minimumBlock until an order reaches a terminal state (FILLED, PARTIAL, FAILED, or CANCELLED) by polling get_order at fixed intervals. Use this right after create_order when you need to confirm the energy/bandwidth has actually been delegated on-chain before sending the next transaction. Returns the final order details including the on-chain delegation tx hash. Auth required.
order_idrequiredtimeout_secpoll_interval_secGet your Merx account balance (TRX, USDT, locked). Requires MERX_API_KEY.
Takes no parameters.
Get your personal TRON address for TRX deposits. No memo is required. Requires MERX_API_KEY.
Takes no parameters.
Get your Merx account transaction history. Requires MERX_API_KEY.
periodExplain a TRON or Merx concept in plain language. Hardcoded topics (exact match): energy, bandwidth, staking, delegation, sun_units, burn_vs_rent, merx_routing, provider_types. The lookup is fuzzy — substring matches also work, so "rent" finds "burn_vs_rent" and "providers" finds "provider_types". For topics outside this list (e.g. x402, stablecoins, gasfree), pick the closest hardcoded topic, or just answer the question yourself from the broader context — this tool only returns canned explanations of TRON resource economics.
topicrequiredRecommend a supported duration and return the executable MERX quote and quoted provider for a target address.
use_caserequiredtarget_addressrequiredtransaction_countCalculate savings from renting energy vs burning TRX. No authentication required.
operationtarget_addressrequiredtransaction_countList all Merx providers with types, durations, and availability. No authentication required.
Takes no parameters.
Inspect any TRON address. Aliases: check_address, get_address_info, get_wallet_info, address_info, account_status. Read the full on-chain state of ANY TRON address (does not have to be your own): TRX balance, free + delegated energy, free + delegated bandwidth, frozen TRX, account creation timestamp. Use this to check if an address has enough resources before sending a transaction, or to inspect any TRON wallet. No auth required, no API key needed.
addressrequiredQuick TRX balance for a TRON address. No auth required.
addressrequiredGet TRC-20 token balance for an address. Supports symbol (USDT, USDC) or contract address. No auth required.
tokenrequiredaddressrequiredLook up a transaction by ID on TRON. No auth required.
tx_idrequiredGet TRON block info by number (or latest if omitted). No auth required.
block_numberGet TRON network parameters (energy fee, bandwidth cost, etc.) with Merx price comparison. No auth required.
Takes no parameters.
Convert TRON address between base58 (T...) and hex (41...) formats. No auth required.
addressrequiredGet current TRX price from CoinGecko. No auth required.
currencyValidate a TRON address format and check on-chain status. No auth required.
addressrequiredGet on-chain transaction history for a TRON address. No auth required.
typelimitaddressrequiredSend TRX to an address. Checks bandwidth, buys via Merx if needed. Signs and broadcasts on-chain. Requires TRON_PRIVATE_KEY.
amount_trxrequiredto_addressrequiredresource_operation_idTransfer TRC-20 tokens with automatic energy optimization. Signs and broadcasts on-chain. Requires TRON_PRIVATE_KEY.
tokenrequiredamountrequiredto_addressrequiredresource_operation_idApprove TRC-20 spending allowance. Signs and broadcasts on-chain. Requires TRON_PRIVATE_KEY.
tokenrequiredamountrequiredspenderrequiredresource_operation_idGet TRC-20 token metadata: name, symbol, decimals, total supply. No auth required.
tokenrequiredCall a view/pure function on a TRON smart contract. No auth or private key required.
parametercontract_addressrequiredfunction_selectorrequiredEstimate energy and bandwidth cost for a smart contract call. Compares rental vs burn cost. No auth required.
parametercaller_addresscontract_addressrequiredfunction_selectorrequiredExecute a state-changing smart contract function. Estimates resources, buys via Merx if needed. Requires TRON_PRIVATE_KEY and TRON_ADDRESS.
parametercall_value_trxcontract_addressrequiredfunction_selectorrequiredresource_operation_idGet on-chain metadata for a TRON smart contract: existence check, owner address, energy origin, code hash, contract name (if set), ABI entries count. Use this to check whether an address is a contract before calling read_contract or estimate_contract_call. For TRC20-specific metadata (name, symbol, decimals, totalSupply) use get_token_info instead. No auth required.
addressrequiredGet a real swap quote from SunSwap V2. No auth required.
amountrequiredslippageto_tokenrequiredfrom_tokenrequiredExecute a token swap on SunSwap V2. Requires TRON_PRIVATE_KEY.
amountrequiredslippageto_tokenrequiredfrom_tokenrequiredresource_operation_idGet token price via SunSwap quote + CoinGecko USD rate. No auth required.
tokenrequiredCreate a new Merx account, generate an API key, and get deposit info. No auth needed.
emailrequiredpasswordrequiredLog in to an existing Merx account. No MERX_API_KEY needed.
emailrequiredpasswordrequiredSet your Merx API key for this session. Unlocks all authenticated tools (trading, balance, orders). Use this if you already have an API key.
api_keyrequiredSet your TRON private key for this session. Address is derived automatically. Enables write tools: transfer_trx, transfer_trc20, approve_trc20, execute_swap, deposit_trx. Key stays local - never sent to Merx servers.
private_keyrequiredSend a plain TRX transfer to your personal Merx deposit address. No memo is required. Broadcast acceptance does not mean the deposit is credited. Requires MERX_API_KEY + TRON_PRIVATE_KEY.
amount_trxrequiredConfigure automatic top-up when balance drops below a threshold. The configuration lives ONLY in the current MCP session — it is held in memory by the MCP server process and is lost on server restart, MCP client reconnect, or server redeploy. Top-ups are signed locally with TRON_PRIVATE_KEY and sent as plain TRX transfers to your personal Merx deposit address, without a memo. For persistent auto-deposit you currently need to call this tool again at the start of each session.
threshold_trxrequireddeposit_amount_trxrequiredmax_daily_depositsUnavailable legacy resource-invoice payment. No transaction is sent. Fund your personal Merx account and use quoted resource orders instead.
invoice_idrequiredUnavailable legacy resource-invoice order. No transaction is sent. Fund your personal Merx account and use quoted resource orders instead.
amountrequiredduration_secrequiredresource_typerequiredtarget_addressrequiredPlan a multi-step operation (transfer, swap, buy resources, etc) and return a cost estimate, total energy/bandwidth needed, and the cheapest resource acquisition strategy. NOTE: actual on-chain execution of multi-step intents is not yet wired up — currently returns the same plan as simulate, regardless of dry_run. Use this for planning; for real execution call the underlying tools (create_order, transfer_trc20, execute_swap) yourself in sequence. Auth required.
stepsrequireddry_runresource_strategyDry-run a multi-step operation (transfer, swap, buy resources, etc) without sending anything on-chain. Returns per-step energy and bandwidth estimates plus a total TRX cost. Use this to preview a plan before committing — for example, before transferring USDT to multiple recipients you can simulate to see the total energy cost. No auth required.
stepsrequiredresource_strategyCreate a server-side standing order with trigger-based automation. Auth required.
budget_trxrequiredexpires_ataction_typerequiredtrigger_typerequiredaction_paramsrequiredmax_executionsrequiredtrigger_paramsrequiredList all standing orders with optional status filter. Auth required.
statusGet full details of a single standing order by its UUID. Returns trigger config, action params, budget, executions count, and status. Auth required (API key).
order_idrequiredCancel a standing order by its UUID. The order is moved to CANCELLED status and will not trigger again. Already-executed actions are NOT reversed. Auth required (API key).
order_idrequiredCreate a persistent server-side monitor that fires notifications when a condition is met. Four monitor types: delegation_expiry (warns when leased energy is about to expire so you can re-rent), balance_threshold (fires when an address goes below a TRX/USDT level), price_alert (fires when energy/bandwidth price crosses a SUN threshold), address_activity (fires on any incoming TX). Notification defaults to webhook=true if omitted. Auth required (API key).
notifyparamsrequiredmonitor_typerequiredtarget_addressList all monitors you created with create_monitor, optionally filtered by status (ACTIVE/CANCELLED). Each row shows the full monitor UUID (pass to cancel_monitor), monitor type, target address, and status. Note: the Target column will be empty for monitor types that do not have a single watched address — specifically price_alert and balance_threshold (when watching the API key holder rather than a third-party address). For delegation_expiry and address_activity monitors, Target will always be set. Auth required (API key).
statusCancel an active monitor by its UUID. The monitor stops firing notifications. Auth required (API key).
monitor_idrequiredWithdraw TRX or USDT from your Merx account to an external TRON address. The "amount" parameter is interpreted in the currency specified by "currency" — i.e. for currency=TRX it is TRX units, for currency=USDT it is USDT units. (The legacy parameter "amount_trx" is still accepted as an alias for backwards compatibility, but is misleading when currency is USDT — prefer "amount" in new code.) Requires MERX_API_KEY.
amountaddressrequiredcurrencyamount_trxConvert a natural language energy management policy into MERX automation. Creates standing orders and monitors based on your instructions. Examples: - "Keep 500k energy on my wallet, buy when price is below 55 SUN, max 200 TRX/week" - "Buy energy every day at 6 AM UTC, 1 million units, for 24 hours" - "Alert me when my energy drops below 100k" Returns a preview of what will be created. Set apply=true to execute.
applyaddressinstructionrequiredBroadcast a signed TRON transaction with automatic energy optimization. If the target address lacks sufficient energy, MERX purchases the deficit at the best market price before broadcasting. One call: estimate, buy energy, wait for delegation, broadcast. Requires MERX_API_KEY with the "broadcast" scope, and a pre-signed transaction. Returns txid on success, refunds on timeout. NOTE: This endpoint is currently behind a feature flag and disabled by default in production. If you get a 503 MAINTENANCE error, use the manual flow instead: call ensure_resources to provision energy, then sign and broadcast the transaction with your own TronWeb client.
signed_txrequiredtarget_addressrequiredRegister your TRON address as an agent on agent.merx.exchange. Required ONCE before using request_payment, create_invoice, watch_address, agent_status, or any other agent payment tool. Pass the TRON address you want to use as the on-chain identity for this API key. Idempotent — calling twice with the same key returns the existing registration. Auth required (API key).
labeltron_addressrequiredCreate a TRC20 payment request on TRON (USDT, USDC, USDD, or any TRC20). Returns a payment address. Fires webhook when payment arrives (<3 seconds). Use for receiving payments from other agents or humans. Requires agent registration first — call register_agent if you get AGENT_NOT_REGISTERED error.
amount_usdtrequireddescriptionwebhook_urltolerance_pcttimeout_secondsLook up a MERX invoice. Shows amount, recipient, token, and status. Agent must sign and broadcast the transfer separately (non-custodial).
invoice_idrequiredCreate an invoice for another agent or human to pay. Returns payment URL, address, and QR code. Payment is detected automatically via ZeroMQ (<3 seconds).
expires_inamount_usdtrequireddescriptionWatch any TRON address for TRC20 transfers (USDT, USDC, USDD, or any token). Fires webhook on each matching transfer. Persistent - runs 24/7 even when conversation ends.
addressrequiredttl_hoursevent_typeswebhook_urlrequiredmin_amount_usdtGet a snapshot of your agent payment service: registered TRON address, count of pending payment requests (request_payment), active address watches (watch_address), and outstanding invoices (create_invoice). Use this right after register_agent to confirm the agent is set up, or any time you want to see how much in-flight activity your agent has. Auth required (API key) and agent must be registered first via register_agent.
Takes no parameters.
100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
Published by GitHub account Hovsteder
Remote MCP server for the PowerSun TRON marketplace that lets an assistant price, buy and sell TRON Energy and Bandwidth, swap TRC-20 tokens, and manage selling
Published by GitHub account BricePourLe13
Remote MCP server for European business data, letting an assistant check French companies, validate EU VAT numbers and search legal information.
npm install merx-sdkimport { MerxClient } from 'merx-sdk'
const merx = new MerxClient({ apiKey: 'merx_sk_your_key' })
// Get current prices from all providersconst prices = await merx.prices.list()console.log(prices[0])// { provider: "netts", price_sun: 22, available: 100000000 }
// Buy energy at best priceconst 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.4311from 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...")# Public -- no auth requiredcurl https://merx.exchange/api/v1/prices
# Authenticatedcurl -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..." }'/plugin marketplace add Hovsteder/merx-claude-plugin/plugin install merx@merx{ "mcpServers": { "merx": { "url": "https://merx.exchange/mcp/sse" } }}set_api_key("merx_sk_your_key")-> All 34 authenticated tools unlocked for this session.set_private_key("your_64_char_hex_key")-> Address derived automatically. All 66 tools available.-> Key never leaves your machine.npm install -g merx{ "mcpServers": { "merx": { "command": "npx merx-mcp", "env": { "MERX_API_KEY": "merx_sk_your_key", "TRON_PRIVATE_KEY": "your_private_key" } } }}graph TB User[User / Application / AI Agent] Platform[MERX Platform<br>merx.exchange] PM[Price Monitor<br>polls every 30s] OE[Order Executor<br>routes to cheapest] DV[Delegation Verifier<br>confirms on-chain] TR[Treasury<br>balance management] RPC[TronGrid / GetBlock<br>TRON RPC] Providers[Energy Providers<br>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<br>cheapest first| Providers DV -->|Verify delegations| RPC RPC --> TRON Providers -->|Delegate energy<br>+ 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:#F5F0E8User / 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 vTronGrid / GetBlock Energy Providers(TRON RPC) (all connected) | | v v+----------------------------------+| TRON Blockchain |+----------------------------------+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)<br>Bandwidth: 345 < 1,500 min order, skip M->>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.<br>Burn alternative: 3.66 TRX. Savings: 87.6%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 < 1,500 min -> skip, burn ~0.3 TRX]| | | | | | | route to cheapest | | | |---------------------->| | | | FILLED 22 SUN | | | | 1.43 TRX | | | |<----------------------| | | | | | | | [poll until delegation arrives] | | | | | | | verify delegation |--------------------->| | | energy: 65,050 |<---------------------| | | | | | | [sign + broadcast] | | | |---------------------->|--------------------->| | | | TX confirmed | | |<----------------------|<---------------------| | | | | | USDT sent | | | | Cost: 1.43 TRX | | | | Burn alt: 3.66 TRX | | | | Savings: 87.6% | | | |<----------------------| | |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).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.npm install merx-sdkimport { MerxClient } from 'merx-sdk'
const merx = new MerxClient({ apiKey: 'merx_sk_your_key' })
// 4 modules: prices, orders, balance, webhooksconst 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()pip install merx-sdkfrom merx import MerxClient
merx = MerxClient(api_key="merx_sk_your_key")
# Same 4 modules, snake_caseprices = 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()# Get prices (public, no auth)curl https://merx.exchange/api/v1/prices
# Get best price for energycurl 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 balancecurl https://merx.exchange/api/v1/balance \ -H "Authorization: Bearer merx_sk_your_key"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, ... }}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"]}'# Check balancecurl 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 }deposit_trx(amount: 10)-> TX: 4bc60854f828...8ddcd509-> 10 TRX deposited. Will be credited to your MERX balance shortly.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...create_standing_order( trigger: { type: "price_below", resource: "ENERGY", threshold_sun: 20 }, action: { type: "buy_resource", amount: 65000, duration_sec: 300 }, target_address: "TLyqz...", max_executions: 10, budget_trx: 15)
-> Standing Order: so_a1b2c3d4-> Status: ACTIVE-> Trigger: ENERGY price < 20 SUN-> Action: Buy 65,000 energy (5m)-> Budget: 15 TRX (10 executions max)create_monitor( type: "delegation_expiry", address: "TLyqz...", resource: "ENERGY", alert_before_sec: 300, auto_renew: true, max_price_sun: 30)
-> Monitor: mon_e5f6g7h8-> Status: ACTIVE-> Type: delegation_expiry-> Alert: 5 minutes before expiry-> Auto-renew: Yes (max 30 SUN){ "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 } }}