@aihubspot/agent-trade-mcp 0.1.3 → 0.1.5

package/README.md

@@ -24,3 +24,13 @@ Setup registers the currently installed MCP binary through its absolute Node run
 Use `spot_prepare_market_buy` or `margin_prepare_market_buy` only with `quoteAmount` (for example, the exact USDT amount to spend for `ETHUSDT`). Use `spot_prepare_market_sell` or `margin_prepare_market_sell` only with `baseQuantity` (the exact ETH amount to sell for `ETHUSDT`). A market buy cannot guarantee an exact base-asset quantity; it must never reinterpret a requested base quantity as a quote amount.
 
 Before any order preview, MCP lazily loads `/sapi/v2/symbols` once per local profile and caches the symbol rules in memory for five minutes. Known quantity/price precision and limit-order minimum violations are rejected before confirmation.
+
+## Ticker response
+
+All read tools return `{ "ok": true, "data": ... }` in one of these stable forms:
+
+- Arrays: `{ "dataType": "array", "items": [...], "count": 500 }`
+- Objects: `{ "dataType": "object", "value": { ... } }`
+- Scalars: `{ "dataType": "scalar", "value": "..." }`
+
+`market_get_ticker` additionally exposes `data.tickers` as an alias of `data.items`. Check `data.dataType` before formatting; do not infer raw OpenAPI nesting.

package/dist/index.js

@@ -917,7 +917,7 @@ var marketTools = [
   {
     name: "market_get_ticker",
     title: "Get Spot Ticker",
-    description: "Get spot ticker data. Pass symbol or symbols when filtering is needed.",
+    description: "Get spot ticker data. Pass symbol or symbols when filtering is needed. The raw OpenAPI response is a ticker array.",
     cliPath: ["market", "ticker"],
     module: "spot-common",
     access: "public",
@@ -2129,6 +2129,19 @@ var CONFIRM_ACTION_TOOL = "confirm_action";
 function result(data) {
   return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
 }
+function formatMcpData(toolName, data) {
+  if (Array.isArray(data)) {
+    return {
+      dataType: "array",
+      items: data,
+      count: data.length,
+      ...toolName === "market_get_ticker" ? { tickers: data } : {}
+    };
+  }
+  if (data === null || data === void 0) return { dataType: "null", value: null };
+  if (typeof data === "object") return { dataType: "object", value: data };
+  return { dataType: "scalar", value: data };
+}
 function toMcpErrorResult(error) {
   const payload = toAiHubErrorPayload(error);
   return { isError: true, content: [{ type: "text", text: JSON.stringify({ ok: false, ...payload }) }] };
@@ -2137,7 +2150,7 @@ function toMcpTool(tool) {
   return {
     name: tool.name,
     title: tool.title,
-    description: tool.description,
+    description: `${tool.description}${tool.operation === "read" ? " Successful MCP output is always { ok: true, data: ... }. For list results, use data.items and data.count (market_get_ticker also provides data.tickers); for object results, use data.value. Check data.dataType before formatting." : ""}`,
     inputSchema: tool.inputSchema,
     annotations: {
       readOnlyHint: tool.operation === "read",
@@ -2164,10 +2177,10 @@ function createServer(profileName, readOnly) {
   const registry = createToolRegistry();
   const writeExecutor = new ToolWriteExecutor(registry);
   const server = new Server(
-    { name: "ai-hub-agent-trade", version: "0.1.3" },
+    { name: "ai-hub-agent-trade", version: "0.1.5" },
     {
       capabilities: { tools: {} },
-      instructions: "For every state-changing action, call only a spot_prepare_* or margin_prepare_* tool first and show its exact summary to the user. Stop and wait for a new, explicit user confirmation message. Only then call confirm_action with that new message verbatim in userConfirmation. Never call prepare and confirm consecutively for one user instruction; never infer confirmation from prior intent, silence, or an Agent-generated message. For spot and margin orders, MARKET BUY always uses quoteAmount (the quote asset to spend); MARKET SELL uses baseQuantity (the base asset to sell). Never reinterpret a requested base quantity as quoteAmount."
+      instructions: "Every successful tool response is JSON text in the envelope { ok: true, data: ... }. All read-tool data is normalized: dataType=array means use data.items and data.count; dataType=object or scalar means use data.value; dataType=null means no value. market_get_ticker also provides data.tickers as an alias of data.items. Inspect data.dataType before formatting and never assume undocumented nested keys. Prepare/confirm tools return their documented action payload directly in data. For every state-changing action, call only a spot_prepare_* or margin_prepare_* tool first and show its exact summary to the user. Stop and wait for a new, explicit user confirmation message. Only then call confirm_action with that new message verbatim in userConfirmation. Never call prepare and confirm consecutively for one user instruction; never infer confirmation from prior intent, silence, or an Agent-generated message. For spot and margin orders, MARKET BUY always uses quoteAmount (the quote asset to spend); MARKET SELL uses baseQuantity (the base asset to sell). Never reinterpret a requested base quantity as quoteAmount."
     }
   );
   server.setRequestHandler(ListToolsRequestSchema, async () => ({
@@ -2214,7 +2227,7 @@ function createServer(profileName, readOnly) {
         return result({ ok: true, data: await writeExecutor.prepare(preparedTool.name, request.params.arguments ?? {}, context) });
       }
       const data = await registry.execute(request.params.name, request.params.arguments ?? {}, context, { readOnly });
-      return result({ ok: true, data });
+      return result({ ok: true, data: formatMcpData(request.params.name, data) });
     } catch (error) {
       return toMcpErrorResult(error);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aihubspot/agent-trade-mcp",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Local stdio MCP server for AI Hub spot trading tools",
   "license": "UNLICENSED",
   "type": "module",