io.github.Hovsteder/powersun-tron-mcp is an MCP server published by io.github.Hovsteder, hosted at powersun.vip. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 27 tools, including get_prices, estimate_cost, get_available_resources, get_market_overview, get_balance.
TRON Energy marketplace + DEX swap aggregator for AI agents. 27 MCP tools.
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Get current TRON Energy and Bandwidth minimum prices for all duration tiers. Returns price per unit in SUN for each available duration.
| Parameter | Type | Description |
|---|---|---|
| resourceType | string | Filter by resource type (default: all) |
{
"name": "get_prices",
"title": "Get Current Prices",
"description": "Get current TRON Energy and Bandwidth minimum prices for all duration tiers. Returns price per unit in SUN for each available duration.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"resourceType": {
"enum": [
"ENERGY",
"BANDWIDTH"
],
"type": "string",
"description": "Filter by resource type (default: all)"
}
}
}
}Calculate the cost of purchasing TRON Energy or Bandwidth. Exact resourceAmount takes priority. Derived Bandwidth is an estimate for standard USDT TRC-20 transfers (345 units plus 5%); other transaction templates require an explicit resourceAmount. Minimum order sizes still apply.
| Parameter | Type | Description |
|---|---|---|
| txType | string | Transaction type (default: trc20_transfer). trc20_transfer_new = first-time transfer to an address. |
| txCount * | integer | Number of transactions |
| resourceType | string | Resource type (default: ENERGY) |
| targetAddress | string | TRON target address. Required for an executable market quote. |
| resourceAmount | integer | Exact resource amount; otherwise derived from transaction count. |
| durationMinutes | number | Duration in minutes. Allowed: 2, 5, 10, 15, 30, 60, 180, 360, 1440, 10080, 43200. Default: 60. |
{
"name": "estimate_cost",
"title": "Estimate Cost",
"description": "Calculate the cost of purchasing TRON Energy or Bandwidth. Exact resourceAmount takes priority. Derived Bandwidth is an estimate for standard USDT TRC-20 transfers (345 units plus 5%); other transaction templates require an explicit resourceAmount. Minimum order sizes still apply.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"txCount"
],
"properties": {
"txType": {
"enum": [
"trc20_transfer",
"trc20_transfer_new",
"trc10_transfer",
"contract_call"
],
"type": "string",
"description": "Transaction type (default: trc20_transfer). trc20_transfer_new = first-time transfer to an address."
},
"txCount": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Number of transactions",
"exclusiveMinimum": 0
},
"resourceType": {
"enum": [
"ENERGY",
"BANDWIDTH"
],
"type": "string",
"description": "Resource type (default: ENERGY)"
},
"targetAddress": {
"type": "string",
"description": "TRON target address. Required for an executable market quote."
},
"resourceAmount": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Exact resource amount; otherwise derived from transaction count.",
"exclusiveMinimum": 0
},
"durationMinutes": {
"type": "number",
"description": "Duration in minutes. Allowed: 2, 5, 10, 15, 30, 60, 180, 360, 1440, 10080, 43200. Default: 60."
}
}
}
}Get total available Energy and Bandwidth across all active pools. Shows how much resource can be purchased right now.
| Parameter | Type | Description |
|---|---|---|
| resourceType | string | Filter by resource type (default: both) |
| durationMinutes | number | Filter pools that support this duration |
{
"name": "get_available_resources",
"title": "Get Available Resources",
"description": "Get total available Energy and Bandwidth across all active pools. Shows how much resource can be purchased right now.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"resourceType": {
"enum": [
"ENERGY",
"BANDWIDTH"
],
"type": "string",
"description": "Filter by resource type (default: both)"
},
"durationMinutes": {
"type": "number",
"description": "Filter pools that support this duration"
}
}
}
}Comprehensive market overview: prices, availability, allowed durations, order constraints, and transaction types. Useful for agents to understand what they can purchase.
No parameters.
{
"name": "get_market_overview",
"title": "Market Overview",
"description": "Comprehensive market overview: prices, availability, allowed durations, order constraints, and transaction types. Useful for agents to understand what they can purchase.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}
}Get your current TRX balance and deposit information. Requires API key authentication.
No parameters.
{
"name": "get_balance",
"title": "Get Balance",
"description": "Get your current TRX balance and deposit information. Requires API key authentication.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}
}Purchase TRON Energy for a target address. Creates a MARKET order that will be filled by available pools. Deducts cost from your balance.
| Parameter | Type | Description |
|---|---|---|
| txType | string | Transaction type (default: trc20_transfer) |
| txCount * | integer | Number of transactions you need energy for |
| resourceType | string | Resource type (default: ENERGY) |
| targetAddress * | string | TRON address to delegate energy to (T-address format) |
| durationMinutes | number | Duration in minutes. Allowed: 2, 5, 10, 15, 30, 60, 180, 360, 1440, 10080, 43200. Default: 60. |
{
"name": "buy_energy",
"title": "Buy Energy",
"description": "Purchase TRON Energy for a target address. Creates a MARKET order that will be filled by available pools. Deducts cost from your balance.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"targetAddress",
"txCount"
],
"properties": {
"txType": {
"enum": [
"trc20_transfer",
"trc20_transfer_new",
"trc10_transfer",
"contract_call"
],
"type": "string",
"description": "Transaction type (default: trc20_transfer)"
},
"txCount": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Number of transactions you need energy for",
"exclusiveMinimum": 0
},
"resourceType": {
"enum": [
"ENERGY",
"BANDWIDTH"
],
"type": "string",
"description": "Resource type (default: ENERGY)"
},
"targetAddress": {
"type": "string",
"maxLength": 34,
"description": "TRON address to delegate energy to (T-address format)"
},
"durationMinutes": {
"type": "number",
"description": "Duration in minutes. Allowed: 2, 5, 10, 15, 30, 60, 180, 360, 1440, 10080, 43200. Default: 60."
}
}
}
}Broadcast a pre-signed TRON transaction with auto energy delegation. Send your signed transaction data and PowerSun will delegate energy before broadcasting. Works with API key (balance deduction) or x402 USDC payment. Without authentication, returns cost estimate.
| Parameter | Type | Description |
|---|---|---|
| txData * | object | Pre-signed transaction object with txID, raw_data, raw_data_hex, and signature |
{
"name": "broadcast_transaction",
"title": "Broadcast Transaction",
"description": "Broadcast a pre-signed TRON transaction with auto energy delegation. Send your signed transaction data and PowerSun will delegate energy before broadcasting. Works with API key (balance deduction) or x402 USDC payment. Without authentication, returns cost estimate.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"txData"
],
"properties": {
"txData": {
"type": "object",
"required": [
"txID",
"raw_data"
],
"properties": {
"txID": {
"type": "string",
"maxLength": 64
},
"raw_data": {},
"signature": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
}
},
"raw_data_hex": {
"type": "string",
"maxLength": 100000
}
},
"description": "Pre-signed transaction object with txID, raw_data, raw_data_hex, and signature",
"additionalProperties": {}
}
}
}
}Get your order history with optional status filter. Returns recent orders sorted by creation time.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Maximum number of orders to return (default: 20) |
| status | string | Filter by order status |
{
"name": "get_orders",
"title": "Get Orders",
"description": "Get your order history with optional status filter. Returns recent orders sorted by creation time.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Maximum number of orders to return (default: 20)"
},
"status": {
"enum": [
"pending",
"active",
"processing",
"completed",
"failed",
"cancelled",
"expired"
],
"type": "string",
"description": "Filter by order status"
}
}
}
}Get detailed status of a specific order including delegation progress.
| Parameter | Type | Description |
|---|---|---|
| orderId * | string | Order ID (UUID format) |
{
"name": "get_order_status",
"title": "Get Order Status",
"description": "Get detailed status of a specific order including delegation progress.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"orderId"
],
"properties": {
"orderId": {
"type": "string",
"maxLength": 36,
"description": "Order ID (UUID format)"
}
}
}
}Get the deposit address to top up your account balance with TRX.
No parameters.
{
"name": "get_deposit_info",
"title": "Get Deposit Info",
"description": "Get the deposit address to top up your account balance with TRX.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}
}Get a price quote and unsigned transaction for swapping tokens on SunSwap DEX. Returns an unsigned TX for client-side signing. After signing, submit via execute_swap. Requires API key.
| Parameter | Type | Description |
|---|---|---|
| toToken * | string | Token to buy — symbol or TRC-20 contract address |
| amountIn * | string | Amount to swap in smallest unit (SUN for TRX, base units for tokens) |
| fromToken * | string | Token to sell — symbol (USDT, TRX, SUN, ...) or TRC-20 contract address |
| slippageBps | integer | Slippage tolerance in basis points (default: 50 = 0.5%) |
{
"name": "get_swap_quote",
"title": "Get Swap Quote",
"description": "Get a price quote and unsigned transaction for swapping tokens on SunSwap DEX. Returns an unsigned TX for client-side signing. After signing, submit via execute_swap. Requires API key.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"fromToken",
"toToken",
"amountIn"
],
"properties": {
"toToken": {
"type": "string",
"maxLength": 34,
"description": "Token to buy — symbol or TRC-20 contract address"
},
"amountIn": {
"type": "string",
"description": "Amount to swap in smallest unit (SUN for TRX, base units for tokens)"
},
"fromToken": {
"type": "string",
"maxLength": 34,
"description": "Token to sell — symbol (USDT, TRX, SUN, ...) or TRC-20 contract address"
},
"slippageBps": {
"type": "integer",
"maximum": 5000,
"minimum": 1,
"description": "Slippage tolerance in basis points (default: 50 = 0.5%)"
}
}
}
}Execute a pre-signed swap transaction with automatic energy delegation. Get the unsigned TX from get_swap_quote, sign it, and submit here. Energy is delegated before broadcast. Works with API key (balance deduction) or x402 USDC payment.
| Parameter | Type | Description |
|---|---|---|
| txData * | object | Pre-signed swap transaction from get_swap_quote |
{
"name": "execute_swap",
"title": "Execute Swap",
"description": "Execute a pre-signed swap transaction with automatic energy delegation. Get the unsigned TX from get_swap_quote, sign it, and submit here. Energy is delegated before broadcast. Works with API key (balance deduction) or x402 USDC payment.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"txData"
],
"properties": {
"txData": {
"type": "object",
"required": [
"txID",
"raw_data"
],
"properties": {
"txID": {
"type": "string",
"maxLength": 64
},
"raw_data": {},
"signature": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200
}
},
"raw_data_hex": {
"type": "string",
"maxLength": 100000
}
},
"description": "Pre-signed swap transaction from get_swap_quote",
"additionalProperties": {}
}
}
}
}Get comprehensive statistics for your energy/bandwidth pools: delegations, revenue, utilization, APY. Requires API key.
No parameters.
{
"name": "get_pool_stats",
"title": "Pool Statistics",
"description": "Get comprehensive statistics for your energy/bandwidth pools: delegations, revenue, utilization, APY. Requires API key.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}
}Get earnings breakdown by pool: total earned, pending payout, paid out. Optionally filter by date range.
| Parameter | Type | Description |
|---|---|---|
| endDate | string | End date (ISO 8601) |
| startDate | string | Start date (ISO 8601, e.g. 2026-01-01) |
{
"name": "get_earnings",
"title": "Get Earnings",
"description": "Get earnings breakdown by pool: total earned, pending payout, paid out. Optionally filter by date range.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"endDate": {
"type": "string",
"maxLength": 30,
"description": "End date (ISO 8601)"
},
"startDate": {
"type": "string",
"maxLength": 30,
"description": "Start date (ISO 8601, e.g. 2026-01-01)"
}
}
}
}Get current auto-selling configuration for your pools. Shows which resources are being sold, duration constraints, and reserves.
No parameters.
{
"name": "get_auto_selling_config",
"title": "Auto-Selling Config",
"description": "Get current auto-selling configuration for your pools. Shows which resources are being sold, duration constraints, and reserves.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}
}Update auto-selling configuration for a pool. Toggle energy/bandwidth selling, set reserves, duration constraints. Pass the configId from get_auto_selling_config.
| Parameter | Type | Description |
|---|---|---|
| active | boolean | Enable/disable auto-selling |
| configId * | string | Configuration ID to update (from get_auto_selling_config) |
| sellEnergy | boolean | Enable/disable energy selling |
| maxDuration | string | Maximum rental duration |
| minDuration | string | Minimum rental duration (e.g., "5min", "1h", "1d") |
| allowRenewals | boolean | Allow order renewals |
| sellBandwidth | boolean | Enable/disable bandwidth selling |
| reservedEnergy | integer | Energy to keep reserved (not sold) |
| reservedBandwidth | integer | Bandwidth to keep reserved (not sold) |
Get active delegations from your pools. Shows who received energy/bandwidth and when delegations expire.
| Parameter | Type | Description |
|---|---|---|
| poolAddress | string | Filter by specific pool address. If not provided, shows all your pools. |
{
"name": "get_pool_delegations",
"title": "Pool Delegations",
"description": "Get active delegations from your pools. Shows who received energy/bandwidth and when delegations expire.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"poolAddress": {
"type": "string",
"maxLength": 34,
"description": "Filter by specific pool address. If not provided, shows all your pools."
}
}
}
}Withdrawal execution is not available through MCP. Use the withdrawal flow at https://powersun.vip. This tool does not create a withdrawal request or move funds.
| Parameter | Type | Description |
|---|---|---|
| amount * | number | Requested TRX amount (retained for compatibility; MCP does not execute withdrawals) |
{
"name": "withdraw_earnings",
"title": "Withdraw Earnings",
"description": "Withdrawal execution is not available through MCP. Use the withdrawal flow at https://powersun.vip. This tool does not create a withdrawal request or move funds.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"amount"
],
"properties": {
"amount": {
"type": "number",
"description": "Requested TRX amount (retained for compatibility; MCP does not execute withdrawals)",
"exclusiveMinimum": 0
}
}
}
}Register a TRON address as an energy/bandwidth selling pool on PowerSun. This creates a pool and auto-selling configuration. After registering, you must grant active permissions to the platform address (DelegateResource, UnDelegateResource, VoteWitness) so the platform can delegate resources to buyers and vote on your behalf. Use check_pool_permissions to verify permissions after granting them. Requires API key.
| Parameter | Type | Description |
|---|---|---|
| autoVote | boolean | Auto-vote for the best Super Representative to earn rewards (default: true) |
| sellEnergy | boolean | Enable energy selling (default: true) |
| sellBandwidth | boolean | Enable bandwidth selling (default: false) |
| paymentAddress * | string | TRON address to register as pool (starts with T, 34 characters). This is the address where you hold/stake TRX. |
{
"name": "register_pool",
"title": "Register Selling Pool",
"description": "Register a TRON address as an energy/bandwidth selling pool on PowerSun. This creates a pool and auto-selling configuration. After registering, you must grant active permissions to the platform address (DelegateResource, UnDelegateResource, VoteWitness) so the platform can delegate resources to buyers and vote on your behalf. Use check_pool_permissions to verify permissions after granting them. Requires API key.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"paymentAddress"
],
"properties": {
"autoVote": {
"type": "boolean",
"default": true,
"description": "Auto-vote for the best Super Representative to earn rewards (default: true)"
},
"sellEnergy": {
"type": "boolean",
"default": true,
"description": "Enable energy selling (default: true)"
},
"sellBandwidth": {
"type": "boolean",
"default": false,
"description": "Enable bandwidth selling (default: false)"
},
"paymentAddress": {
"type": "string",
"maxLength": 34,
"description": "TRON address to register as pool (starts with T, 34 characters). This is the address where you hold/stake TRX."
}
}
}
}Get live blockchain state for your pool: TRX balance, frozen resources (Energy/Bandwidth), voting status, claimable rewards, and delegated resources. Data is fetched directly from TRON blockchain. Requires API key.
| Parameter | Type | Description |
|---|---|---|
| poolAddress | string | Pool address to check. If omitted, uses your first registered pool. |
{
"name": "get_onchain_status",
"title": "On-Chain Pool Status",
"description": "Get live blockchain state for your pool: TRX balance, frozen resources (Energy/Bandwidth), voting status, claimable rewards, and delegated resources. Data is fetched directly from TRON blockchain. Requires API key.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"poolAddress": {
"type": "string",
"maxLength": 34,
"description": "Pool address to check. If omitted, uses your first registered pool."
}
}
}
}Verify that the platform has the required active permissions on your pool address. Required: DelegateResource (to sell energy), UnDelegateResource (to reclaim). Optional: VoteWitness (to vote for SRs and earn rewards). Run this after granting permissions to confirm the platform can operate your pool. Requires API key.
| Parameter | Type | Description |
|---|---|---|
| poolAddress | string | Pool address to check. If omitted, uses your first registered pool. |
{
"name": "check_pool_permissions",
"title": "Check Pool Permissions",
"description": "Verify that the platform has the required active permissions on your pool address. Required: DelegateResource (to sell energy), UnDelegateResource (to reclaim). Optional: VoteWitness (to vote for SRs and earn rewards). Run this after granting permissions to confirm the platform can operate your pool. Requires API key.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"poolAddress": {
"type": "string",
"maxLength": 34,
"description": "Pool address to check. If omitted, uses your first registered pool."
}
}
}
}Vote for the best Super Representative (SR) with the highest APY to earn voting rewards. The platform automatically selects the SR with the best return. Requires VoteWitness permission granted to the platform. Voting rewards accumulate and can be claimed automatically if auto-claim is enabled. Requires API key.
| Parameter | Type | Description |
|---|---|---|
| poolAddress | string | Pool address to vote from. If omitted, uses your first registered pool. |
{
"name": "trigger_vote",
"title": "Vote for SR",
"description": "Vote for the best Super Representative (SR) with the highest APY to earn voting rewards. The platform automatically selects the SR with the best return. Requires VoteWitness permission granted to the platform. Voting rewards accumulate and can be claimed automatically if auto-claim is enabled. Requires API key.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"poolAddress": {
"type": "string",
"maxLength": 34,
"description": "Pool address to vote from. If omitted, uses your first registered pool."
}
}
}
}View execution history of automatic actions (stake, vote, claim) for your pool. Shows status (success/failed/skipped), amounts, transaction hashes, and timestamps. Requires API key.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Number of records to return (default: 20, max: 100) |
| actionType | string | Filter by action type |
| poolAddress | string | Pool address to get history for. If omitted, uses your first registered pool. |
{
"name": "get_auto_action_history",
"title": "Auto-Action History",
"description": "View execution history of automatic actions (stake, vote, claim) for your pool. Shows status (success/failed/skipped), amounts, transaction hashes, and timestamps. Requires API key.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"default": 20,
"maximum": 100,
"minimum": 1,
"description": "Number of records to return (default: 20, max: 100)"
},
"actionType": {
"enum": [
"stake",
"vote",
"claim"
],
"type": "string",
"description": "Filter by action type"
},
"poolAddress": {
"type": "string",
"maxLength": 34,
"description": "Pool address to get history for. If omitted, uses your first registered pool."
}
}
}
}Start agent registration by providing your TRON address. Returns a challenge string that you must sign with your TRON private key using tronWeb.trx.signMessageV2(). After signing, call verify_registration with the signature to receive your API key. No authentication required.
| Parameter | Type | Description |
|---|---|---|
| address * | string | Your TRON wallet address (T-address format, 34 characters) |
{
"name": "register",
"title": "Register Agent",
"description": "Start agent registration by providing your TRON address. Returns a challenge string that you must sign with your TRON private key using tronWeb.trx.signMessageV2(). After signing, call verify_registration with the signature to receive your API key. No authentication required.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"maxLength": 34,
"description": "Your TRON wallet address (T-address format, 34 characters)"
}
}
}
}Complete agent registration by verifying your signed challenge. Returns an API key and upgrades the current session to authenticated. After verification, all authenticated tools (buy_energy, get_balance, register_pool, etc.) will work in this session without needing to reconnect. No authentication required.
| Parameter | Type | Description |
|---|---|---|
| address * | string | Your TRON wallet address (must match the register call) |
| signature * | string | Signature from tronWeb.trx.signMessageV2(challenge, privateKey) |
| challengeId * | string | Challenge ID from the register tool |
{
"name": "verify_registration",
"title": "Verify Registration",
"description": "Complete agent registration by verifying your signed challenge. Returns an API key and upgrades the current session to authenticated. After verification, all authenticated tools (buy_energy, get_balance, register_pool, etc.) will work in this session without needing to reconnect. No authentication required.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"challengeId",
"address",
"signature"
],
"properties": {
"address": {
"type": "string",
"maxLength": 34,
"description": "Your TRON wallet address (must match the register call)"
},
"signature": {
"type": "string",
"maxLength": 200,
"description": "Signature from tronWeb.trx.signMessageV2(challenge, privateKey)"
},
"challengeId": {
"type": "string",
"maxLength": 50,
"description": "Challenge ID from the register tool"
}
}
}
}Build an AccountPermissionUpdate transaction that grants the PowerSun platform permission to delegate/undelegate resources and optionally vote on your behalf. Returns an unsigned transaction that you must sign with your private key and then broadcast using broadcast_signed_permission_tx. All existing account permissions are preserved. Requires authentication.
| Parameter | Type | Description |
|---|---|---|
| includeVote | boolean | Include VoteWitness permission for earning SR rewards (default: true) |
| poolAddress * | string | TRON address to grant permissions on (your pool address, T-address format) |
{
"name": "build_permission_transaction",
"title": "Build Permission Transaction",
"description": "Build an AccountPermissionUpdate transaction that grants the PowerSun platform permission to delegate/undelegate resources and optionally vote on your behalf. Returns an unsigned transaction that you must sign with your private key and then broadcast using broadcast_signed_permission_tx. All existing account permissions are preserved. Requires authentication.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"poolAddress"
],
"properties": {
"includeVote": {
"type": "boolean",
"description": "Include VoteWitness permission for earning SR rewards (default: true)"
},
"poolAddress": {
"type": "string",
"maxLength": 34,
"description": "TRON address to grant permissions on (your pool address, T-address format)"
}
}
}
}Broadcast a signed AccountPermissionUpdate transaction to the TRON blockchain. After broadcasting, verifies that the platform permissions were correctly applied. Use this after signing the transaction from build_permission_transaction. Requires authentication.
| Parameter | Type | Description |
|---|---|---|
| poolAddress * | string | The pool address that the permission was granted on |
| signedTransaction * | object | The complete signed permission transaction from tronWeb.trx.sign(), including visible, raw_data_hex, and signature |
{
"name": "broadcast_signed_permission_tx",
"title": "Broadcast Signed Permission Transaction",
"description": "Broadcast a signed AccountPermissionUpdate transaction to the TRON blockchain. After broadcasting, verifies that the platform permissions were correctly applied. Use this after signing the transaction from build_permission_transaction. Requires authentication.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"signedTransaction",
"poolAddress"
],
"properties": {
"poolAddress": {
"type": "string",
"maxLength": 34,
"description": "The pool address that the permission was granted on"
},
"signedTransaction": {
"type": "object",
"required": [
"visible",
"txID",
"raw_data_hex",
"signature",
"raw_data"
],
"properties": {
"txID": {
"type": "string",
"pattern": "^(?:[a-fA-F0-9]{2})+$",
"maxLength": 64,
"minLength": 64
},
"visible": {
"type": "boolean"
},
"raw_data": {
"type": "object",
"required": [
"contract",
"ref_block_bytes",
"ref_block_hash",
"expiration",
"timestamp"
],
"properties": {
"data": {
"type": "string",
"pattern": "^(?:[a-fA-F0-9]{2})+$"
},
"contract": {
"type": "array",
"items": {
"type": "object",
"required": [
"type",
"parameter"
],
"properties": {
"type": {
"type": "string",
"const": "AccountPermissionUpdateContract"
},
"parameter": {
"type": "object",
"required": [
"type_url",
"value"
],
"properties": {
"value": {
"type": "object",
"required": [
"owner_address"
],
"properties": {
"owner": {
"type": "object",
"required": [
"permission_name",
"threshold",
"keys"
],
"properties": {
"id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "string",
"pattern": "^\\d+$"
}
]
},
"keys": {
"type": "array",
"items": {
"type": "object",
"required": [
"address",
"weight"
],
"properties": {
"weight": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^(?=\\d*[1-9])\\d+$"
}
]
},
"address": {
"type": "string",
"maxLength": 42,
"minLength": 1
}
},
"additionalProperties": {}
},
"minItems": 1
},
"type": {
"anyOf": [
{
"type": "number",
"const": 0
},
{
"type": "number",
"const": 1
},
{
"type": "number",
"const": 2
},
{
"enum": [
"Owner",
"Witness",
"Active"
],
"type": "string"
}
]
},
"threshold": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^(?=\\d*[1-9])\\d+$"
}
]
},
"operations": {
"type": "string",
"pattern": "^(?:[a-fA-F0-9]{2})+$",
"maxLength": 64,
"minLength": 64
},
"permission_name": {
"type": "string",
"maxLength": 100
}
},
"additionalProperties": {}
},
"actives": {
"type": "array",
"items": {
"type": "object",
"required": [
"permission_name",
"threshold",
"keys"
],
"properties": {
"id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "string",
"pattern": "^\\d+$"
}
]
},
"keys": {
"type": "array",
"items": {
"type": "object",
"required": [
"address",
"weight"
],
"properties": {
"weight": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^(?=\\d*[1-9])\\d+$"
}
]
},
"address": {
"type": "string",
"maxLength": 42,
"minLength": 1
}
},
"additionalProperties": {}
},
"minItems": 1
},
"type": {
"anyOf": [
{
"type": "number",
"const": 0
},
{
"type": "number",
"const": 1
},
{
"type": "number",
"const": 2
},
{
"enum": [
"Owner",
"Witness",
"Active"
],
"type": "string"
}
]
},
"threshold": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^(?=\\d*[1-9])\\d+$"
}
]
},
"operations": {
"type": "string",
"pattern": "^(?:[a-fA-F0-9]{2})+$",
"maxLength": 64,
"minLength": 64
},
"permission_name": {
"type": "string",
"maxLength": 100
}
},
"additionalProperties": {}
}
},
"witness": {
"type": "object",
"required": [
"permission_name",
"threshold",
"keys"
],
"properties": {
"id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
{
"type": "string",
"pattern": "^\\d+$"
}
]
},
"keys": {
"type": "array",
"items": {
"type": "object",
"required": [
"address",
"weight"
],
"properties": {
"weight": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^(?=\\d*[1-9])\\d+$"
}
]
},
"address": {
"type": "string",
"maxLength": 42,
"minLength": 1
}
},
"additionalProperties": {}
},
"minItems": 1
},
"type": {
"anyOf": [
{
"type": "number",
"const": 0
},
{
"type": "number",
"const": 1
},
{
"type": "number",
"const": 2
},
{
"enum": [
"Owner",
"Witness",
"Active"
],
"type": "string"
}
]
},
"threshold": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^(?=\\d*[1-9])\\d+$"
}
]
},
"operations": {
"type": "string",
"pattern": "^(?:[a-fA-F0-9]{2})+$",
"maxLength": 64,
"minLength": 64
},
"permission_name": {
"type": "string",
"maxLength": 100
}
},
"additionalProperties": {}
},
"owner_address": {
"type": "string",
"maxLength": 42,
"minLength": 1
}
},
"additionalProperties": {}
},
"type_url": {
"type": "string",
"const": "type.googleapis.com/protocol.AccountPermissionUpdateContract"
}
},
"additionalProperties": {}
},
"Permission_id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": {}
},
"maxItems": 1,
"minItems": 1
},
"fee_limit": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"timestamp": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"expiration": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"ref_block_hash": {
"type": "string",
"pattern": "^(?:[a-fA-F0-9]{2})+$",
"maxLength": 16,
"minLength": 16
},
"ref_block_bytes": {
"type": "string",
"pattern": "^(?:[a-fA-F0-9]{2})+$",
"maxLength": 4,
"minLength": 4
}
},
"additionalProperties": {}
},
"signature": {
"type": "array",
"items": {
"type": "string",
"pattern": "^(?:[a-fA-F0-9]{2})+$",
"maxLength": 130,
"minLength": 130
},
"minItems": 1
},
"raw_data_hex": {
"type": "string",
"pattern": "^(?:[a-fA-F0-9]{2})+$",
"maxLength": 100000
}
},
"description": "The complete signed permission transaction from tronWeb.trx.sign(), including visible, raw_data_hex, and signature",
"additionalProperties": {}
}
}
}
}Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
{
"name": "configure_auto_selling",
"title": "Configure Auto-Selling",
"description": "Update auto-selling configuration for a pool. Toggle energy/bandwidth selling, set reserves, duration constraints. Pass the configId from get_auto_selling_config.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"configId"
],
"properties": {
"active": {
"type": "boolean",
"description": "Enable/disable auto-selling"
},
"configId": {
"type": "string",
"maxLength": 36,
"description": "Configuration ID to update (from get_auto_selling_config)"
},
"sellEnergy": {
"type": "boolean",
"description": "Enable/disable energy selling"
},
"maxDuration": {
"type": "string",
"maxLength": 10,
"description": "Maximum rental duration"
},
"minDuration": {
"type": "string",
"maxLength": 10,
"description": "Minimum rental duration (e.g., \"5min\", \"1h\", \"1d\")"
},
"allowRenewals": {
"type": "boolean",
"description": "Allow order renewals"
},
"sellBandwidth": {
"type": "boolean",
"description": "Enable/disable bandwidth selling"
},
"reservedEnergy": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Energy to keep reserved (not sold)"
},
"reservedBandwidth": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Bandwidth to keep reserved (not sold)"
}
}
}
}