MCP Examples

10 ready-to-use examples. Copy the user message, paste into Claude Desktop or any MCP client connected to MERX.

1

Check Energy Prices

Get real-time prices from all providers, sorted by cheapest.

None
You

What is the cheapest energy right now?

Agent
get_prices
Cheapest energy: 22 SUN from Netts (5-min delegation)
For 65,000 energy: 1.43 TRX

All providers:
  Netts:     22 SUN (5m), 27 SUN (1h), 30 SUN (1d)
  CatFee:   25 SUN (1h), 28 SUN (1d), 32 SUN (3d)
  Sohu:     26 SUN (1h), 30 SUN (1d)
  PowerSun: 24 SUN (1h), 27 SUN (1d), 35 SUN (7d)
2

Buy Energy at Best Price

Purchase energy routed to the cheapest available provider.

API key
You

Buy 65,000 energy for TLyqzZopGCP78s5woNxb4n9frmcjA2RhFb

Agent
create_order
Order filled.
  Amount: 65,050 energy
  Provider: Netts
  Cost: 1.43 TRX (22 SUN/unit)
  Duration: 5 minutes
  TX: 27ab0019f4e3... (verified on-chain)
  Status: FILLED
3

Send USDT with Auto Energy

Transfer USDT with automatic energy purchase. Saves up to 94% vs burning.

API key + Private key
You

Send 100 USDT to TAddr

Agent
estimate_transaction_costcheck_address_resourcescreate_ordertransfer_trc20
USDT sent.
  Amount: 100.00 USDT
  Energy used: 7,896 (bought 65,000 at 22 SUN)
  Energy cost: 1.43 TRX
  Burn alternative: 3.66 TRX
  Savings: 60.9%
  TX: 8c3f1ab2e5d9...
4

Swap Tokens on SunSwap

Execute a DEX swap with exact energy simulation. No hardcoded estimates.

Private key
You

Swap 500 TRX for USDT

Agent
get_swap_quoteexecute_swap
Swap executed.
  Sold: 500 TRX
  Received: 39.42 USDT
  Rate: 1 TRX = 0.0788 USDT
  Slippage: 0.12%
  Energy: 223,354 (simulated exactly)
  TX: f7a2c890d134...
5

Check Wallet Balance

Full on-chain account overview: TRX, tokens, energy, bandwidth.

None
You

Check the balance of TLyqzZopGCP78s5woNxb4n9frmcjA2RhFb

Agent
get_account_infoget_trc20_balance
Account: TLyqz...RhFb
  TRX: 1,250.50
  USDT: 5,420.00
  Energy: 12,000 / 65,000 (limit)
  Bandwidth: 600 (free)
  Staked: 10,000 TRX
  Created: 2024-01-15
6

Market Analysis

Price trends, percentile ranking, and buy/sell recommendation.

None
You

Is now a good time to buy energy?

Agent
analyze_prices
Energy market analysis:
  Current best: 22 SUN (Netts)
  7-day average: 62 SUN
  Percentile: 1st (cheaper than 99% of the week)
  Trend: falling
  Recommendation: Good time to buy.
  Price is 64% below the weekly average.
7

Automate with Standing Orders

Server-side 24/7 automation. Triggers when conditions are met.

API key
You

Buy 65,000 energy whenever price drops below 20 SUN, max 5 times, budget 10 TRX

Agent
create_standing_order
Standing order created.
  ID: so_8f2a1b3c
  Trigger: price_below 20 SUN (ENERGY)
  Action: buy 65,000 energy for TAddr
  Budget: 10.00 TRX
  Max executions: 5
  Status: ACTIVE
  Runs 24/7 on server, works when client is offline.
8

Estimate Transaction Costs

Calculate energy and bandwidth needs before executing.

None
You

How much energy does a USDT transfer need?

Agent
estimate_transaction_cost
USDT transfer estimate:
  Energy: 7,896 units
  Bandwidth: 345 bytes
  With rented energy (22 SUN): 0.17 TRX
  Without energy (burn): 3.66 TRX
  Savings: 95.4%
  Note: first-time recipients use ~29,000 energy.
9

Calculate Bulk Savings

Compare renting vs burning for high-volume operations.

None
You

How much would I save on 1000 USDT transfers?

Agent
calculate_savings
Savings for 1,000 USDT transfers:
  Burn cost: 3,660 TRX ($292.80)
  Rental cost: 170 TRX ($13.60)
  Savings: 3,490 TRX ($279.20)
  Reduction: 95.4%
  Rental includes energy at 22 SUN for 65,000 units.
10

Pay-per-Use (No Account)

Buy energy without creating an account. Pay with TRX from any wallet.

Private key
You

Buy 65,000 energy for TAddr without an account

Agent
create_paid_order
x402 order complete.
  Invoice: inv_9d4e2f1a
  Payment: 1.43 TRX sent to MERX treasury
  Payment TX: a1b2c3d4e5f6...
  Delegation: 65,050 energy to TAddr
  Delegation TX: 7g8h9i0j1k2l...
  No account needed. No deposit. One-step.

Try It Now

Add MERX to your MCP client. 22 tools work immediately, no keys needed.

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