# MERX

TRON resource exchange for AI agents. 52 tools for energy trading, token transfers, DEX swaps, and on-chain queries.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add powersun/merx

# Browse available tools
npx -y @smithery/cli@latest tool list powersun/merx

# Get full schema for a tool
npx -y @smithery/cli@latest tool get powersun/merx get_prices

# Call a tool
npx -y @smithery/cli@latest tool call powersun/merx get_prices '{}'
```

## Direct MCP Connection

Endpoint: `https://merx.run.tools`

## Tools (52)

- `get_prices` — Get current energy and bandwidth prices from all Merx providers. No auth required.
- `get_best_price` — Find the cheapest provider for a given resource and amount. No auth required.
- `analyze_prices` — Market price analysis with trends and recommendations. No auth required.
- `get_price_history` — Historical price snapshots. No auth required.
- `compare_providers` — Side-by-side provider comparison with prices and availability. No auth required.
- `estimate_transaction_cost` — Estimate energy and bandwidth cost for a TRON transaction. Compares rental vs burn cost. No auth required.
- `check_address_resources` — Check energy, bandwidth, and TRX balance for any TRON address. No auth required.
- `create_order` — Buy energy or bandwidth on Merx. Routed to cheapest provider. Auth required.
- `get_order` — Get order details and fill status by ID. Auth required.
- `list_orders` — List recent orders with optional status filter. Auth required.
- `ensure_resources` — Declarative resource provisioning. Checks current resources on target address and purchases only what is missing. Auth …
- `get_balance` — Get your Merx account balance (TRX, USDT, locked). Requires MERX_API_KEY.
- `get_deposit_info` — Get your Merx deposit address and memo. Requires MERX_API_KEY.
- `get_transaction_history` — Get your Merx account transaction history. Requires MERX_API_KEY.
- `explain_concept` — Explain a TRON or Merx concept. No authentication required.
- `suggest_duration` — Recommend a rental duration based on your use case. No authentication required.
- `calculate_savings` — Calculate savings from renting energy vs burning TRX. No authentication required.
- `list_providers` — List all Merx providers with types, durations, and availability. No authentication required.
- `get_account_info` — Full on-chain account state: TRX balance, energy, bandwidth, creation date. No auth required.
- `get_trx_balance` — Quick TRX balance for a TRON address. No auth required.
- `get_trc20_balance` — Get TRC-20 token balance for an address. Supports symbol (USDT, USDC) or contract address. No auth required.
- `get_transaction` — Look up a transaction by ID on TRON. No auth required.
- `get_block` — Get TRON block info by number (or latest if omitted). No auth required.
- `get_chain_parameters` — Get TRON network parameters (energy fee, bandwidth cost, etc.) with Merx price comparison. No auth required.
- `convert_address` — Convert TRON address between base58 (T...) and hex (41...) formats. No auth required.
- `get_trx_price` — Get current TRX price from CoinGecko. No auth required.
- `validate_address` — Validate a TRON address format and check on-chain status. No auth required.
- `search_transaction_history` — Get on-chain transaction history for a TRON address. No auth required.
- `transfer_trx` — Send TRX to an address. Checks bandwidth, buys via Merx if needed. Signs and broadcasts on-chain. Requires TRON_PRIVATE…
- `transfer_trc20` — Transfer TRC-20 tokens with automatic energy optimization. Signs and broadcasts on-chain. Requires TRON_PRIVATE_KEY.
- `approve_trc20` — Approve TRC-20 spending allowance. Signs and broadcasts on-chain. Requires TRON_PRIVATE_KEY.
- `get_token_info` — Get TRC-20 token metadata: name, symbol, decimals, total supply. No auth required.
- `read_contract` — Call a view/pure function on a TRON smart contract. No auth or private key required.
- `estimate_contract_call` — Estimate energy and bandwidth cost for a smart contract call. Compares rental vs burn cost. No auth required.
- `call_contract` — Execute a state-changing smart contract function. Estimates resources, buys via Merx if needed. Requires TRON_PRIVATE_K…
- `get_swap_quote` — Get a real swap quote from SunSwap V2. No auth required.
- `execute_swap` — Execute a token swap on SunSwap V2. Requires TRON_PRIVATE_KEY.
- `get_token_price` — Get token price via SunSwap quote + CoinGecko USD rate. No auth required.
- `create_account` — Create a new Merx account, generate an API key, and get deposit info. No auth needed.
- `login` — Log in to an existing Merx account. No MERX_API_KEY needed.
- `set_api_key` — Set your Merx API key for this session. Unlocks all authenticated tools (trading, balance, orders). Use this if you alr…
- `set_private_key` — Set your TRON private key for this session. Address is derived automatically. Enables write tools: transfer_trx, transf…
- `deposit_trx` — Deposit TRX to your Merx account. Requires MERX_API_KEY + TRON_PRIVATE_KEY.
- `enable_auto_deposit` — Configure automatic top-up when balance drops below a threshold. Session-only.
- `pay_invoice` — Pay an x402 invoice by sending TRX and verifying payment.
- `create_paid_order` — Create a zero-registration order via x402 pay-per-use. Requires TRON_PRIVATE_KEY.
- `execute_intent` — Execute a multi-step operation (transfer, swap, buy resources, etc). Validates and simulates all steps with resource co…
- `simulate` — Simulate a multi-step operation without executing. Returns resource estimates and costs.
- `create_standing_order` — Create a server-side standing order with trigger-based automation. Auth required.
- `list_standing_orders` — List all standing orders with optional status filter. Auth required.
- `create_monitor` — Create a persistent monitor (delegation expiry, balance, price alert). Auth required.
- `list_monitors` — List all monitors with optional status filter. Auth required.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get powersun/merx <tool-name>
```

## Resources

- `merx://prices/energy` — Energy prices from all providers, sorted cheapest first
- `merx://prices/bandwidth` — Bandwidth prices from providers that offer it
- `merx://prices/best` — Best energy + bandwidth price with USDT transfer cost
- `merx://market/analysis` — Price trends, averages, and buy/wait recommendation
- `merx://market/providers` — All providers with type, durations, resources, status
- `merx://market/providers/status` — Provider health: online/offline, available supply
- `merx://account/balance` — Merx balance: TRX available, locked, USDT
- `merx://account/orders/recent` — Last 10 orders with status and cost
- `merx://account/stats` — 30-day stats: total spent, saved, order count
- `merx://account/auto-deposit` — Auto-deposit threshold and amount configuration
- `merx://network/parameters` — TRON network parameters: burn prices, energy limit
- `merx://network/trx-price` — Current TRX price in USD
- `merx://reference/tokens` — Well-known TRC20 tokens: addresses, decimals
- `merx://standing-orders/active` — Active standing orders with trigger status

## Prompts (30)

- `buy-energy` (amount, target_address, duration) — Buy TRON energy at the best market price
- `buy-bandwidth` (amount, target_address, duration) — Buy TRON bandwidth at the best market price
- `ensure-resources` (target_address, energy, bandwidth, duration) — Guarantee minimum energy + bandwidth on an address
- `market-analysis` — Full TRON energy and bandwidth market analysis
- `compare-providers` (resource, amount, frequency) — Deep comparison of providers for a specific use case
- `send-usdt` (to_address, amount) — Send USDT (TRC-20) to a TRON address with optimized fees
- `send-trx` (to_address, amount) — Send TRX to a TRON address
- `send-token` (token, to_address, amount) — Send any TRC-20 token to a TRON address

---
*Response truncated. Use `npx -y @smithery/cli@latest` for complete data.*
