TronSave MCP Server

Order Detail

tronsave_get_order

Read-onlyIdempotent

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.

Input Schema

Name	Required	Description	Default
`id`	Yes	Target order id (`MObjectId`) to inspect. Use this to confirm current status/price before update, sell, or cancel actions.

Output Schema

Name	Required	Description	Default
`order`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed3 schema fields changedOct 28, 2026

changedOutput schema / additionalProperties
```
Previous value: -falseNew value: +{}
```

changedOutput schema / properties / order / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "apy": {
-        "description": "Annualized yield hint as returned by the API (see TronSave semantics).",
-        "type": "number"
-      },
-      "createdAt": {
-        "description": "Order creation time (ISO-8601).",
-        "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))$",
-        "type": "string"
-      },
-      "durationSec": {
-        "description": "Delegation duration in seconds.",
-        "type": "number"
-      },
-      "id": {
-        "description": "Order id (`MObjectId`); use with `tronsave_get_order` or mutate tools.",
-        "type": "string"
-      },
-      "isMatching": {
-        "description": "Whether this order matches the viewer/matching filter used in the query.",
-        "type": "boolean"
-      },
-      "isOwner": {
-        "description": "Whether the list query’s viewer context treats this row as owned by `myAddress`.",
-        "type": "boolean"
-      },
-      "receiver": {
-        "additionalProperties": false,
-        "description": "Receiver wallet and related party info for the delegation leg.",
-        "properties": {
-          "address": {
-            "description": "TRON base58 address for this party.",
-            "type": "string"
-          }
-        },
-        "required": [
-          "address"
-        ],
-        "type": "object"
-      },
-      "remainAmount": {
-        "description": "Resource not yet consumed or remaining to fulfill.",
-        "type": "number"
-      },
-      "requester": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "address": {
-                "description": "TRON base58 address for this party.",
-                "type": "string"
-              }
-            },
-            "required": [
-              "address"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Requester party when present."
-      },
-      "resourceAmount": {
-        "description": "Original resource amount on the order.",
-        "type": "number"
-      },
-      "resourceType": {
-        "description": "`ENERGY` or `BANDWIDTH`.",
-        "enum": [
-          "ENERGY",
-          "BANDWIDTH"
-        ],
-        "type": "string"
-      },
-      "typeOrder": {
-        "description": "Market order flavor.",
-        "enum": [
-          "NORMAL",
-          "FAST",
-          "EXTEND"
-        ],
-        "type": "string"
-      },
-      "unitPrice": {
-        "description": "Unit price in SUN.",
-        "type": "number"
-      }
-    },
-    "required": [
-      "id",
-      "receiver",
-      "resourceType",
-      "resourceAmount",
-      "remainAmount",
-      "durationSec",
-      "isOwner",
-      "isMatching",
-      "apy",
-      "unitPrice",
-      "createdAt",
-      "typeOrder"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": {},
+    "properties": {
+      "apy": {
+        "anyOf": [
+          {
+            "description": "Annualized yield hint as returned by the API (see TronSave semantics).",
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Annualized yield hint as returned by the API (see TronSave semantics)."
+      },
+      "createdAt": {
+        "anyOf": [
+          {
+            "description": "Order creation time (ISO-8601).",
+            "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))$",
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Order creation time (ISO-8601)."
+      },
+      "durationSec": {
+        "anyOf": [
+          {
+            "description": "Delegation duration in seconds.",
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Delegation duration in seconds."
+      },
+      "id": {
+        "anyOf": [
+          {
+            "description": "Order id (`MObjectId`); use with `tronsave_get_order` or mutate tools.",
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Order id (`MObjectId`); use with `tronsave_get_order` or mutate tools."
+      },
+      "isMatching": {
+        "anyOf": [
+          {
+            "description": "Whether this order matches the viewer/matching filter used in the query.",
+            "type": "boolean"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Whether this order matches the viewer/matching filter used in the query."
+      },
+      "isOwner": {
+        "anyOf": [
+          {
+            "description": "Whether the list query’s viewer context treats this row as owned by `myAddress`.",
+            "type": "boolean"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Whether the list query’s viewer context treats this row as owned by `myAddress`."
+      },
+      "receiver": {
+        "anyOf": [
+          {
+            "additionalProperties": {},
+            "description": "Receiver wallet and related party info for the delegation leg.",
+            "properties": {
+              "address": {
+                "anyOf": [
+                  {
+                    "description": "TRON base58 address for this party.",
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "TRON base58 address for this party."
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Receiver wallet and related party info for the delegation leg."
+      },
+      "remainAmount": {
+        "anyOf": [
+          {
+            "description": "Resource not yet consumed or remaining to fulfill.",
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Resource not yet consumed or remaining to fulfill."
+      },
+      "requester": {
+        "anyOf": [
+          {
+            "additionalProperties": {},
+            "description": "Requester party when present.",
+            "properties": {
+              "address": {
+                "anyOf": [
+                  {
+                    "description": "TRON base58 address for this party.",
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "TRON base58 address for this party."
+              }
+            },
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Requester party when present."
+      },
+      "resourceAmount": {
+        "anyOf": [
+          {
+            "description": "Original resource amount on the order.",
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Original resource amount on the order."
+      },
+      "resourceType": {
+        "anyOf": [
+          {
+            "description": "`ENERGY` or `BANDWIDTH`.",
+            "enum": [
+              "ENERGY",
+              "BANDWIDTH"
+            ],
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "`ENERGY` or `BANDWIDTH`."
+      },
+      "typeOrder": {
+        "anyOf": [
+          {
+            "description": "Market order flavor.",
+            "enum": [
+              "NORMAL",
+              "FAST",
+              "EXTEND"
+            ],
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Market order flavor."
+      },
+      "unitPrice": {
+        "anyOf": [
+          {
+            "description": "Unit price in SUN.",
+            "type": "number"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Unit price in SUN."
+      }
+    },
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / required
```
Removed value: -[
-  "order"
-]
```

Changed1 schema field changedMay 4, 2026

changedOutput schema / properties / order / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "apy": {
-        "type": "number"
-      },
-      "createdAt": {
-        "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))$",
-        "type": "string"
-      },
-      "durationSec": {
-        "type": "number"
-      },
-      "id": {
-        "type": "string"
-      },
-      "isMatching": {
-        "type": "boolean"
-      },
-      "isOwner": {
-        "type": "boolean"
-      },
-      "receiver": {
-        "additionalProperties": false,
-        "properties": {
-          "address": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "address"
-        ],
-        "type": "object"
-      },
-      "remainAmount": {
-        "type": "number"
-      },
-      "requester": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "address": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "address"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "resourceAmount": {
-        "type": "number"
-      },
-      "resourceType": {
-        "enum": [
-          "ENERGY",
-          "BANDWIDTH"
-        ],
-        "type": "string"
-      },
-      "typeOrder": {
-        "enum": [
-          "NORMAL",
-          "FAST",
-          "EXTEND"
-        ],
-        "type": "string"
-      },
-      "unitPrice": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "id",
-      "receiver",
-      "resourceType",
-      "resourceAmount",
-      "remainAmount",
-      "durationSec",
-      "isOwner",
-      "isMatching",
-      "apy",
-      "unitPrice",
-      "createdAt",
-      "typeOrder"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "apy": {
+        "description": "Annualized yield hint as returned by the API (see TronSave semantics).",
+        "type": "number"
+      },
+      "createdAt": {
+        "description": "Order creation time (ISO-8601).",
+        "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))$",
+        "type": "string"
+      },
+      "durationSec": {
+        "description": "Delegation duration in seconds.",
+        "type": "number"
+      },
+      "id": {
+        "description": "Order id (`MObjectId`); use with `tronsave_get_order` or mutate tools.",
+        "type": "string"
+      },
+      "isMatching": {
+        "description": "Whether this order matches the viewer/matching filter used in the query.",
+        "type": "boolean"
+      },
+      "isOwner": {
+        "description": "Whether the list query’s viewer context treats this row as owned by `myAddress`.",
+        "type": "boolean"
+      },
+      "receiver": {
+        "additionalProperties": false,
+        "description": "Receiver wallet and related party info for the delegation leg.",
+        "properties": {
+          "address": {
+            "description": "TRON base58 address for this party.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "address"
+        ],
+        "type": "object"
+      },
+      "remainAmount": {
+        "description": "Resource not yet consumed or remaining to fulfill.",
+        "type": "number"
+      },
+      "requester": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "address": {
+                "description": "TRON base58 address for this party.",
+                "type": "string"
+              }
+            },
+            "required": [
+              "address"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Requester party when present."
+      },
+      "resourceAmount": {
+        "description": "Original resource amount on the order.",
+        "type": "number"
+      },
+      "resourceType": {
+        "description": "`ENERGY` or `BANDWIDTH`.",
+        "enum": [
+          "ENERGY",
+          "BANDWIDTH"
+        ],
+        "type": "string"
+      },
+      "typeOrder": {
+        "description": "Market order flavor.",
+        "enum": [
+          "NORMAL",
+          "FAST",
+          "EXTEND"
+        ],
+        "type": "string"
+      },
+      "unitPrice": {
+        "description": "Unit price in SUN.",
+        "type": "number"
+      }
+    },
+    "required": [
+      "id",
+      "receiver",
+      "resourceType",
+      "resourceAmount",
+      "remainAmount",
+      "durationSec",
+      "isOwner",
+      "isMatching",
+      "apy",
+      "unitPrice",
+      "createdAt",
+      "typeOrder"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Changed1 schema field changedApr 29, 2026

changedInput schema / properties / id / description

Previous value: -"Order id (`MObjectId`)."New value: +"Target order id (`MObjectId`) to inspect. Use this to confirm current status/price before update, sell, or cancel actions."

AddedApr 24, 2026

TDQS

A4.7/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint, idempotentHint, and openWorldHint, so the safety profile is covered. The description adds two things beyond them: the wallet-signature identity requirement (an auth prerequisite the annotations do not express) and the sequencing role as source of truth before mutations. Return-value detail is omitted, but that is acceptable given the output schema.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Four short sentences, each carrying a distinct fact: what it reads, the API-key alternative, the pre-mutation sequencing role, and the auth/safety profile. Front-loaded with the action and resource, zero filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a single-parameter read tool with full schema coverage, an output schema, and complete annotations, nothing an agent needs is missing. Auth requirement, alternative tool, and ordering relative to write tools are all present.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100% and the single parameter already documents `id` as an MObjectId for confirming status/price. The description adds the useful framing that the id refers to one of three order types (NORMAL, FAST, EXTEND), which is not in the schema. Slightly above baseline because of that added semantic.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Read one order by `id`') plus the return shape ('full snapshot') and the covered order types (NORMAL, FAST, EXTEND). It is immediately distinguishable from `tronsave_list_orders` (plural listing) and `tronsave_internal_order_details` (API-key variant), both named or implied.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives explicit routing: use `tronsave_internal_order_details` when only an API key is available, and use this tool as the freshness check before `tronsave_update_order`, `tronsave_sell_order_manual`, or `tronsave_cancel_order`. Both the when-to-use and the alternative condition are spelled out, with the stale-state risk stated as the reason.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All TronSave MCP Server tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?