Skip to content

Hovsteder/powersun-tron-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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 Tools OpenAPI Commission License: MIT

PowerSun MCP server

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


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


License

MIT License. See LICENSE for details.

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

About

TRON Energy & Bandwidth MCP Server + DEX Swap Aggregator for AI agents. 27 tools: self-service onboarding, buy/sell TRON resources, swap tokens on SunSwap DEX via MCP, REST API, or HTTP 402. Only 10% commission.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors