MCP 服务器

TRON Energy/Bandwidth MCP Server

TRON Energy & Bandwidth marketplace for AI agents — 27 MCP tools for buying/selling resources, DEX swaps, and automated energy management via Streamable HTTP.

README

PowerSun.vip — TRON Energy & Bandwidth MCP Server + DEX Swap Aggregator

The first TRON Energy marketplace and DEX swap aggregator for AI agents. Buy energy, sell resources, swap tokens on SunSwap DEX, and earn passive income — fully autonomous via MCP, REST API, or HTTP 402. Only 10% commission — the lowest on the market.

MCP Endpoint: https://powersun.vip/mcp Transport: Streamable HTTP (remote — no installation required) Auth: Optional X-API-Key header (public tools work without authentication)

About PowerSun.vip

PowerSun.vip is a full-featured TRON Energy & Bandwidth marketplace and DEX swap aggregator where users and AI agents can buy and sell network resources required for TRON transactions, and swap any TRC-20 tokens via SunSwap V2 Smart Router.

Platform Highlights

Only 10% commission — competitors charge 15–30%. PowerSun.vip offers the lowest fees on the market.
Save 20–50% on TRON transaction fees by renting Energy instead of burning TRX.
DEX Token Swaps — swap any TRC-20 token pair (TRX, USDT, USDC, USDD, SUN, BTT, WIN, JST, or any contract address) via SunSwap V2 Smart Router with automatic energy delegation.
Instant delegation — Energy is delegated to your address within seconds after payment.
Flexible durations — rent from 5 minutes to 30 days, pay only for what you need.
Autonomous selling — AI agents can register pools, verify permissions, vote for SRs, and earn passive income entirely through MCP.
Human + AI friendly — full web interface for humans, MCP + REST API + HTTP 402 for agents.
No registration required — use HTTP 402 pay-per-use or x402 (USDC on Base) without creating an account.

Why TRON Energy Matters

Every TRON transaction (USDT transfers, smart contract calls) requires Energy. Without it, TRX tokens are burned as fees. For example, a single USDT transfer burns ~27 TRX (~$7) without Energy. With PowerSun.vip, the same transfer costs as little as ~$1.

MCP Server — Quick Start

Connect from Claude Desktop / Cursor / any MCP client

{
  "mcpServers": {
    "powersun": {
      "url": "https://powersun.vip/mcp"
    }
  }
}

That's it — no API keys, no npm install, no Docker. The server is hosted and always available.

With authentication (for balance, orders, selling & swaps)

{
  "mcpServers": {
    "powersun": {
      "url": "https://powersun.vip/mcp",
      "headers": {
        "X-API-Key": "ps_your_api_key_here"
      }
    }
  }
}

MCP Tools (27 total)

Onboarding Tools — 4 tools (self-service registration via MCP)

These tools let agents register, authenticate, and grant permissions — entirely within a single MCP session. No REST API needed.

Tool	Description
`register`	Start registration — get a challenge to sign with your TRON wallet
`verify_registration`	Submit wallet signature → get API key, session upgrades automatically
`build_permission_transaction`	Build an unsigned AccountPermissionUpdate tx to grant platform permissions
`broadcast_signed_permission_tx`	Broadcast the signed permission tx and verify on-chain

Returning users: If the wallet is already registered, verify_registration returns the existing API key + account status (pools, permissions, balance).

Market Tools — 4 tools (public, no auth required)

Tool	Description
`get_prices`	Current Energy & Bandwidth prices for all duration tiers (5min to 30d)
`estimate_cost`	Calculate exact cost for a specific energy amount and duration
`get_available_resources`	Check available Energy & Bandwidth in the marketplace
`get_market_overview`	Full market snapshot — prices, availability, order stats

Buyer Tools — 6 tools (auth recommended)

Tool	Description
`buy_energy`	Purchase Energy delegation for any TRON address
`get_balance`	Account balance and deposit address
`get_orders`	List your recent orders
`get_order_status`	Detailed order status with delegation progress
`get_deposit_info`	Get deposit address and payment instructions
`broadcast_transaction`	Broadcast a pre-signed TRON transaction with automatic Energy delegation. Works with API key (balance), x402 USDC, or 402 pay-per-use — no registration required.

Swap Tools — 2 tools (auth recommended)

Tool	Description
`get_swap_quote`	Get a swap quote from SunSwap V2 Smart Router — returns expected output, minimum output with slippage, energy cost, and unsigned TX to sign. Supports TRX, USDT, USDC, USDD, SUN, BTT, WIN, JST, or any TRC-20 contract address.
`execute_swap`	Broadcast a pre-signed swap transaction with automatic Energy delegation. Get the unsigned TX from `get_swap_quote`, sign it with your private key, then submit here. Works with API key, x402, or 402.

Swap flow: get_swap_quote → agent signs unsigned TX → execute_swap → tokens swapped with energy delegation included.

Seller Tools — 11 tools (auth required)

Pool Management

Tool	Description
`register_pool`	Register a TRON address as a selling pool (autonomous onboarding)
`get_pool_stats`	Pool performance and delegation statistics
`get_earnings`	Earnings breakdown and history
`get_auto_selling_config`	Current auto-selling configuration
`configure_auto_selling`	Enable/disable auto-selling with price settings
`get_pool_delegations`	Active delegations from your pool
`withdraw_earnings`	Withdraw earned TRX to your wallet

On-Chain Operations

Tool	Description
`get_onchain_status`	Live blockchain state — balance, frozen TRX, energy/bandwidth, votes, claimable rewards
`check_pool_permissions`	Verify platform has required on-chain permissions (delegate, undelegate, vote)
`trigger_vote`	Vote for Super Representative to earn staking rewards
`get_auto_action_history`	View auto-action execution logs (stake, vote, claim)

Full Autonomous Onboarding

AI agents can go from "I have a TRON wallet with a private key" to "I'm earning passive income" — in a single MCP session:

Step 1: Register & Authenticate

MCP: register { address: "TMyWallet..." }
→ challengeId + challenge text

Agent signs: tronWeb.trx.signMessageV2(challenge, privateKey)

MCP: verify_registration { challengeId, address, signature }
→ API key + balance + session upgraded
→ All authenticated tools now work in this session

Step 2: Grant Permissions

MCP: build_permission_transaction { poolAddress: "TMyWallet..." }
→ unsigned AccountPermissionUpdate transaction
→ Grants: DelegateResource(57), UnDelegateResource(58), VoteWitness(4)

Agent signs: tronWeb.trx.sign(unsignedTx, privateKey)

MCP: broadcast_signed_permission_tx { signedTransaction, poolAddress }
→ txHash + permissions verified on-chain

Security: Agent permissions are limited to delegate, undelegate, and vote only. No access to FreezeBalanceV2 or WithdrawBalance. Staking and reward claiming are managed by the platform automatically.

Step 3: Register Pool

MCP: register_pool { paymentAddress: "TMyWallet..." }
→ Pool created, auto-selling enabled

Step 4: Vote & Monitor

MCP: trigger_vote → Vote for highest-APY Super Representative
MCP: get_onchain_status → Balance, frozen TRX, energy, votes, rewards
MCP: get_earnings → Selling earnings breakdown
MCP: get_auto_action_history → Auto-action execution logs

Token Swap (SunSwap DEX)

PowerSun integrates with SunSwap V2 Smart Router to provide non-custodial token swaps on the TRON network. Energy is automatically delegated for the swap transaction, so you save on gas compared to burning TRX.

Supported Tokens

TRX, USDT, USDC, USDD, SUN, BTT, WIN, JST — or any TRC-20 contract address.

Swap via MCP

MCP: get_swap_quote {
  fromToken: "TRX",
  toToken: "USDT",
  amountIn: "10000000",     // 10 TRX in SUN
  slippageBps: 50,          // 0.5%
  senderAddress: "TMyWallet..."
}
→ quote (expected output, minimum output, price impact)
→ energy (cost, savings vs burn)
→ unsignedTx (raw transaction to sign)

Agent signs: tronWeb.trx.sign(unsignedTx, privateKey)

MCP: execute_swap { signedTransaction: "..." }
→ txHash + swap result

Swap via REST API

curl -X POST https://powersun.vip/api/v2/agent/swap \
  -H "X-API-Key: ps_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "fromToken": "TRX",
    "toToken": "USDT",
    "amountIn": "10000000",
    "slippageBps": 50,
    "senderAddress": "TYourAddress..."
  }'

Payment Methods

PowerSun.vip supports three payment flows — choose what's most convenient:

1. API Key + TRX Balance

2. HTTP 402 Pay-per-use (TRX)

No registration needed. Works with all endpoints: buy-energy, broadcast, and swap. Request → receive 402 response with platform deposit address and unique TRX amount → send exact amount to the platform wallet on TRON → poll for completion. Payment is matched by unique amount. Fully autonomous.

3. x402 Protocol (USDC on Base)

No registration needed. Works with all endpoints: buy-energy, broadcast, and swap. Request → receive 402 with x402 payment requirements → sign EIP-3009 transferWithAuthorization → resend with X-PAYMENT header → instant settlement. Cross-chain payments powered by Coinbase x402.

REST API

Full REST API available alongside MCP:

Endpoint	Description
`POST /api/v2/agent/register`	Start wallet registration
`POST /api/v2/agent/verify`	Verify signature, get API key
`POST /api/v2/agent/estimate`	Estimate cost
`POST /api/v2/agent/buy-energy`	Purchase energy (API key, 402, or x402)
`POST /api/v2/agent/swap`	Get swap quote from SunSwap DEX (returns unsigned TX)
`POST /api/v2/agent/broadcast`	Broadcast signed transaction with auto Energy (API key, 402, or x402)
`GET /api/v2/agent/balance`	Check balance
`GET /api/v2/agent/order/{id}`	Order status
`GET /api/v2/agent/payment-status/{id}`	402 payment status

Pricing

Energy Prices

Duration	Min Price (SUN/unit)
5 min	80
10 min	75
15 min	70
30 min	65
1 hour	60
6 hours	57
1 day	55
7 days	52
30 days	50

Bandwidth prices follow a 10x ratio (e.g. 800 SUN for 5 min, 500 SUN for 30 days).


Commission	Only 10% — lowest on the market
Savings	20–50% vs TRX burn

Available durations: 5min, 10min, 15min, 30min, 1h, 6h, 1d, 7d, 30d

Swap energy cost: When swapping tokens, PowerSun automatically delegates 5-minute Energy for the swap transaction. The energy cost is included in the swap quote — no separate purchase needed.

Commission Comparison

Platform	Commission
PowerSun.vip	10%
Competitor A	15–20%
Competitor B	20–30%

SDKs

Package	Language	Install	Tools
@powersun/mcp-client	TypeScript	`npm i @powersun/mcp-client`	Energy + Swap
langchain-powersun	Python	`pip install langchain-powersun`	12 LangChain tools
crewai-powersun	Python	`pip install crewai-powersun`	9 CrewAI tools
Hovsteder/tron-energy-action	GitHub Action	`uses: Hovsteder/tron-energy-action@v1`	CI/CD energy rental

Supported Networks

Network	Asset	Usage
TRON mainnet	TRX	Native payment + resource delegation + token swaps
Base (EVM)	USDC	x402 payment via Coinbase facilitator

Use Cases

Wallet agents — Automatically rent Energy before sending USDT/TRX, reducing fees by 20–50%
Trading bots — Bulk Energy purchases for high-frequency TRON transactions
DEX swap agents — Swap any TRC-20 token pair on SunSwap DEX with automatic energy delegation and slippage protection
DApp backends — Provide free transactions to users by delegating Energy
Multi-chain agents — Pay with USDC on Base, receive Energy on TRON
Autonomous sellers — Register a pool via MCP, vote for SRs, earn staking + selling rewards with zero manual intervention

Discovery & Documentation

Resource	URL
Platform	powersun.vip
Agent Landing Page	powersun.vip/agents
MCP Endpoint	powersun.vip/mcp
OpenAPI Spec	powersun.vip/openapi.json
LLM Guide (short)	powersun.vip/llms.txt
LLM Guide (full)	powersun.vip/llms-full.txt
Agent Descriptor	powersun.vip/.well-known/agents.json
AI Plugin Manifest	powersun.vip/ai-plugin.json
Full API Docs	powersun.vip/api-docs
Blog	powersun.vip/blog

Architecture

┌─────────────────────────────────────────────┐
│              AI Agent / LLM                  │
│         (Claude, GPT, custom agent)          │
└──────────┬──────────────┬───────────────────┘
           │ MCP          │ REST API
           ▼              ▼
┌──────────────────────────────────────────────┐
│            PowerSun.vip Server                │
│                                              │
│  ┌─────────┐ ┌──────────┐ ┌──────────────┐  │
│  │27 MCP   │ │ REST API │ │ HTTP 402     │  │
│  │Tools    │ │ Endpoints│ │ + x402 USDC  │  │
│  └────┬────┘ └────┬─────┘ └──────┬───────┘  │
│       └───────────┴──────────────┘           │
│                    │                          │
│       ┌────────────┴────────────┐            │
│       │    Order Engine +       │            │
│       │    Pool Management +    │            │
│       │    SunSwap Router +     │            │
│       │    Auto-Actions         │            │
│       └────────────┬────────────┘            │
└────────────────────┼─────────────────────────┘
                     │
        ┌────────────┴────────────┐
        ▼                         ▼
   TRON Mainnet              Base (EVM)
   (Energy + Swaps)       (USDC settlement)

GitHub Topics

tron tron-energy tron-bandwidth mcp mcp-server ai-agent blockchain trx usdt energy-rental bandwidth http-402 x402 rest-api crypto defi passive-income staking sunswap dex-swap token-swap

License

MIT License. See LICENSE for details.

The PowerSun.vip platform is a hosted service available at powersun.vip.