{
  "notice": "bxzxxr MCP archive: a record of what public MCP servers declared when we listed them (we never call their tools). It is data, not a rating: nothing here says a server is safe, secure, verified or trustworthy, and a server can change after we looked. Secrets we detected are redacted; redacted tool lists are withheld and only their hash is shown.",
  "infrastructure": {
    "host": "mcp.tronsave.io",
    "site": "tronsave.io",
    "addresses": [
      {
        "address": "172.67.70.18",
        "endpoints": 3,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "172.67.64.0/20",
          "country": "US"
        }
      },
      {
        "address": "104.26.8.170",
        "endpoints": 3,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "104.26.0.0/20",
          "country": "US"
        }
      },
      {
        "address": "104.26.9.170",
        "endpoints": 3,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "104.26.0.0/20",
          "country": "US"
        }
      },
      {
        "address": "2606:4700:20::681a:8aa",
        "endpoints": 3,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "2606:4700:20::/44",
          "country": "US"
        }
      },
      {
        "address": "2606:4700:20::681a:9aa",
        "endpoints": 3,
        "shared_infrastructure": false,
        "network": null
      },
      {
        "address": "2606:4700:20::ac43:4612",
        "endpoints": 3,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "prefix": "2606:4700:20::/44",
          "country": "US",
          "name": "CLOUDFLARENET - Cloudflare, Inc."
        }
      }
    ],
    "addresses_recorded": true,
    "address_history": [
      {
        "addresses": [
          "172.67.70.18",
          "104.26.8.170",
          "104.26.9.170",
          "2606:4700:20::681a:8aa",
          "2606:4700:20::681a:9aa",
          "2606:4700:20::ac43:4612"
        ],
        "first_seen": "2026-11-21T17:24:01.963Z",
        "last_seen": "2026-11-21T17:24:01.963Z",
        "checks": 1
      }
    ],
    "hosting": [
      {
        "value": "Cloudflare",
        "evidence": "Server header \"cloudflare\""
      }
    ],
    "software": [],
    "server_info": {
      "name": "TronSave MCP Server",
      "version": "1.5.2",
      "protocol_version": "2025-06-18"
    },
    "headers": {
      "server": "cloudflare",
      "strict-transport-security": "max-age=31536000; includeSubDomains; preload"
    },
    "auth": null
  },
  "related": {
    "same_address": {
      "total": 2,
      "sample": [
        {
          "id": "40415",
          "url": "https://mcp.tronsave.io/testnet/mcp",
          "server_name": "io.github.tronsave/mcp",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T17:25:01.142Z"
        },
        {
          "id": "40416",
          "url": "https://mcp.tronsave.io/oauth/mcp",
          "server_name": "io.github.tronsave/mcp",
          "last_state": "auth_required",
          "last_checked_at": "2026-11-21T17:26:00.680Z"
        }
      ]
    },
    "same_site": {
      "total": 2,
      "sample": [
        {
          "id": "40415",
          "url": "https://mcp.tronsave.io/testnet/mcp",
          "server_name": "io.github.tronsave/mcp",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T17:25:01.142Z"
        },
        {
          "id": "40416",
          "url": "https://mcp.tronsave.io/oauth/mcp",
          "server_name": "io.github.tronsave/mcp",
          "last_state": "auth_required",
          "last_checked_at": "2026-11-21T17:26:00.680Z"
        }
      ]
    },
    "same_tool_list": {
      "total": 1,
      "sample": [
        {
          "id": "40415",
          "url": "https://mcp.tronsave.io/testnet/mcp",
          "server_name": "io.github.tronsave/mcp",
          "last_state": "listed",
          "last_checked_at": "2026-11-21T17:25:01.142Z"
        }
      ]
    },
    "same_publisher": {
      "publisher": "io.github.tronsave",
      "total": 0,
      "sample": []
    },
    "same_repository": {
      "repository_url": "https://github.com/tronsave/tronsave-mcp",
      "total": 0,
      "sample": []
    },
    "note": "Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators."
  },
  "endpoint": {
    "id": "40414",
    "server_name": "io.github.tronsave/mcp",
    "url": "https://mcp.tronsave.io/mcp",
    "host": "mcp.tronsave.io",
    "transport": "streamable-http",
    "last_checked_at": "2026-11-21T17:24:01.963Z",
    "last_state": "listed",
    "last_detail": null,
    "consecutive_failures": 0,
    "current_sha": "a5175c8c87058afa1645ddb750828f57e5b1896f36adb0e71b4ae7ce1a1e2540",
    "first_listed_at": "2026-11-21T17:24:01.963Z",
    "created_at": "2026-11-21T12:15:05.008Z",
    "resolved_addresses": [
      "172.67.70.18",
      "104.26.8.170",
      "104.26.9.170",
      "2606:4700:20::681a:8aa",
      "2606:4700:20::681a:9aa",
      "2606:4700:20::ac43:4612"
    ]
  },
  "server": {
    "name": "io.github.tronsave/mcp",
    "title": "TronSave",
    "description": "Buy, sell and extend TRON Energy/Bandwidth on the TronSave market. Quotes need no login.",
    "version": "1.5.2",
    "registry_status": "active",
    "repository_url": "https://github.com/tronsave/tronsave-mcp",
    "website_url": "https://docs.tronsave.io",
    "published_at": "2026-11-13T11:37:39.829Z",
    "updated_at": "2026-11-13T11:37:39.829Z",
    "first_seen": "2026-11-21T12:15:04.359Z"
  },
  "other_endpoints": [
    {
      "id": "40415",
      "url": "https://mcp.tronsave.io/testnet/mcp",
      "transport": "streamable-http",
      "last_state": "listed",
      "last_checked_at": "2026-11-21T17:25:01.142Z"
    },
    {
      "id": "40416",
      "url": "https://mcp.tronsave.io/oauth/mcp",
      "transport": "streamable-http",
      "last_state": "auth_required",
      "last_checked_at": "2026-11-21T17:26:00.680Z"
    }
  ],
  "intel": {
    "capabilities": [
      "defi",
      "handles-keys",
      "runs-agents",
      "signs-transactions",
      "trades"
    ],
    "evm_addresses": [],
    "chains": [
      "tron"
    ],
    "tokens": [
      "TRX",
      "USDT"
    ],
    "computed_at": "2026-11-22T15:52:06.529Z"
  },
  "operator": {
    "key": "tronsave.io",
    "name": "tronsave.io",
    "platform": false
  },
  "needs_sign_in": false,
  "reachability": {
    "window_days": 30,
    "checks": 1,
    "answered": 1,
    "answered_percent": 100,
    "avg_listing_latency_ms": 2057,
    "first_check_in_window": "2026-11-21T17:24:01.963Z",
    "consecutive_failures_now": 0,
    "days": [
      {
        "day": "2026-11-21",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      }
    ]
  },
  "tool_list": {
    "sha256": "a5175c8c87058afa1645ddb750828f57e5b1896f36adb0e71b4ae7ce1a1e2540",
    "tools": 53,
    "resources": 1,
    "prompts": 2,
    "first_seen": "2026-11-21T17:24:04.023Z",
    "tool_names": [
      "tronsave_get_internal_account",
      "tronsave_get_deposit_address",
      "tronsave_internal_order_history",
      "tronsave_internal_order_details",
      "tronsave_internal_order_book",
      "tronsave_internal_order_estimate",
      "tronsave_internal_order_create",
      "tronsave_internal_extend_delegates",
      "tronsave_internal_create_extend_request",
      "tronsave_get_sign_message",
      "tronsave_login",
      "tronsave_logout",
      "tronsave_get_session_status",
      "tronsave_get_user_info",
      "tronsave_get_user_auto_setting",
      "tronsave_get_user_permissions",
      "tronsave_estimate_buy_resource",
      "tronsave_get_order",
      "tronsave_list_orders",
      "tronsave_list_order_books",
      "tronsave_get_min_price",
      "tronsave_list_extendable_delegates",
      "tronsave_create_order",
      "tronsave_sell_order_manual",
      "tronsave_cancel_order",
      "tronsave_update_order",
      "tronsave_register_auto_sell",
      "tronsave_update_auto_sell_setting",
      "tronsave_generate_api_key",
      "tronsave_revoke_api_key",
      "tronsave_delete_auto_buy_setting",
      "tronsave_get_market_overview",
      "tronsave_get_price_table",
      "tronsave_get_system_info",
      "tronsave_get_account_resources",
      "tronsave_suggest_create_order",
      "tronsave_list_extendable_receivers",
      "tronsave_get_seller_stats",
      "tronsave_list_delegations",
      "tronsave_list_auto_buy_settings",
      "tronsave_create_auto_buy_setting",
      "tronsave_update_auto_buy_setting",
      "tronsave_list_notifications",
      "tronsave_mark_notifications_read",
      "tronsave_get_referral",
      "tronsave_get_telegram_notify_setting",
      "tronsave_update_telegram_notify_setting",
      "tronsave_get_agency_bot",
      "tronsave_list_internal_transactions",
      "tronsave_get_flash_unstake_request",
      "tronsave_list_flash_unstake_orders",
      "tronsave_estimate_flash_unstake",
      "tronsave_bulk_create_internal_orders"
    ],
    "declared": {
      "tools": [
        {
          "name": "tronsave_get_internal_account",
          "title": "Internal Account Information",
          "description": "Retrieve the Tronsave internal account profile for the current logged-in session (wallet/represent address, balances, deposit address). Requires an internal API key: `tronsave_login` (api-key mode, or signature mode for a wallet with an internal account) or an `Authorization: ApiKey <key>` client header. Never pass API keys as tool arguments; the server forwards the key from the session/header to TronSave. Use when the user needs their linked address or balance; for the full wallet profile use `tronsave_get_user_info`, for the ledger of deposits and payments `tronsave_list_internal_transactions`. Returns `{ id, balance (SUN string), representAddress, depositAddress }`; any API key in the payload is masked. Read-only.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {},
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "id": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Internal account id."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Internal account id."
              },
              "apiKey": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "MASKED internal API key; the full key is never returned."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "MASKED internal API key; the full key is never returned."
              },
              "balance": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Internal balance in SUN as a decimal string (TRX = SUN / 1e6)."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Internal balance in SUN as a decimal string (TRX = SUN / 1e6)."
              },
              "depositAddress": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "TRON base58 deposit address; send TRX here to top up the internal balance (min 10 TRX)."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "TRON base58 deposit address; send TRX here to top up the internal balance (min 10 TRX)."
              },
              "representAddress": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "TRON base58 address that represents (owns) the internal account."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "TRON base58 address that represents (owns) the internal account."
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Internal Account Information",
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true
          }
        },
        {
          "name": "tronsave_get_deposit_address",
          "title": "Get Deposit Address",
          "description": "Fetches the specific deposit address for the TronSave internal account. Requires an internal API key: `tronsave_login` (api-key mode, or signature mode for a wallet with an internal account) or an `Authorization: ApiKey <key>` client header. Never pass API keys as tool arguments; the server forwards the key from the session/header to TronSave. Trigger this tool if the user asks for a deposit address or needs to top up their TronSave TRX balance. Constraints: 1) TRX only; 2) Minimum deposit amount is 10 TRX; 3) Read-only operation.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "amountTrx"
            ],
            "properties": {
              "amountTrx": {
                "type": "number",
                "minimum": 10,
                "description": "Amount of TRX the user intends to deposit (minimum 10 TRX)."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "amountTrx": {
                "anyOf": [
                  {
                    "type": "number",
                    "description": "Amount of TRX the user intends to deposit (echoed back)."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Amount of TRX the user intends to deposit (echoed back)."
              },
              "depositAddress": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "TRON base58 deposit address; send TRX here to top up the TronSave internal balance."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "TRON base58 deposit address; send TRX here to top up the TronSave internal balance."
              },
              "minimumDepositTrx": {
                "anyOf": [
                  {
                    "type": "number",
                    "description": "Minimum accepted deposit in TRX."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Minimum accepted deposit in TRX."
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Get Deposit Address",
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true
          }
        },
        {
          "name": "tronsave_internal_order_history",
          "title": "Internal Account Order History",
          "description": "List paginated order history for the internal account linked to the API key, newest first. Requires an internal API key: `tronsave_login` (api-key mode, or signature mode for a wallet with an internal account) or an `Authorization: ApiKey <key>` client header. Never pass API keys as tool arguments; the server forwards the key from the session/header to TronSave. Use when the user asks about past purchases, fulfillment, payouts, or delegates on their internal account. This is the API-key path; wallet-signature sessions can also use `tronsave_list_orders` with `isOnlyMyOrder`. Read-only. Pair with `tronsave_internal_order_details` for a single order's full snapshot.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "page": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": 0,
                "description": "Page index, 0-based. Omit for first page (default 0)."
              },
              "pageSize": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": 1,
                "description": "Orders per page. Default 10 when omitted. Typical range 1–100."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "data": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "anyOf": [
                            {
                              "type": "string",
                              "description": "TronSave order ID (hex string)."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "TronSave order ID (hex string)."
                        },
                        "price": {
                          "anyOf": [
                            {
                              "type": "number",
                              "description": "Unit price in SUN."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Unit price in SUN."
                        },
                        "status": {
                          "anyOf": [
                            {
                              "type": "string",
                              "description": "Order status."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Order status."
                        },
                        "receiver": {
                          "anyOf": [
                            {
                              "type": "string",
                              "description": "TRON base58 receiver address."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "TRON base58 receiver address."
                        },
                        "createdAt": {
                          "anyOf": [
                            {
                              "anyOf": [
                                {
                                  "type": "number"
                                },
                                {
                                  "type": "string"
                                }
                              ],
                              "description": "Order created time (Unix epoch ms or ISO-8601, endpoint-dependent)."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Order created time (Unix epoch ms or ISO-8601, endpoint-dependent)."
                        },
                        "delegates": {
                          "anyOf": [
                            {
                              "type": "array",
                              "items": {
                                "type": "object",
                                "properties": {
                                  "txid": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "description": "Transaction ID on TRON network."
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "Transaction ID on TRON network."
                                  },
                                  "amount": {
                                    "anyOf": [
                                      {
                                        "type": "number",
                                        "description": "Delegated resource amount."
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "Delegated resource amount."
                                  },
                                  "delegator": {
                                    "anyOf": [
                                      {
                                        "type": "string",
                                        "description": "TRON base58 address of delegator."
                                      },
                                      {
                                        "type": "null"
                                      }
                                    ],
                                    "description": "TRON base58 address of delegator."
                                  }
                                },
                                "additionalProperties": {}
                              },
                              "description": "Delegations fulfilling this order."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Delegations fulfilling this order."
                        },
                        "orderType": {
                          "anyOf": [
                            {
                              "type": "string",
                              "description": "Order type (NORMAL | FAST | EXTEND)."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Order type (NORMAL | FAST | EXTEND)."
                        },
                        "requester": {
                          "anyOf": [
                            {
                              "type": "string",
                              "description": "TRON base58 requester address."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "TRON base58 requester address."
                        },
                        "durationSec": {
                          "anyOf": [
                            {
                              "type": "number",
                              "description": "Delegated duration in seconds."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Delegated duration in seconds."
                        },
                        "payoutAmount": {
                          "anyOf": [
                            {
                              "type": "number",
                              "description": "Payout amount in SUN."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Payout amount in SUN."
                        },
                        "remainAmount": {
                          "anyOf": [
                            {
                              "type": "number",
                              "description": "Remaining unfulfilled amount."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Remaining unfulfilled amount."
                        },
                        "resourceType": {
                          "anyOf": [
                            {
                              "enum": [
                                "ENERGY",
                                "BANDWIDTH"
                              ],
                              "type": "string",
                              "description": "Resource type."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Resource type."
                        },
                        "resourceAmount": {
                          "anyOf": [
                            {
                              "type": "number",
                              "description": "Resource amount of order."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Resource amount of order."
                        },
                        "allowPartialFill": {
                          "anyOf": [
                            {
                              "type": "boolean",
                              "description": "Whether partial fill is allowed."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Whether partial fill is allowed."
                        },
                        "fulfilledPercent": {
                          "anyOf": [
                            {
                              "type": "number",
                              "description": "0 = pending, 1-99 = partial, 100 = fully matched."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "0 = pending, 1-99 = partial, 100 = fully matched."
                        }
                      },
                      "additionalProperties": {}
                    },
                    "description": "Orders on this page, newest first."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Orders on this page, newest first."
              },
              "total": {
                "anyOf": [
                  {
                    "type": "number",
                    "description": "Total orders matching the query (for pagination)."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Total orders matching the query (for pagination)."
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Internal Account Order History",
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true
          }
        },
        {
          "name": "tronsave_internal_order_details",
          "title": "Internal Order Details",
          "description": "Fetch full details for one internal-account order by order ID. Requires an internal API key: `tronsave_login` (api-key mode, or signature mode for a wallet with an internal account) or an `Authorization: ApiKey <key>` client header. Never pass API keys as tool arguments; the server forwards the key from the session/header to TronSave. Use when monitoring fulfillment after `tronsave_internal_order_create`, or when the user asks for status on a specific order id. API-key path; with a wallet signature `tronsave_get_order` returns the same order. Read-only. FRESHNESS: order state changes within seconds as the market matches — re-read immediately before acting.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "orderId"
            ],
            "properties": {
              "orderId": {
                "type": "string",
                "minLength": 1,
                "description": "TronSave order ID (hex string), e.g. value returned in internal.order.create response data.orderId."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "id": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "TronSave order ID (hex string)."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "TronSave order ID (hex string)."
              },
              "price": {
                "anyOf": [
                  {
                    "type": "number",
                    "description": "Unit price in SUN."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Unit price in SUN."
              },
              "status": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Order status."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Order status."
              },
              "receiver": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "TRON base58 receiver address."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "TRON base58 receiver address."
              },
              "createdAt": {
                "anyOf": [
                  {
                    "anyOf": [
                      {
                        "type": "number"
                      },
                      {
                        "type": "string"
                      }
                    ],
                    "description": "Order created time (Unix epoch ms or ISO-8601, endpoint-dependent)."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Order created time (Unix epoch ms or ISO-8601, endpoint-dependent)."
              },
              "delegates": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "txid": {
                          "anyOf": [
                            {
                              "type": "string",
                              "description": "Transaction ID on TRON network."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Transaction ID on TRON network."
                        },
                        "amount": {
                          "anyOf": [
                            {
                              "type": "number",
                              "description": "Delegated resource amount."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Delegated resource amount."
                        },
                        "delegator": {
                          "anyOf": [
                            {
                              "type": "string",
                              "description": "TRON base58 address of delegator."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "TRON base58 address of delegator."
                        }
                      },
                      "additionalProperties": {}
                    },
                    "description": "Delegations fulfilling this order."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Delegations fulfilling this order."
              },
              "orderType": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Order type (NORMAL | FAST | EXTEND)."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Order type (NORMAL | FAST | EXTEND)."
              },
              "requester": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "TRON base58 requester address."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "TRON base58 requester address."
              },
              "durationSec": {
                "anyOf": [
                  {
                    "type": "number",
                    "description": "Delegated duration in seconds."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Delegated duration in seconds."
              },
              "payoutAmount": {
                "anyOf": [
                  {
                    "type": "number",
                    "description": "Payout amount in SUN."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Payout amount in SUN."
              },
              "remainAmount": {
                "anyOf": [
                  {
                    "type": "number",
                    "description": "Remaining unfulfilled amount."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Remaining unfulfilled amount."
              },
              "resourceType": {
                "anyOf": [
                  {
                    "enum": [
                      "ENERGY",
                      "BANDWIDTH"
                    ],
                    "type": "string",
                    "description": "Resource type."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Resource type."
              },
              "resourceAmount": {
                "anyOf": [
                  {
                    "type": "number",
                    "description": "Resource amount of order."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Resource amount of order."
              },
              "allowPartialFill": {
                "anyOf": [
                  {
                    "type": "boolean",
                    "description": "Whether partial fill is allowed."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Whether partial fill is allowed."
              },
              "fulfilledPercent": {
                "anyOf": [
                  {
                    "type": "number",
                    "description": "0 = pending, 1-99 = partial, 100 = fully matched."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "0 = pending, 1-99 = partial, 100 = fully matched."
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Internal Order Details",
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true
          }
        },
        {
          "name": "tronsave_internal_order_book",
          "title": "Internal Market Order Book",
          "description": "Return the current TronSave market depth/price tiers for ENERGY or BANDWIDTH via the api-key REST endpoint. Requires an internal API key: `tronsave_login` (api-key mode, or signature mode for a wallet with an internal account) or an `Authorization: ApiKey <key>` client header. Never pass API keys as tool arguments; the server forwards the key from the session/header to TronSave. Use before `tronsave_internal_order_create` or `tronsave_internal_order_estimate` when the user needs live prices or liquidity. Same depth as the public `tronsave_list_order_books`, plus SLOW/MEDIUM/FAST price tiers; use the public tool when there is no API key. Read-only. FRESHNESS: live market depth can change roughly every 3 seconds (one TRON block) — re-read immediately before placing an order.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "address": {
                "type": "string",
                "pattern": "^T[1-9A-HJ-NP-Za-km-z]{33}$",
                "description": "Optional TRON base58 address filter for the receiver."
              },
              "durationSec": {
                "type": "integer",
                "maximum": 9007199254740991,
                "description": "Delegation duration window in seconds for the quote.",
                "exclusiveMinimum": 0
              },
              "resourceType": {
                "enum": [
                  "ENERGY",
                  "BANDWIDTH"
                ],
                "type": "string",
                "description": "Resource type. Default ENERGY when omitted."
              },
              "minDelegateAmount": {
                "type": "number",
                "minimum": 0,
                "description": "Minimum resource amount per offer level to include (resource units, not SUN)."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "data": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "price": {
                          "anyOf": [
                            {
                              "type": "number",
                              "description": "Price in SUN."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Price in SUN."
                        },
                        "availableResourceAmount": {
                          "anyOf": [
                            {
                              "type": "number",
                              "description": "Available resource amount at this price level."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Available resource amount at this price level."
                        }
                      },
                      "additionalProperties": {}
                    },
                    "description": "Order book entries sorted by price."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Order book entries sorted by price."
              },
              "fast": {
                "anyOf": [
                  {
                    "type": "number",
                    "description": "FAST price tier (SUN)."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "FAST price tier (SUN)."
              },
              "slow": {
                "anyOf": [
                  {
                    "type": "number",
                    "description": "SLOW price tier (SUN)."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "SLOW price tier (SUN)."
              },
              "medium": {
                "anyOf": [
                  {
                    "type": "number",
                    "description": "MEDIUM price tier (SUN)."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "MEDIUM price tier (SUN)."
              },
              "availableResource": {
                "anyOf": [
                  {
                    "type": "number",
                    "description": "Available resource at the quoted tiers."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Available resource at the quoted tiers."
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Internal Market Order Book",
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true
          }
        },
        {
          "name": "tronsave_internal_order_estimate",
          "title": "Estimate TRX Cost Before Order",
          "description": "Estimate the TRX cost and availability for a buy order before submitting it (api-key internal account). Requires an internal API key: `tronsave_login` (api-key mode, or signature mode for a wallet with an internal account) or an `Authorization: ApiKey <key>` client header. Never pass API keys as tool arguments; the server forwards the key from the session/header to TronSave. Use when the user wants a quote or price check; feed the result into `tronsave_internal_order_create`. Quotes for `tronsave_create_order` come from `tronsave_estimate_buy_resource` instead. Read-only. FRESHNESS: `unitPrice`/`estimateTrx` are live and can change roughly every 3 seconds — re-estimate immediately before creating the order.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "resourceAmount"
            ],
            "properties": {
              "options": {
                "type": "object",
                "properties": {
                  "allowPartialFill": {
                    "type": "boolean",
                    "description": "Allow partial fill so the order can match partially. Default true when omitted."
                  }
                },
                "description": "Optional flags that affect matching behavior for the estimate."
              },
              "receiver": {
                "type": "string",
                "pattern": "^T[1-9A-HJ-NP-Za-km-z]{33}$",
                "description": "TRON base58 address that will receive the resource."
              },
              "requester": {
                "type": "string",
                "pattern": "^T[1-9A-HJ-NP-Za-km-z]{33}$",
                "description": "TRON base58 requester; defaults to the API key account when omitted."
              },
              "unitPrice": {
                "anyOf": [
                  {
                    "enum": [
                      "FAST",
                      "MEDIUM",
                      "SLOW"
                    ],
                    "type": "string"
                  },
                  {
                    "type": "number"
                  }
                ],
                "description": "Pricing: FAST | MEDIUM | SLOW strategy, or exact unit price in SUN per resource unit. Default MEDIUM when omitted."
              },
              "durationSec": {
                "type": "integer",
                "maximum": 9007199254740991,
                "description": "Delegation duration in seconds. Default 259200 (3 days) when omitted.",
                "exclusiveMinimum": 0
              },
              "resourceType": {
                "enum": [
                  "ENERGY",
                  "BANDWIDTH"
                ],
                "type": "string",
                "description": "Resource type. Default ENERGY when omitted."
              },
              "resourceAmount": {
                "type": "number",
                "description": "Amount of resource to purchase (resource units).",
                "exclusiveMinimum": 0
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "unitPrice": {
                "anyOf": [
                  {
                    "type": "number",
                    "description": "Unit price in SUN."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Unit price in SUN."
              },
              "durationSec": {
                "anyOf": [
                  {
                    "type": "number",
                    "description": "Delegated duration in seconds."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Delegated duration in seconds."
              },
              "estimateTrx": {
                "anyOf": [
                  {
                    "type": "number",
                    "description": "Estimated TRX cost in SUN."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Estimated TRX cost in SUN."
              },
              "availableResource": {
                "anyOf": [
                  {
                    "type": "number",
                    "description": "Available resource amount."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Available resource amount."
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Estimate TRX Cost Before Order",
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true
          }
        },
        {
          "name": "tronsave_internal_order_create",
          "title": "Create Energy or Bandwidth Order (Internal)",
          "description": "Place a new buy order for ENERGY or BANDWIDTH on TronSave, paid from the internal account balance. Requires an internal API key: `tronsave_login` (api-key mode, or signature mode for a wallet with an internal account) or an `Authorization: ApiKey <key>` client header. Never pass API keys as tool arguments; the server forwards the key from the session/header to TronSave. Side effect: SPENDS internal TRX balance and creates a live order; not idempotent — each call places a new order. This is the api-key/internal path; for the signature-session market path use `tronsave_create_order`. Always derive `unitPrice` from the latest `tronsave_internal_order_estimate` (re-estimate immediately before submitting — quotes older than a few seconds may be stale and revert). Returns `{ orderId }`.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "resourceAmount",
              "receiver"
            ],
            "properties": {
              "options": {
                "type": "object",
                "properties": {
                  "allowPartialFill": {
                    "type": "boolean",
                    "description": "Allow partial fill. Default true when omitted."
                  },
                  "maxPriceAccepted": {
                    "type": "number",
                    "minimum": 0,
                    "description": "Maximum unit price in SUN you accept."
                  },
                  "onlyCreateWhenFulfilled": {
                    "type": "boolean",
                    "description": "Only create if the order can be 100% fulfilled. Default false when omitted."
                  },
                  "preventDuplicateIncompleteOrders": {
                    "type": "boolean",
                    "description": "Skip if an identical pending order already exists. Default false when omitted."
                  },
                  "minResourceDelegateRequiredAmount": {
                    "type": "number",
                    "minimum": 0,
                    "description": "Minimum resource amount per matching provider (resource units)."
                  }
                },
                "description": "Optional execution guards and fill behavior."
              },
              "sponsor": {
                "type": "string",
                "description": "Optional sponsor or referral code."
              },
              "receiver": {
                "type": "string",
                "pattern": "^T[1-9A-HJ-NP-Za-km-z]{33}$",
                "description": "TRON base58 address that will receive the resource."
              },
              "unitPrice": {
                "anyOf": [
                  {
                    "enum": [
                      "FAST",
                      "MEDIUM",
                      "SLOW"
                    ],
                    "type": "string"
                  },
                  {
                    "type": "number"
                  }
                ],
                "description": "Pricing: FAST | MEDIUM | SLOW strategy, or exact unit price in SUN per resource unit. Default MEDIUM when omitted."
              },
              "durationSec": {
                "type": "integer",
                "maximum": 9007199254740991,
                "description": "Delegation duration in seconds. Default 259200 (3 days) when omitted.",
                "exclusiveMinimum": 0
              },
              "resourceType": {
                "enum": [
                  "ENERGY",
                  "BANDWIDTH"
                ],
                "type": "string",
                "description": "Resource type. Default ENERGY when omitted."
              },
              "resourceAmount": {
                "type": "number",
                "description": "Amount of resource to purchase (resource units).",
                "exclusiveMinimum": 0
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "orderId": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "New extension order id (hex string)."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "New extension order id (hex string)."
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Create Energy or Bandwidth Order (Internal)",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "tronsave_internal_extend_delegates",
          "title": "List Extendable Delegations",
          "description": "Return extendable delegations for a receiver plus an `extendData` payload for the extension flow. Requires an internal API key: `tronsave_login` (api-key mode, or signature mode for a wallet with an internal account) or an `Authorization: ApiKey <key>` client header. Never pass API keys as tool arguments; the server forwards the key from the session/header to TronSave. Use as STEP 1 before `tronsave_internal_create_extend_request` when the user wants to extend existing delegation time. This is the only source of submittable `extendData`; `tronsave_list_extendable_delegates` is a public market view, and `tronsave_list_extendable_receivers` finds which receiver to extend. Read-only; does not submit anything. FRESHNESS: pricing/availability change within seconds — run immediately before extending and pass the returned `extendData` unchanged.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "receiver",
              "extendTo"
            ],
            "properties": {
              "extendTo": {
                "type": "integer",
                "maximum": 9007199254740991,
                "description": "Target end time as Unix epoch SECONDS (UTC) for the extended delegation, e.g. now + 86400 for one more day. Milliseconds are rejected by TronSave (INVALID_EXTEND_TIME).",
                "exclusiveMinimum": 0
              },
              "receiver": {
                "type": "string",
                "pattern": "^T[1-9A-HJ-NP-Za-km-z]{33}$",
                "description": "TRON base58 address of the account that receives the delegated resource."
              },
              "requester": {
                "type": "string",
                "pattern": "^T[1-9A-HJ-NP-Za-km-z]{33}$",
                "description": "TRON base58 requester; defaults to the API key account when omitted."
              },
              "resourceType": {
                "enum": [
                  "ENERGY",
                  "BANDWIDTH"
                ],
                "type": "string",
                "description": "Resource type. Default ENERGY when omitted."
              },
              "maxPriceAccepted": {
                "type": "number",
                "minimum": 0,
                "description": "Maximum unit price in SUN you are willing to pay for the extension."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "extendData": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "extendTo": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "maximum": 9007199254740991,
                              "description": "Target end time as Unix epoch SECONDS (UTC) for this delegator row in `POST /v2/extend-request`; echo the value returned by `tronsave_internal_extend_delegates`.",
                              "exclusiveMinimum": 0
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Target end time as Unix epoch SECONDS (UTC) for this delegator row in `POST /v2/extend-request`; echo the value returned by `tronsave_internal_extend_delegates`."
                        },
                        "isExtend": {
                          "anyOf": [
                            {
                              "type": "boolean",
                              "description": "Whether to extend this delegation row."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Whether to extend this delegation row."
                        },
                        "delegator": {
                          "anyOf": [
                            {
                              "type": "string",
                              "pattern": "^T[1-9A-HJ-NP-Za-km-z]{33}$",
                              "description": "TRON base58 delegator address."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "TRON base58 delegator address."
                        },
                        "extraAmount": {
                          "anyOf": [
                            {
                              "type": "number",
                              "minimum": 0,
                              "description": "Additional resource amount to add (resource units)."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Additional resource amount to add (resource units)."
                        }
                      },
                      "additionalProperties": {}
                    },
                    "description": "Delegations to extend; pass unchanged into internal_create_extend_request `extendData`."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Delegations to extend; pass unchanged into internal_create_extend_request `extendData`."
              },
              "yourBalance": {
                "anyOf": [
                  {
                    "type": "number",
                    "description": "Current account balance in SUN."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Current account balance in SUN."
              },
              "isAbleToExtend": {
                "anyOf": [
                  {
                    "type": "boolean",
                    "description": "Whether balance is sufficient to extend."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Whether balance is sufficient to extend."
              },
              "extendOrderBook": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "price": {
                          "anyOf": [
                            {
                              "type": "number",
                              "description": "Price in SUN."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Price in SUN."
                        },
                        "availableResourceAmount": {
                          "anyOf": [
                            {
                              "type": "number",
                              "description": "Available resource amount at this price level."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Available resource amount at this price level."
                        }
                      },
                      "additionalProperties": {}
                    },
                    "description": "Order book for extend."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Order book for extend."
              },
              "totalEstimateTrx": {
                "anyOf": [
                  {
                    "type": "number",
                    "description": "Total estimated TRX cost in SUN."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Total estimated TRX cost in SUN."
              },
              "totalDelegateAmount": {
                "anyOf": [
                  {
                    "type": "number",
                    "description": "Total delegated resource amount."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Total delegated resource amount."
              },
              "totalAvailableExtendAmount": {
                "anyOf": [
                  {
                    "type": "number",
                    "description": "Total available amount to extend."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Total available amount to extend."
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "List Extendable Delegations",
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true
          }
        },
        {
          "name": "tronsave_internal_create_extend_request",
          "title": "Submit Delegation Extension",
          "description": "Submit an extension request for existing delegated resources on TronSave via authenticated REST `POST /v2/extend-request`. Requires an internal API key: `tronsave_login` (api-key mode, or signature mode for a wallet with an internal account) or an `Authorization: ApiKey <key>` client header. Never pass API keys as tool arguments; the server forwards the key from the session/header to TronSave. Side effect: creates an extension order and may commit TRX from the internal account. `extendData` must follow the REST contract (see schema on each row). Get `extendData` from `tronsave_internal_extend_delegates` (STEP 1) and pass the rows unchanged. Do not copy rows from `tronsave_list_extendable_delegates` (GraphQL); that payload shape differs and is for market discovery only.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "receiver",
              "extendData"
            ],
            "properties": {
              "receiver": {
                "type": "string",
                "pattern": "^T[1-9A-HJ-NP-Za-km-z]{33}$",
                "description": "TRON base58 address of the account that receives the delegated resource."
              },
              "extendData": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "delegator",
                    "isExtend",
                    "extraAmount",
                    "extendTo"
                  ],
                  "properties": {
                    "extendTo": {
                      "type": "integer",
                      "maximum": 9007199254740991,
                      "description": "Target end time as Unix epoch SECONDS (UTC) for this delegator row in `POST /v2/extend-request`; echo the value returned by `tronsave_internal_extend_delegates`.",
                      "exclusiveMinimum": 0
                    },
                    "isExtend": {
                      "type": "boolean",
                      "description": "Whether to extend this delegation row."
                    },
                    "delegator": {
                      "type": "string",
                      "pattern": "^T[1-9A-HJ-NP-Za-km-z]{33}$",
                      "description": "TRON base58 delegator address."
                    },
                    "extraAmount": {
                      "type": "number",
                      "minimum": 0,
                      "description": "Additional resource amount to add (resource units)."
                    }
                  }
                },
                "minItems": 1,
                "description": "Delegator-level rows for `POST /v2/extend-request`. Each row matches TronSave's REST extend contract (delegator, isExtend, extraAmount, extendTo in Unix seconds)—typically taken from `extendData` returned by `POST /v2/get-extendable-delegates` when called with the user's session, not from GraphQL `tronsave_list_extendable_delegates`."
              },
              "resourceType": {
                "enum": [
                  "ENERGY",
                  "BANDWIDTH"
                ],
                "type": "string",
                "description": "Resource type. Default ENERGY when omitted."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "orderId": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "New extension order id (hex string)."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "New extension order id (hex string)."
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Submit Delegation Extension",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "tronsave_get_sign_message",
          "title": "Get Signature Message",
          "description": "Step 1 of wallet login. Returns `{ message, timestamp }`: ask the user to sign `message` with their TRON wallet (TronWeb `signMessageV2`, TronLink, etc.), then call `tronsave_login` with `signature: \"<signature>_<timestamp>\"`. Signing the plain decimal `timestamp` text is also accepted. No auth needed; no side effects on the account.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {},
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "message": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Hex-encoded nonce message to sign client-side with the user's TRON wallet. The signature must be produced over THIS exact message (case-sensitive)."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Hex-encoded nonce message to sign client-side with the user's TRON wallet. The signature must be produced over THIS exact message (case-sensitive)."
              },
              "timestamp": {
                "anyOf": [
                  {
                    "type": "integer",
                    "maximum": 9007199254740991,
                    "description": "Unix epoch seconds corresponding to `message`. Pair it with the wallet signature in `<signature>_<timestamp>` form when calling `tronsave_login` (signature mode). This endpoint is a convenience helper; clients may provide their own timestamp payload as well.",
                    "exclusiveMinimum": 0
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Unix epoch seconds corresponding to `message`. Pair it with the wallet signature in `<signature>_<timestamp>` form when calling `tronsave_login` (signature mode). This endpoint is a convenience helper; clients may provide their own timestamp payload as well."
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Get Signature Message",
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true
          }
        },
        {
          "name": "tronsave_login",
          "title": "Login Session",
          "description": "Log in to TronSave for the rest of this MCP connection. Provide EXACTLY ONE of: `signature` = `<signature>_<timestamp>` produced by the user's wallet over the `message` from `tronsave_get_sign_message` (unlocks wallet tools; also loads the wallet's internal API key if it has one), or `apiKey` = raw TronSave internal API key (unlocks internal-account tools and `paymentMethod=internal`). The login is bound to the current `mcp-session-id` automatically — do not pass session ids in later tool arguments. Returns `{ sessionId, authMode, walletAddress?, hasInternalApiKey, expiresAt, unlocked }`. Signed timestamps older than the server limit (default 24h) are rejected with `SIGNATURE_EXPIRED`. Never ask the user for private keys or seed phrases.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "apiKey": {
                "type": "string",
                "minLength": 1,
                "description": "Raw API key for internal-tools login. Provide EXACTLY ONE of `apiKey` or `signature`."
              },
              "signature": {
                "type": "string",
                "minLength": 1,
                "description": "Signature token in `signature_timestamp` format (timestamp is the signed message). Provide EXACTLY ONE of `apiKey` or `signature`."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "authMode": {
                "anyOf": [
                  {
                    "enum": [
                      "signature",
                      "api-key"
                    ],
                    "type": "string",
                    "description": "Which credential type the session holds."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Which credential type the session holds."
              },
              "unlocked": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Human-readable summary of the tool groups now available."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Human-readable summary of the tool groups now available."
              },
              "warnings": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Non-fatal issues (e.g. internal API key could not be loaded)."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Non-fatal issues (e.g. internal API key could not be loaded)."
              },
              "expiresAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
                    "description": "Session expiry (ISO-8601)."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Session expiry (ISO-8601)."
              },
              "sessionId": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "The MCP session (`mcp-session-id`) the login is bound to. MCP clients resend it automatically; never pass it as a tool argument."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "The MCP session (`mcp-session-id`) the login is bound to. MCP clients resend it automatically; never pass it as a tool argument."
              },
              "walletAddress": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Wallet recovered from the signature (signature mode only)."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Wallet recovered from the signature (signature mode only)."
              },
              "hasInternalApiKey": {
                "anyOf": [
                  {
                    "type": "boolean",
                    "description": "Whether internal-account tools and `paymentMethod=internal` are usable in this session."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Whether internal-account tools and `paymentMethod=internal` are usable in this session."
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Login Session",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": false
          }
        },
        {
          "name": "tronsave_logout",
          "title": "Logout",
          "description": "Remove the TronSave login bound to this MCP connection (api-key or signature). Returns `{ loggedOut: true }`; idempotent. Header credentials configured on the client are not affected.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {},
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "loggedOut": {
                "anyOf": [
                  {
                    "type": "boolean",
                    "description": "Always true; the login bound to this MCP session was removed (idempotent)."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Always true; the login bound to this MCP session was removed (idempotent)."
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Logout",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "tronsave_get_session_status",
          "title": "Session Status",
          "description": "Report the current authentication state without calling TronSave: `authMode` (none | api-key | signature), `source` (login | header), `walletAddress`, `hasInternalApiKey`, `expiresAt`, network, and which tool groups are available now. Call this first when unsure whether to log in, and after `SESSION_REQUIRED` / `INVALID_SESSION_TYPE` errors.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {},
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "source": {
                "anyOf": [
                  {
                    "enum": [
                      "none",
                      "login",
                      "header",
                      "oauth"
                    ],
                    "type": "string",
                    "description": "`login` = `tronsave_login` session, `header` = static Authorization header, `oauth` = OAuth sign-in by the client app."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "`login` = `tronsave_login` session, `header` = static Authorization header, `oauth` = OAuth sign-in by the client app."
              },
              "network": {
                "anyOf": [
                  {
                    "enum": [
                      "mainnet",
                      "testnet"
                    ],
                    "type": "string",
                    "description": "Network served by this endpoint."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Network served by this endpoint."
              },
              "authMode": {
                "anyOf": [
                  {
                    "enum": [
                      "none",
                      "api-key",
                      "signature"
                    ],
                    "type": "string",
                    "description": "`signature` unlocks wallet tools; `api-key` unlocks internal-account tools."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "`signature` unlocks wallet tools; `api-key` unlocks internal-account tools."
              },
              "expiresAt": {
                "anyOf": [
                  {
                    "type": "string",
                    "format": "date-time",
                    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
                    "description": "Login expiry for `source=login`."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Login expiry for `source=login`."
              },
              "availableNow": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Tool groups callable with the current auth."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Tool groups callable with the current auth."
              },
              "authenticated": {
                "anyOf": [
                  {
                    "type": "boolean",
                    "description": "Whether any credential is active for this request."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Whether any credential is active for this request."
              },
              "walletAddress": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Wallet of the signature identity, if any."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Wallet of the signature identity, if any."
              },
              "headerAuthError": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "code": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "message": {
                        "anyOf": [
                          {
                            "type": "string"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      }
                    },
                    "description": "Present when header credentials were sent but rejected.",
                    "additionalProperties": {}
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Present when header credentials were sent but rejected."
              },
              "hasInternalApiKey": {
                "anyOf": [
                  {
                    "type": "boolean",
                    "description": "Whether an internal API key is available for api-key tools."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Whether an internal API key is available for api-key tools."
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Session Status",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true
          }
        },
        {
          "name": "tronsave_get_user_info",
          "title": "User Information",
          "description": "Read the current authenticated user's profile and linked TronSave internal account. For the internal balance alone use `tronsave_get_internal_account`; for referral data `tronsave_get_referral`. Returns `{ caller, address, balance (SUN string), info, internalAccount }` — `info` carries referral/contact metadata and may be null; `internalAccount` is null when the wallet has not provisioned a TronSave internal balance yet. `internalAccount.apiKey` is masked. Requires a wallet signature identity. Read-only and idempotent. Use `tronsave_get_user_auto_setting` for the auto-sell config or `tronsave_get_user_permissions` for permission flags when the full profile is unnecessary.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {},
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "info": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "rank": {
                        "anyOf": [
                          {
                            "type": "number",
                            "description": "Rank"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Rank"
                      },
                      "sponsor": {
                        "anyOf": [
                          {
                            "type": "string",
                            "description": "Sponsor"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Sponsor"
                      },
                      "contacts": {
                        "anyOf": [
                          {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "type": {
                                  "anyOf": [
                                    {
                                      "enum": [
                                        "EMAIL",
                                        "PHONE",
                                        "TELEGRAM",
                                        "WECHAT"
                                      ],
                                      "type": "string"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ]
                                },
                                "isActive": {
                                  "anyOf": [
                                    {
                                      "type": "boolean",
                                      "description": "Whether the contact is active"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "description": "Whether the contact is active"
                                },
                                "isVerify": {
                                  "anyOf": [
                                    {
                                      "type": "boolean",
                                      "description": "Whether the contact is verified"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "description": "Whether the contact is verified"
                                },
                                "username": {
                                  "anyOf": [
                                    {
                                      "type": "string",
                                      "description": "Username"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "description": "Username"
                                },
                                "contactId": {
                                  "anyOf": [
                                    {
                                      "type": "string",
                                      "description": "Contact id"
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "description": "Contact id"
                                }
                              },
                              "additionalProperties": {}
                            }
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "totalRef": {
                        "anyOf": [
                          {
                            "type": "number",
                            "description": "Total ref"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Total ref"
                      },
                      "userRefCode": {
                        "anyOf": [
                          {
                            "type": "string",
                            "description": "User ref code"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "User ref code"
                      },
                      "totalRefBonus": {
                        "anyOf": [
                          {
                            "type": "string",
                            "description": "Total ref bonus"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Total ref bonus"
                      },
                      "pendingRefCode": {
                        "anyOf": [
                          {
                            "type": "string",
                            "description": "Pending ref code"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Pending ref code"
                      },
                      "remainRefBonus": {
                        "anyOf": [
                          {
                            "type": "string",
                            "description": "Remain ref bonus"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Remain ref bonus"
                      },
                      "whitelistLevel": {
                        "anyOf": [
                          {
                            "type": "number",
                            "description": "Whitelist level"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Whitelist level"
                      },
                      "createdBotCount": {
                        "anyOf": [
                          {
                            "type": "number",
                            "description": "Number of bots created by the user"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Number of bots created by the user"
                      },
                      "totalPendingRef": {
                        "anyOf": [
                          {
                            "type": "number",
                            "description": "Total pending ref"
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Total pending ref"
                      }
                    },
                    "description": "user information",
                    "additionalProperties": {}
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "caller": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "TRON base58 address of the caller"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "TRON base58 address of the caller"
              },
              "address": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "TRON base58 address"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "TRON base58 address"
              },
              "balance": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Amount in SUN, onchain balance of the address"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Amount in SUN, onchain balance of the address"
              },
              "internalAccount": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "apiKey": {
                        "anyOf": [
                          {
                            "type": "string",
                            "description": "MASKED internal API key (first/last characters only). The full key is held server-side in the session and is never returned."
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "MASKED internal API key (first/last characters only). The full key is held server-side in the session and is never returned."
                      },
                      "balance": {
                        "anyOf": [
                          {
                            "type": "string",
                            "description": "Internal-account balance as a decimal string in SUN (BigInt-safe; TRX = SUN / 1e6)."
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Internal-account balance as a decimal string in SUN (BigInt-safe; TRX = SUN / 1e6)."
                      },
                      "depositAddress": {
                        "anyOf": [
                          {
                            "type": "string",
                            "description": "TRON base58 deposit address used for depositing TRX to the TronSave internal balance."
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "TRON base58 deposit address used for depositing TRX to the TronSave internal balance."
                      }
                    },
                    "description": "Internal account information; null when the wallet has not provisioned a TronSave internal account yet.",
                    "additionalProperties": {}
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "User Information",
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true
          }
        },
        {
          "name": "tronsave_get_user_auto_setting",
          "title": "User Auto Setting",
          "description": "Read the current user's auto-sell configuration (`autoSettings`). Returns the full `autoSettings` object — call this before `tronsave_register_auto_sell` or `tronsave_update_auto_sell_setting` to avoid overwriting fields you do not intend to change. Requires a wallet signature identity. Read-only and idempotent.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {},
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "vote": {
                "anyOf": [
                  {
                    "type": "boolean",
                    "description": "Whether vote-related automation is enabled for the wallet."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Whether vote-related automation is enabled for the wallet."
              },
              "energy": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "isActive": {
                        "anyOf": [
                          {
                            "type": "boolean",
                            "description": "Whether auto-sell is currently active for this resource leg."
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Whether auto-sell is currently active for this resource leg."
                      },
                      "minPrice": {
                        "anyOf": [
                          {
                            "type": "number",
                            "description": "Minimum unit price the seller accepts for auto matches (SUN per resource unit)."
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Minimum unit price the seller accepts for auto matches (SUN per resource unit)."
                      },
                      "profitShare": {
                        "anyOf": [
                          {
                            "type": "number",
                            "description": "Profit share percentage for this resource leg."
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Profit share percentage for this resource leg."
                      },
                      "isAcceptExtended": {
                        "anyOf": [
                          {
                            "type": "boolean",
                            "description": "Whether incoming extend-style matches are accepted for this leg."
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Whether incoming extend-style matches are accepted for this leg."
                      },
                      "minDelegateAmount": {
                        "anyOf": [
                          {
                            "type": "number",
                            "description": "Minimum per-delegation resource amount accepted by auto matches."
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Minimum per-delegation resource amount accepted by auto matches."
                      },
                      "maintainUnDelegate": {
                        "anyOf": [
                          {
                            "type": "number",
                            "description": "Buffer of undelegated resource the seller keeps reserved."
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Buffer of undelegated resource the seller keeps reserved."
                      },
                      "maxDelegateDurationSec": {
                        "anyOf": [
                          {
                            "type": "number",
                            "description": "Upper bound of accepted delegation duration in seconds."
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Upper bound of accepted delegation duration in seconds."
                      },
                      "minDelegateDurationSec": {
                        "anyOf": [
                          {
                            "type": "number",
                            "description": "Lower bound of accepted delegation duration in seconds."
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Lower bound of accepted delegation duration in seconds."
                      }
                    },
                    "description": "Energy auto-sell pool snapshot; null when energy automation is disabled.",
                    "additionalProperties": {}
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Energy auto-sell pool snapshot; null when energy automation is disabled."
              },
              "bandwidth": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "isActive": {
                        "anyOf": [
                          {
                            "type": "boolean",
                            "description": "Whether auto-sell is currently active for this resource leg."
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Whether auto-sell is currently active for this resource leg."
                      },
                      "minPrice": {
                        "anyOf": [
                          {
                            "type": "number",
                            "description": "Minimum unit price the seller accepts for auto matches (SUN per resource unit)."
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Minimum unit price the seller accepts for auto matches (SUN per resource unit)."
                      },
                      "profitShare": {
                        "anyOf": [
                          {
                            "type": "number",
                            "description": "Profit share percentage for this resource leg."
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Profit share percentage for this resource leg."
                      },
                      "isAcceptExtended": {
                        "anyOf": [
                          {
                            "type": "boolean",
                            "description": "Whether incoming extend-style matches are accepted for this leg."
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Whether incoming extend-style matches are accepted for this leg."
                      },
                      "minDelegateAmount": {
                        "anyOf": [
                          {
                            "type": "number",
                            "description": "Minimum per-delegation resource amount accepted by auto matches."
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Minimum per-delegation resource amount accepted by auto matches."
                      },
                      "maintainUnDelegate": {
                        "anyOf": [
                          {
                            "type": "number",
                            "description": "Buffer of undelegated resource the seller keeps reserved."
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Buffer of undelegated resource the seller keeps reserved."
                      },
                      "maxDelegateDurationSec": {
                        "anyOf": [
                          {
                            "type": "number",
                            "description": "Upper bound of accepted delegation duration in seconds."
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Upper bound of accepted delegation duration in seconds."
                      },
                      "minDelegateDurationSec": {
                        "anyOf": [
                          {
                            "type": "number",
                            "description": "Lower bound of accepted delegation duration in seconds."
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Lower bound of accepted delegation duration in seconds."
                      }
                    },
                    "description": "Bandwidth auto-sell pool snapshot; null when bandwidth automation is disabled.",
                    "additionalProperties": {}
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Bandwidth auto-sell pool snapshot; null when bandwidth automation is disabled."
              },
              "suggestSell": {
                "anyOf": [
                  {
                    "type": "boolean",
                    "description": "Whether suggest-sell UX hints are enabled."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Whether suggest-sell UX hints are enabled."
              },
              "withdrawVote": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Withdraw-vote configuration as a backend-defined string; semantics from TronSave docs."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Withdraw-vote configuration as a backend-defined string; semantics from TronSave docs."
              },
              "permitOperations": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "anyOf": [
                            {
                              "type": "number",
                              "description": "Backend-assigned permission row id; null when not yet persisted."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Backend-assigned permission row id; null when not yet persisted."
                        },
                        "type": {
                          "anyOf": [
                            {
                              "type": "string",
                              "description": "Permission category as labelled by the backend (e.g. role/scope tag)."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Permission category as labelled by the backend (e.g. role/scope tag)."
                        },
                        "operations": {
                          "anyOf": [
                            {
                              "type": "array",
                              "items": {
                                "type": "number"
                              },
                              "description": "Numeric operation codes enabled for this row; semantics defined by the backend."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Numeric operation codes enabled for this row; semantics defined by the backend."
                        },
                        "permissionName": {
                          "anyOf": [
                            {
                              "type": "string",
                              "description": "Human-readable permission name; meant for display rather than equality checks."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Human-readable permission name; meant for display rather than equality checks."
                        }
                      },
                      "additionalProperties": {}
                    },
                    "description": "Permission rows enabled for this user; null/empty when no automation has been configured."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Permission rows enabled for this user; null/empty when no automation has been configured."
              },
              "reclaimOnlyTronSave": {
                "anyOf": [
                  {
                    "type": "boolean",
                    "description": "Reclaim flag — when `true`, only TronSave-managed delegations are reclaimed automatically."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Reclaim flag — when `true`, only TronSave-managed delegations are reclaimed automatically."
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "User Auto Setting",
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true
          }
        },
        {
          "name": "tronsave_get_user_permissions",
          "title": "User Permissions",
          "description": "Read the enabled permission operations (`autoSettings.permitOperations`) for the authenticated user. Returns `{ permitOperations: string[] }` — use it before mutating auto-sell or auto-buy rules to confirm the action is allowed for the wallet. Requires a wallet signature identity. Read-only and idempotent.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {},
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "permitOperations": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "anyOf": [
                            {
                              "type": "number",
                              "description": "Backend-assigned permission row id; null when not yet persisted."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Backend-assigned permission row id; null when not yet persisted."
                        },
                        "type": {
                          "anyOf": [
                            {
                              "type": "string",
                              "description": "Permission category as labelled by the backend (e.g. role/scope tag)."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Permission category as labelled by the backend (e.g. role/scope tag)."
                        },
                        "operations": {
                          "anyOf": [
                            {
                              "type": "array",
                              "items": {
                                "type": "number"
                              },
                              "description": "Numeric operation codes enabled for this row; semantics defined by the backend."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Numeric operation codes enabled for this row; semantics defined by the backend."
                        },
                        "permissionName": {
                          "anyOf": [
                            {
                              "type": "string",
                              "description": "Human-readable permission name; meant for display rather than equality checks."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Human-readable permission name; meant for display rather than equality checks."
                        }
                      },
                      "additionalProperties": {}
                    },
                    "description": "Permission rows enabled for this user; defaults to `[]` when nothing is configured."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Permission rows enabled for this user; defaults to `[]` when nothing is configured."
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "User Permissions",
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true
          }
        },
        {
          "name": "tronsave_estimate_buy_resource",
          "title": "Estimate Buy Resource",
          "description": "Quote price and availability for buying ENERGY or BANDWIDTH for a receiver address before placing an order. This quote feeds `tronsave_create_order`; for `tronsave_internal_order_create` (API key) quote with `tronsave_internal_order_estimate`. Returns `{ unitPrice (SUN/unit), durationSec, estimateTrx (total cost in SUN), availableResource, systemDepositAddress }` — map them to `tronsave_create_order` as `orderUnitPrice`, `orderDurationSec`, `paymentPaymentAmount`. Defaults: ENERGY, 100000 units (1000 for BANDWIDTH), 900 s. Read-only and safe to call repeatedly; no session is required, but backend rate limits apply. For order-book depth use `tronsave_list_order_books`; for the minimum unit price only use `tronsave_get_min_price`.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "receiver": {
                "type": "string",
                "pattern": "^T[1-9A-HJ-NP-Za-km-z]{33}$",
                "description": "TRON address that will receive the resource. Strongly recommended: quotes depend on it."
              },
              "unitPrice": {
                "type": "number",
                "description": "Desired unit price in SUN. Values below the market minimum are raised to the minimum. Omit for the MEDIUM market price.",
                "exclusiveMinimum": 0
              },
              "durationSec": {
                "type": "integer",
                "maximum": 9007199254740991,
                "description": "Delegation duration in seconds. Default 900 (15 minutes).",
                "exclusiveMinimum": 0
              },
              "resourceType": {
                "enum": [
                  "ENERGY",
                  "BANDWIDTH"
                ],
                "type": "string",
                "default": "ENERGY",
                "description": "Resource type to buy. Default ENERGY."
              },
              "allowPartialFill": {
                "type": "boolean",
                "description": "Allow partial fill of the order."
              },
              "buyResourceAmount": {
                "type": "integer",
                "maximum": 9007199254740991,
                "description": "Resource units to buy. Default 100000 for ENERGY and 1000 for BANDWIDTH.",
                "exclusiveMinimum": 0
              },
              "minResourceDelegateRequiredAmount": {
                "type": "number",
                "minimum": 0,
                "description": "Minimum resource amount per matching provider."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "unitPrice": {
                "anyOf": [
                  {
                    "type": "number",
                    "description": "Quoted unit price in SUN per resource unit → `orderUnitPrice`."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Quoted unit price in SUN per resource unit → `orderUnitPrice`."
              },
              "durationSec": {
                "anyOf": [
                  {
                    "type": "number",
                    "description": "Delegation duration in seconds → `orderDurationSec`."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Delegation duration in seconds → `orderDurationSec`."
              },
              "estimateTrx": {
                "anyOf": [
                  {
                    "type": "number",
                    "description": "Estimated total cost in SUN (despite the name; TRX = value / 1e6) → `paymentPaymentAmount`."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Estimated total cost in SUN (despite the name; TRX = value / 1e6) → `paymentPaymentAmount`."
              },
              "availableResource": {
                "anyOf": [
                  {
                    "type": "number",
                    "description": "Resource units currently available at this price; if lower than requested, the order may fill partially."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Resource units currently available at this price; if lower than requested, the order may fill partially."
              },
              "systemDepositAddress": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "TronSave deposit address; destination of the signed TRX transfer for `paymentMethod=onchain`."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "TronSave deposit address; destination of the signed TRX transfer for `paymentMethod=onchain`."
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Estimate Buy Resource",
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true
          }
        },
        {
          "name": "tronsave_get_order",
          "title": "Order Detail",
          "description": "Read one order by `id` and return its full snapshot for NORMAL, FAST, or EXTEND order types. With only an API key, use `tronsave_internal_order_details` instead. Use this as the source of truth before `tronsave_update_order`, `tronsave_sell_order_manual`, or `tronsave_cancel_order` to avoid acting on stale state. Requires a wallet signature identity. Read-only and idempotent.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Target order id (`MObjectId`) to inspect. Use this to confirm current status/price before update, sell, or cancel actions."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "order": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "id": {
                        "anyOf": [
                          {
                            "type": "string",
                            "description": "Order id (`MObjectId`); use with `tronsave_get_order` or mutate tools."
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Order id (`MObjectId`); use with `tronsave_get_order` or mutate tools."
                      },
                      "apy": {
                        "anyOf": [
                          {
                            "type": "number",
                            "description": "Annualized yield hint as returned by the API (see TronSave semantics)."
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Annualized yield hint as returned by the API (see TronSave semantics)."
                      },
                      "isOwner": {
                        "anyOf": [
                          {
                            "type": "boolean",
                            "description": "Whether the list query’s viewer context treats this row as owned by `myAddress`."
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Whether the list query’s viewer context treats this row as owned by `myAddress`."
                      },
                      "receiver": {
                        "anyOf": [
                          {
                            "type": "object",
                            "properties": {
                              "address": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "description": "TRON base58 address for this party."
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "TRON base58 address for this party."
                              }
                            },
                            "description": "Receiver wallet and related party info for the delegation leg.",
                            "additionalProperties": {}
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Receiver wallet and related party info for the delegation leg."
                      },
                      "createdAt": {
                        "anyOf": [
                          {
                            "type": "string",
                            "format": "date-time",
                            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
                            "description": "Order creation time (ISO-8601)."
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Order creation time (ISO-8601)."
                      },
                      "requester": {
                        "anyOf": [
                          {
                            "type": "object",
                            "properties": {
                              "address": {
                                "anyOf": [
                                  {
                                    "type": "string",
                                    "description": "TRON base58 address for this party."
                                  },
                                  {
                                    "type": "null"
                                  }
                                ],
                                "description": "TRON base58 address for this party."
                              }
                            },
                            "description": "Requester party when present.",
                            "additionalProperties": {}
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Requester party when present."
                      },
                      "typeOrder": {
                        "anyOf": [
                          {
                            "enum": [
                              "NORMAL",
                              "FAST",
                              "EXTEND"
                            ],
                            "type": "string",
                            "description": "Market order flavor."
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Market order flavor."
                      },
                      "unitPrice": {
                        "anyOf": [
                          {
                            "type": "number",
                            "description": "Unit price in SUN."
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Unit price in SUN."
                      },
                      "isMatching": {
                        "anyOf": [
                          {
                            "type": "boolean",
                            "description": "Whether this order matches the viewer/matching filter used in the query."
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Whether this order matches the viewer/matching filter used in the query."
                      },
                      "durationSec": {
                        "anyOf": [
                          {
                            "type": "number",
                            "description": "Delegation duration in seconds."
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Delegation duration in seconds."
                      },
                      "remainAmount": {
                        "anyOf": [
                          {
                            "type": "number",
                            "description": "Resource not yet consumed or remaining to fulfill."
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Resource not yet consumed or remaining to fulfill."
                      },
                      "resourceType": {
                        "anyOf": [
                          {
                            "enum": [
                              "ENERGY",
                              "BANDWIDTH"
                            ],
                            "type": "string",
                            "description": "`ENERGY` or `BANDWIDTH`."
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "`ENERGY` or `BANDWIDTH`."
                      },
                      "resourceAmount": {
                        "anyOf": [
                          {
                            "type": "number",
                            "description": "Original resource amount on the order."
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Original resource amount on the order."
                      }
                    },
                    "additionalProperties": {}
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Order Detail",
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true
          }
        },
        {
          "name": "tronsave_list_orders",
          "title": "List Orders",
          "description": "Query the market order list with paging (`offset`, `limit` ≤ 10). For an API-key account's own purchases use `tronsave_internal_order_history`. Returns `{ orders: [{ id, requester?.address, receiver.address, resourceType, resourceAmount, remainAmount, durationSec, unitPrice (SUN), isOwner, isMatching, apy, createdAt, typeOrder (NORMAL|FAST|EXTEND) }] }`. `status`: `ACTIVE` = still matching, `COMPLETED` = no longer matching. Set `isOnlyMyOrder=true` (requires a wallet signature identity) to list orders requested by the caller's wallet. Use `tronsave_get_order` with an `id` for one snapshot before mutating an order.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "limit": {
                "type": "integer",
                "maximum": 10,
                "minimum": 1,
                "description": "Maximum rows to return in one call. Prefer modest limits to avoid huge payloads; page with `offset`."
              },
              "offset": {
                "type": "integer",
                "maximum": 200,
                "minimum": 0,
                "description": "Zero-based row offset for page N (skip first `offset` matches). Omit when starting from the first page."
              },
              "status": {
                "enum": [
                  "ACTIVE",
                  "COMPLETED"
                ],
                "type": "string",
                "description": "Lifecycle filter: `ACTIVE` = still matching/open, `COMPLETED` = no longer matching. Omit for both."
              },
              "resourceType": {
                "enum": [
                  "ENERGY",
                  "BANDWIDTH"
                ],
                "type": "string",
                "description": "Restrict to `ENERGY` or `BANDWIDTH` orders; omit for both."
              },
              "isOnlyMyOrder": {
                "type": "boolean",
                "description": "When `true`, only orders requested by the wallet of the current signature identity (signature login or `Signature` header). Api-key-only sessions cannot use this filter."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "orders": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "anyOf": [
                            {
                              "type": "string",
                              "description": "Order id (`MObjectId`); use with `tronsave_get_order` or mutate tools."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Order id (`MObjectId`); use with `tronsave_get_order` or mutate tools."
                        },
                        "apy": {
                          "anyOf": [
                            {
                              "type": "number",
                              "description": "Annualized yield hint as returned by the API (see TronSave semantics)."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Annualized yield hint as returned by the API (see TronSave semantics)."
                        },
                        "isOwner": {
                          "anyOf": [
                            {
                              "type": "boolean",
                              "description": "Whether the list query’s viewer context treats this row as owned by `myAddress`."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Whether the list query’s viewer context treats this row as owned by `myAddress`."
                        },
                        "receiver": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "address": {
                                  "anyOf": [
                                    {
                                      "type": "string",
                                      "description": "TRON base58 address for this party."
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "description": "TRON base58 address for this party."
                                }
                              },
                              "description": "Receiver wallet and related party info for the delegation leg.",
                              "additionalProperties": {}
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Receiver wallet and related party info for the delegation leg."
                        },
                        "createdAt": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "date-time",
                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
                              "description": "Order creation time (ISO-8601)."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Order creation time (ISO-8601)."
                        },
                        "requester": {
                          "anyOf": [
                            {
                              "type": "object",
                              "properties": {
                                "address": {
                                  "anyOf": [
                                    {
                                      "type": "string",
                                      "description": "TRON base58 address for this party."
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "description": "TRON base58 address for this party."
                                }
                              },
                              "description": "Requester party when present.",
                              "additionalProperties": {}
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Requester party when present."
                        },
                        "typeOrder": {
                          "anyOf": [
                            {
                              "enum": [
                                "NORMAL",
                                "FAST",
                                "EXTEND"
                              ],
                              "type": "string",
                              "description": "Market order flavor."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Market order flavor."
                        },
                        "unitPrice": {
                          "anyOf": [
                            {
                              "type": "number",
                              "description": "Unit price in SUN."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Unit price in SUN."
                        },
                        "isMatching": {
                          "anyOf": [
                            {
                              "type": "boolean",
                              "description": "Whether this order matches the viewer/matching filter used in the query."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Whether this order matches the viewer/matching filter used in the query."
                        },
                        "durationSec": {
                          "anyOf": [
                            {
                              "type": "number",
                              "description": "Delegation duration in seconds."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Delegation duration in seconds."
                        },
                        "remainAmount": {
                          "anyOf": [
                            {
                              "type": "number",
                              "description": "Resource not yet consumed or remaining to fulfill."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Resource not yet consumed or remaining to fulfill."
                        },
                        "resourceType": {
                          "anyOf": [
                            {
                              "enum": [
                                "ENERGY",
                                "BANDWIDTH"
                              ],
                              "type": "string",
                              "description": "`ENERGY` or `BANDWIDTH`."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "`ENERGY` or `BANDWIDTH`."
                        },
                        "resourceAmount": {
                          "anyOf": [
                            {
                              "type": "number",
                              "description": "Original resource amount on the order."
                            },
                            {
                              "type": "null"
                            }
                          ],
                          "description": "Original resource amount on the order."
                        }
                      },
                      "additionalProperties": {}
                    },
                    "description": "Matching orders for this page; may be large—use pagination inputs to chunk."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Matching orders for this page; may be large—use pagination inputs to chunk."
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "List Orders",
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true
          }
        },
        {
          "name": "tronsave_list_order_books",
          "title": "Order Book",
          "description": "Read market depth buckets for `ENERGY` or `BANDWIDTH`. Public view; with an API key, `tronsave_internal_order_book` adds SLOW/MEDIUM/FAST price tiers. Returns price buckets `{ min, max, value }` optionally scoped by viewer address, minimum delegate amount, and duration. No login required; read-only and idempotent. Use this to estimate market ranges before create/update decisions; pair with `tronsave_estimate_buy_resource` for quote-style buy estimation and `tronsave_get_order` for one concrete order.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "resourceType"
            ],
            "properties": {
              "address": {
                "type": "string",
                "pattern": "^T[1-9A-HJ-NP-Za-km-z]{33}$",
                "description": "Optional viewer/requester wallet context."
              },
              "durationSec": {
                "type": "number",
                "description": "Optional delegation duration filter in seconds."
              },
              "resourceType": {
                "enum": [
                  "ENERGY",
                  "BANDWIDTH"
                ],
                "type": "string",
                "description": "Order-book side to query (`ENERGY` or `BANDWIDTH`)."
              },
              "minDelegateAmount": {
                "type": "number",
                "description": "Optional minimum delegate amount floor for bucket filtering."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "orderBook": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "max": {
                          "anyOf": [
                            {
                              "type": "number"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "min": {
                          "anyOf": [
                            {
                              "type": "number"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "value": {
                          "anyOf": [
                            {
                              "type": "number"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        }
                      },
                      "additionalProperties": {}
                    }
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Order Book",
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true
          }
        },
        {
          "name": "tronsave_get_min_price",
          "title": "Get Minimum Unit Price",
          "description": "Quote the minimum unit price for a buy. Use when only the floor price matters; for a full purchase quote use `tronsave_estimate_buy_resource`, for a grid across amounts and durations `tronsave_get_price_table`. Returns `{ minPrice }` (SUN per resource unit; per day when `durationSec` >= 86400) from GraphQL `market.estimateMinPrice` for the given `resourceType`, `buyAmount`, and `durationSec`. Optional `address` scopes context when the API supports it. No login required. Read-only and idempotent. Pair with `tronsave_estimate_buy_resource` for full buy quotes and `tronsave_list_order_books` for depth buckets.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "address": {
                "type": "string",
                "pattern": "^T[1-9A-HJ-NP-Za-km-z]{33}$",
                "description": "Optional TRON base58 address (`TronAddress`). When omitted, the server uses anonymous/global market context."
              },
              "buyAmount": {
                "type": "number",
                "description": "Resource amount to price (same units as order book / delegate amounts for that resource type). Default 100000 for ENERGY and 1000 for BANDWIDTH",
                "exclusiveMinimum": 0
              },
              "durationSec": {
                "type": "number",
                "default": 900,
                "description": "Delegation window in seconds; must match the duration you plan to use on a real order for comparable quotes. Default 15 minutes",
                "exclusiveMinimum": 0
              },
              "resourceType": {
                "enum": [
                  "ENERGY",
                  "BANDWIDTH"
                ],
                "type": "string",
                "default": "ENERGY",
                "description": "Market leg: `ENERGY` or `BANDWIDTH`. Default ENERGY"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "minPrice": {
                "anyOf": [
                  {
                    "type": "number",
                    "description": "Estimated minimum unit price in SUN for the given `resourceType`, `buyAmount`, and `durationSec`; align with `tronsave_estimate_buy_resource` and order `unitPrice` conventions (same as GraphQL `market.estimateMinPrice`)."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Estimated minimum unit price in SUN for the given `resourceType`, `buyAmount`, and `durationSec`; align with `tronsave_estimate_buy_resource` and order `unitPrice` conventions (same as GraphQL `market.estimateMinPrice`)."
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Get Minimum Unit Price",
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true
          }
        },
        {
          "name": "tronsave_list_extendable_delegates",
          "title": "Extendable Delegates",
          "description": "List extendable delegate candidates for a `receiver` and `resourceType` (ENERGY|BANDWIDTH). Optional `suggestData` scores an extend-and-buy scenario for planning purposes. Read-only; does NOT create orders or change on-chain state. No login required. NOTE: this is GraphQL market data for discovery only. To actually submit an extension, use `tronsave_internal_create_extend_request` with `extendData` from the authenticated REST `POST /v2/get-extendable-delegates` (payload shape differs from this GraphQL response).",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "receiver",
              "resourceType"
            ],
            "properties": {
              "receiver": {
                "type": "string",
                "pattern": "^T[1-9A-HJ-NP-Za-km-z]{33}$",
                "description": "TRON base58 address (typically starts with `T`) that currently receives or will receive the delegated resource. This is the primary filter: the response describes delegates relevant to extending that account's delegation."
              },
              "requester": {
                "type": "string",
                "description": "Optional TRON base58 address of the viewing/requesting party. When an MCP session is active, the server may still derive identity from auth headers; use this when the API expects an explicit requester string distinct from the receiver."
              },
              "suggestData": {
                "type": "object",
                "required": [
                  "extendTo",
                  "extraBuyAmount",
                  "extendAmount",
                  "maxPrice"
                ],
                "properties": {
                  "extendTo": {
                    "type": "integer",
                    "maximum": 9007199254740991,
                    "description": "Target end time as Unix epoch SECONDS (UTC), e.g. now + 86400, same unit as the internal extend tools' `extendTo`.",
                    "exclusiveMinimum": 0
                  },
                  "maxPrice": {
                    "type": "number",
                    "description": "Maximum unit price in SUN the user is willing to pay for the suggested extend/buy path; used for server-side scoring, not a live order placement by itself."
                  },
                  "extendAmount": {
                    "type": "number",
                    "description": "Hypothetical amount of existing delegation to extend (resource units matching `resourceType`)."
                  },
                  "extraBuyAmount": {
                    "type": "number",
                    "description": "Hypothetical extra ENERGY or BANDWIDTH units to buy beyond simple extension; units match `resourceType`, not SUN."
                  }
                },
                "description": "Optional nested scenario for extend-and-buy suggestion scoring. If omitted, the query returns delegate rows without that hypothetical. If provided, supply all four fields together; partial objects are invalid for typical GraphQL input shapes."
              },
              "resourceType": {
                "enum": [
                  "ENERGY",
                  "BANDWIDTH"
                ],
                "type": "string",
                "description": "Which resource market leg to query: `ENERGY` for contract execution headroom, `BANDWIDTH` for transaction bandwidth. Must match how you plan to extend or buy."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "extendableDelegates": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "data": {
                        "anyOf": [
                          {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "amount": {
                                  "anyOf": [
                                    {
                                      "type": "number",
                                      "description": "Delegate amount associated with this row (resource units)."
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "description": "Delegate amount associated with this row (resource units)."
                                },
                                "reason": {
                                  "anyOf": [
                                    {
                                      "type": "array",
                                      "items": {
                                        "type": "string"
                                      },
                                      "description": "Human-readable reasons when extension is blocked or conditional."
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "description": "Human-readable reasons when extension is blocked or conditional."
                                },
                                "extendPrice": {
                                  "anyOf": [
                                    {
                                      "type": "number",
                                      "description": "Indicative unit price or price component for extending this row (SUN unless API documents otherwise)."
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "description": "Indicative unit price or price component for extending this row (SUN unless API documents otherwise)."
                                },
                                "reclaimTime": {
                                  "anyOf": [
                                    {
                                      "type": "number",
                                      "description": "Timestamp related to reclaim/unlock timing when relevant."
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "description": "Timestamp related to reclaim/unlock timing when relevant."
                                },
                                "isExtendable": {
                                  "anyOf": [
                                    {
                                      "type": "boolean",
                                      "description": "Whether this delegate entry can be extended under current rules."
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "description": "Whether this delegate entry can be extended under current rules."
                                },
                                "minTimeExtendTo": {
                                  "anyOf": [
                                    {
                                      "type": "number",
                                      "description": "Minimum end time boundary required before extension is allowed."
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "description": "Minimum end time boundary required before extension is allowed."
                                },
                                "availableExtendAt": {
                                  "anyOf": [
                                    {
                                      "type": "number",
                                      "description": "Earliest time at which extension becomes available for this row."
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "description": "Earliest time at which extension becomes available for this row."
                                },
                                "availableResource": {
                                  "anyOf": [
                                    {
                                      "type": "number",
                                      "description": "Resource still available from this delegate for matching/extension."
                                    },
                                    {
                                      "type": "null"
                                    }
                                  ],
                                  "description": "Resource still available from this delegate for matching/extension."
                                }
                              },
                              "additionalProperties": {}
                            },
                            "description": "Per-delegator or per-offer rows backing the aggregates above; may be empty when nothing is extendable."
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Per-delegator or per-offer rows backing the aggregates above; may be empty when nothing is extendable."
                      },
                      "overBuyPrice": {
                        "anyOf": [
                          {
                            "type": "number",
                            "description": "Price facet associated with the over-buy leg (SUN-related aggregate; exact semantics from TronSave API)."
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Price facet associated with the over-buy leg (SUN-related aggregate; exact semantics from TronSave API)."
                      },
                      "overBuyAmount": {
                        "anyOf": [
                          {
                            "type": "number",
                            "description": "Amount considered in excess of a simple extend-only path when `suggestData` implies extra buy."
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Amount considered in excess of a simple extend-only path when `suggestData` implies extra buy."
                      },
                      "maxExtendAmount": {
                        "anyOf": [
                          {
                            "type": "number",
                            "description": "Largest extendable resource amount (units) aggregated for this query."
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Largest extendable resource amount (units) aggregated for this query."
                      },
                      "minExtendRequired": {
                        "anyOf": [
                          {
                            "type": "number",
                            "description": "Minimum resource amount the market requires to treat an extension as valid, if applicable."
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Minimum resource amount the market requires to treat an extension as valid, if applicable."
                      },
                      "overBuyAmountAvailable": {
                        "anyOf": [
                          {
                            "type": "number",
                            "description": "How much of the over-buy amount is currently matchable."
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "How much of the over-buy amount is currently matchable."
                      },
                      "overBuyAmountMaxAvailable": {
                        "anyOf": [
                          {
                            "type": "number",
                            "description": "Upper cap for over-buy availability under current book conditions."
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Upper cap for over-buy availability under current book conditions."
                      },
                      "totalAvailableExtraBuyAmount": {
                        "anyOf": [
                          {
                            "type": "number",
                            "description": "Capacity hint for additional buy amount on top of extension under current market state."
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Capacity hint for additional buy amount on top of extension under current market state."
                      }
                    },
                    "description": "Null when the market has no payload or GraphQL returned no branch; check tool-level errors for hard failures.",
                    "additionalProperties": {}
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Null when the market has no payload or GraphQL returned no branch; check tool-level errors for hard failures."
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Extendable Delegates",
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true
          }
        },
        {
          "name": "tronsave_create_order",
          "title": "Create Order",
          "description": "Create a buy order for ENERGY/BANDWIDTH delegated to `orderReceiver`. SPENDS FUNDS — confirm the plan with the user first. API-key integrations paying from the internal balance can instead use `tronsave_internal_order_create` (FAST/MEDIUM/SLOW pricing, fill guards). Inputs: `orderResourceType`, `orderReceiver`, `orderUnitPrice` (SUN, not TRX), `orderDurationSec`, `orderResourceAmount`, `paymentPaymentAmount` (SUN), and `paymentMethod`: `internal` — debits the TronSave internal balance (needs an api-key login/header or a signature login whose wallet has an internal account); `onchain` — no login needed, but `paymentSignedTx` must be the user's wallet-signed TRX transfer to `systemDepositAddress`. Take price/amount/duration values from the latest `tronsave_estimate_buy_resource`. Returns `{ success, message, code, data.orderId }` — check `success`; verify with `tronsave_get_order` or `tronsave_list_orders`. Not idempotent: on a timeout, verify before retrying to avoid duplicate orders.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "orderResourceType",
              "orderReceiver",
              "orderUnitPrice",
              "orderDurationSec",
              "orderResourceAmount",
              "paymentMethod",
              "paymentPaymentAmount"
            ],
            "properties": {
              "orderReceiver": {
                "type": "string",
                "pattern": "^T[1-9A-HJ-NP-Za-km-z]{33}$",
                "description": "TRON base58 address (starts with T) that receives delegated resource. Same as `receiver` passed to `tronsave_estimate_buy_resource`."
              },
              "paymentMethod": {
                "enum": [
                  "onchain",
                  "internal"
                ],
                "type": "string",
                "description": "Payment method for this order: `onchain` (wallet signed tx) or `internal` (internal balance)."
              },
              "orderUnitPrice": {
                "type": "number",
                "description": "Unit price in SUN per resource unit (NOT TRX). Use `unitPrice` from the latest `tronsave_estimate_buy_resource` for the same receiver, amount, and duration.",
                "exclusiveMinimum": 0
              },
              "paymentSignedTx": {
                "type": "object",
                "required": [
                  "txID",
                  "raw_data",
                  "raw_data_hex",
                  "signature"
                ],
                "properties": {
                  "txID": {
                    "type": "string",
                    "pattern": "^[0-9a-fA-F]+$",
                    "maxLength": 64,
                    "minLength": 64,
                    "description": "Transaction hash (64 hex chars, lowercase, no `0x` prefix)."
                  },
                  "visible": {
                    "type": "boolean",
                    "description": "Whether addresses inside `raw_data.contract` are base58 (`true`) vs hex (`false`)."
                  },
                  "raw_data": {
                    "type": "object",
                    "required": [
                      "contract",
                      "ref_block_bytes",
                      "ref_block_hash",
                      "expiration",
                      "timestamp"
                    ],
                    "properties": {
                      "contract": {
                        "type": "array",
                        "items": {},
                        "minItems": 1,
                        "description": "At least one TRON contract entry; shape varies by contract type."
                      },
                      "timestamp": {
                        "type": "integer",
                        "maximum": 9007199254740991,
                        "description": "Tx timestamp (Unix epoch ms).",
                        "exclusiveMinimum": 0
                      },
                      "expiration": {
                        "type": "integer",
                        "maximum": 9007199254740991,
                        "description": "Tx expiration (Unix epoch ms).",
                        "exclusiveMinimum": 0
                      },
                      "ref_block_hash": {
                        "type": "string",
                        "description": "Reference block hash (hex)."
                      },
                      "ref_block_bytes": {
                        "type": "string",
                        "description": "Reference block bytes (hex)."
                      }
                    },
                    "description": "Raw transaction body produced by TronWeb (`raw_data`).",
                    "additionalProperties": {}
                  },
                  "signature": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "pattern": "^[0-9a-fA-F]+$",
                      "minLength": 1
                    },
                    "minItems": 1,
                    "description": "Wallet signatures over `raw_data_hex`; usually a single hex string (130 chars for 65-byte secp256k1)."
                  },
                  "raw_data_hex": {
                    "type": "string",
                    "pattern": "^[0-9a-fA-F]+$",
                    "description": "Hex-encoded `raw_data` body."
                  }
                },
                "description": "Required when `paymentMethod=onchain`: the user's wallet-signed TRX transfer of `paymentPaymentAmount` SUN to `systemDepositAddress` (from `tronsave_estimate_buy_resource`), TronWeb shape `{ txID, raw_data, raw_data_hex, signature[] }`. Must be produced client-side by the user's wallet; never fabricate or hand-edit.",
                "additionalProperties": {}
              },
              "orderDurationSec": {
                "type": "integer",
                "maximum": 9007199254740991,
                "description": "Delegation duration in seconds. Must match the `durationSec` used in `tronsave_estimate_buy_resource`.",
                "exclusiveMinimum": 0
              },
              "orderResourceType": {
                "enum": [
                  "ENERGY",
                  "BANDWIDTH"
                ],
                "type": "string",
                "description": "Resource to buy: ENERGY (smart contracts) or BANDWIDTH (transactions). Must match `tronsave_estimate_buy_resource`."
              },
              "orderResourceAmount": {
                "type": "integer",
                "maximum": 9007199254740991,
                "description": "Amount of ENERGY or BANDWIDTH units to purchase. Same as `buyResourceAmount` in estimate when applicable.",
                "exclusiveMinimum": 0
              },
              "paymentPaymentAmount": {
                "type": "number",
                "minimum": 0,
                "description": "Total payment in SUN (1 TRX = 1e6 SUN). Use `estimateTrx` (SUN) from the latest `tronsave_estimate_buy_resource`."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "code": {
                "anyOf": [
                  {
                    "type": "integer",
                    "maximum": 9007199254740991,
                    "minimum": -9007199254740991,
                    "description": "GraphQL mutation status code (HTTP-like; `0`/`200` indicates success). Always pair with `success` for routing."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "GraphQL mutation status code (HTTP-like; `0`/`200` indicates success). Always pair with `success` for routing."
              },
              "data": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "orderId": {
                        "anyOf": [
                          {
                            "type": "string",
                            "description": "Newly created order id (`MObjectId`); pass to `tronsave_get_order` to inspect status."
                          },
                          {
                            "type": "null"
                          }
                        ],
                        "description": "Newly created order id (`MObjectId`); pass to `tronsave_get_order` to inspect status."
                      }
                    },
                    "additionalProperties": {}
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "message": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Human-readable status text. Populated even on success; localized error messages may appear here on failure."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Human-readable status text. Populated even on success; localized error messages may appear here on failure."
              },
              "success": {
                "anyOf": [
                  {
                    "type": "boolean",
                    "description": "Whether the mutation succeeded at the backend level. Always check this before reading `data`."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Whether the mutation succeeded at the backend level. Always check this before reading `data`."
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Create Order",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "tronsave_sell_order_manual",
          "title": "Sell Order Manual",
          "description": "Manually execute seller-side fulfillment of an existing order with a wallet `signedTx`. Returns `{ success, message, code, delegatedId }`. Side effect: broadcasts a market/delegation transaction and may consume balances/resources; not idempotent — each call re-executes. Requires a wallet signature identity. Use only when explicit manual sell is intended; call `tronsave_get_order` first to verify order state before signing.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "orderId",
              "signedTx"
            ],
            "properties": {
              "orderId": {
                "type": "string",
                "minLength": 1,
                "description": "Target order id (`MObjectId`) to manually fulfill. Should be an order eligible for seller-side manual execution."
              },
              "signedTx": {
                "type": "object",
                "required": [
                  "txID",
                  "raw_data",
                  "raw_data_hex",
                  "signature"
                ],
                "properties": {
                  "txID": {
                    "type": "string",
                    "pattern": "^[0-9a-fA-F]+$",
                    "maxLength": 64,
                    "minLength": 64,
                    "description": "Transaction hash (64 hex chars, lowercase, no `0x` prefix)."
                  },
                  "visible": {
                    "type": "boolean",
                    "description": "Whether addresses inside `raw_data.contract` are base58 (`true`) vs hex (`false`)."
                  },
                  "raw_data": {
                    "type": "object",
                    "required": [
                      "contract",
                      "ref_block_bytes",
                      "ref_block_hash",
                      "expiration",
                      "timestamp"
                    ],
                    "properties": {
                      "contract": {
                        "type": "array",
                        "items": {},
                        "minItems": 1,
                        "description": "At least one TRON contract entry; shape varies by contract type."
                      },
                      "timestamp": {
                        "type": "integer",
                        "maximum": 9007199254740991,
                        "description": "Tx timestamp (Unix epoch ms).",
                        "exclusiveMinimum": 0
                      },
                      "expiration": {
                        "type": "integer",
                        "maximum": 9007199254740991,
                        "description": "Tx expiration (Unix epoch ms).",
                        "exclusiveMinimum": 0
                      },
                      "ref_block_hash": {
                        "type": "string",
                        "description": "Reference block hash (hex)."
                      },
                      "ref_block_bytes": {
                        "type": "string",
                        "description": "Reference block bytes (hex)."
                      }
                    },
                    "description": "Raw transaction body produced by TronWeb (`raw_data`).",
                    "additionalProperties": {}
                  },
                  "signature": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "pattern": "^[0-9a-fA-F]+$",
                      "minLength": 1
                    },
                    "minItems": 1,
                    "description": "Wallet signatures over `raw_data_hex`; usually a single hex string (130 chars for 65-byte secp256k1)."
                  },
                  "raw_data_hex": {
                    "type": "string",
                    "pattern": "^[0-9a-fA-F]+$",
                    "description": "Hex-encoded `raw_data` body."
                  }
                },
                "description": "Required wallet-signed transaction payload (TronWeb shape: `{ txID, raw_data, raw_data_hex, signature[] }`). Must come from client-side signing; never fabricate.",
                "additionalProperties": {}
              },
              "paymentAddress": {
                "type": "string",
                "pattern": "^T[1-9A-HJ-NP-Za-km-z]{33}$",
                "description": "Optional payout/payment address override when settlement flow requires it."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "code": {
                "anyOf": [
                  {
                    "type": "integer",
                    "maximum": 9007199254740991,
                    "minimum": -9007199254740991,
                    "description": "GraphQL mutation status code (HTTP-like; `0`/`200` indicates success). Always pair with `success` for routing."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "GraphQL mutation status code (HTTP-like; `0`/`200` indicates success). Always pair with `success` for routing."
              },
              "message": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Human-readable status text. Populated even on success; localized error messages may appear here on failure."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Human-readable status text. Populated even on success; localized error messages may appear here on failure."
              },
              "success": {
                "anyOf": [
                  {
                    "type": "boolean",
                    "description": "Whether the mutation succeeded at the backend level. Always check this before reading `data`."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Whether the mutation succeeded at the backend level. Always check this before reading `data`."
              },
              "delegatedId": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "On-chain delegate id created by the manual sell when the underlying transaction is confirmed; null until confirmation lands."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "On-chain delegate id created by the manual sell when the underlying transaction is confirmed; null until confirmation lands."
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Sell Order Manual",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "tronsave_cancel_order",
          "title": "Cancel Order",
          "description": "Cancel an open order by `orderId`. Returns `{ success, message, code }`. Side effect: marks the order non-matchable and refunds locked balance per backend rules; effectively destructive on the live order. Idempotent — cancelling an already-cancelled order is a no-op success. Fails for fulfilled orders or unauthorized callers. Requires a wallet signature identity (the order's owner). Verify state with `tronsave_get_order` first; prefer `tronsave_update_order` when only price/receiver should change.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "orderId"
            ],
            "properties": {
              "orderId": {
                "type": "string",
                "minLength": 1,
                "description": "Target order id (`MObjectId`) to cancel. Must be an active order owned/authorized by the current session; already-fulfilled or already-cancelled orders are expected to fail."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "code": {
                "anyOf": [
                  {
                    "type": "integer",
                    "maximum": 9007199254740991,
                    "minimum": -9007199254740991,
                    "description": "GraphQL mutation status code (HTTP-like; `0`/`200` indicates success). Always pair with `success` for routing."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "GraphQL mutation status code (HTTP-like; `0`/`200` indicates success). Always pair with `success` for routing."
              },
              "message": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Human-readable status text. Populated even on success; localized error messages may appear here on failure."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Human-readable status text. Populated even on success; localized error messages may appear here on failure."
              },
              "success": {
                "anyOf": [
                  {
                    "type": "boolean",
                    "description": "Whether the mutation succeeded at the backend level. Always check this before reading `data`."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Whether the mutation succeeded at the backend level. Always check this before reading `data`."
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Cancel Order",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "tronsave_update_order",
          "title": "Update Order",
          "description": "Update an open order by `orderId` with partial fields (`receiver`, `newPrice`). Returns `{ success, message, code }`. Side effect: overwrites live order parameters; not idempotent — each call with a different `newPrice` produces a new state. Requires a wallet signature identity (the order's owner). Prefer this over cancel+recreate when only price/receiver should change. Verify state with `tronsave_get_order` first; fails for already-fulfilled, already-cancelled, or non-editable orders.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "orderId"
            ],
            "properties": {
              "orderId": {
                "type": "string",
                "minLength": 1,
                "description": "Target order id (`MObjectId`) to update. Order must still be open and editable."
              },
              "newPrice": {
                "type": "number",
                "description": "Optional replacement unit price in SUN per resource unit.",
                "exclusiveMinimum": 0
              },
              "receiver": {
                "type": "string",
                "pattern": "^T[1-9A-HJ-NP-Za-km-z]{33}$",
                "description": "Optional replacement receiver TRON address."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "code": {
                "anyOf": [
                  {
                    "type": "integer",
                    "maximum": 9007199254740991,
                    "minimum": -9007199254740991,
                    "description": "GraphQL mutation status code (HTTP-like; `0`/`200` indicates success). Always pair with `success` for routing."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "GraphQL mutation status code (HTTP-like; `0`/`200` indicates success). Always pair with `success` for routing."
              },
              "message": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Human-readable status text. Populated even on success; localized error messages may appear here on failure."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Human-readable status text. Populated even on success; localized error messages may appear here on failure."
              },
              "success": {
                "anyOf": [
                  {
                    "type": "boolean",
                    "description": "Whether the mutation succeeded at the backend level. Always check this before reading `data`."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Whether the mutation succeeded at the backend level. Always check this before reading `data`."
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Update Order",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "tronsave_register_auto_sell",
          "title": "Register Auto Sell",
          "description": "Create the initial auto-sell configuration for the authenticated user. Returns the persisted `autoSettings` payload. Side effect: persists automation settings that affect future delegation/sell behavior; not idempotent — calling twice may reset fields. Requires a wallet signature identity. Use for FIRST-TIME setup only; for subsequent edits use `tronsave_update_auto_sell_setting`, and always read the current state with `tronsave_get_user_auto_setting` first to avoid overwriting unknown fields. Fails for invalid config combinations, unauthorized sessions, or backend policy restrictions.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "poolSetting": {
                "type": "object",
                "properties": {
                  "energy": {
                    "type": "object",
                    "properties": {
                      "minPrice": {
                        "type": "number",
                        "description": "Minimum unit price accepted for auto matches."
                      },
                      "profitShare": {
                        "type": "integer",
                        "maximum": 9007199254740991,
                        "minimum": -9007199254740991,
                        "description": "Profit share percentage for this resource leg."
                      },
                      "isAcceptExtended": {
                        "type": "boolean",
                        "description": "Whether incoming extend-style matches are accepted."
                      },
                      "minDelegateAmount": {
                        "type": "number",
                        "description": "Minimum per-delegation resource amount."
                      },
                      "maintainUnDelegate": {
                        "type": "number",
                        "description": "Buffer of undelegated resource the seller keeps."
                      },
                      "maxDelegateDurationSec": {
                        "type": "integer",
                        "maximum": 9007199254740991,
                        "minimum": -9007199254740991,
                        "description": "Upper bound delegation duration (seconds)."
                      },
                      "minDelegateDurationSec": {
                        "type": "integer",
                        "maximum": 9007199254740991,
                        "minimum": -9007199254740991,
                        "description": "Lower bound delegation duration (seconds)."
                      }
                    },
                    "description": "Auto-sell rules for staked ENERGY; omit to leave ENERGY selling unchanged."
                  },
                  "reclaim": {
                    "enum": [
                      "ALL",
                      "ONLY_TRONSAVE"
                    ],
                    "type": "string",
                    "description": "Reclaim behaviour: ALL resources vs ONLY_TRONSAVE-managed delegations."
                  },
                  "bandwidth": {
                    "type": "object",
                    "properties": {
                      "minPrice": {
                        "type": "number",
                        "description": "Minimum unit price accepted for auto matches."
                      },
                      "profitShare": {
                        "type": "integer",
                        "maximum": 9007199254740991,
                        "minimum": -9007199254740991,
                        "description": "Profit share percentage for this resource leg."
                      },
                      "isAcceptExtended": {
                        "type": "boolean",
                        "description": "Whether incoming extend-style matches are accepted."
                      },
                      "minDelegateAmount": {
                        "type": "number",
                        "description": "Minimum per-delegation resource amount."
                      },
                      "maintainUnDelegate": {
                        "type": "number",
                        "description": "Buffer of undelegated resource the seller keeps."
                      },
                      "maxDelegateDurationSec": {
                        "type": "integer",
                        "maximum": 9007199254740991,
                        "minimum": -9007199254740991,
                        "description": "Upper bound delegation duration (seconds)."
                      },
                      "minDelegateDurationSec": {
                        "type": "integer",
                        "maximum": 9007199254740991,
                        "minimum": -9007199254740991,
                        "description": "Lower bound delegation duration (seconds)."
                      }
                    },
                    "description": "Auto-sell rules for staked BANDWIDTH; omit to leave BANDWIDTH selling unchanged."
                  }
                },
                "description": "What the wallet sells automatically: per-resource price floor, duration bounds, minimum amount, reserve, and reclaim scope."
              },
              "addOnFeature": {
                "type": "object",
                "properties": {
                  "vote": {
                    "type": "boolean",
                    "description": "Enable vote-related automation when supported."
                  },
                  "stake": {
                    "type": "object",
                    "required": [
                      "minAmount",
                      "remainBalance",
                      "resourceStake"
                    ],
                    "properties": {
                      "minAmount": {
                        "type": "number",
                        "description": "Minimum TRX (sun semantics per API) for auto-stake trigger."
                      },
                      "remainBalance": {
                        "type": "number",
                        "description": "TRX balance floor to preserve after staking."
                      },
                      "resourceStake": {
                        "enum": [
                          "ENERGY",
                          "BANDWIDTH"
                        ],
                        "type": "string",
                        "description": "Whether auto-stake targets ENERGY or BANDWIDTH."
                      }
                    },
                    "description": "Optional auto-stake policy."
                  },
                  "suggestSell": {
                    "type": "boolean",
                    "description": "Enable suggest-sell UX hints."
                  },
                  "withdrawVote": {
                    "type": "number",
                    "description": "GraphQL Float input for withdraw-vote configuration."
                  }
                },
                "description": "Optional extras: voting, auto-stake of idle TRX, suggest-sell hints."
              },
              "paymentConfig": {
                "type": "object",
                "properties": {
                  "paymentMode": {
                    "enum": [
                      "FIXED",
                      "RANDOM"
                    ],
                    "type": "string",
                    "description": "FIXED vs RANDOM payout mode when applicable."
                  },
                  "paymentAddress": {
                    "type": "string",
                    "pattern": "^T[1-9A-HJ-NP-Za-km-z]{33}$",
                    "description": "TRON address that receives payouts."
                  },
                  "paymentFrequency": {
                    "enum": [
                      "DAILY",
                      "IMMEDIATE"
                    ],
                    "type": "string",
                    "description": "DAILY vs IMMEDIATE settlement rhythm."
                  },
                  "paymentTimeWindow": {
                    "type": "object",
                    "required": [
                      "start",
                      "end"
                    ],
                    "properties": {
                      "end": {
                        "type": "integer",
                        "maximum": 9007199254740991,
                        "minimum": 0,
                        "description": "Window end as a non-negative GraphQL `Int` (same unit as `start`); end > start is enforced server-side, not by this schema."
                      },
                      "start": {
                        "type": "integer",
                        "maximum": 9007199254740991,
                        "minimum": 0,
                        "description": "Window start as a non-negative GraphQL `Int` (TronSave commonly uses minutes from midnight UTC, `0..1439`)."
                      }
                    },
                    "description": "Optional daily time window for scheduled payouts."
                  }
                },
                "description": "Where and how often seller earnings are paid out (address, DAILY/IMMEDIATE, payout window)."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "code": {
                "anyOf": [
                  {
                    "type": "integer",
                    "maximum": 9007199254740991,
                    "minimum": -9007199254740991,
                    "description": "GraphQL mutation status code (HTTP-like; `0`/`200` indicates success). Always pair with `success` for routing."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "GraphQL mutation status code (HTTP-like; `0`/`200` indicates success). Always pair with `success` for routing."
              },
              "data": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Opaque server-defined payload (tx id, setting id, or status text). Treat as identifier-or-message; rely on `message` for human routing."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Opaque server-defined payload (tx id, setting id, or status text). Treat as identifier-or-message; rely on `message` for human routing."
              },
              "message": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Human-readable status text. Populated even on success; localized error messages may appear here on failure."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Human-readable status text. Populated even on success; localized error messages may appear here on failure."
              },
              "success": {
                "anyOf": [
                  {
                    "type": "boolean",
                    "description": "Whether the mutation succeeded at the backend level. Always check this before reading `data`."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Whether the mutation succeeded at the backend level. Always check this before reading `data`."
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Register Auto Sell",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "tronsave_update_auto_sell_setting",
          "title": "Update Auto Sell Setting",
          "description": "Update the existing auto-sell configuration with partial fields. Returns the updated `autoSettings` payload. Side effect: overwrites stored automation settings for the current user; not idempotent across different field sets. Requires a wallet signature identity. Use for INCREMENTAL changes after registration; read the baseline via `tronsave_get_user_auto_setting` to avoid accidental resets, and use `tronsave_register_auto_sell` only for first-time setup. Fails for invalid field combinations, unauthorized sessions, or policy constraints.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "poolSetting": {
                "type": "object",
                "properties": {
                  "energy": {
                    "type": "object",
                    "properties": {
                      "minPrice": {
                        "type": "number",
                        "description": "Minimum unit price accepted for auto matches."
                      },
                      "profitShare": {
                        "type": "integer",
                        "maximum": 9007199254740991,
                        "minimum": -9007199254740991,
                        "description": "Profit share percentage for this resource leg."
                      },
                      "isAcceptExtended": {
                        "type": "boolean",
                        "description": "Whether incoming extend-style matches are accepted."
                      },
                      "minDelegateAmount": {
                        "type": "number",
                        "description": "Minimum per-delegation resource amount."
                      },
                      "maintainUnDelegate": {
                        "type": "number",
                        "description": "Buffer of undelegated resource the seller keeps."
                      },
                      "maxDelegateDurationSec": {
                        "type": "integer",
                        "maximum": 9007199254740991,
                        "minimum": -9007199254740991,
                        "description": "Upper bound delegation duration (seconds)."
                      },
                      "minDelegateDurationSec": {
                        "type": "integer",
                        "maximum": 9007199254740991,
                        "minimum": -9007199254740991,
                        "description": "Lower bound delegation duration (seconds)."
                      }
                    },
                    "description": "Auto-sell rules for staked ENERGY; omit to leave ENERGY selling unchanged."
                  },
                  "reclaim": {
                    "enum": [
                      "ALL",
                      "ONLY_TRONSAVE"
                    ],
                    "type": "string",
                    "description": "Reclaim behaviour: ALL resources vs ONLY_TRONSAVE-managed delegations."
                  },
                  "bandwidth": {
                    "type": "object",
                    "properties": {
                      "minPrice": {
                        "type": "number",
                        "description": "Minimum unit price accepted for auto matches."
                      },
                      "profitShare": {
                        "type": "integer",
                        "maximum": 9007199254740991,
                        "minimum": -9007199254740991,
                        "description": "Profit share percentage for this resource leg."
                      },
                      "isAcceptExtended": {
                        "type": "boolean",
                        "description": "Whether incoming extend-style matches are accepted."
                      },
                      "minDelegateAmount": {
                        "type": "number",
                        "description": "Minimum per-delegation resource amount."
                      },
                      "maintainUnDelegate": {
                        "type": "number",
                        "description": "Buffer of undelegated resource the seller keeps."
                      },
                      "maxDelegateDurationSec": {
                        "type": "integer",
                        "maximum": 9007199254740991,
                        "minimum": -9007199254740991,
                        "description": "Upper bound delegation duration (seconds)."
                      },
                      "minDelegateDurationSec": {
                        "type": "integer",
                        "maximum": 9007199254740991,
                        "minimum": -9007199254740991,
                        "description": "Lower bound delegation duration (seconds)."
                      }
                    },
                    "description": "Auto-sell rules for staked BANDWIDTH; omit to leave BANDWIDTH selling unchanged."
                  }
                },
                "description": "What the wallet sells automatically: per-resource price floor, duration bounds, minimum amount, reserve, and reclaim scope."
              },
              "addOnFeature": {
                "type": "object",
                "properties": {
                  "vote": {
                    "type": "boolean",
                    "description": "Enable vote-related automation when supported."
                  },
                  "stake": {
                    "type": "object",
                    "required": [
                      "minAmount",
                      "remainBalance",
                      "resourceStake"
                    ],
                    "properties": {
                      "minAmount": {
                        "type": "number",
                        "description": "Minimum TRX (sun semantics per API) for auto-stake trigger."
                      },
                      "remainBalance": {
                        "type": "number",
                        "description": "TRX balance floor to preserve after staking."
                      },
                      "resourceStake": {
                        "enum": [
                          "ENERGY",
                          "BANDWIDTH"
                        ],
                        "type": "string",
                        "description": "Whether auto-stake targets ENERGY or BANDWIDTH."
                      }
                    },
                    "description": "Optional auto-stake policy."
                  },
                  "suggestSell": {
                    "type": "boolean",
                    "description": "Enable suggest-sell UX hints."
                  },
                  "withdrawVote": {
                    "type": "number",
                    "description": "GraphQL Float input for withdraw-vote configuration."
                  }
                },
                "description": "Optional extras: voting, auto-stake of idle TRX, suggest-sell hints."
              },
              "paymentConfig": {
                "type": "object",
                "properties": {
                  "paymentMode": {
                    "enum": [
                      "FIXED",
                      "RANDOM"
                    ],
                    "type": "string",
                    "description": "FIXED vs RANDOM payout mode when applicable."
                  },
                  "paymentAddress": {
                    "type": "string",
                    "pattern": "^T[1-9A-HJ-NP-Za-km-z]{33}$",
                    "description": "TRON address that receives payouts."
                  },
                  "paymentFrequency": {
                    "enum": [
                      "DAILY",
                      "IMMEDIATE"
                    ],
                    "type": "string",
                    "description": "DAILY vs IMMEDIATE settlement rhythm."
                  },
                  "paymentTimeWindow": {
                    "type": "object",
                    "required": [
                      "start",
                      "end"
                    ],
                    "properties": {
                      "end": {
                        "type": "integer",
                        "maximum": 9007199254740991,
                        "minimum": 0,
                        "description": "Window end as a non-negative GraphQL `Int` (same unit as `start`); end > start is enforced server-side, not by this schema."
                      },
                      "start": {
                        "type": "integer",
                        "maximum": 9007199254740991,
                        "minimum": 0,
                        "description": "Window start as a non-negative GraphQL `Int` (TronSave commonly uses minutes from midnight UTC, `0..1439`)."
                      }
                    },
                    "description": "Optional daily time window for scheduled payouts."
                  }
                },
                "description": "Where and how often seller earnings are paid out (address, DAILY/IMMEDIATE, payout window)."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "code": {
                "anyOf": [
                  {
                    "type": "integer",
                    "maximum": 9007199254740991,
                    "minimum": -9007199254740991,
                    "description": "GraphQL mutation status code (HTTP-like; `0`/`200` indicates success). Always pair with `success` for routing."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "GraphQL mutation status code (HTTP-like; `0`/`200` indicates success). Always pair with `success` for routing."
              },
              "data": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Opaque server-defined payload (tx id, setting id, or status text). Treat as identifier-or-message; rely on `message` for human routing."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Opaque server-defined payload (tx id, setting id, or status text). Treat as identifier-or-message; rely on `message` for human routing."
              },
              "message": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Human-readable status text. Populated even on success; localized error messages may appear here on failure."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Human-readable status text. Populated even on success; localized error messages may appear here on failure."
              },
              "success": {
                "anyOf": [
                  {
                    "type": "boolean",
                    "description": "Whether the mutation succeeded at the backend level. Always check this before reading `data`."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Whether the mutation succeeded at the backend level. Always check this before reading `data`."
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Update Auto Sell Setting",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "tronsave_generate_api_key",
          "title": "Generate API Key",
          "description": "Generate a new internal API key credential for the current user. Returns `data` containing the issued key — show it to the user once and tell them to store it securely; do not repeat it in later messages. Side effect: issues secret material; not idempotent — each call mints a fresh key and may invalidate the previous one per backend policy. Requires a wallet signature identity. Sensitive output — never log raw keys; unauthorized sessions or policy checks may reject issuance.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {},
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "code": {
                "anyOf": [
                  {
                    "type": "integer",
                    "maximum": 9007199254740991,
                    "minimum": -9007199254740991,
                    "description": "GraphQL mutation status code (HTTP-like; `0`/`200` indicates success). Always pair with `success` for routing."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "GraphQL mutation status code (HTTP-like; `0`/`200` indicates success). Always pair with `success` for routing."
              },
              "data": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "For `generateApiKey`: the freshly issued internal API key — treat as SECRET, store securely. For `revokeApiKey`: server-defined confirmation string (no key material)."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "For `generateApiKey`: the freshly issued internal API key — treat as SECRET, store securely. For `revokeApiKey`: server-defined confirmation string (no key material)."
              },
              "message": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Human-readable status text. Populated even on success; localized error messages may appear here on failure."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Human-readable status text. Populated even on success; localized error messages may appear here on failure."
              },
              "success": {
                "anyOf": [
                  {
                    "type": "boolean",
                    "description": "Whether the mutation succeeded at the backend level. Always check this before reading `data`."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Whether the mutation succeeded at the backend level. Always check this before reading `data`."
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Generate API Key",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": false,
            "destructiveHint": true
          }
        },
        {
          "name": "tronsave_revoke_api_key",
          "title": "Revoke API Key",
          "description": "Revoke the caller's current internal API key. Side effect: any future request using the previous key is rejected. Existing in-flight sessions cached by the server may continue serving until their TTL expires — treat the effect as 'best-effort immediate' rather than guaranteed instantaneous cutoff. Idempotent — revoking an already-revoked key returns success. Requires a wallet signature identity. Call `tronsave_generate_api_key` afterwards to mint a replacement when continued internal access is needed.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {},
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "code": {
                "anyOf": [
                  {
                    "type": "integer",
                    "maximum": 9007199254740991,
                    "minimum": -9007199254740991,
                    "description": "GraphQL mutation status code (HTTP-like; `0`/`200` indicates success). Always pair with `success` for routing."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "GraphQL mutation status code (HTTP-like; `0`/`200` indicates success). Always pair with `success` for routing."
              },
              "data": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "For `generateApiKey`: the freshly issued internal API key — treat as SECRET, store securely. For `revokeApiKey`: server-defined confirmation string (no key material)."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "For `generateApiKey`: the freshly issued internal API key — treat as SECRET, store securely. For `revokeApiKey`: server-defined confirmation string (no key material)."
              },
              "message": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Human-readable status text. Populated even on success; localized error messages may appear here on failure."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Human-readable status text. Populated even on success; localized error messages may appear here on failure."
              },
              "success": {
                "anyOf": [
                  {
                    "type": "boolean",
                    "description": "Whether the mutation succeeded at the backend level. Always check this before reading `data`."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Whether the mutation succeeded at the backend level. Always check this before reading `data`."
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Revoke API Key",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "tronsave_delete_auto_buy_setting",
          "title": "Delete Auto Buy Setting",
          "description": "Permanently delete one auto-buy rule by `id` (`MObjectId`). Side effect: stops all future executions matching that rule; the rule cannot be restored. Idempotent — deleting a non-existent or already-removed id returns success. Requires a wallet signature identity. Use `tronsave_get_user_auto_setting` to list current rules first; prefer disabling/updating instead when reversibility is desired.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "minLength": 1,
                "description": "Auto-buy setting id (`MObjectId`) to delete."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "code": {
                "anyOf": [
                  {
                    "type": "integer",
                    "maximum": 9007199254740991,
                    "minimum": -9007199254740991,
                    "description": "GraphQL mutation status code (HTTP-like; `0`/`200` indicates success). Always pair with `success` for routing."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "GraphQL mutation status code (HTTP-like; `0`/`200` indicates success). Always pair with `success` for routing."
              },
              "message": {
                "anyOf": [
                  {
                    "type": "string",
                    "description": "Human-readable status text. Populated even on success; localized error messages may appear here on failure."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Human-readable status text. Populated even on success; localized error messages may appear here on failure."
              },
              "success": {
                "anyOf": [
                  {
                    "type": "boolean",
                    "description": "Whether the mutation succeeded at the backend level. Always check this before reading `data`."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Whether the mutation succeeded at the backend level. Always check this before reading `data`."
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Delete Auto Buy Setting",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "tronsave_get_market_overview",
          "title": "Market Overview",
          "description": "Read the TronSave market summary: resource currently available and total listed for ENERGY and BANDWIDTH, number of pooled sellers, and seller APY (percent). Use for a quick 'how is the market' answer before pricing; for prices use `tronsave_get_price_table` (grid) or `tronsave_estimate_buy_resource` (one quote), for depth by price use `tronsave_list_order_books`. Public, read-only. Data refreshes about every TRON block (3 s).",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {},
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "apy": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "energy": {
                        "anyOf": [
                          {
                            "type": "number"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "bandwidth": {
                        "anyOf": [
                          {
                            "type": "number"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      }
                    },
                    "additionalProperties": {}
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "resources": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "totalLimitEnergy": {
                        "anyOf": [
                          {
                            "type": "number"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "totalLimitBandwidth": {
                        "anyOf": [
                          {
                            "type": "number"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "totalAvailableEnergy": {
                        "anyOf": [
                          {
                            "type": "number"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "totalAvailableBandwidth": {
                        "anyOf": [
                          {
                            "type": "number"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      }
                    },
                    "additionalProperties": {}
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "totalPool": {
                "anyOf": [
                  {
                    "type": "number",
                    "description": "Number of sellers in the pool."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Number of sellers in the pool."
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Market Overview",
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true
          }
        },
        {
          "name": "tronsave_get_price_table",
          "title": "Resource Price Table",
          "description": "Read the price grid for ENERGY or BANDWIDTH: `prices[i][j]` is the unit price in SUN for `amounts[i]` resource units rented for `durations[j]` (e.g. '15m', '1h', '1d'). Durations of 1 day or longer are priced per day: '30d' at 40 SUN costs 40 x 30 SUN per unit in total. Use to compare cost across amounts and durations in one call. For an exact quote on one purchase use `tronsave_estimate_buy_resource`; for only the floor price use `tronsave_get_min_price`. Public, read-only.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "resourceType"
            ],
            "properties": {
              "address": {
                "type": "string",
                "pattern": "^T[1-9A-HJ-NP-Za-km-z]{33}$",
                "description": "Optional receiver address; prices can depend on the account."
              },
              "resourceType": {
                "enum": [
                  "ENERGY",
                  "BANDWIDTH"
                ],
                "type": "string",
                "description": "ENERGY (smart-contract calls) or BANDWIDTH (plain transfers)."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "prices": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "number"
                      }
                    }
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "amounts": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "type": "number"
                    }
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "durations": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Resource Price Table",
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true
          }
        },
        {
          "name": "tronsave_get_system_info",
          "title": "Protocol Parameters",
          "description": "Read TronSave and TRON protocol parameters: latest block, minimum buy amounts, TRX burn rates per unit, dynamic buy/lowest prices, the system deposit address, max lock period and the energy cost of a USDT transfer. Use to size purchases (minimums) and to compare renting with burning TRX. For market prices use `tronsave_get_price_table` or `tronsave_estimate_buy_resource`; for supply and APY use `tronsave_get_market_overview`. Public, read-only.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {},
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "lastBlock": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "number": {
                        "anyOf": [
                          {
                            "type": "number"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "timestamp": {
                        "anyOf": [
                          {
                            "type": "number"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      }
                    },
                    "additionalProperties": {}
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "burningEnergyRate": {
                "anyOf": [
                  {
                    "type": "number",
                    "description": "SUN burned per energy unit when none is rented."
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "SUN burned per energy unit when none is rented."
              },
              "minBuyEnergyAmount": {
                "anyOf": [
                  {
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "burningBandwidthRate": {
                "anyOf": [
                  {
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "systemDepositAddress": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "minBuyBandwidthAmount": {
                "anyOf": [
                  {
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "usdtTransferEnergyValue": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {
                      "value": {
                        "anyOf": [
                          {
                            "type": "number"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      },
                      "rawValue": {
                        "anyOf": [
                          {
                            "type": "number"
                          },
                          {
                            "type": "null"
                          }
                        ]
                      }
                    },
                    "additionalProperties": {}
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Protocol Parameters",
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true
          }
        },
        {
          "name": "tronsave_get_account_resources",
          "title": "Account Resources",
          "description": "Read the on-chain staked and delegatable ENERGY/BANDWIDTH of a TRON address, plus its TRX balance (SUN string). Use to check whether a wallet can sell, or how much resource it holds. Public (any address), read-only; does not need a login.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "address"
            ],
            "properties": {
              "address": {
                "type": "string",
                "pattern": "^T[1-9A-HJ-NP-Za-km-z]{33}$",
                "description": "TRON base58 address to inspect."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "address": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "balance": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "resourcesV2": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {},
                    "additionalProperties": {}
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Account Resources",
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true
          }
        },
        {
          "name": "tronsave_suggest_create_order",
          "title": "Suggest Order Strategy",
          "description": "Ask the market how a buy would be filled: a plain new order, buying more only, or extending existing delegations (optionally plus extra). Returns each option with `readyToFill` (percent), `payout` (SUN) and the `extendData` rows. Use before `tronsave_create_order` when the receiver may already have delegations that can be extended cheaper. Public, read-only. Prices move every ~3 s: re-run right before ordering.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "resourceType",
              "receiver",
              "resourceAmount",
              "durationSec",
              "unitPrice"
            ],
            "properties": {
              "receiver": {
                "type": "string",
                "pattern": "^T[1-9A-HJ-NP-Za-km-z]{33}$",
                "description": "TRON base58 address that will receive the resource."
              },
              "requester": {
                "type": "string",
                "pattern": "^T[1-9A-HJ-NP-Za-km-z]{33}$",
                "description": "TRON base58 address that pays; defaults to the logged-in wallet."
              },
              "unitPrice": {
                "type": "number",
                "description": "Unit price in SUN you are willing to pay.",
                "exclusiveMinimum": 0
              },
              "durationSec": {
                "type": "number",
                "description": "Delegation duration in seconds.",
                "exclusiveMinimum": 0
              },
              "resourceType": {
                "enum": [
                  "ENERGY",
                  "BANDWIDTH"
                ],
                "type": "string",
                "description": "ENERGY (smart-contract calls) or BANDWIDTH (plain transfers)."
              },
              "resourceAmount": {
                "type": "number",
                "description": "Resource units to buy.",
                "exclusiveMinimum": 0
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "suggestions": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {},
                      "additionalProperties": {}
                    }
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Suggest Order Strategy",
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true
          }
        },
        {
          "name": "tronsave_list_extendable_receivers",
          "title": "Extendable Receivers",
          "description": "List the receiver addresses that have delegations bought by `requester` which can still be extended, with expiry time (Unix seconds), delegation count and total amount. Use as the first step of an extension flow to find which receiver to extend, then `tronsave_list_extendable_delegates` (market view) or `tronsave_internal_extend_delegates` (API-key path, returns the `extendData` to submit). Public (any requester address), read-only.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "requester"
            ],
            "properties": {
              "requester": {
                "type": "string",
                "pattern": "^T[1-9A-HJ-NP-Za-km-z]{33}$",
                "description": "TRON base58 address that bought the delegations."
              },
              "resourceType": {
                "enum": [
                  "ENERGY",
                  "BANDWIDTH"
                ],
                "type": "string",
                "description": "Only delegations of this resource; omit for both."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "receivers": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {},
                      "additionalProperties": {}
                    }
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Extendable Receivers",
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true
          }
        },
        {
          "name": "tronsave_get_seller_stats",
          "title": "Seller Statistics",
          "description": "Read the logged-in seller's lifetime totals (delegations, resource delegated, TRX earned, average price per resource) and a daily earnings chart split into auto, manual, exclusive and extend delegations. Use for 'how much did I earn' totals; for the individual delegations behind them use `tronsave_list_delegations`. Requires a wallet signature identity. Read-only.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "resourceType": {
                "enum": [
                  "ENERGY",
                  "BANDWIDTH"
                ],
                "type": "string",
                "default": "ENERGY",
                "description": "Resource the chart is drawn for."
              },
              "timeFilterBy": {
                "enum": [
                  "D7",
                  "D30",
                  "D365"
                ],
                "type": "string",
                "description": "Chart window; default D30."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "chart": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {},
                      "additionalProperties": {}
                    }
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "stats": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {},
                    "additionalProperties": {}
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Seller Statistics",
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true
          }
        },
        {
          "name": "tronsave_list_delegations",
          "title": "Delegation History",
          "description": "List the logged-in seller's delegations (resource sent to buyers): amount, TRX amount, duration, unit price, type (AUTO, MANUAL, EXTEND, FAST), status and payout. Newest first; page with `offset`/`limit`. Use for a seller's per-delegation history; for earnings totals use `tronsave_get_seller_stats`, for orders the user bought use `tronsave_list_orders` (`isOnlyMyOrder`). Requires a wallet signature identity. Read-only.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "limit": {
                "type": "integer",
                "maximum": 50,
                "minimum": 1,
                "description": "Rows to return (default 20, max 50)."
              },
              "offset": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": 0,
                "description": "Number of delegations to skip for pagination (default 0); add `limit` to page forward."
              },
              "timeFilterBy": {
                "enum": [
                  "All",
                  "D7",
                  "D30"
                ],
                "type": "string",
                "description": "Time window: All, last 7 days (D7) or last 30 days (D30). Default All."
              },
              "filterByResourceType": {
                "enum": [
                  "ENERGY",
                  "BANDWIDTH"
                ],
                "type": "string",
                "description": "Only ENERGY or only BANDWIDTH delegations; omit for both."
              },
              "filterByTypeDelegate": {
                "enum": [
                  "AUTO",
                  "MANUAL",
                  "EXTEND",
                  "FAST"
                ],
                "type": "string",
                "description": "Only this delegation type: AUTO (auto-sell pool), MANUAL (`tronsave_sell_order_manual`), EXTEND (extensions), FAST (fast orders). Omit for all."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "delegations": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {},
                      "additionalProperties": {}
                    }
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Delegation History",
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true
          }
        },
        {
          "name": "tronsave_list_auto_buy_settings",
          "title": "Auto-Buy Rules",
          "description": "List the logged-in user's auto-buy rules: receiver, resource, unit price cap, threshold, budget/order limits, totals bought and active state. Use before `tronsave_update_auto_buy_setting` or `tronsave_delete_auto_buy_setting` to get rule ids. Requires a wallet signature identity. Read-only.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "limit": {
                "type": "integer",
                "maximum": 10,
                "minimum": 1,
                "description": "Rows to return (default 10, max 10)."
              },
              "offset": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": 0,
                "description": "Number of rules to skip for pagination (default 0); add `limit` to page forward."
              },
              "filterBy": {
                "enum": [
                  "ENERGY",
                  "BANDWIDTH"
                ],
                "type": "string",
                "description": "Only rules for this resource."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "settings": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {},
                      "additionalProperties": {}
                    }
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Auto-Buy Rules",
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true
          }
        },
        {
          "name": "tronsave_create_auto_buy_setting",
          "title": "Create Auto-Buy Rule",
          "description": "Create a rule that automatically buys `resourceAmount` for `receiver` whenever its remaining resource falls below `thresholdResourceAmount`, paying up to `unitPrice` SUN per unit from the TronSave internal balance. Side effect: SPENDS internal TRX every time the rule fires until a budget/order limit or `endActiveAt` stops it; not idempotent (each call adds a rule). Confirm receiver, amounts, price cap and limits with the user first; prefer setting `limitBudgetInSun`. Requires a wallet signature identity.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "resourceType",
              "receiver",
              "unitPrice",
              "durationSec",
              "resourceAmount",
              "thresholdResourceAmount"
            ],
            "properties": {
              "receiver": {
                "type": "string",
                "pattern": "^T[1-9A-HJ-NP-Za-km-z]{33}$",
                "description": "TRON base58 address that receives each delegation."
              },
              "unitPrice": {
                "type": "string",
                "minLength": 1,
                "description": "Maximum unit price in SUN, as a decimal string."
              },
              "durationSec": {
                "type": "number",
                "description": "Delegation duration of each purchase, in seconds.",
                "exclusiveMinimum": 0
              },
              "endActiveAt": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": -9007199254740991,
                "description": "Optional Unix time in seconds when the rule stops."
              },
              "resourceType": {
                "enum": [
                  "ENERGY",
                  "BANDWIDTH"
                ],
                "type": "string",
                "description": "ENERGY or BANDWIDTH."
              },
              "startActiveAt": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": -9007199254740991,
                "description": "Optional Unix time in seconds when the rule starts."
              },
              "resourceAmount": {
                "type": "number",
                "description": "Resource units bought each time the rule fires.",
                "exclusiveMinimum": 0
              },
              "limitBudgetInSun": {
                "type": "string",
                "description": "Optional total budget cap in SUN (decimal string); must be greater than 10000000 (10 TRX)."
              },
              "limitInOrderCount": {
                "type": "integer",
                "maximum": 9007199254740991,
                "description": "Optional cap on the number of orders.",
                "exclusiveMinimum": 0
              },
              "thresholdResourceAmount": {
                "type": "number",
                "minimum": 0,
                "description": "Rule fires when the receiver's remaining resource drops below this many units (TronSave requires at least 100000)."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "code": {
                "anyOf": [
                  {
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "message": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "success": {
                "anyOf": [
                  {
                    "type": "boolean"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Create Auto-Buy Rule",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "tronsave_update_auto_buy_setting",
          "title": "Update Auto-Buy Rule",
          "description": "Change an auto-buy rule by id: pause or resume it with `isActive`, or change any of price cap, amount, duration, threshold and limits (only the fields you send change). Side effect: a resumed or loosened rule can start spending internal TRX again. Idempotent for the same arguments. Get ids from `tronsave_list_auto_buy_settings`. Requires a wallet signature identity.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^[0-9a-f]{24}$",
                "description": "Rule id from `tronsave_list_auto_buy_settings`."
              },
              "isActive": {
                "type": "boolean",
                "description": "false pauses the rule, true resumes it."
              },
              "receiver": {
                "type": "string",
                "pattern": "^T[1-9A-HJ-NP-Za-km-z]{33}$",
                "description": "TRON base58 address that receives each delegation."
              },
              "unitPrice": {
                "type": "string",
                "minLength": 1,
                "description": "Maximum unit price in SUN, as a decimal string."
              },
              "durationSec": {
                "type": "number",
                "description": "Delegation duration of each purchase, in seconds.",
                "exclusiveMinimum": 0
              },
              "endActiveAt": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": -9007199254740991,
                "description": "Optional Unix time in seconds when the rule stops."
              },
              "resourceType": {
                "enum": [
                  "ENERGY",
                  "BANDWIDTH"
                ],
                "type": "string",
                "description": "ENERGY or BANDWIDTH."
              },
              "startActiveAt": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": -9007199254740991,
                "description": "Optional Unix time in seconds when the rule starts."
              },
              "resourceAmount": {
                "type": "number",
                "description": "Resource units bought each time the rule fires.",
                "exclusiveMinimum": 0
              },
              "limitBudgetInSun": {
                "type": "string",
                "description": "Optional total budget cap in SUN (decimal string); must be greater than 10000000 (10 TRX)."
              },
              "limitInOrderCount": {
                "type": "integer",
                "maximum": 9007199254740991,
                "description": "Optional cap on the number of orders.",
                "exclusiveMinimum": 0
              },
              "thresholdResourceAmount": {
                "type": "number",
                "minimum": 0,
                "description": "Rule fires when the receiver's remaining resource drops below this many units (TronSave requires at least 100000)."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "code": {
                "anyOf": [
                  {
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "data": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {},
                    "additionalProperties": {}
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "message": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "success": {
                "anyOf": [
                  {
                    "type": "boolean"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Update Auto-Buy Rule",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "tronsave_list_notifications",
          "title": "Notifications",
          "description": "List the logged-in user's notifications (order created / filled / cancelled / reclaimed, referral payouts) newest first, with the unread count. Use to follow up on an order after creating it; page with `offset`/`limit`, and mark items read with `tronsave_mark_notifications_read`. Requires a wallet signature identity. Read-only.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "limit": {
                "type": "integer",
                "maximum": 100,
                "minimum": 1,
                "description": "Notifications to return (default 20, max 100)."
              },
              "offset": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": 0,
                "description": "Number of notifications to skip for pagination (default 0); add `limit` to page forward."
              },
              "unreadOnly": {
                "type": "boolean",
                "description": "true returns only unread notifications; default false returns all."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "total": {
                "anyOf": [
                  {
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "unreadCount": {
                "anyOf": [
                  {
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "notifications": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {},
                      "additionalProperties": {}
                    }
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Notifications",
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true
          }
        },
        {
          "name": "tronsave_mark_notifications_read",
          "title": "Mark Notifications Read",
          "description": "Mark one notification (by `id`) or, when `id` is omitted, ALL of the user's notifications as read. Get ids from `tronsave_list_notifications`. Only changes the read flag; idempotent. Requires a wallet signature identity.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "id": {
                "type": "string",
                "pattern": "^[0-9a-f]{24}$",
                "description": "Notification id; omit to mark everything read."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "code": {
                "anyOf": [
                  {
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "message": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "success": {
                "anyOf": [
                  {
                    "type": "boolean"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "modifiedCount": {
                "anyOf": [
                  {
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Mark Notifications Read",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "tronsave_get_referral",
          "title": "Referral Program",
          "description": "Read the logged-in user's referral status: own referral code, sponsor, referral counts, bonus earned and remaining (SUN strings), rank, the referral list (PENDING/ACTIVE) and recent commission payouts. Use for referral questions only; account profile is `tronsave_get_user_info`. `offset`/`limit` page the referral list and the payout list together. Requires a wallet signature identity. Read-only.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "limit": {
                "type": "integer",
                "maximum": 50,
                "minimum": 1,
                "description": "Rows per list (default 10, max 50)."
              },
              "offset": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": 0,
                "description": "Number of rows of each list to skip for pagination (default 0); add `limit` to page forward."
              },
              "filterBy": {
                "enum": [
                  "PENDING",
                  "ACTIVE"
                ],
                "type": "string",
                "description": "Only referrals in this status."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "totalRef": {
                "anyOf": [
                  {
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "userRefCode": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Referral Program",
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true
          }
        },
        {
          "name": "tronsave_get_telegram_notify_setting",
          "title": "Telegram Notification Settings",
          "description": "Read the Telegram alert filters of the logged-in user: seller alerts (remaining amount, duration, price and APY ranges, unlocked-only) and buyer alerts (reclaim warning time, low energy / bandwidth thresholds). `setting` is null when Telegram is not linked. Read these before changing them with `tronsave_update_telegram_notify_setting` (which replaces whole filter objects). For in-app alerts use `tronsave_list_notifications`. Requires a wallet signature identity. Read-only.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {},
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "setting": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {},
                    "additionalProperties": {}
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Telegram Notification Settings",
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true
          }
        },
        {
          "name": "tronsave_update_telegram_notify_setting",
          "title": "Update Telegram Notification Settings",
          "description": "Replace the Telegram alert filters. Send the COMPLETE `sellerFilter` and/or `buyerFilter` objects (read the current ones with `tronsave_get_telegram_notify_setting`, edit, send back); each range or value has `isEnabled` plus its numbers. Only changes which alerts are sent; no funds move. Idempotent. Requires a wallet signature identity and a linked Telegram account.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "buyerFilter": {
                "type": "object",
                "required": [
                  "isEnabled",
                  "reclaimAlertTime",
                  "lowResourceAlertEnergy",
                  "lowResourceAlertBandwidth"
                ],
                "properties": {
                  "isEnabled": {
                    "type": "boolean",
                    "description": "Master switch for buyer alerts (your delegations and resources)."
                  },
                  "reclaimAlertTime": {
                    "type": "object",
                    "required": [
                      "isEnabled",
                      "value"
                    ],
                    "properties": {
                      "value": {
                        "type": "number",
                        "description": "Threshold: seconds left before a delegation is reclaimed."
                      },
                      "isEnabled": {
                        "type": "boolean",
                        "description": "Whether this alert is sent."
                      }
                    },
                    "description": "Alert when seconds left before a delegation is reclaimed is reached."
                  },
                  "lowResourceAlertEnergy": {
                    "type": "object",
                    "required": [
                      "isEnabled",
                      "value"
                    ],
                    "properties": {
                      "value": {
                        "type": "number",
                        "description": "Threshold: remaining ENERGY units of the receiver."
                      },
                      "isEnabled": {
                        "type": "boolean",
                        "description": "Whether this alert is sent."
                      }
                    },
                    "description": "Alert when remaining ENERGY units of the receiver is reached."
                  },
                  "lowResourceAlertBandwidth": {
                    "type": "object",
                    "required": [
                      "isEnabled",
                      "value"
                    ],
                    "properties": {
                      "value": {
                        "type": "number",
                        "description": "Threshold: remaining BANDWIDTH units of the receiver."
                      },
                      "isEnabled": {
                        "type": "boolean",
                        "description": "Whether this alert is sent."
                      }
                    },
                    "description": "Alert when remaining BANDWIDTH units of the receiver is reached."
                  }
                },
                "description": "Complete buyer alert filter; omit to leave buyer alerts unchanged."
              },
              "sellerFilter": {
                "type": "object",
                "required": [
                  "isEnabled",
                  "onlySendUnlockOrders",
                  "remainAmount",
                  "duration",
                  "price",
                  "apy"
                ],
                "properties": {
                  "apy": {
                    "type": "object",
                    "required": [
                      "isEnabled",
                      "from",
                      "to"
                    ],
                    "properties": {
                      "to": {
                        "type": "number",
                        "description": "Upper bound (seller APY in percent)."
                      },
                      "from": {
                        "type": "number",
                        "description": "Lower bound (seller APY in percent)."
                      },
                      "isEnabled": {
                        "type": "boolean",
                        "description": "Whether this range filter is applied."
                      }
                    },
                    "description": "Alert only for orders whose seller APY in percent is in this range."
                  },
                  "price": {
                    "type": "object",
                    "required": [
                      "isEnabled",
                      "from",
                      "to"
                    ],
                    "properties": {
                      "to": {
                        "type": "number",
                        "description": "Upper bound (unit price in SUN)."
                      },
                      "from": {
                        "type": "number",
                        "description": "Lower bound (unit price in SUN)."
                      },
                      "isEnabled": {
                        "type": "boolean",
                        "description": "Whether this range filter is applied."
                      }
                    },
                    "description": "Alert only for orders whose unit price in SUN is in this range."
                  },
                  "duration": {
                    "type": "object",
                    "required": [
                      "isEnabled",
                      "from",
                      "to"
                    ],
                    "properties": {
                      "to": {
                        "type": "number",
                        "description": "Upper bound (rental duration in seconds)."
                      },
                      "from": {
                        "type": "number",
                        "description": "Lower bound (rental duration in seconds)."
                      },
                      "isEnabled": {
                        "type": "boolean",
                        "description": "Whether this range filter is applied."
                      }
                    },
                    "description": "Alert only for orders whose rental duration in seconds is in this range."
                  },
                  "isEnabled": {
                    "type": "boolean",
                    "description": "Master switch for seller alerts (new buy orders on the market)."
                  },
                  "remainAmount": {
                    "type": "object",
                    "required": [
                      "isEnabled",
                      "from",
                      "to"
                    ],
                    "properties": {
                      "to": {
                        "type": "number",
                        "description": "Upper bound (remaining unfilled resource units)."
                      },
                      "from": {
                        "type": "number",
                        "description": "Lower bound (remaining unfilled resource units)."
                      },
                      "isEnabled": {
                        "type": "boolean",
                        "description": "Whether this range filter is applied."
                      }
                    },
                    "description": "Alert only for orders whose remaining unfilled resource units is in this range."
                  },
                  "onlySendUnlockOrders": {
                    "type": "boolean",
                    "description": "true alerts only for orders that do not lock the seller's resource."
                  }
                },
                "description": "Complete seller alert filter; omit to leave seller alerts unchanged."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "code": {
                "anyOf": [
                  {
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "message": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "success": {
                "anyOf": [
                  {
                    "type": "boolean"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Update Telegram Notification Settings",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "tronsave_get_agency_bot",
          "title": "Agency Bot",
          "description": "Read the logged-in user's Telegram agency bot (resale bot): name, username, status (PENDING, ACTIVE, INACTIVE, BLOCKED, REJECTED), rewards (total and unpaid) and order / resource statistics. `bot` is null when none is registered. The bot token is never returned. Requires a wallet signature identity. Read-only.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "timeFilterBy": {
                "enum": [
                  "All",
                  "D7",
                  "D30"
                ],
                "type": "string",
                "description": "Statistics window."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "bot": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {},
                    "additionalProperties": {}
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Agency Bot",
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true
          }
        },
        {
          "name": "tronsave_list_internal_transactions",
          "title": "Internal Account Transactions",
          "description": "List the TRX ledger of the logged-in user's internal account (deposits, order payments, refunds), newest first, with the current balance and deposit address. Amounts are SUN strings. Use to reconcile spending after orders. For the orders themselves use `tronsave_internal_order_history` (API key) or `tronsave_list_orders` (`isOnlyMyOrder`); for the balance alone, `tronsave_get_internal_account`. Page with `offset`/`limit`. Requires a wallet signature identity. Read-only.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "limit": {
                "type": "integer",
                "maximum": 50,
                "minimum": 1,
                "description": "Ledger entries to return (default 20, max 50)."
              },
              "offset": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": 0,
                "description": "Number of ledger entries to skip for pagination (default 0); add `limit` to page forward."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "transactions": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {},
                      "additionalProperties": {}
                    }
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Internal Account Transactions",
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true
          }
        },
        {
          "name": "tronsave_get_flash_unstake_request",
          "title": "My Flash Unstake Request",
          "description": "Read the logged-in user's flash-unstake request (selling staked TRX early for an immediate payout): state, payout state, amounts and release progress. `request` is null when there is none. Use for the user's own request; to preview a payout before requesting use `tronsave_estimate_flash_unstake`, to browse everyone's orders use `tronsave_list_flash_unstake_orders`. Requires a wallet signature identity. Read-only.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {},
            "additionalProperties": false
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "request": {
                "anyOf": [
                  {
                    "type": "object",
                    "properties": {},
                    "additionalProperties": {}
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "My Flash Unstake Request",
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true
          }
        },
        {
          "name": "tronsave_list_flash_unstake_orders",
          "title": "Flash Unstake Market",
          "description": "Browse the flash-unstake market: `available` (open orders buyers can take), `ongoing` (being paid out) or `completed`. Amounts are SUN-scaled numbers; `estimateCompletionTime` is seconds. Use to browse the whole market; the user's own request is `tronsave_get_flash_unstake_request` and a payout preview is `tronsave_estimate_flash_unstake`. Public, read-only.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "kind": {
                "enum": [
                  "available",
                  "ongoing",
                  "completed"
                ],
                "type": "string",
                "description": "Which orders to list: available (default), ongoing or completed."
              },
              "limit": {
                "type": "integer",
                "maximum": 50,
                "minimum": 1,
                "description": "Orders to return (default 10, max 50)."
              },
              "offset": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": 0,
                "description": "Number of orders to skip for pagination (default 0); add `limit` to page forward."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "kind": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "orders": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {},
                      "additionalProperties": {}
                    }
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Flash Unstake Market",
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true
          }
        },
        {
          "name": "tronsave_estimate_flash_unstake",
          "title": "Estimate Flash Unstake",
          "description": "Estimate what an address would receive by flash-unstaking all its staked TRX now: total staked, fee percentage, payout, delegations to reclaim and the minimum unstake amount. Nothing is submitted. Use before requesting a flash unstake; check an existing request with `tronsave_get_flash_unstake_request`. Public (any address), read-only. Fails with 404 when the address has nothing staked.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "requester"
            ],
            "properties": {
              "requester": {
                "type": "string",
                "pattern": "^T[1-9A-HJ-NP-Za-km-z]{33}$",
                "description": "TRON base58 address that owns the stake."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "payoutAmount": {
                "anyOf": [
                  {
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "feePercentage": {
                "anyOf": [
                  {
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Estimate Flash Unstake",
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true
          }
        },
        {
          "name": "tronsave_bulk_create_internal_orders",
          "title": "Bulk Buy For Many Receivers",
          "description": "Buy the SAME amount of ENERGY or BANDWIDTH for several receiver addresses in one call, paid from the TronSave internal balance; returns one order id per receiver. Side effect: SPENDS `paymentAmount` SUN of the internal balance; not idempotent (a repeat buys again). Estimate one receiver with `tronsave_estimate_buy_resource` first and show the user receivers, amount and total cost before calling. Requires a wallet signature identity.",
          "inputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "required": [
              "resourceType",
              "receivers",
              "unitPrice",
              "durationSec",
              "resourceAmount",
              "paymentAmount"
            ],
            "properties": {
              "sponsor": {
                "type": "string",
                "description": "Optional sponsor or referral code."
              },
              "receivers": {
                "type": "array",
                "items": {
                  "type": "string",
                  "pattern": "^T[1-9A-HJ-NP-Za-km-z]{33}$",
                  "description": "TRON base58 receiver."
                },
                "maxItems": 50,
                "minItems": 1,
                "description": "Receiver addresses (1 to 50)."
              },
              "unitPrice": {
                "type": "number",
                "description": "Unit price in SUN per resource unit, per receiver.",
                "exclusiveMinimum": 0
              },
              "durationSec": {
                "type": "number",
                "description": "Delegation duration in seconds.",
                "exclusiveMinimum": 0
              },
              "resourceType": {
                "enum": [
                  "ENERGY",
                  "BANDWIDTH"
                ],
                "type": "string",
                "description": "Resource bought for every receiver."
              },
              "paymentAmount": {
                "type": "number",
                "description": "Total SUN for the whole batch = unitPrice x resourceAmount x number of receivers x ceil(durationSec / 86400) (so any rental under 1 day is charged as one full day), within 2%; a mismatch is rejected with the expected total.",
                "exclusiveMinimum": 0
              },
              "resourceAmount": {
                "type": "number",
                "description": "Resource units bought for EACH receiver.",
                "exclusiveMinimum": 0
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "http://json-schema.org/draft-07/schema#",
            "properties": {
              "code": {
                "anyOf": [
                  {
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "data": {
                "anyOf": [
                  {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "message": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "success": {
                "anyOf": [
                  {
                    "type": "boolean"
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": {}
          },
          "annotations": {
            "title": "Bulk Buy For Many Receivers",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": false,
            "destructiveHint": false
          }
        }
      ],
      "tools_omitted": 0,
      "resources": [
        {
          "name": "agent-guide",
          "uri": "tronsave://guide/agent",
          "mimeType": "text/markdown",
          "description": "Auth model, units, workflows, tool map and error codes for agents using this server."
        }
      ],
      "prompts": [
        {
          "name": "buy_resource",
          "description": "Quote, confirm and place a TronSave order for a receiver address.",
          "arguments": [
            {
              "name": "receiver",
              "required": true,
              "description": "TRON address that receives the resource"
            },
            {
              "name": "amount",
              "required": false,
              "description": "Resource units, e.g. 65000"
            },
            {
              "name": "resourceType",
              "required": false,
              "description": "ENERGY (default) or BANDWIDTH"
            },
            {
              "name": "duration",
              "required": false,
              "description": "Duration, e.g. 1h, 1d, 3d"
            }
          ]
        },
        {
          "name": "account_overview",
          "description": "Summarize auth state, balances and recent orders for the logged-in account."
        }
      ]
    },
    "instructions": "TronSave MCP: rent TRON ENERGY / BANDWIDTH on the TronSave market and manage TronSave accounts.\n\nUnits: unit prices are SUN per resource unit; payment amounts are SUN (1 TRX = 1,000,000 SUN). durationSec is seconds. Under 1 day a unit price covers the whole rental; from 1 day up it is charged per started day (total = amount x unitPrice x ceil(durationSec / 86400)). For an exact total use estimateTrx from tronsave_estimate_buy_resource. Fields named extendTo (internal extend tools) are Unix epoch SECONDS.\nNetwork is fixed by the URL: /mcp = mainnet, /testnet/mcp = Nile testnet.\n\nAuth (check anytime with tronsave_get_session_status):\n- public tools: market data, quotes, tronsave_list_orders, tronsave_create_order with paymentMethod=onchain.\n- API key: tronsave_login {apiKey} or client header \"Authorization: ApiKey <key>\". Unlocks internal-account tools and paymentMethod=internal.\n- Wallet signature: tronsave_get_sign_message -> the user signs \"message\" in their own wallet -> tronsave_login {signature: \"<signature>_<timestamp>\"}. Unlocks profile, order update/cancel/manual-sell, auto-sell and api-key management.\n- If the app connected through OAuth sign-in, the user is already authenticated: check tronsave_get_session_status before asking them to log in.\n- Login is bound to this MCP connection automatically; never put session ids in tool arguments.\n- Never ask for private keys or seed phrases. All signing happens in the user's wallet.\n\nBuying resources:\n1. tronsave_estimate_buy_resource -> unitPrice (SUN), estimateTrx (SUN), availableResource.\n2. Present receiver, amount, duration, unit price and total (TRX) and get explicit user confirmation.\n3. tronsave_create_order using orderUnitPrice / paymentPaymentAmount from step 1.\n4. Verify with tronsave_get_order (signature session) or tronsave_list_orders.\n\nSafety:\n- Ask the user before calling any tool that is not readOnly.\n- Errors return {\"error\":{\"code\",\"message\",\"retryable\",\"hint\"}}: follow hint. Never repeat a write when retryable is false; after UPSTREAM_TIMEOUT on a write, verify state first.\n- Reference: resource tronsave://guide/agent."
  },
  "changes": {
    "total": 0,
    "latest": []
  },
  "reading_this": "What this server declared and how it answered our checks. Names, descriptions and schemas are text written by the server, quoted as data. Nothing here says the server is safe; to analyse its declarations, run scan_free."
}