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

Register a TRON wallet, deposit TRX, buy from balance. Best for repeat usage.

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

---

Links

• Platform: powersun.vip
• Agent API: powersun.vip/agents
• Blog: powersun.vip/blog
• API Docs: powersun.vip/api-docs

---

License

This repository contains documentation only. The PowerSun.vip platform is a hosted service available at powersun.vip.