ASCII diagram (if Mermaid does not render)

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

\n\n**Key architecture principle:** All traffic goes through the MERX platform. Users\nnever need TronGrid API keys. MERX manages all RPC infrastructure, caching, and\nfailover server-side. The only operation that stays on the client: transaction\nsigning with a private key. Private keys never leave the client process.\n\n### Resource-aware transaction flow\n\nThis sequence diagram shows a real USDT transfer with auto-resource optimization.\nNumbers are from production testing.\n\n```mermaid\nsequenceDiagram\n participant C as Client\n participant M as MERX\n participant P as Providers\n participant T as TRON\n\n C->>M: POST /orders or transfer_trc20(USDT, 100, TAddr)\n M->>M: POST /estimate (trc20_transfer)\n Note over M: energy: 7,896 / bandwidth: 345\n M->>M: GET /chain/resources/TSender\n Note over M: energy: 0 / bandwidth: 0 / free BW: 600\n Note over M: Energy deficit: 7,896 (round up to 65,000 min)
Bandwidth: 345 < 1,500 min order, skip\n M->>P: Route order: ENERGY, 65,000, 300s\n P-->>M: FILLED at 22 SUN (1.43 TRX)\n Note over M: Poll every 2s until delegation arrives\n M->>T: Verify delegation on sender address\n T-->>M: energy: 65,050 available\n Note over M: Sign TX (client-side if MCP, server-side if API)\n M->>T: Broadcast signed TX\n T-->>M: TX confirmed\n M-->>C: USDT sent. Cost: 1.43 TRX.
Burn alternative: 3.66 TRX. Savings: 87.6%\n```\n\n

ASCII diagram (if Mermaid does not render)

\n\n```\nClient MERX Providers TRON\n | | | |\n | order / transfer | | |\n |---------------------->| | |\n | | estimate energy+BW | |\n | | energy: 7,896 | |\n | | bandwidth: 345 | |\n | | | |\n | | check sender resources| |\n | | energy: 0, BW: 0 | |\n | | | |\n | | [deficit: 7,896 -> round up to 65,000] |\n | | [BW: 345 < 1,500 min -> skip, burn ~0.3 TRX]|\n | | | |\n | | route to cheapest | |\n | |---------------------->| |\n | | FILLED 22 SUN | |\n | | 1.43 TRX | |\n | |<----------------------| |\n | | | |\n | | [poll until delegation arrives] |\n | | | |\n | | verify delegation |--------------------->|\n | | energy: 65,050 |<---------------------|\n | | | |\n | | [sign + broadcast] | |\n | |---------------------->|--------------------->|\n | | | TX confirmed |\n | |<----------------------|<---------------------|\n | | | |\n | USDT sent | | |\n | Cost: 1.43 TRX | | |\n | Burn alt: 3.66 TRX | | |\n | Savings: 87.6% | | |\n |<----------------------| | |\n```\n\n

\n\n### Resource purchase rules\n\n| Rule | Details |\n|---|---|\n| Energy deficit > 0 | Round up to minimum 65,000 units. Cheaper to buy minimum than to burn even small deficits. |\n| Bandwidth deficit < 1,500 | Skip purchase, let network burn ~0.3 TRX. Cheaper than minimum bandwidth order. |\n| After energy purchase | Poll `check_address_resources` every 2 seconds until delegation arrives on-chain. Never broadcast TX before delegation is confirmed. |\n| DEX swaps | Simulate exact energy via `triggerConstantContract` with real swap parameters. No hardcoded estimates. |\n\n---\n\n## API overview\n\nBase URL: `https://merx.exchange/api/v1`\n\nAll endpoints are versioned. Errors follow a standard format:\n`{ \"error\": { \"code\": \"...\", \"message\": \"...\", \"details\": { ... } } }`.\nIdempotency-Key header supported on `POST /orders` and `POST /withdraw`.\n\n### Public endpoints (no authentication)\n\n| Method | Endpoint | Description |\n|---|---|---|\n| GET | `/prices` | Current energy and bandwidth prices from all providers |\n| GET | `/prices/best` | Cheapest provider for given resource and amount |\n| GET | `/prices/history` | Historical price snapshots by provider and period |\n| GET | `/prices/stats` | Price statistics: min, max, average, percentiles |\n| GET | `/prices/analysis` | Market analysis with trends and recommendations |\n| GET | `/orders/preview` | Preview order cost without creating it |\n| POST | `/estimate` | Estimate energy and bandwidth for any transaction type |\n| GET | `/chain/account/:address` | On-chain account info |\n| GET | `/chain/resources/:address` | Energy, bandwidth, and free BW for any address |\n| GET | `/chain/transaction/:txid` | Transaction details by ID |\n| GET | `/chain/block/:number` | Block info by number or latest |\n| GET | `/chain/parameters` | TRON network parameters |\n\n### Authenticated endpoints (API key required)\n\n| Method | Endpoint | Description |\n|---|---|---|\n| POST | `/orders` | Create order -- routed to cheapest provider |\n| GET | `/orders` | List orders with optional status filter |\n| GET | `/orders/:id` | Order details with fills, TX hashes, verification |\n| GET | `/balance` | MERX account balance (TRX, USDT, locked) |\n| GET | `/deposit/info` | Deposit address and memo |\n| POST | `/withdraw` | Withdraw TRX to external address |\n| GET | `/history` | Account transaction history |\n| GET | `/history/summary` | History summary with totals |\n| POST | `/keys` | Create new API key |\n| GET | `/keys` | List API keys |\n| DELETE | `/keys/:id` | Revoke API key |\n| POST | `/webhooks` | Register webhook endpoint |\n| GET | `/webhooks` | List registered webhooks |\n| DELETE | `/webhooks/:id` | Remove webhook |\n| POST | `/ensure` | Ensure minimum resources on an address |\n| POST | `/standing-orders` | Create server-side standing order |\n| GET | `/standing-orders` | List standing orders |\n| POST | `/monitors` | Create delegation or balance monitor |\n| GET | `/monitors` | List monitors |\n\n### x402 endpoints (zero registration)\n\n| Method | Endpoint | Description |\n|---|---|---|\n| POST | `/x402/invoice` | Create payment invoice |\n| POST | `/x402/verify` | Verify invoice payment |\n\nFull API reference: [merx.exchange/docs/api](https://merx.exchange/docs/api)\n\n---\n\n## MCP server\n\nMERX provides a full MCP (Model Context Protocol) server for AI agents. 66 tools\nacross 18 categories, 30 pre-built prompts, and 21 live data resources.\n\n> **Note:** the tool catalog table below was last fully audited at 52 tools.\n> Twelve newer tools (agent payment service, swap module, advanced standing\n> orders) are documented at [merx.exchange/docs/tools/mcp-server](https://merx.exchange/docs/tools/mcp-server).\n> The canonical count is **64**, served by the live MCP server.\n\n### Tool categories\n\n| Category | Count | Auth | Description |\n|---|---|---|---|\n| Price Intelligence | 5 | -- | Real-time prices from all providers, market analysis, trends, history |\n| Resource Estimation | 2 | -- | Estimate energy + bandwidth for any transaction type |\n| Resource Trading | 4 | API key | Buy energy/bandwidth at best price, ensure resources on any address |\n| Account Management | 3 | API key | Balance, deposit info, transaction history |\n| Agent Convenience | 4 | -- | Explain concepts, suggest durations, calculate savings, list providers |\n| On-chain Queries | 5 | -- | Account info, TRX/TRC20 balances, transaction lookup, blocks |\n| Token Operations | 4 | Private key | Send TRX, transfer TRC20, approve tokens -- all resource-aware |\n| Smart Contracts | 3 | Mixed | Read contract state, estimate call cost, execute with auto-resources |\n| Network Utilities | 5 | -- | Chain parameters, address tools, TRX price, on-chain history |\n| DEX Swaps | 3 | Private key | SunSwap V2 quotes, execution with exact energy simulation |\n| Onboarding | 2 | -- | Create account + login, no browser needed |\n| Payments | 4 | Mixed | Self-deposit, auto-deposit config, x402 pay-per-use |\n| Intent Execution | 2 | Mixed | Multi-step plans: simulate or execute complex sequences |\n| Standing Orders | 4 | API key | Server-side 24/7 automation: price triggers, cron, monitors |\n| Session Management | 2 | -- | Set API key and private key for current session |\n| **Total** | **52** | | |\n\n### Prompts (30)\n\nPre-built conversation templates available in Claude Desktop prompt picker and via\n`prompts/get` in any MCP client.\n\n| Group | Prompts | Examples |\n|---|---|---|\n| Market (5) | buy-energy, buy-bandwidth, ensure-resources, market-analysis, compare-providers | \"Buy energy at best market price\" |\n| Transactions (5) | send-usdt, send-trx, send-token, multi-transfer, explain-transaction | \"Send USDT with auto resource optimization\" |\n| Wallet (4) | check-wallet, audit-spending, monitor-delegations, optimize-wallet | \"Full wallet overview with balances and delegations\" |\n| DEX (3) | swap-tokens, check-token, price-check | \"Swap tokens via SunSwap\" |\n| Planning (3) | estimate-costs, budget-plan, stake-vs-rent | \"Plan energy budget for a period\" |\n| Developer (2) | integrate-merx, setup-mcp | \"How to integrate MERX API\" |\n| Onboarding (2) | onboard, fund-account | \"Create account and get started\" |\n| Payments (2) | setup-auto-funding, buy-without-account | \"x402 zero-registration purchase\" |\n| Simulation (2) | simulate-plan, execute-plan | \"Simulate a multi-step plan\" |\n| Monitoring (2) | setup-standing-order, auto-renew-delegations | \"Set up auto-renewal for delegations\" |\n\n### Resources (21)\n\n14 static resources + 7 URI templates. Attach to conversations as context or\nsubscribe for real-time updates.\n\n| Resource | URI | Updates |\n|---|---|---|\n| Energy prices | `merx://prices/energy` | Every 30s |\n| Bandwidth prices | `merx://prices/bandwidth` | Every 30s |\n| Best price | `merx://prices/best` | Every 30s |\n| Market analysis | `merx://market/analysis` | Every 5m |\n| Provider list | `merx://market/providers` | Every 30s |\n| Provider status | `merx://market/providers/status` | Every 30s |\n| Account balance | `merx://account/balance` | On change |\n| Recent orders | `merx://account/orders/recent` | On change |\n| Account stats | `merx://account/stats` | Every 5m |\n| Auto-deposit config | `merx://account/auto-deposit` | On change |\n| Network parameters | `merx://network/parameters` | Every 1h |\n| TRX price | `merx://network/trx-price` | Every 1m |\n| Token reference | `merx://reference/tokens` | Static |\n| Standing orders | `merx://standing-orders/active` | On change |\n\n**URI Templates:**\n\n| Template | Description |\n|---|---|\n| `merx://address/{address}/overview` | Full address state: TRX, tokens, energy, bandwidth |\n| `merx://address/{address}/resources` | Energy + bandwidth with free BW tracking |\n| `merx://address/{address}/transactions` | Recent transactions with type and amounts |\n| `merx://address/{address}/delegations` | Active delegations with expiry times |\n| `merx://token/{token}/info` | Token metadata + price + transfer energy cost |\n| `merx://order/{order_id}/status` | Order details with fills and cost breakdown |\n| `merx://standing-order/{id}/status` | Standing order trigger state and executions |\n\n### Example conversations\n\n**Check prices and buy energy:**\n\n```\nUser: What is the cheapest energy right now?\nAgent: [calls get_prices] Cheapest energy is 22 SUN from Netts (5-minute\n delegation). For 65,000 energy, that is 1.43 TRX.\nUser: Buy it for TLyqz...\nAgent: [calls create_order] Done. 65,050 energy delegated via Netts.\n Cost: 1.43 TRX. TX: 27ab0019... (verified on-chain).\n```\n\n**Resource-aware USDT transfer:**\n\n```\nUser: Send 100 USDT to TAddr.\nAgent: [calls transfer_trc20] MERX estimated 7,896 energy needed,\n bought 65,000 at 22 SUN, waited for delegation, signed and\n broadcast. USDT sent. Cost: 1.43 TRX instead of 3.66 TRX.\n Savings: 87.6%.\n```\n\n**Market analysis:**\n\n```\nUser: Is now a good time to buy energy?\nAgent: [calls analyze_prices] Energy is at 22 SUN -- the 1st percentile\n of the last 7 days. 64% below the weekly average of 62 SUN.\n Trend: falling. Recommendation: good time to buy.\n```\n\n### Full tool reference\n\nAll 66 tools with auth requirements. For input schemas and output examples, see\n[docs/TOOLS.md](https://github.com/Hovsteder/merx-mcp/blob/main/docs/TOOLS.md).\n\n**Price Intelligence**\n\n| # | Tool | Description | Auth |\n|---|---|---|---|\n| 1 | `get_prices` | Current energy and bandwidth prices from all providers | -- |\n| 2 | `get_best_price` | Cheapest provider for given resource and amount | -- |\n| 3 | `analyze_prices` | Market analysis with trends, percentile, and recommendation | -- |\n| 4 | `get_price_history` | Historical price snapshots by provider, resource, and period | -- |\n| 5 | `compare_providers` | Side-by-side provider comparison with all duration tiers | -- |\n\n**Resource Estimation**\n\n| # | Tool | Description | Auth |\n|---|---|---|---|\n| 6 | `estimate_transaction_cost` | Estimate energy + bandwidth for TRX/TRC20/custom operations | -- |\n| 7 | `check_address_resources` | Energy, bandwidth, free BW, and TRX balance for any address | -- |\n\n**Resource Trading**\n\n| # | Tool | Description | Auth |\n|---|---|---|---|\n| 8 | `create_order` | Buy energy or bandwidth, routed to cheapest provider | API key |\n| 9 | `get_order` | Order details with fills, TX hashes, and verification status | API key |\n| 10 | `list_orders` | List orders with optional status filter | API key |\n| 11 | `ensure_resources` | Declarative: ensure minimum energy/bandwidth on an address | API key |\n\n**Account Management**\n\n| # | Tool | Description | Auth |\n|---|---|---|---|\n| 12 | `get_balance` | MERX account balance (TRX, USDT, locked) | API key |\n| 13 | `get_deposit_info` | MERX deposit address and memo | API key |\n| 14 | `get_transaction_history` | MERX account order history (7D/30D/90D) | API key |\n\n**Agent Convenience**\n\n| # | Tool | Description | Auth |\n|---|---|---|---|\n| 15 | `explain_concept` | Explain TRON concepts: energy, bandwidth, staking, delegation, sun_units | -- |\n| 16 | `suggest_duration` | Recommend rental duration based on use case and TX count | -- |\n| 17 | `calculate_savings` | Calculate savings from renting vs burning for N transactions | -- |\n| 18 | `list_providers` | All providers with types, durations, and availability | -- |\n\n**On-chain Queries**\n\n| # | Tool | Description | Auth |\n|---|---|---|---|\n| 19 | `get_account_info` | Full on-chain account: TRX, energy, bandwidth, limits | -- |\n| 20 | `get_trx_balance` | Quick TRX balance for any address | -- |\n| 21 | `get_trc20_balance` | TRC-20 token balance (supports symbol or contract address) | -- |\n| 22 | `get_transaction` | Look up transaction by ID with status, energy, bandwidth used | -- |\n| 23 | `get_block` | Block info by number (or latest) | -- |\n\n**Token Operations**\n\n| # | Tool | Description | Auth |\n|---|---|---|---|\n| 24 | `transfer_trx` | Send TRX with auto bandwidth optimization | Private key |\n| 25 | `transfer_trc20` | Transfer TRC-20 tokens with auto energy + bandwidth | Private key |\n| 26 | `approve_trc20` | Approve TRC-20 spending allowance with auto energy | Private key |\n| 27 | `get_token_info` | Token metadata: name, symbol, decimals, total supply | -- |\n\n**Smart Contracts**\n\n| # | Tool | Description | Auth |\n|---|---|---|---|\n| 28 | `read_contract` | Call view/pure contract functions (no gas, no signing) | -- |\n| 29 | `estimate_contract_call` | Estimate energy + bandwidth for a contract call | -- |\n| 30 | `call_contract` | Execute state-changing contract function with auto resources | Private key |\n\n**Network Utilities**\n\n| # | Tool | Description | Auth |\n|---|---|---|---|\n| 31 | `get_chain_parameters` | TRON network parameters with MERX price comparison | -- |\n| 32 | `convert_address` | Convert between base58 (T...) and hex (41...) formats | -- |\n| 33 | `get_trx_price` | Current TRX price from CoinGecko | -- |\n| 34 | `validate_address` | Validate TRON address format and check on-chain status | -- |\n| 35 | `search_transaction_history` | On-chain transaction history for any address | -- |\n\n**DEX Swaps**\n\n| # | Tool | Description | Auth |\n|---|---|---|---|\n| 36 | `get_swap_quote` | Real SunSwap V2 quote with expected output and slippage | -- |\n| 37 | `execute_swap` | Execute SunSwap swap with exact energy simulation | Private key |\n| 38 | `get_token_price` | Token price via SunSwap pools + CoinGecko USD rate | -- |\n\n**Onboarding**\n\n| # | Tool | Description | Auth |\n|---|---|---|---|\n| 39 | `create_account` | Create MERX account and get API key | -- |\n| 40 | `login` | Log in to existing MERX account | -- |\n\n**Payments**\n\n| # | Tool | Description | Auth |\n|---|---|---|---|\n| 41 | `deposit_trx` | Deposit TRX to MERX from wallet (signs TX with memo) | API key + Private key |\n| 42 | `enable_auto_deposit` | Configure auto-deposit when balance drops below threshold | API key |\n| 43 | `pay_invoice` | Pay an existing x402 invoice | Private key |\n| 44 | `create_paid_order` | x402 zero-registration order: invoice, pay, verify, order | Private key |\n\n**Intent Execution**\n\n| # | Tool | Description | Auth |\n|---|---|---|---|\n| 45 | `execute_intent` | Execute multi-step plan with resource optimization | API key |\n| 46 | `simulate` | Simulate multi-step plan without executing | -- |\n\n**Standing Orders and Monitors**\n\n| # | Tool | Description | Auth |\n|---|---|---|---|\n| 47 | `create_standing_order` | Create server-side standing order with trigger + action | API key |\n| 48 | `list_standing_orders` | List standing orders with status filter | API key |\n| 49 | `create_monitor` | Create persistent monitor (delegation, balance, price) | API key |\n| 50 | `list_monitors` | List monitors with status filter | API key |\n\n**Session Management**\n\n| # | Tool | Description | Auth |\n|---|---|---|---|\n| 51 | `set_api_key` | Set MERX API key for this session | -- |\n| 55 | `set_private_key` | Set TRON private key for this session (address auto-derived) | -- |\n\n---\n\n## SDKs\n\n### JavaScript / TypeScript\n\n```bash\nnpm install merx-sdk\n```\n\n```typescript\nimport { MerxClient } from 'merx-sdk'\n\nconst merx = new MerxClient({ apiKey: 'merx_sk_your_key' })\n\n// 4 modules: prices, orders, balance, webhooks\nconst prices = await merx.prices.list()\nconst best = await merx.prices.best({ resource: 'ENERGY' })\nconst order = await merx.orders.create({ ... })\nconst status = await merx.orders.get(order.id)\nconst balance = await merx.balance.get()\nconst webhooks = await merx.webhooks.list()\n```\n\n| Property | Value |\n|---|---|\n| Package | `merx-sdk` |\n| Modules | `prices`, `orders`, `balance`, `webhooks` |\n| Methods | 16 |\n| TypeScript | Full type definitions included |\n| Dependencies | Zero |\n| Node.js | 18+ |\n\n### Python\n\n```bash\npip install merx-sdk\n```\n\n```python\nfrom merx import MerxClient\n\nmerx = MerxClient(api_key=\"merx_sk_your_key\")\n\n# Same 4 modules, snake_case\nprices = merx.prices.list()\nbest = merx.prices.best(resource=\"ENERGY\")\norder = merx.orders.create(resource_type=\"ENERGY\", amount=65000, ...)\nstatus = merx.orders.get(order.id)\nbalance = merx.balance.get()\n```\n\n| Property | Value |\n|---|---|\n| Package | `merx-sdk` |\n| Modules | `prices`, `orders`, `balance`, `webhooks` |\n| Methods | 16 |\n| Type hints | Full type annotations |\n| Dependencies | Zero |\n| Python | 3.11+ |\n\n### REST API\n\nNo SDK required. All endpoints accept JSON and return JSON.\n\n```bash\n# Get prices (public, no auth)\ncurl https://merx.exchange/api/v1/prices\n\n# Get best price for energy\ncurl https://merx.exchange/api/v1/prices/best?resource=ENERGY\n\n# Create order (authenticated)\ncurl -X POST https://merx.exchange/api/v1/orders \\\n -H \"Authorization: Bearer merx_sk_your_key\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"resource_type\":\"ENERGY\",\"amount\":65000,\"duration_sec\":300,\"target_address\":\"TAddr...\"}'\n\n# Check balance\ncurl https://merx.exchange/api/v1/balance \\\n -H \"Authorization: Bearer merx_sk_your_key\"\n```\n\n---\n\n## Real-time data\n\n### WebSocket\n\nConnect to `wss://merx.exchange/ws` for real-time price updates.\n\n```javascript\nconst ws = new WebSocket('wss://merx.exchange/ws')\n\nws.onopen = () => {\n // Subscribe to all energy price updates\n ws.send(JSON.stringify({ type: 'subscribe', channel: 'prices', resource: 'ENERGY' }))\n}\n\nws.onmessage = (event) => {\n const data = JSON.parse(event.data)\n // { provider: \"netts\", resource: \"ENERGY\", price_sun: 22, available: 100000000, ... }\n}\n```\n\n| Property | Value |\n|---|---|\n| Endpoint | `wss://merx.exchange/ws` |\n| Channels | `prices`, `orders`, `balance` |\n| Update frequency | Every 30 seconds for prices |\n| Heartbeat | Every 30 seconds |\n| Reconnect | Client-side with exponential backoff recommended |\n\n### Webhooks\n\nRegister webhook endpoints to receive HTTP POST notifications for account events.\n\n```bash\ncurl -X POST https://merx.exchange/api/v1/webhooks \\\n -H \"Authorization: Bearer merx_sk_your_key\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\"url\":\"https://your-app.com/webhook\",\"events\":[\"order.filled\",\"deposit.received\"]}'\n```\n\n| Event | Fired when |\n|---|---|\n| `order.filled` | Energy or bandwidth order has been filled by a provider |\n| `order.failed` | Order failed after all provider attempts exhausted |\n| `deposit.received` | TRX deposit confirmed and credited to balance |\n| `withdrawal.completed` | TRX withdrawal broadcast and confirmed on-chain |\n\n**Security:** Every webhook request includes an `X-Merx-Signature` header containing\nan HMAC-SHA256 signature computed with your webhook secret. Verify this signature\nbefore processing. Failed deliveries are retried with exponential backoff.\n\n---\n\n## Payment methods\n\nMERX supports three ways to pay for energy and bandwidth.\n\n### 1. Pre-funded MERX balance\n\nDeposit TRX to your MERX account via the dashboard at merx.exchange or via the API.\nTrade directly from your balance. Best for high-volume users and teams.\n\n```bash\n# Check balance\ncurl https://merx.exchange/api/v1/balance \\\n -H \"Authorization: Bearer merx_sk_your_key\"\n\n# Response\n# { \"available_trx\": 45.20, \"locked_trx\": 1.43, \"total_trx\": 46.63 }\n```\n\n### 2. Self-deposit from agent wallet\n\nThe agent deposits TRX to MERX from its own wallet using the `deposit_trx` tool or\nAPI. The tool builds a TRX transfer with the correct memo, signs it locally, and\nbroadcasts. Balance is credited in 1-2 minutes.\n\n```\ndeposit_trx(amount: 10)\n-> TX: 4bc60854f828...8ddcd509\n-> 10 TRX deposited. Will be credited to your MERX balance shortly.\n```\n\n### 3. x402 pay-per-use\n\nNo account needed. No pre-deposit. Create an invoice, pay with TRX from any wallet,\nand receive energy delegation directly. Complete flow in one API call or one tool\ncall via `create_paid_order`.\n\n```\ncreate_paid_order(amount: 65000, duration_sec: 300,\n resource_type: \"ENERGY\", target_address: \"THT49...\")\n-> Invoice: inv_f41ffc2f...\n-> Payment TX: 53236a5a...\n-> Cost: 1.43 TRX\n-> Status: PENDING -> FILLED\n-> 65,050 energy delegated to THT49...\n```\n\n| Method | Setup required | Best for | Min deposit |\n|---|---|---|---|\n| Pre-funded balance | Account + dashboard deposit | High-volume users, teams | Any amount |\n| Self-deposit (`deposit_trx`) | API key + private key | Autonomous agents | Any amount |\n| x402 (`create_paid_order`) | Private key only | One-off purchases, no-account agents | Per-order |\n\nSee [docs/PAYMENT-METHODS.md](https://github.com/Hovsteder/merx-mcp/blob/main/docs/PAYMENT-METHODS.md) for detailed flow diagrams.\n\n---\n\n## Standing orders and monitors\n\n### Standing orders\n\nServer-side 24/7 automation stored in PostgreSQL. Persists across restarts. Works\nwhen the client is offline.\n\n**Trigger types:**\n\n| Trigger | Description | Example |\n|---|---|---|\n| `price_below` | Fire when best price drops below threshold | Buy 65,000 energy when price < 20 SUN |\n| `price_above` | Fire when best price exceeds threshold | Alert when energy exceeds 50 SUN |\n| `schedule` | Cron-based schedule | Buy energy every day at 03:00 UTC |\n| `balance_below` | Fire when MERX balance drops below threshold | Auto-deposit 50 TRX when balance < 10 TRX |\n\n**Action types:**\n\n| Action | Description |\n|---|---|\n| `buy_resource` | Buy specified amount of energy or bandwidth |\n| `ensure_resources` | Ensure minimum resources on target address |\n| `notify_only` | Send notification via webhook |\n\n**Example:**\n\n```\ncreate_standing_order(\n trigger: { type: \"price_below\", resource: \"ENERGY\", threshold_sun: 20 },\n action: { type: \"buy_resource\", amount: 65000, duration_sec: 300 },\n target_address: \"TLyqz...\",\n max_executions: 10,\n budget_trx: 15\n)\n\n-> Standing Order: so_a1b2c3d4\n-> Status: ACTIVE\n-> Trigger: ENERGY price < 20 SUN\n-> Action: Buy 65,000 energy (5m)\n-> Budget: 15 TRX (10 executions max)\n```\n\n### Delegation monitors\n\nWatch delegations and resources on any address. Alert before expiry. Auto-renew\nwith configurable max price.\n\n| Monitor type | Description | Example |\n|---|---|---|\n| `delegation_expiry` | Alert before energy/bandwidth delegation expires | Alert 5 minutes before expiry, auto-renew at max 30 SUN |\n| `balance_threshold` | Alert when TRX balance drops below threshold | Alert when balance < 5 TRX |\n| `price_alert` | Alert on price movements | Alert when energy price drops below 20 SUN |\n\n**Example:**\n\n```\ncreate_monitor(\n type: \"delegation_expiry\",\n address: \"TLyqz...\",\n resource: \"ENERGY\",\n alert_before_sec: 300,\n auto_renew: true,\n max_price_sun: 30\n)\n\n-> Monitor: mon_e5f6g7h8\n-> Status: ACTIVE\n-> Type: delegation_expiry\n-> Alert: 5 minutes before expiry\n-> Auto-renew: Yes (max 30 SUN)\n```\n\n---\n\n## Savings calculator\n\nEnergy is the expensive resource on TRON. These numbers show the cost difference\nbetween burning TRX (no energy) and renting energy through MERX.\n\n| Resource | Purpose | Free daily | Without it |\n|---|---|---|---|\n| Energy | Smart contract execution (USDT transfers, swaps, approvals) | 0 (must stake or rent) | TRX burned at network rate |\n| Bandwidth | Transaction serialization (every TX needs some) | 600 bytes/day | TRX burned at network rate |\n\n### Cost comparison\n\n| Scenario | Burn cost (no energy) | Rental cost (MERX) | Savings |\n|---|---|---|---|\n| 1 USDT transfer | 3-13 TRX | 1.43 TRX | 56-89% |\n| 10 USDT transfers | 30-130 TRX | 14.30 TRX | 52-89% |\n| 100 USDT transfers/day | 300-1,300 TRX | 143 TRX | 52-89% |\n| SunSwap swap (small) | ~50 TRX | ~4.91 TRX | ~90% |\n| Contract call (simple) | ~1 TRX | ~0.09 TRX | ~91% |\n\nNumbers assume the cheapest available provider at time of order. Actual burn cost\nvaries by recipient address state (whether it has held the token before).\n\n### How it works\n\n1 TRX = 1,000,000 SUN. Energy is priced in SUN per unit. A USDT transfer needs\napproximately 65,000 energy units. At 22 SUN per unit, that is 65,000 x 22 =\n1,430,000 SUN = 1.43 TRX. Without energy, the network burns 3-13 TRX from the\nsender depending on the recipient's account state.\n\n---\n\n## Error handling\n\nAll errors follow a standard format across API, SDKs, and MCP:\n\n```json\n{\n \"error\": {\n \"code\": \"INSUFFICIENT_BALANCE\",\n \"message\": \"MERX balance too low. Need 1.43 TRX, have 0.50 TRX.\",\n \"details\": {\n \"required_trx\": 1.43,\n \"available_trx\": 0.50\n }\n }\n}\n```\n\n### Common error codes\n\n| Code | Description | Resolution |\n|---|---|---|\n| `INSUFFICIENT_BALANCE` | MERX account balance too low | Deposit TRX via dashboard or `deposit_trx` |\n| `PROVIDER_UNAVAILABLE` | All providers failed for this order | Try again later or increase max price |\n| `INVALID_ADDRESS` | TRON address format invalid | Check address starts with T and is 34 characters |\n| `DELEGATION_TIMEOUT` | Energy delegation did not arrive within timeout | Check order status with `get_order` |\n| `SIMULATION_FAILED` | Contract call simulation failed | Check contract address and function parameters |\n| `PRIVATE_KEY_REQUIRED` | Operation requires TRON private key | Set `TRON_PRIVATE_KEY` env var or call `set_private_key` |\n| `API_KEY_REQUIRED` | Operation requires MERX API key | Set `MERX_API_KEY` env var or call `set_api_key` |\n| `ORDER_MIN_AMOUNT` | Amount below minimum order size | Energy minimum: 65,000. Bandwidth minimum: 1,500 |\n\n---\n\n## Security\n\n### Private key handling\n\n- Private keys are set via environment variable (`TRON_PRIVATE_KEY`) or the\n `set_private_key` tool in-session.\n- Keys never leave the client process. All transaction signing happens locally.\n- The MERX API never receives private keys.\n- The `set_private_key` tool derives the TRON address automatically -- the user\n only provides the 64-character hex key.\n\n### API key handling\n\n- API keys authenticate with the MERX API for trading operations.\n- Keys can be set via environment variable (`MERX_API_KEY`) or the `set_api_key`\n tool in-session.\n- Create an account and get an API key without leaving the conversation using the\n `create_account` tool.\n\n### What MERX can and cannot do\n\n| With private key | Without private key |\n|---|---|\n| Sign and broadcast transactions | Read-only operations only |\n| Send TRX and TRC-20 tokens | Check prices and balances |\n| Execute swaps | Get swap quotes |\n| Approve contracts | Estimate costs |\n| Deposit TRX to MERX | View market data |\n\n---\n\n## Tested on mainnet\n\nEvery capability was tested in production on TRON mainnet. These are not simulations --\nevery TX hash is verifiable on [TronScan](https://tronscan.org).\n\n### Verified transactions\n\n| Category | Operation | TX Hash | Status | Details |\n|---|---|---|---|---|\n| Token Operations | `transfer_trx` | `b22813a813c3...990e7955` | SUCCESS | 0.1 TRX sent, 267 bandwidth consumed |\n| Payments | `deposit_trx` | `4bc60854f828...8ddcd509` | SUCCESS | 10 TRX deposited to MERX with memo, credited to balance |\n| Token Operations | `approve_trc20` | `56fc87f319b9...0bf5ffbb` | SUCCESS | USDT approval, 99,764 energy consumed |\n| Smart Contracts | `call_contract` | `fc55aee3dc50...4bb5c1bf` | SUCCESS | name() call on contract, 4,098 energy consumed |\n| DEX Swaps | `execute_swap` | `61424b1e89a0...d066d21577` | SUCCESS | 0.1 TRX -> 0.032 USDT via SunSwap V2, 223,354 energy (exactly as simulated) |\n| Resource Trading | `create_order` | `8adac3b8a859...4e69e4ca` | FILLED | 65,050 energy via Netts at 22 SUN, 1.43 TRX |\n| Payments | `create_paid_order` | `53236a5aeba0...984dec7b` | SUCCESS | x402 flow: 1.43 TRX invoice paid, 65,050 energy delegated |\n\n### Key findings from mainnet testing\n\n| Metric | Value |\n|---|---|\n| USDT transfer energy (typical) | 65,000 units |\n| USDT transfer cost (rented energy) | 1.43 TRX |\n| USDT transfer cost (burned) | 3-13 TRX |\n| Maximum savings observed | 94% |\n| SunSwap swap energy (0.1 TRX -> USDT) | 223,354 units (exact simulation match) |\n| SunSwap swap output | 0.032094 USDT for 0.1 TRX |\n| x402 payment flow | Invoice -> pay -> verify -> order -> fill -> delegate (one call) |\n| Energy delegation confirmation | 2-6 seconds after order fill |\n\n---\n\n## Comparison with alternatives\n\nFactual comparison based on publicly available information.\n\n| Feature | MERX | Sun Protocol | Netts MCP | TronLink MCP | PowerSun MCP |\n|---|---|---|---|---|---|\n| MCP Tools | 55 | ~20 | ~10 | 27 | 27 |\n| MCP Prompts | 30 | 0 | 0 | 0 | 0 |\n| MCP Resources | 21 | 0 | 0 | 0 | 0 |\n| REST API | 70+ endpoints | No | No | No | No |\n| JavaScript SDK | Yes | No | No | No | No |\n| Python SDK | Yes | No | No | No | No |\n| WebSocket | Yes | No | No | No | No |\n| Web exchange | Yes | No | No | No | No |\n| Transport | stdio + SSE | stdio | stdio | stdio | SSE |\n| Energy providers | All connected | 0 | 1 | 0 | 1 |\n| Bandwidth support | Yes | No | No | No | No |\n| Auto resource purchase | Energy + BW | No | No | No | Energy only |\n| Exact energy simulation | Yes | No | No | No | No |\n| Intent execution | Yes | No | No | No | No |\n| Standing orders (24/7) | Yes | No | No | No | No |\n| Delegation monitors | Yes | No | No | No | No |\n| x402 pay-per-use | Yes | No | No | No | No |\n| DEX swaps | Yes | No | No | No | Yes |\n| Zero install option | Yes (SSE) | No | No | No | Yes (SSE) |\n| Private key required | Optional | Yes | Yes | Yes | No |\n| Webhooks | Yes | No | No | No | No |\n| Tested on mainnet | 7 TX verified | Unknown | Unknown | Unknown | Unknown |\n\nMERX covers resource economics, transaction optimization, and general blockchain\noperations. Other servers focus on one area.\n\n---\n\n## Documentation\n\n| | |\n|---|---|\n| Platform | [merx.exchange](https://merx.exchange) |\n| Documentation | [merx.exchange/docs](https://merx.exchange/docs) |\n| API Reference | [merx.exchange/docs/api](https://merx.exchange/docs/api) |\n| MCP Tools | [docs/TOOLS.md](https://github.com/Hovsteder/merx-mcp/blob/main/docs/TOOLS.md) |\n| MCP Prompts | [docs/PROMPTS.md](https://github.com/Hovsteder/merx-mcp/blob/main/docs/PROMPTS.md) |\n| MCP Resources | [docs/RESOURCES.md](https://github.com/Hovsteder/merx-mcp/blob/main/docs/RESOURCES.md) |\n| Configuration | [docs/CONFIGURATION.md](https://github.com/Hovsteder/merx-mcp/blob/main/docs/CONFIGURATION.md) |\n| Examples | [docs/EXAMPLES.md](https://github.com/Hovsteder/merx-mcp/blob/main/docs/EXAMPLES.md) |\n| Comparison | [docs/COMPARISON.md](https://github.com/Hovsteder/merx-mcp/blob/main/docs/COMPARISON.md) |\n| Intent Guide | [docs/INTENT-GUIDE.md](https://github.com/Hovsteder/merx-mcp/blob/main/docs/INTENT-GUIDE.md) |\n| Standing Orders | [docs/STANDING-ORDERS-GUIDE.md](https://github.com/Hovsteder/merx-mcp/blob/main/docs/STANDING-ORDERS-GUIDE.md) |\n| Payment Methods | [docs/PAYMENT-METHODS.md](https://github.com/Hovsteder/merx-mcp/blob/main/docs/PAYMENT-METHODS.md) |\n| Architecture | [docs/ARCHITECTURE.md](https://github.com/Hovsteder/merx-mcp/blob/main/docs/ARCHITECTURE.md) |\n| Changelog | [docs/CHANGELOG.md](https://github.com/Hovsteder/merx-mcp/blob/main/docs/CHANGELOG.md) |\n\n---\n\n## License\n\nMIT. See [LICENSE](https://github.com/Hovsteder/merx-mcp/blob/main/LICENSE).\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"upstream",{"_113":114,"_115":116,"_117":118,"_119":120,"_121":122,"_123":124},"requiredSecrets",[],"tags",[98,99,100,101,102,103,104,105,106,107,108,109,110,111,112],"assets",[],"stats",{"_96":85,"_97":85},"ratingAvg","reviewCount","ai-agent","blockchain","claude","cursor","defi","energy-delegation","intent-execution","resource-optimization","sunswap","tron","tron-bandwidth","tron-energy","trx","usdt","web3","topics",[98,99,100,101,102,103,104,129,130,131,105,106,107,108,109,110,111,112,132],"license","MIT","language","TypeScript","registryName","exchange.merx/mcp","homepage","https://merx.exchange","packages",[125],{"_126":127,"_128":21,"_75":76},"registryType","npm","identifier","mcp","mcp-server","model-context-protocol","x402","ENV",{"_135":136,"_137":138,"_139":140},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]

MERX - TRON Resource Exchange