Skip to main content
Glama

TronSave MCP Server

by io.tronsave.mcp
OverviewDiscussionsAdmin

Order Detail

tronsave_get_order
Read-onlyIdempotent

Read one order by id and return its full snapshot for NORMAL, FAST, or EXTEND order types. 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. FRESHNESS: order state can change within seconds as the market matches — re-read immediately before each mutation instead of reusing an earlier snapshot. Requires a signature session and mcp-session-id. Read-only and idempotent.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
idYesTarget order id (`MObjectId`) to inspect. Use this to confirm current status/price before update, sell, or cancel actions.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
orderYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • 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"
+  }
+]
  2. Changed1 schema field changed
    • 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."
  3. Added

TDQS

A4.7/5.0
Behavior5/5

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

Annotations already declare readOnlyHint, idempotentHint, openWorldHint. Description adds authentication requirement (signature session, mcp-session-id) and a FRESHNESS warning about rapid state changes, which are behavioral traits not covered by annotations. No contradictions.

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?

The description is concise: first sentence states purpose, second provides usage guidelines with sibling references, third gives behavioral context, and final sentence covers requirements. No redundant words, front-loaded with key info.

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 simple read tool with one parameter and an output schema, the description covers purpose, usage guidelines, behavioral context, and prerequisites. No gaps remain.

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

Parameters3/5

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

Schema description coverage is 100%, with the only parameter 'id' well-described in the schema. The description merely mentions 'by id' and does not add significant new meaning beyond the schema. Baseline score of 3 is appropriate as schema does the heavy lifting.

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?

The description clearly states 'Read one order by id and return its full snapshot for NORMAL, FAST, or EXTEND order types,' specifying the verb, resource, and scope. It distinguishes from siblings like tronsave_list_orders by focusing on a single order.

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?

Explicitly instructs to use before tronsave_update_order, tronsave_sell_order_manual, or tronsave_cancel_order to avoid stale state, and advises to re-read immediately before each mutation. Also mentions prerequisites: signature session and mcp-session-id. Provides clear when-to-use and rationale.

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 toolsInspect
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