@okx_ai/okx-trade-mcp 1.3.5 → 1.3.6

package/dist/index.js

@@ -5,6 +5,7 @@ import { parseArgs } from "util";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 
 // ../core/dist/index.js
+import { EnvHttpProxyAgent, setGlobalDispatcher } from "undici";
 import { ProxyAgent } from "undici";
 import { isIP } from "net";
 import { lookup as dnsLookup } from "dns";
@@ -35,10 +36,10 @@ import { writeFileSync as writeFileSync2, renameSync as renameSync2, unlinkSync
 import { join as join4, resolve, basename, sep } from "path";
 import { randomUUID } from "crypto";
 import yauzl from "yauzl";
-import { join as join6, dirname as dirname3 } from "path";
+import { join as join8, dirname as dirname3 } from "path";
 import { homedir as homedir4 } from "os";
-import { readFileSync as readFileSync4, writeFileSync as writeFileSync4, mkdirSync as mkdirSync5, existsSync as existsSync3 } from "fs";
-import { join as join7, dirname as dirname4 } from "path";
+import { readFileSync as readFileSync6, writeFileSync as writeFileSync4, mkdirSync as mkdirSync5, existsSync as existsSync3 } from "fs";
+import { join as join9, dirname as dirname4 } from "path";
 import { homedir as homedir5 } from "os";
 
 // ../../node_modules/.pnpm/smol-toml@1.6.0/node_modules/smol-toml/dist/error.js
@@ -727,8 +728,8 @@ function parse(toml, { maxDepth = 1e3, integersAsBigInt } = {}) {
 }
 
 // ../core/dist/index.js
-import { readFileSync as readFileSync5, writeFileSync as writeFileSync5, mkdirSync as mkdirSync6, existsSync as existsSync4 } from "fs";
-import { join as join8 } from "path";
+import { readFileSync as readFileSync7, writeFileSync as writeFileSync5, mkdirSync as mkdirSync6, existsSync as existsSync4 } from "fs";
+import { join as join10 } from "path";
 import { homedir as homedir6 } from "os";
 import fs2 from "fs";
 import path2 from "path";
@@ -737,8 +738,21 @@ import * as fs3 from "fs";
 import * as path3 from "path";
 import * as os3 from "os";
 import { execFileSync } from "child_process";
-import { join as join12 } from "path";
+import { join as join14 } from "path";
 import { homedir as homedir10 } from "os";
+function hasProxyEnv(env = process.env) {
+  return Boolean(
+    env.HTTPS_PROXY || env.https_proxy || env.HTTP_PROXY || env.http_proxy
+  );
+}
+function installEnvProxyDispatcher(deps = {}) {
+  const env = deps.env ?? process.env;
+  if (!hasProxyEnv(env)) return false;
+  const register = deps.register ?? (() => setGlobalDispatcher(new EnvHttpProxyAgent()));
+  register();
+  return true;
+}
+installEnvProxyDispatcher();
 var EXEC_TIMEOUT_MS = 3e4;
 var ALLOWED_DOMAIN_RE = /^[\w.-]+\.okx\.com$/;
 var PILOT_BIN_DIR = join(homedir(), ".okx", "bin");
@@ -761,25 +775,25 @@ function execPilotBinary(domain, exclude = [], userAgent) {
   if (userAgent) {
     args.push("--user-agent", userAgent);
   }
-  return new Promise((resolve3) => {
+  return new Promise((resolve4) => {
     execFile(
       binPath,
       args,
       { timeout: EXEC_TIMEOUT_MS, encoding: "utf-8" },
       (error, stdout) => {
         if (error) {
-          resolve3(null);
+          resolve4(null);
           return;
         }
         try {
           const result = JSON.parse(stdout);
           if (result.code === 0 && result.data) {
-            resolve3(result.data);
+            resolve4(result.data);
           } else {
-            resolve3(null);
+            resolve4(null);
           }
         } catch {
-          resolve3(null);
+          resolve4(null);
         }
       }
     );
@@ -1113,7 +1127,7 @@ var EXIT_CODES = {
   NOT_LOGGED_IN: 2,
   REFRESH_FAILED: 3
 };
-function finalizeToken(code, token, resolve3, reject) {
+function finalizeToken(code, token, resolve4, reject) {
   if (code === EXIT_CODES.SUCCESS) {
     if (!token) {
       reject(new AuthenticationError(
@@ -1122,7 +1136,7 @@ function finalizeToken(code, token, resolve3, reject) {
       ));
       return;
     }
-    resolve3(token);
+    resolve4(token);
     return;
   }
   if (code === EXIT_CODES.NOT_LOGGED_IN) {
@@ -1159,7 +1173,7 @@ function defaultWindowsPipeName() {
   return WIN_PIPE_PREFIX + randomBytes(32).toString("hex");
 }
 function execAuthTokenWindows(binPath, makePipeName = defaultWindowsPipeName) {
-  return new Promise((resolve3, reject) => {
+  return new Promise((resolve4, reject) => {
     const pipeName = makePipeName();
     const server = createServer();
     const chunks = [];
@@ -1179,7 +1193,7 @@ function execAuthTokenWindows(binPath, makePipeName = defaultWindowsPipeName) {
     const tryFinalize = () => {
       if (!pipeClosed || exitCode === void 0) return;
       const token = Buffer.concat(chunks).toString("utf-8").trim();
-      settle(() => finalizeToken(exitCode, token, resolve3, reject));
+      settle(() => finalizeToken(exitCode, token, resolve4, reject));
     };
     server.on("connection", (socket) => {
       connectionMade = true;
@@ -1226,7 +1240,7 @@ function execAuthToken() {
   return process.platform === "win32" ? execAuthTokenWindows(binPath) : execAuthTokenUnix(binPath);
 }
 function execAuthTokenUnix(binPath) {
-  return new Promise((resolve3, reject) => {
+  return new Promise((resolve4, reject) => {
     const child = spawn2(binPath, ["token"], {
       stdio: ["ignore", "ignore", "inherit", "pipe"]
       //       stdin    stdout    stderr     fd3 (pipe)
@@ -1239,35 +1253,35 @@ function execAuthTokenUnix(binPath) {
     });
     child.on("close", (code) => {
       const token = Buffer.concat(chunks).toString("utf-8").trim();
-      finalizeToken(code, token, resolve3, reject);
+      finalizeToken(code, token, resolve4, reject);
     });
   });
 }
 function execAuthStatus() {
   const binPath = getAuthBinaryPath();
-  return new Promise((resolve3) => {
+  return new Promise((resolve4) => {
     execFile2(
       binPath,
       ["status", "--json"],
       { timeout: EXEC_TIMEOUT_MS2, encoding: "utf-8" },
       (error, stdout) => {
         if (error) {
-          resolve3(null);
+          resolve4(null);
           return;
         }
         try {
           const result = JSON.parse(stdout);
-          resolve3(result);
+          resolve4(result);
         } catch {
-          resolve3(null);
+          resolve4(null);
         }
       }
     );
   });
 }
 function sleep(ms) {
-  return new Promise((resolve3) => {
-    setTimeout(resolve3, ms);
+  return new Promise((resolve4) => {
+    setTimeout(resolve4, ms);
   });
 }
 var RateLimiter = class {
@@ -2337,6 +2351,7 @@ function registerIndicatorTools() {
   return [
     {
       name: "market_get_indicator",
+      title: "Get Technical Indicator",
       module: "market",
       description: "Get technical indicator values for an instrument. Common indicators: ma, ema, rsi, macd, bb (Bollinger), kdj, supertrend, ahr999. Call market_list_indicators first to see all valid names. No credentials required.",
       isWrite: false,
@@ -2410,6 +2425,7 @@ function registerIndicatorTools() {
     },
     {
       name: "market_list_indicators",
+      title: "List Technical Indicators",
       module: "market",
       description: "List all supported technical indicator names and descriptions. Call this before market_get_indicator to discover valid indicator names. No credentials required.",
       isWrite: false,
@@ -2468,6 +2484,7 @@ function registerAccountTools() {
   return [
     {
       name: "account_get_balance",
+      title: "Get Trading Account Balance",
       module: "account",
       description: "Get account balance for trading account. Returns balances for all currencies or a specific one.",
       isWrite: false,
@@ -2492,9 +2509,11 @@ function registerAccountTools() {
     },
     {
       name: "account_transfer",
+      title: "Transfer Between Accounts",
       module: "account",
       description: "Transfer funds between accounts (trading, funding, etc.). [CAUTION] Moves real funds.",
       isWrite: true,
+      destructiveHint: false,
       inputSchema: {
         type: "object",
         properties: {
@@ -2549,6 +2568,7 @@ function registerAccountTools() {
     },
     {
       name: "account_get_max_size",
+      title: "Get Max Order Size",
       module: "account",
       description: "Get max buy/sell order size for a SWAP/FUTURES instrument given current balance and leverage. Useful before placing orders.",
       isWrite: false,
@@ -2596,6 +2616,7 @@ function registerAccountTools() {
     },
     {
       name: "account_get_asset_balance",
+      title: "Get Funding Account Balance",
       module: "account",
       description: "Get funding account balance (asset account). Different from account_get_balance which queries the trading account. Optionally includes total asset valuation across all account types (trading, funding, earn, etc.).",
       isWrite: false,
@@ -2659,6 +2680,7 @@ function registerAccountTools() {
     },
     {
       name: "account_get_bills",
+      title: "Get Account Bills",
       module: "account",
       description: "Get account ledger: fees paid, funding charges, realized PnL, transfers, etc. Default 20 records (last 7 days), max 100.",
       isWrite: false,
@@ -2725,6 +2747,7 @@ function registerAccountTools() {
     },
     {
       name: "account_get_positions_history",
+      title: "Get Closed Positions History",
       module: "account",
       description: "Get closed position history for SWAP or FUTURES. Default 20 records, max 100.",
       isWrite: false,
@@ -2786,6 +2809,7 @@ function registerAccountTools() {
     },
     {
       name: "account_get_trade_fee",
+      title: "Get Trade Fee Tier",
       module: "account",
       description: "Get maker/taker fee rates for the account. Useful to understand your fee tier before trading.",
       isWrite: false,
@@ -2818,6 +2842,7 @@ function registerAccountTools() {
     },
     {
       name: "account_get_config",
+      title: "Get Account Configuration",
       module: "account",
       description: "Get account configuration: position mode (net vs hedge), account level, auto-loan settings, etc. Note: `settleCcy` is the current settlement currency for USDS-margined contracts. `settleCcyList` is the list of available settlement currencies to choose from. These fields only apply to USDS-margined contracts and can be ignored for standard USDT/coin-margined trading.",
       isWrite: false,
@@ -2836,6 +2861,7 @@ function registerAccountTools() {
     },
     {
       name: "account_get_max_withdrawal",
+      title: "Get Max Withdrawable Amount",
       module: "account",
       description: "Get maximum withdrawable amount for a currency from the trading account. Useful before initiating a transfer or withdrawal.",
       isWrite: false,
@@ -2860,6 +2886,7 @@ function registerAccountTools() {
     },
     {
       name: "account_get_max_avail_size",
+      title: "Get Max Available Position Size",
       module: "account",
       description: "Get maximum available size for opening or reducing a position. Different from account_get_max_size which calculates new order size.",
       isWrite: false,
@@ -2904,6 +2931,7 @@ function registerAccountTools() {
     },
     {
       name: "account_get_positions",
+      title: "Get Current Positions",
       module: "account",
       description: "Get current open positions across all instrument types (MARGIN, SWAP, FUTURES, OPTION, EVENTS). Use swap_get_positions for SWAP/FUTURES-only queries.",
       isWrite: false,
@@ -2939,6 +2967,7 @@ function registerAccountTools() {
     },
     {
       name: "account_get_bills_archive",
+      title: "Get Archived Account Bills",
       module: "account",
       description: "Get archived account ledger (bills older than 7 days, up to 3 months). Use account_get_bills for recent 7-day records. Default 20 records, max 100.",
       isWrite: false,
@@ -3005,9 +3034,11 @@ function registerAccountTools() {
     },
     {
       name: "account_set_position_mode",
+      title: "Set Position Mode",
       module: "account",
       description: "Switch between net position mode and long/short hedge mode. net: one position per instrument (default). long_short_mode: separate long and short positions. [CAUTION] Requires no open positions or pending orders.",
       isWrite: true,
+      idempotentHint: true,
       inputSchema: {
         type: "object",
         properties: {
@@ -3147,6 +3178,8 @@ function registerAlgoTradeTools() {
   return [
     {
       name: "swap_place_algo_order",
+      title: "Perpetual Futures Place Algo Order",
+      destructiveHint: false,
       module: "swap",
       description: "Place a SWAP/FUTURES algo order. [CAUTION] Executes real trades. conditional: single TP, single SL, or both on one order. oco: TP+SL simultaneously - first trigger cancels the other. move_order_stop: trailing stop (callbackRatio or callbackSpread). trigger: pending order activated when triggerPx is hit (provide triggerPx + orderPx). chase: smart-follow best bid/ask. iceberg: split large order into child orders at intervals. twap: time-weighted average price order splitting.",
       isWrite: true,
@@ -3295,6 +3328,8 @@ function registerAlgoTradeTools() {
     },
     {
       name: "swap_place_move_stop_order",
+      title: "Perpetual Futures Place Move-Stop Order",
+      destructiveHint: false,
       module: "swap",
       description: "[DEPRECATED] Use swap_place_algo_order with ordType='move_order_stop' instead. Place a SWAP/FUTURES trailing stop order. [CAUTION] Executes real trades. Specify callbackRatio (e.g. '0.01'=1%) or callbackSpread (fixed price distance), not both. Optionally set activePx so tracking starts once market reaches that price.",
       isWrite: true,
@@ -3372,6 +3407,8 @@ function registerAlgoTradeTools() {
     },
     {
       name: "swap_cancel_algo_orders",
+      title: "Perpetual Futures Cancel Algo Orders",
+      idempotentHint: true,
       module: "swap",
       description: "Cancel one or more pending SWAP/FUTURES algo orders (TP/SL). Accepts a list of {algoId, instId} objects.",
       isWrite: true,
@@ -3415,6 +3452,7 @@ function registerAlgoTradeTools() {
     },
     {
       name: "swap_get_algo_orders",
+      title: "Perpetual Futures Get Algo Orders",
       module: "swap",
       description: "Query pending or completed SWAP/FUTURES algo orders (TP/SL, OCO, trailing stop).",
       isWrite: false,
@@ -3507,6 +3545,8 @@ function registerFuturesAlgoTools() {
   return [
     {
       name: "futures_place_algo_order",
+      title: "Futures Place Algo Order",
+      destructiveHint: false,
       module: "futures",
       description: "Place a FUTURES delivery algo order. [CAUTION] Executes real trades. conditional: single TP, single SL, or both on one order. oco: TP+SL simultaneously - first trigger cancels the other. move_order_stop: trailing stop (callbackRatio or callbackSpread). trigger: pending order activated when triggerPx is hit (provide triggerPx + orderPx). chase: smart-follow best bid/ask. iceberg: split large order into child orders at intervals. twap: time-weighted average price order splitting.",
       isWrite: true,
@@ -3655,6 +3695,8 @@ function registerFuturesAlgoTools() {
     },
     {
       name: "futures_place_move_stop_order",
+      title: "Futures Place Move-Stop Order",
+      destructiveHint: false,
       module: "futures",
       description: "[DEPRECATED] Use futures_place_algo_order with ordType='move_order_stop' instead. Place a FUTURES delivery trailing stop order. [CAUTION] Executes real trades.",
       isWrite: true,
@@ -3732,6 +3774,8 @@ function registerFuturesAlgoTools() {
     },
     {
       name: "futures_amend_algo_order",
+      title: "Futures Amend Algo Order",
+      idempotentHint: true,
       module: "futures",
       description: "Amend a pending FUTURES delivery algo order (modify TP/SL prices or size). Also covers TP/SL orders attached when placing the main order - look up algoId via futures_get_algo_orders first.",
       isWrite: true,
@@ -3768,6 +3812,8 @@ function registerFuturesAlgoTools() {
     },
     {
       name: "futures_cancel_algo_orders",
+      title: "Futures Cancel Algo Orders",
+      idempotentHint: true,
       module: "futures",
       description: "Cancel one or more pending FUTURES delivery algo orders (TP/SL). Accepts a list of {algoId, instId} objects.",
       isWrite: true,
@@ -3805,6 +3851,7 @@ function registerFuturesAlgoTools() {
     },
     {
       name: "futures_get_algo_orders",
+      title: "Futures Get Algo Orders",
       module: "futures",
       description: "Query pending or completed FUTURES delivery algo orders (TP/SL, OCO, trailing stop).",
       isWrite: false,
@@ -3926,6 +3973,7 @@ function registerAuditTools() {
     {
       name: "trade_get_history",
       module: "account",
+      title: "Get Tool-Call Audit Log",
       description: "Query local audit log of tool calls made through this MCP server. Returns recent operations with timestamps, duration, params, and results. Use to review what trades or queries were executed in this session or past sessions.",
       isWrite: false,
       inputSchema: {
@@ -4023,13 +4071,15 @@ async function downloadSkillZip(client, name, targetDir, format = "zip") {
   const filePath = safeWriteFile(targetDir, fileName, result.data);
   return filePath;
 }
+var ED25519_SPKI_HEADER = Buffer.from("302a300506032b6570032100", "hex");
 var DEFAULT_MAX_TOTAL_BYTES = 100 * 1024 * 1024;
-var DEFAULT_REGISTRY_PATH = join6(homedir4(), ".okx", "skills", "registry.json");
+var DEFAULT_REGISTRY_PATH = join8(homedir4(), ".okx", "skills", "registry.json");
 function registerSkillsTools() {
   return [
     {
       name: "skills_get_categories",
       module: "skills",
+      title: "Skills Marketplace List Categories",
       description: "List all available skill categories in OKX Skills Marketplace. Use the returned categoryId as input to skills_search for category filtering. Do NOT use for searching or downloading skills - use skills_search or skills_download.",
       inputSchema: {
         type: "object",
@@ -4042,6 +4092,7 @@ function registerSkillsTools() {
     {
       name: "skills_search",
       module: "skills",
+      title: "Skills Marketplace Search",
       description: "Search for skills in OKX Skills Marketplace by keyword or category. To get valid category IDs, call skills_get_categories first. Returns skill names for use with skills_download. Do NOT use for downloading - use skills_download.",
       inputSchema: {
         type: "object",
@@ -4071,6 +4122,7 @@ function registerSkillsTools() {
     {
       name: "skills_download",
       module: "skills",
+      title: "Skills Marketplace Download",
       description: "Download a skill package from OKX Skills Marketplace to a local directory. Always call skills_search first to confirm the skill name exists. Downloads the latest approved version. NOTE: Downloads third-party developer content - does NOT install to agents. For full installation use CLI: okx skill add <name>. Use when the user wants to inspect or manually install a skill package.",
       inputSchema: {
         type: "object",
@@ -4093,6 +4145,8 @@ function registerSkillsTools() {
         additionalProperties: false
       },
       isWrite: true,
+      destructiveHint: false,
+      idempotentHint: true,
       handler: handleDownload
     }
   ];
@@ -4156,6 +4210,7 @@ function registerGridTools() {
   return [
     {
       name: "grid_get_orders",
+      title: "Grid Bot List Orders",
       module: "bot.grid",
       description: "List grid bots. status='active' for running; 'history' for stopped.",
       isWrite: false,
@@ -4202,6 +4257,7 @@ function registerGridTools() {
     },
     {
       name: "grid_get_order_details",
+      title: "Grid Bot Get Detail",
       module: "bot.grid",
       description: "Get grid bot detail by algo ID. Returns config, status, PnL, and position.",
       isWrite: false,
@@ -4232,6 +4288,7 @@ function registerGridTools() {
     },
     {
       name: "grid_get_sub_orders",
+      title: "Grid Bot Get Sub-Orders",
       module: "bot.grid",
       description: "Query sub-orders (grid trades) of a bot. type='filled' for executed; 'live' for pending.",
       isWrite: false,
@@ -4276,9 +4333,11 @@ function registerGridTools() {
     },
     {
       name: "grid_create_order",
+      title: "Grid Bot Create",
       module: "bot.grid",
       description: "Create grid bot (spot, USDT-margined, or coin-margined contract). [CAUTION] Locks funds. Spot: quoteSz|baseSz. Contract: direction+lever+sz.",
       isWrite: true,
+      destructiveHint: false,
       inputSchema: {
         type: "object",
         properties: {
@@ -4351,7 +4410,9 @@ function registerGridTools() {
     },
     {
       name: "grid_amend_order",
+      title: "Grid Bot Amend",
       module: "bot.grid",
+      idempotentHint: true,
       description: "Amend a running grid bot. [CAUTION] Modifies a running bot. Use grid_list_orders to confirm the bot is running and obtain the algoId before calling.\nSupports two modes, which can be combined in a single call:\n\u2022 Price-range mode (maxPx+minPx+gridNum): change upper/lower price boundary and grid count. Contract grid: if new range requires more margin, pass topUpAmt; omit to auto-use the minimum required. Spot grid: topUpAmt is not supported.\n\u2022 TP/SL mode (instId + any of tpTriggerPx/slTriggerPx/tpRatio/slRatio): update take-profit and/or stop-loss. Pass '-1' to explicitly clear an existing TP or SL. tpTriggerPx/slTriggerPx are absolute prices; tpRatio/slRatio are profit ratios (e.g. '0.1' = 10%).\nWhen both sets of params are provided, both APIs are called sequentially.\nDo NOT use to create a new grid bot - use grid_create_order instead. Do NOT use to stop a grid bot - use grid_stop_order instead.",
       isWrite: true,
       inputSchema: {
@@ -4474,7 +4535,9 @@ function registerGridTools() {
     },
     {
       name: "grid_stop_order",
+      title: "Grid Bot Stop",
       module: "bot.grid",
+      idempotentHint: true,
       description: "[CAUTION] Stop a grid bot or close its remaining open position \u2014 real trades, irreversible. Workflow: (1) If the user has not specified which bot to stop, call grid_get_orders first and ask the user to confirm which bot before proceeding. (2) Call grid_get_order_details to check the current 'state' field. (3) If state='running' \u2192 call this tool: stopType='1' (default, clean exit) \u2014 spot grid sells all base assets back to quote; contract grid market-closes all positions. stopType='2' (keep assets) \u2014 spot grid keeps base assets as-is; contract grid cancels grid orders but leaves the position open. (4) If state='no_close_position' \u2192 call this tool with stopType='1' to close the remaining open position.",
       isWrite: true,
       inputSchema: {
@@ -4574,9 +4637,11 @@ function registerDcaTools() {
   return [
     {
       name: "dca_create_order",
+      title: "Martingale Bot Create",
       module: "bot.dca",
       description: "Create a DCA (Martingale) bot. [CAUTION] Real trades. contract_dca requires lever; spot_dca must be long. If maxSafetyOrds>0: need safetyOrdAmt, pxSteps.",
       isWrite: true,
+      destructiveHint: false,
       inputSchema: {
         type: "object",
         properties: {
@@ -4652,7 +4717,9 @@ function registerDcaTools() {
     },
     {
       name: "dca_stop_order",
+      title: "Martingale Bot Stop",
       module: "bot.dca",
+      idempotentHint: true,
       description: "[CAUTION] Stop a DCA bot or close its remaining open position \u2014 real trades, irreversible. Workflow: (1) If the user has not specified which bot to stop, call dca_get_orders first and ask the user to confirm which bot before proceeding. (2) Call dca_get_order_details to check the current 'state' field. (3) If state='running' \u2192 call this tool. (4) If state='no_close_position' \u2192 call this tool with stopType='1' to close the remaining open position. spot_dca requires stopType: 1=sell all tokens, 2=keep tokens.",
       isWrite: true,
       inputSchema: {
@@ -4685,6 +4752,7 @@ function registerDcaTools() {
     },
     {
       name: "dca_get_orders",
+      title: "Martingale Bot List Orders",
       module: "bot.dca",
       description: "List DCA bots. Default: active (running). Use status=history for stopped.",
       isWrite: false,
@@ -4723,6 +4791,7 @@ function registerDcaTools() {
     },
     {
       name: "dca_get_order_details",
+      title: "Martingale Bot Get Detail",
       module: "bot.dca",
       description: "Get DCA bot position details (avgPx, upl, liqPx, etc).",
       isWrite: false,
@@ -4748,6 +4817,7 @@ function registerDcaTools() {
     },
     {
       name: "dca_get_sub_orders",
+      title: "Martingale Bot Get Sub-Orders",
       module: "bot.dca",
       description: "Get DCA cycles or orders in a cycle. Omit cycleId=cycle list; with cycleId=orders.",
       isWrite: false,
@@ -4807,8 +4877,9 @@ function registerEarnTools() {
   return [
     {
       name: "earn_get_savings_balance",
+      title: "Get Simple Earn Balance",
       module: "earn.savings",
-      description: "Get Simple Earn (savings/flexible earn) balance. Returns current holdings for all currencies or a specific one. To show market rates alongside balance (\u5E02\u573A\u5747\u5229\u7387), call earn_get_lending_rate_history. earn_get_lending_rate_history also returns fixed-term (\u5B9A\u671F) product offers, so one call gives a complete view of both flexible and fixed options. Do NOT use for fixed-term (\u5B9A\u671F) order queries - use earn_get_fixed_order_list instead.",
+      description: "Get Simple Earn (savings/flexible earn) balance. Returns current holdings for all currencies or a specific one. To show market rates alongside balance, call earn_get_lending_rate_history. To browse available fixed-term products with quota info, use earn_get_fixed_earn_products. Do NOT use for fixed-term order queries \u2014 use earn_get_fixed_order_list instead.",
       isWrite: false,
       inputSchema: {
         type: "object",
@@ -4831,6 +4902,7 @@ function registerEarnTools() {
     },
     {
       name: "earn_get_fixed_order_list",
+      title: "Get Fixed-Term Earn Orders",
       module: "earn.savings",
       description: "Get Simple Earn Fixed (\u5B9A\u671F\u8D5A\u5E01) lending order list. Returns orders sorted by creation time descending. Use this to check status of fixed-term lending orders (pending/earning/expired/settled/cancelled). Do NOT use for flexible earn balance - use earn_get_savings_balance instead. If the result is empty, do NOT display any fixed-term section in the output.",
       isWrite: false,
@@ -4868,9 +4940,11 @@ function registerEarnTools() {
     },
     {
       name: "earn_savings_purchase",
+      title: "Subscribe Simple Earn",
       module: "earn.savings",
       description: "Purchase Simple Earn (savings/flexible earn). [CAUTION] Moves real funds into earn product.",
       isWrite: true,
+      destructiveHint: false,
       inputSchema: {
         type: "object",
         properties: {
@@ -4906,9 +4980,11 @@ function registerEarnTools() {
     },
     {
       name: "earn_savings_redeem",
+      title: "Redeem Simple Earn",
       module: "earn.savings",
       description: "Redeem Simple Earn (savings/flexible earn). [CAUTION] Withdraws funds from earn product.",
       isWrite: true,
+      destructiveHint: false,
       inputSchema: {
         type: "object",
         properties: {
@@ -4939,9 +5015,11 @@ function registerEarnTools() {
     },
     {
       name: "earn_set_lending_rate",
+      title: "Set Lending Rate",
       module: "earn.savings",
       description: "Set lending rate for Simple Earn. [CAUTION] Changes your lending rate preference.",
       isWrite: true,
+      idempotentHint: true,
       inputSchema: {
         type: "object",
         properties: {
@@ -4971,6 +5049,7 @@ function registerEarnTools() {
     },
     {
       name: "earn_get_lending_history",
+      title: "Get Lending History",
       module: "earn.savings",
       description: "Get personal lending records for Simple Earn (your own lending history). NOT for market rate queries. Returns your lending records with amount, rate, and earnings data.",
       isWrite: false,
@@ -5012,9 +5091,11 @@ function registerEarnTools() {
     },
     {
       name: "earn_fixed_purchase",
+      title: "Subscribe Fixed-Term Earn",
       module: "earn.savings",
-      description: "Purchase Simple Earn Fixed (\u5B9A\u671F) product, two-step flow. First call (confirm omitted or false): returns purchase preview with product details and risk warning. Preview offer fields: lendQuota = remaining quota (\u5269\u4F59\u989D\u5EA6), soldOut = whether product is sold out (lendQuota is 0). YOU MUST display the 'warning' field from the preview response to the user VERBATIM before asking for confirmation - do NOT omit or summarize it. Second call (confirm=true): executes the purchase. Only proceed after the user explicitly confirms. IMPORTANT: Orders in 'pending' (\u5339\u914D\u4E2D) state can still be cancelled via earn_fixed_redeem; once the status changes to 'earning' (\u8D5A\u5E01\u4E2D), funds are LOCKED until maturity - no early redemption allowed.",
+      description: "Purchase Simple Earn Fixed (\u5B9A\u671F) product, two-step flow. First call (confirm omitted or false): returns purchase preview with product details and risk warning. Preview offer fields: lendQuota = remaining quota, soldOut = whether product is sold out (lendQuota is 0). YOU MUST display the 'warning' field from the preview response to the user VERBATIM before asking for confirmation \u2014 do NOT omit or summarize it. Second call (confirm=true): executes the purchase. Only proceed after the user explicitly confirms. IMPORTANT: Orders in 'pending' (\u5339\u914D\u4E2D) state can still be cancelled via earn_fixed_redeem; once the status changes to 'earning' (\u8D5A\u5E01\u4E2D), funds are LOCKED until maturity - no early redemption allowed.",
       isWrite: true,
+      destructiveHint: false,
       inputSchema: {
         type: "object",
         properties: {
@@ -5086,9 +5167,11 @@ function registerEarnTools() {
     },
     {
       name: "earn_fixed_redeem",
+      title: "Redeem Fixed-Term Earn",
       module: "earn.savings",
       description: "Redeem Simple Earn Fixed (\u5B9A\u671F\u8D5A\u5E01) order. [CAUTION] Redeems a fixed-term lending order. Always redeems the full order amount. Only orders in 'pending' (\u5339\u914D\u4E2D) state can be redeemed - orders in 'earning' state are locked until maturity and cannot be redeemed early. Do NOT use for flexible earn redemption - use earn_savings_redeem instead.",
       isWrite: true,
+      destructiveHint: false,
       inputSchema: {
         type: "object",
         properties: {
@@ -5114,8 +5197,9 @@ function registerEarnTools() {
     },
     {
       name: "earn_get_lending_rate_history",
+      title: "Get Lending Rates & Offers",
       module: "earn.savings",
-      description: "Query Simple Earn lending rates and fixed-term offers. Use this tool when the user asks about Simple Earn products, current or historical lending rates, or when displaying savings balance with market rate context (\u5E02\u573A\u5747\u5229\u7387). Returns lending rate history (lendingRate field, newest-first) AND available fixed-term (\u5B9A\u671F) offers with APR, term, min amount, and quota - one call gives a complete view of both flexible and fixed options. In fixedOffers: lendQuota = remaining quota (\u5269\u4F59\u989D\u5EA6), soldOut = whether product is sold out (lendQuota is 0). To get current flexible APY: use limit=1 and read lendingRate.",
+      description: "Query Simple Earn lending rates and fixed-term offers. Use this tool when the user asks about Simple Earn products, current or historical lending rates, or when displaying savings balance with market rate context (\u5E02\u573A\u5747\u5229\u7387). Returns lending rate history (lendingRate field, newest-first) AND available fixed-term (\u5B9A\u671F) offers with APR, term, min amount, and quota \u2014 one call gives a complete view of both flexible and fixed options. In fixedOffers: lendQuota = remaining quota, soldOut = whether product is sold out (lendQuota is 0). For dedicated fixed-term product queries, use earn_get_fixed_earn_products. To get current flexible APY: use limit=1 and read lendingRate.",
       isWrite: false,
       inputSchema: {
         type: "object",
@@ -5174,6 +5258,37 @@ function registerEarnTools() {
           fixedOffers
         };
       }
+    },
+    {
+      name: "earn_get_fixed_earn_products",
+      title: "Get Fixed-Term Earn Products",
+      module: "earn.savings",
+      description: "Query available Simple Earn Fixed-term products. Returns fixed-term offers with APR, term, min investment, and remaining quota. Use to check available products and quota before purchasing. Do NOT use for querying your own orders \u2014 use earn_get_fixed_order_list instead. Do NOT use just for current flexible APY -- use earn_get_lending_rate_history with limit=1 instead.",
+      isWrite: false,
+      inputSchema: {
+        type: "object",
+        properties: {
+          ccy: {
+            type: "string",
+            description: "e.g. USDT. Omit for all currencies."
+          }
+        }
+      },
+      handler: async (rawArgs, context) => {
+        const args = asRecord(rawArgs);
+        const response = await context.client.privateGet(
+          "/api/v5/finance/simple-earn-fixed/offers",
+          compactObject({ ccy: readString(args, "ccy") }),
+          privateRateLimit("earn_get_fixed_earn_products", 2)
+        );
+        const result = normalizeResponse(response);
+        const allOffers = Array.isArray(result["data"]) ? result["data"] : [];
+        result["data"] = allOffers.map(({ borrowingOrderQuota: _, ...rest }) => ({
+          ...rest,
+          soldOut: rest["lendQuota"] === "0"
+        }));
+        return result;
+      }
     }
   ];
 }
@@ -5184,6 +5299,7 @@ function registerOnchainEarnTools() {
     // -------------------------------------------------------------------------
     {
       name: "onchain_earn_get_offers",
+      title: "On-chain Earn List Offers",
       module: "earn.onchain",
       description: "List staking/DeFi products with APY, terms, and limits. Always show protocol name (protocol field) and earnings currency (earningData[].ccy) when presenting results.",
       isWrite: false,
@@ -5223,9 +5339,11 @@ function registerOnchainEarnTools() {
     // -------------------------------------------------------------------------
     {
       name: "onchain_earn_purchase",
+      title: "On-chain Earn Subscribe",
       module: "earn.onchain",
       description: "Invest in a staking/DeFi product. [CAUTION] Moves real funds.",
       isWrite: true,
+      destructiveHint: false,
       inputSchema: {
         type: "object",
         properties: {
@@ -5276,9 +5394,11 @@ function registerOnchainEarnTools() {
     // -------------------------------------------------------------------------
     {
       name: "onchain_earn_redeem",
+      title: "On-chain Earn Redeem",
       module: "earn.onchain",
       description: "Redeem a staking/DeFi investment. [CAUTION] Some products have lock periods, early redemption may incur penalties.",
       isWrite: true,
+      destructiveHint: false,
       inputSchema: {
         type: "object",
         properties: {
@@ -5316,9 +5436,11 @@ function registerOnchainEarnTools() {
     // -------------------------------------------------------------------------
     {
       name: "onchain_earn_cancel",
+      title: "On-chain Earn Cancel Order",
       module: "earn.onchain",
       description: "Cancel a pending staking/DeFi purchase order. [CAUTION]",
       isWrite: true,
+      idempotentHint: true,
       inputSchema: {
         type: "object",
         properties: {
@@ -5351,6 +5473,7 @@ function registerOnchainEarnTools() {
     // -------------------------------------------------------------------------
     {
       name: "onchain_earn_get_active_orders",
+      title: "On-chain Earn Active Orders",
       module: "earn.onchain",
       description: "List current active staking/DeFi investments.",
       isWrite: false,
@@ -5395,6 +5518,7 @@ function registerOnchainEarnTools() {
     // -------------------------------------------------------------------------
     {
       name: "onchain_earn_get_order_history",
+      title: "On-chain Earn Order History",
       module: "earn.onchain",
       description: "List past staking/DeFi orders including redeemed ones.",
       isWrite: false,
@@ -5493,6 +5617,7 @@ function registerDcdTools() {
   return [
     {
       name: "dcd_get_currency_pairs",
+      title: "Dual Investment List Currency Pairs",
       module: "earn.dcd",
       description: "Get available DCD currency pairs.",
       isWrite: false,
@@ -5510,6 +5635,7 @@ function registerDcdTools() {
     },
     {
       name: "dcd_get_products",
+      title: "Dual Investment List Products",
       module: "earn.dcd",
       description: "Get DCD products with yield and quota info. Yields in response are decimal fractions, not percentages.",
       isWrite: false,
@@ -5540,6 +5666,7 @@ function registerDcdTools() {
     },
     {
       name: "dcd_get_order_state",
+      title: "Dual Investment Get Order State",
       module: "earn.dcd",
       description: "Check DCD order state after subscription (returns ordId + state only). For full order details (productId, strike, yield, settlement info), use dcd_get_orders instead.",
       isWrite: false,
@@ -5564,6 +5691,7 @@ function registerDcdTools() {
     },
     {
       name: "dcd_get_orders",
+      title: "Dual Investment Get Order History",
       module: "earn.dcd",
       description: "Get DCD order history. Yields in response are decimal fractions, not percentages.",
       isWrite: false,
@@ -5608,9 +5736,11 @@ function registerDcdTools() {
     },
     {
       name: "dcd_subscribe",
+      title: "Dual Investment Subscribe",
       module: "earn.dcd",
       description: "Subscribe to a DCD product: get quote and execute atomically. Confirm product, amount, and currency with user before calling. Optional minAnnualizedYield rejects the order if quote yield falls below threshold. Returns order result with quote snapshot (minAnnualizedYield is in percent; response yields are decimal fractions).",
       isWrite: true,
+      destructiveHint: false,
       inputSchema: {
         type: "object",
         properties: {
@@ -5693,9 +5823,11 @@ function registerDcdTools() {
     },
     {
       name: "dcd_redeem",
+      title: "Dual Investment Redeem",
       module: "earn.dcd",
       description: "Early redemption of a DCD order, two-step flow. First call (no quoteId): returns redemption quote for user confirmation. Second call (with quoteId): executes redemption. If the quote expired, auto-refreshes and executes; response includes autoRefreshedQuote: true.",
       isWrite: true,
+      destructiveHint: false,
       inputSchema: {
         type: "object",
         properties: {
@@ -5770,9 +5902,11 @@ function registerAutoEarnTools() {
   return [
     {
       name: "earn_auto_set",
+      title: "Set Auto-Earn Configuration",
       module: "earn.autoearn",
       description: "Enable or disable auto-earn for a currency. earnType='0' for auto-lend+stake (most currencies); earnType='1' for USDG earn (USDG, BUIDL). Use account_get_balance first: if autoLendStatus or autoStakingStatus != 'unsupported', use earnType='0'; for USDG/BUIDL use earnType='1'. [CAUTION] Cannot disable within 24h of enabling.",
       isWrite: true,
+      idempotentHint: true,
       inputSchema: {
         type: "object",
         properties: {
@@ -5822,6 +5956,7 @@ function registerFlashEarnTools() {
   return [
     {
       name: "earn_get_flash_earn_projects",
+      title: "Flash Earn List Projects",
       module: "earn.flash",
       description: "Get Flash Earn projects. Use this to browse upcoming or in-progress Flash Earn opportunities. Do NOT use for purchase or redeem actions - Flash Earn is query-only in this module.",
       isWrite: false,
@@ -6244,6 +6379,7 @@ function registerEventContractTools() {
     // -----------------------------------------------------------------------
     {
       name: "event_browse",
+      title: "Event Contracts Browse Active",
       module: "event",
       description: "Browse currently active (in-progress) event contracts. Call when user asks what event contracts are available to trade. Returns only in-progress contracts (floorStrike set). If a live quote field px is present, it is the event contract price (0.01-0.99), not the underlying asset price; it reflects the market-implied probability when actively trading. Grouped by settlement type and underlying. Do NOT use for querying contracts within a specific series - use event_get_markets with seriesId instead.",
       isWrite: false,
@@ -6284,6 +6420,7 @@ function registerEventContractTools() {
     },
     {
       name: "event_get_series",
+      title: "Event Contracts List Series",
       module: "event",
       description: "List event contract series. Returns all available series with settlement type and underlying. Use event_browse to see currently active contracts.",
       isWrite: false,
@@ -6308,6 +6445,7 @@ function registerEventContractTools() {
     },
     {
       name: "event_get_events",
+      title: "Event Contracts List Events",
       module: "event",
       description: "List expiry periods within a series. state: preopen|live|settling|expired. expTime is pre-formatted UTC+8.",
       isWrite: false,
@@ -6363,6 +6501,7 @@ function registerEventContractTools() {
     },
     {
       name: "event_get_markets",
+      title: "Event Contracts List Markets",
       module: "event",
       description: "List tradeable contracts within a series. state=live for active contracts, state=expired for settlement results. floorStrike=strike price; px (when present) is the event contract price (0.01-0.99), not the underlying asset price - reflects the market-implied probability when actively trading; outcome pre-translated (pending/YES/NO/UP/DOWN); timestamps UTC+8. Do NOT use for discovering what series are available across all underlyings - use event_browse instead.",
       isWrite: false,
@@ -6444,6 +6583,7 @@ function registerEventContractTools() {
     },
     {
       name: "event_get_orders",
+      title: "Event Contracts Get Orders",
       module: "event",
       description: "Query event contract orders (open, 7d history, or 3-month archive). outcome pre-translated (YES/NO/UP/DOWN). Do NOT use for trade executions - use event_get_fills for fill records and settlement outcomes.",
       isWrite: false,
@@ -6502,6 +6642,7 @@ function registerEventContractTools() {
     },
     {
       name: "event_get_fills",
+      title: "Event Contracts Get Fills",
       module: "event",
       description: "Get event contract fill history (trade executions and settlement payouts). archive=true for up to 3mo, false (default) for last 3d. outcome pre-translated (YES/NO/UP/DOWN). Each record includes a 'type' field: 'fill' (opening trade) or 'settlement' (expiry payout with settlementResult win/loss and pnl). Do NOT use for order status - use event_get_orders instead.",
       isWrite: false,
@@ -6549,6 +6690,8 @@ function registerEventContractTools() {
     // -----------------------------------------------------------------------
     {
       name: "event_place_order",
+      title: "Event Contracts Place Order",
+      destructiveHint: false,
       module: "event",
       description: `Place an event contract order. [CAUTION] Places a real order. Before placing, call event_get_markets(seriesId, state=live) to obtain the instId of the target contract.
 - outcome: UP/YES (bet price goes up/condition met) or DOWN/NO (bet price goes down/condition not met)
@@ -6624,6 +6767,8 @@ function registerEventContractTools() {
     },
     {
       name: "event_amend_order",
+      title: "Event Contracts Amend Order",
+      idempotentHint: true,
       module: "event",
       description: "Amend a pending event contract order (change price or size). [CAUTION] Modifies a real order. Before amending, call event_get_orders(status=open) to obtain the ordId and confirm the order is still pending. Only limit/post_only orders can be amended.",
       isWrite: true,
@@ -6655,6 +6800,8 @@ function registerEventContractTools() {
     },
     {
       name: "event_cancel_order",
+      title: "Event Contracts Cancel Order",
+      idempotentHint: true,
       module: "event",
       description: "Cancel a pending event contract order. [CAUTION] Cancels a real order. Before cancelling, call event_get_orders(status=open) to obtain the ordId and confirm the order is still pending. instId must be the full event contract instrument ID (e.g. BTC-ABOVE-DAILY-260224-1600-69700), NOT a spot trading pair.",
       isWrite: true,
@@ -7063,6 +7210,7 @@ function registerSmartmoneyTools() {
     /* ---------- T1. Top traders (leaderboard rank) ---------- */
     {
       name: "smartmoney_get_traders_by_filter",
+      title: "Smart Money Leaderboard",
       module: "smartmoney",
       description: "Leaderboard ranking of OKX smart-money traders, filtered by pool conditions and ranked by `sortBy`. Use when: discovering top performers by criteria (PnL / win-rate / drawdown / AUM). See also: `smartmoney_get_performance_by_trader` (lookup by ID), `smartmoney_search_trader` (lookup by nickname). Note: `updateTime` is 12-digit `yyyyMMddHHmm` UTC+8, different from signal tools' 10-digit UTC `asOfTime`/`dataVersion` - do not cross-pass.",
       isWrite: false,
@@ -7129,6 +7277,7 @@ function registerSmartmoneyTools() {
     /* ---------- T2. Trader performance (by authorIds) ---------- */
     {
       name: "smartmoney_get_performance_by_trader",
+      title: "Smart Money Trader Performance",
       module: "smartmoney",
       description: "PnL / win-rate / drawdown profile for one or more traders looked up by `authorIds`. Use when: caller already has trader IDs and needs their performance metrics. See also: `smartmoney_search_trader` (resolve nickname -> authorId), `smartmoney_get_traders_by_filter` (criteria-based discovery). Note: response `updateTime` is 12-digit `yyyyMMddHHmm` UTC+8 - do not pass to signal-side tools' `asOfTime` (10-digit UTC).",
       isWrite: false,
@@ -7199,6 +7348,7 @@ function registerSmartmoneyTools() {
     /* ---------- T3. Trader current positions ---------- */
     {
       name: "smartmoney_get_trader_positions",
+      title: "Smart Money Trader Current Positions",
       module: "smartmoney",
       description: "Currently-open positions held by a single trader (direction, size, leverage, entry, conviction). Use when: inspecting what a top trader is holding RIGHT NOW. See also: `smartmoney_get_trader_positions_history` (closed positions), `smartmoney_search_trader` (nickname -> authorId), `smartmoney_get_traders_by_filter` (discover trader).",
       isWrite: false,
@@ -7280,6 +7430,7 @@ function registerSmartmoneyTools() {
     /* ---------- T4. Trader closed-position history ---------- */
     {
       name: "smartmoney_get_trader_positions_history",
+      title: "Smart Money Trader Position History",
       module: "smartmoney",
       description: "Closed-position history of a single trader, paginated by `posId` cursor. Use when: studying realized PnL pattern, holding duration, win/loss streaks, or how positions ended (closed vs liquidated). See also: `smartmoney_get_trader_positions` (currently-open), `smartmoney_search_trader` (nickname -> authorId), `smartmoney_get_traders_by_filter` (discover trader).",
       isWrite: false,
@@ -7417,6 +7568,7 @@ function registerSmartmoneyTools() {
     /* ---------- T5. Trader order history ---------- */
     {
       name: "smartmoney_get_trader_orders_history",
+      title: "Smart Money Trader Order History",
       module: "smartmoney",
       description: "Recent orders/fills placed by a single trader (direction, size, price, leverage), paginated by `ordId` cursor. Aligned with the cross-module `*_get_orders` family. Use when: tracking a top trader's latest trade activity. See also: `smartmoney_search_trader` (nickname -> authorId), `smartmoney_get_traders_by_filter` (discover trader).",
       isWrite: false,
@@ -7535,6 +7687,7 @@ function registerSmartmoneyTools() {
     /* ---------- T6. Search top traders by nickname keyword ---------- */
     {
       name: "smartmoney_search_trader",
+      title: "Search Smart Money Top Traders",
       module: "smartmoney",
       description: "Search Top Traders by nickname keyword, ranked by OKX-platform follower count DESC. Returns up to 10 matches; intersects KOL full-text recall with the Top Trader set. Use when: resolving a nickname or partial name to `authorId`(s) before calling other `smartmoney_get_trader_*` tools. See also: `smartmoney_get_traders_by_filter` (discover top performers by criteria), `smartmoney_get_performance_by_trader` (lookup by known authorId).",
       isWrite: false,
@@ -7585,6 +7738,7 @@ function registerSmartmoneyTools() {
     /* ---------- S1. Signal overview by filter (multi-asset, tier-filtered pool) ---------- */
     {
       name: "smartmoney_get_signal_overview_by_filter",
+      title: "Smart Money Consensus Signals by Filter",
       module: "smartmoney",
       description: "Multi-asset smart-money consensus signals (long/short ratio, weighted entry, capital flow, deltas vs 1h/24h/7d), aggregated over a tier-filtered trader pool (PnL / win-rate / drawdown / AUM). Pick instruments via `topInstruments` OR `instCcyList` - exactly one. Snapshot time auto-resolved to current hour. **Linear (USDT/USDS-margined) contracts only - coin-margined (`-USD-SWAP` / `-USD-DELIVERY`) positions are excluded by upstream and silently omitted from the aggregation.** Use when: latest cross-asset consensus from a criteria-defined pool. See also: `smartmoney_get_signal_overview_by_trader` (restrict pool to specific traders), `smartmoney_get_signal_trend_by_filter` (time-series instead of latest snapshot).",
       isWrite: false,
@@ -7645,6 +7799,7 @@ function registerSmartmoneyTools() {
     /* ---------- S2. Signal overview by trader (multi-asset, authorIds-restricted) ---------- */
     {
       name: "smartmoney_get_signal_overview_by_trader",
+      title: "Smart Money Consensus Signals by Trader",
       module: "smartmoney",
       description: "Multi-asset smart-money signals aggregated over a hand-picked set of traders (`authorIds`). Pick instruments via `topInstruments` OR `instCcyList`. Capability tier filters (pnlTier / winRateTier / etc.) not exposed - backend uses defaults for direct-lookup scenarios. **Linear (USDT/USDS-margined) contracts only - a trader's coin-margined (`-USD-SWAP` / `-USD-DELIVERY`) positions are silently excluded from the aggregation, even when those positions are large.** Use `smartmoney_get_trader_positions` if the full position book is needed. Use when: caller already knows which traders to follow and wants their cross-asset consensus at the latest hour. See also: `smartmoney_get_signal_overview_by_filter` (criteria-defined pool), `smartmoney_get_signal_trend_by_trader` (time-series), `smartmoney_get_traders_by_filter` / `smartmoney_search_trader` (discover authorIds).",
       isWrite: false,
@@ -7727,6 +7882,7 @@ function registerSmartmoneyTools() {
     /* ---------- S3. Signal trend by filter (single-asset, tier-filtered pool, asOfTime anchor) ---------- */
     {
       name: "smartmoney_get_signal_trend_by_filter",
+      title: "Smart Money Signal Trend by Filter",
       module: "smartmoney",
       description: "Time-series of single-asset smart-money signal across hourly/daily buckets, aggregated over a tier-filtered trader pool. Returns the latest `limit` buckets ending at `asOfTime` (defaults to current UTC hour). **Linear (USDT/USDS-margined) contracts only - coin-margined (`-USD-SWAP` / `-USD-DELIVERY`) positions are excluded by upstream and silently omitted.** Use when: tracking how long/short conviction and capital evolve over time (smart money adding exposure or retreating). See also: `smartmoney_get_signal_overview_by_filter` (latest snapshot only), `smartmoney_get_signal_trend_by_trader` (restrict to specific traders). Note: `asOfTime` is 10-digit `yyyyMMddHH` UTC, different from leaderboard tools' 12-digit UTC+8 `updateTime` - do not cross-pass.",
       isWrite: false,
@@ -7799,6 +7955,7 @@ function registerSmartmoneyTools() {
     /* ---------- S4. Signal trend by trader (single-asset, authorIds-restricted) ---------- */
     {
       name: "smartmoney_get_signal_trend_by_trader",
+      title: "Smart Money Signal Trend by Trader",
       module: "smartmoney",
       description: "Time-series of single-asset smart-money signal aggregated over a hand-picked set of traders (`authorIds`). Returns the latest `limit` buckets ending at `asOfTime` (defaults to current UTC hour). Capability tier filters (pnlTier / winRateTier / etc.) not exposed - backend uses defaults for direct-lookup scenarios. **Linear (USDT/USDS-margined) contracts only - a trader's coin-margined (`-USD-SWAP` / `-USD-DELIVERY`) positions on the requested base ccy are silently excluded from each bucket.** Use `smartmoney_get_trader_positions` to inspect the full position book. Use when: tracking how a specific group of traders has evolved their long/short consensus over time on one coin. See also: `smartmoney_get_signal_trend_by_filter` (criteria-defined pool), `smartmoney_get_signal_overview_by_trader` (latest snapshot only), `smartmoney_get_traders_by_filter` / `smartmoney_search_trader` (discover authorIds). Note: `asOfTime` is 10-digit `yyyyMMddHH` UTC, different from leaderboard tools' 12-digit UTC+8 `updateTime` - do not cross-pass.",
       isWrite: false,
@@ -7893,7 +8050,7 @@ function registerSmartmoneyTools() {
   return tools;
 }
 function buildContractTradeTools(cfg) {
-  const { prefix, module, label, instTypes, instIdExample } = cfg;
+  const { prefix, module, label, instTypes, instIdExample, titleLabel } = cfg;
   const [defaultType, otherType] = instTypes;
   const instTypeDesc = `${defaultType} (default) or ${otherType}`;
   const n = (suffix) => `${prefix}_${suffix}`;
@@ -7901,6 +8058,8 @@ function buildContractTradeTools(cfg) {
     // ── place_order ──────────────────────────────────────────────────────────
     {
       name: n("place_order"),
+      title: `${titleLabel} Place Order`,
+      destructiveHint: false,
       module,
       description: `Place ${label} order. Attach TP/SL via tpTriggerPx/slTriggerPx. Before placing, use market_get_instruments to get ctVal (contract face value) - do NOT assume contract sizes. [CAUTION] Executes real trades.`,
       isWrite: true,
@@ -7997,6 +8156,8 @@ function buildContractTradeTools(cfg) {
     // ── cancel_order ─────────────────────────────────────────────────────────
     {
       name: n("cancel_order"),
+      title: `${titleLabel} Cancel Order`,
+      idempotentHint: true,
       module,
       description: `Cancel an unfilled ${label} order.`,
       isWrite: true,
@@ -8026,6 +8187,7 @@ function buildContractTradeTools(cfg) {
     // ── get_order ─────────────────────────────────────────────────────────────
     {
       name: n("get_order"),
+      title: `${titleLabel} Get Order`,
       module,
       description: `Get details of a single ${label} order by ordId or clOrdId.`,
       isWrite: false,
@@ -8055,6 +8217,7 @@ function buildContractTradeTools(cfg) {
     // ── get_orders ───────────────────────────────────────────────────────────
     {
       name: n("get_orders"),
+      title: `${titleLabel} Get Orders`,
       module,
       description: `Query ${label} open orders, history (last 7 days), or archive (up to 3 months).`,
       isWrite: false,
@@ -8113,6 +8276,7 @@ function buildContractTradeTools(cfg) {
     // ── get_positions ────────────────────────────────────────────────────────
     {
       name: n("get_positions"),
+      title: `${titleLabel} Get Positions`,
       module,
       description: `Get current ${label} positions.`,
       isWrite: false,
@@ -8147,6 +8311,7 @@ function buildContractTradeTools(cfg) {
     // ── get_fills ────────────────────────────────────────────────────────────
     {
       name: n("get_fills"),
+      title: `${titleLabel} Get Fills`,
       module,
       description: `Get ${label} fill details. archive=false (default): last 3 days; archive=true: up to 3 months.`,
       isWrite: false,
@@ -8197,6 +8362,8 @@ function buildContractTradeTools(cfg) {
     // ── close_position ───────────────────────────────────────────────────────
     {
       name: n("close_position"),
+      title: `${titleLabel} Close Position`,
+      idempotentHint: true,
       module,
       description: `[CAUTION] Close entire ${label} position at market.`,
       isWrite: true,
@@ -8239,6 +8406,8 @@ function buildContractTradeTools(cfg) {
     // ── set_leverage ─────────────────────────────────────────────────────────
     {
       name: n("set_leverage"),
+      title: `${titleLabel} Set Leverage`,
+      idempotentHint: true,
       module,
       description: `Set leverage for a ${label} instrument or position. [CAUTION] Changes risk parameters.
 Scenarios (SWAP/FUTURES only):
@@ -8301,6 +8470,7 @@ Not supported: PORTFOLIO MARGIN accounts cannot adjust cross leverage for SWAP/F
     // ── get_leverage ─────────────────────────────────────────────────────────
     {
       name: n("get_leverage"),
+      title: `${titleLabel} Get Leverage`,
       module,
       description: `Get current leverage for a ${label} instrument.`,
       isWrite: false,
@@ -8328,6 +8498,8 @@ Not supported: PORTFOLIO MARGIN accounts cannot adjust cross leverage for SWAP/F
     // ── batch_amend ──────────────────────────────────────────────────────────
     {
       name: n("batch_amend"),
+      title: `${titleLabel} Batch Amend Orders`,
+      idempotentHint: true,
       module,
       description: `[CAUTION] Batch amend up to 20 unfilled ${label} orders.`,
       isWrite: true,
@@ -8359,6 +8531,8 @@ Not supported: PORTFOLIO MARGIN accounts cannot adjust cross leverage for SWAP/F
     // ── batch_cancel ─────────────────────────────────────────────────────────
     {
       name: n("batch_cancel"),
+      title: `${titleLabel} Batch Cancel Orders`,
+      idempotentHint: true,
       module,
       description: `[CAUTION] Batch cancel up to 20 ${label} orders.`,
       isWrite: true,
@@ -8394,6 +8568,7 @@ function registerFuturesTools() {
     prefix: "futures",
     module: "futures",
     label: "FUTURES delivery",
+    titleLabel: "Futures",
     instTypes: ["FUTURES", "SWAP"],
     instIdExample: "e.g. BTC-USDT-240329"
   });
@@ -8403,6 +8578,8 @@ function registerFuturesTools() {
     // Unique to futures: amend a regular (non-algo) unfilled order.
     {
       name: "futures_amend_order",
+      title: "Futures Amend Order",
+      idempotentHint: true,
       module: "futures",
       description: "Amend an unfilled FUTURES delivery order (modify price and/or size). To modify attached TP/SL, use futures_amend_algo_order with the algoId from futures_get_algo_orders.",
       isWrite: true,
@@ -8437,6 +8614,8 @@ function registerFuturesTools() {
     // Unique to futures: batch place only (no cancel/amend action dispatch).
     {
       name: "futures_batch_orders",
+      title: "Futures Batch Place Orders",
+      destructiveHint: false,
       module: "futures",
       description: "[CAUTION] Batch place up to 20 FUTURES delivery orders.",
       isWrite: true,
@@ -8496,6 +8675,7 @@ function registerMarketTools() {
   return [
     {
       name: "market_get_ticker",
+      title: "Get Ticker",
       module: "market",
       description: "Get ticker data for a single instrument.",
       isWrite: false,
@@ -8523,6 +8703,7 @@ function registerMarketTools() {
     },
     {
       name: "market_get_tickers",
+      title: "Get All Tickers",
       module: "market",
       description: "Get ticker data for all instruments of a given type.",
       isWrite: false,
@@ -8562,6 +8743,7 @@ function registerMarketTools() {
     },
     {
       name: "market_get_orderbook",
+      title: "Get Order Book",
       module: "market",
       description: "Get the order book (bids/asks) for an instrument.",
       isWrite: false,
@@ -8596,6 +8778,7 @@ function registerMarketTools() {
     },
     {
       name: "market_get_candles",
+      title: "Get Candlesticks",
       module: "market",
       description: "Get candlestick (OHLCV) data for an instrument. Automatically retrieves historical data (back to 2021) when requesting older time ranges. Use the `after` parameter to paginate back in time (the old `history` parameter has been removed). IMPORTANT: Before fetching with `after`/`before`, estimate the number of candles: time_range_ms / bar_interval_ms. If the estimate exceeds ~500 candles, inform the user of the estimated count and ask for confirmation before proceeding.",
       isWrite: false,
@@ -8652,6 +8835,7 @@ function registerMarketTools() {
     },
     {
       name: "market_get_instruments",
+      title: "List Instruments",
       module: "market",
       description: "Get tradable instruments for a given type. Returns contract specs: min order size, lot size, tick size, contract value, settlement currency, listing/expiry time. Essential before placing orders.",
       isWrite: false,
@@ -8696,6 +8880,7 @@ function registerMarketTools() {
     },
     {
       name: "market_get_funding_rate",
+      title: "Get Funding Rate",
       module: "market",
       description: "Get funding rate for a perpetual SWAP instrument. IMPORTANT: instId must end with -SWAP (e.g. BTC-USDT-SWAP). Spot IDs like BTC-USDT are NOT valid. history=false (default): current rate + next estimated rate; history=true: historical rates.",
       isWrite: false,
@@ -8757,6 +8942,7 @@ function registerMarketTools() {
     },
     {
       name: "market_get_mark_price",
+      title: "Get Mark Price",
       module: "market",
       description: "Get mark price for SWAP, FUTURES, or MARGIN instruments. Used for liquidation calculations and unrealized PnL.",
       isWrite: false,
@@ -8800,6 +8986,7 @@ function registerMarketTools() {
     },
     {
       name: "market_get_trades",
+      title: "Get Recent Trades",
       module: "market",
       description: "Get recent trades for an instrument. Default 20 records, max 500.",
       isWrite: false,
@@ -8834,6 +9021,7 @@ function registerMarketTools() {
     },
     {
       name: "market_get_index_ticker",
+      title: "Get Index Ticker",
       module: "market",
       description: "Get index ticker data (e.g. BTC-USD, ETH-USD index prices). Independent of any single exchange.",
       isWrite: false,
@@ -8867,6 +9055,7 @@ function registerMarketTools() {
     },
     {
       name: "market_get_index_candles",
+      title: "Get Index Candlesticks",
       module: "market",
       description: "Get candlestick data for an index (e.g. BTC-USD index). history=false: recent up to 1440 bars; history=true: older data.",
       isWrite: false,
@@ -8923,6 +9112,7 @@ function registerMarketTools() {
     },
     {
       name: "market_get_price_limit",
+      title: "Get Price Limit",
       module: "market",
       description: "Get the current price limit (upper and lower bands) for a SWAP or FUTURES instrument. Orders outside these limits will be rejected.",
       isWrite: false,
@@ -8950,6 +9140,7 @@ function registerMarketTools() {
     },
     {
       name: "market_get_open_interest",
+      title: "Get Open Interest",
       module: "market",
       description: "Get open interest for SWAP, FUTURES, or OPTION instruments. Useful for gauging market sentiment and positioning.",
       isWrite: false,
@@ -8993,6 +9184,7 @@ function registerMarketTools() {
     },
     {
       name: "market_get_stock_tokens",
+      title: "List Stock Tokens",
       module: "market",
       description: '[Deprecated: use market_get_instruments_by_category with instCategory="3" instead] Get all stock token instruments (instCategory=3). Stock tokens track real-world stock prices on OKX (e.g. AAPL-USDT-SWAP).',
       isWrite: false,
@@ -9029,6 +9221,7 @@ function registerMarketTools() {
     },
     {
       name: "market_get_instruments_by_category",
+      title: "List Instruments by Category",
       module: "market",
       description: "Discover tradeable instruments by asset category. Stock tokens (instCategory=3, e.g. AAPL-USDT-SWAP, TSLA-USDT-SWAP), Metals (4, e.g. XAUUSDT-USDT-SWAP for gold), Commodities (5, e.g. OIL-USDT-SWAP for crude oil), Forex (6, e.g. EURUSDT-USDT-SWAP for EUR/USD), Bonds (7, e.g. US30Y-USDT-SWAP for crude oil). Use this to find instIds before querying prices or placing orders. Filters client-side by instCategory.",
       isWrite: false,
@@ -9079,6 +9272,7 @@ function registerMarketFilterTools() {
     // ─────────────────────────────────────────────────────────────────────────
     {
       name: "market_filter",
+      title: "Screen Instruments",
       module: "market",
       description: "Screen / rank instruments across SPOT, SWAP, or FUTURES by multi-dimensional criteria: price range, 24h change %, market cap, 24h volume (USD), funding rate (SWAP), open interest (USD), listing time. Returns ranked rows with full ticker snapshot. Use to find top movers, high-OI contracts, newly listed tokens, etc. No credentials required. Do NOT use to get OI change rankings across contracts - use market_filter_oi_change instead. Do NOT use to get OI time series for a single instrument - use market_get_oi_history instead.",
       isWrite: false,
@@ -9216,6 +9410,7 @@ function registerMarketFilterTools() {
     // ─────────────────────────────────────────────────────────────────────────
     {
       name: "market_get_oi_history",
+      title: "Get Open Interest History",
       module: "market",
       description: "Get open interest (OI) history time series for a single SWAP or FUTURES instrument. Returns per-bar OI in contracts, base currency and USD, plus bar-over-bar delta and delta %. Useful for tracking how OI evolves around price moves. No credentials required. Do NOT use to compare OI changes across multiple contracts - use market_filter_oi_change instead. Do NOT use to screen instruments by current OI level - use market_filter instead.",
       isWrite: false,
@@ -9263,6 +9458,7 @@ function registerMarketFilterTools() {
     // ─────────────────────────────────────────────────────────────────────────
     {
       name: "market_filter_oi_change",
+      title: "Find Open Interest Change Instruments",
       module: "market",
       description: "Find SWAP or FUTURES instruments with significant open interest changes over a given bar window. Returns ranked rows with current OI (USD), previous OI (USD), OI delta (USD and %), price change %, 24h volume and funding rate. Ideal for spotting unusual accumulation/distribution or confirming trend momentum. No credentials required. Do NOT use to get OI time series for a single instrument - use market_get_oi_history instead. Do NOT use to screen by current OI absolute level or other non-OI metrics - use market_filter instead.",
       isWrite: false,
@@ -9335,6 +9531,7 @@ function registerMarketFilterTools() {
     // ─────────────────────────────────────────────────────────────────────────
     {
       name: "market_get_pair_spread",
+      title: "Get Pair Spread",
       module: "market",
       description: "Compute spread statistics between two instruments over a lookback window. Returns absolute and ratio spread (mean / stdDev / median / min / max) plus an optional realtime spread snapshot. Use to size pairs trades, detect mean-reversion setups, or compare cross-listed contracts. Results are cached ~60s per (pair, bar, window) tuple. Read-only, no credentials required.\nDo NOT use to fetch raw candles (use market_get_candles) or single-instrument OI/funding (use market_get_oi_history / market_filter_oi_change).",
       isWrite: false,
@@ -9627,6 +9824,7 @@ function registerNewsTools() {
     // -----------------------------------------------------------------------
     {
       name: "news_get_latest",
+      title: "Get Latest Crypto News",
       module: "news",
       description: "Get crypto news sorted by time. For broad browsing ('what happened recently', 'latest news', 'any big news today'), pass importance='low' to include both high and low importance. Server default (when importance omitted) returns only high-importance news. For coin-specific news, use news_get_by_coin instead.",
       isWrite: false,
@@ -9672,6 +9870,7 @@ function registerNewsTools() {
     },
     {
       name: "news_get_by_coin",
+      title: "Get News by Coin",
       module: "news",
       description: "Get news for specific coins or tokens. Use when user mentions a coin: 'BTC news', 'any SOL updates'. Supports multiple coins (comma-separated). For general browsing without a coin filter, use news_get_latest.",
       isWrite: false,
@@ -9715,6 +9914,7 @@ function registerNewsTools() {
     },
     {
       name: "news_search",
+      title: "Search News",
       module: "news",
       description: "Search crypto news by keyword with optional filters. Use when user provides specific search terms: 'SEC ETF news', 'stablecoin regulation'. Keyword is optional - pass sentiment alone to browse by sentiment direction. For coin-only queries prefer news_get_by_coin.",
       isWrite: false,
@@ -9772,6 +9972,7 @@ function registerNewsTools() {
     },
     {
       name: "news_get_detail",
+      title: "Get News Article",
       module: "news",
       description: "Get full article content by news ID (returns title + summary + full original text). Use when user says 'show full article', 'read more', or provides a specific news ID from a previous result.",
       isWrite: false,
@@ -9803,6 +10004,7 @@ function registerNewsTools() {
     },
     {
       name: "news_get_domains",
+      title: "List News Sources",
       module: "news",
       description: "List available news source domains (e.g. coindesk, cointelegraph). Use when user asks what news sources are available or which platforms are covered.",
       isWrite: false,
@@ -9825,6 +10027,7 @@ function registerNewsTools() {
     // -----------------------------------------------------------------------
     {
       name: "news_get_coin_sentiment",
+      title: "Get Coin Sentiment",
       module: "news",
       description: "Get sentiment snapshot or time-series trend for coins. Returns bullish/bearish ratios and mention counts. Pass trendPoints for trend data (1h->24 points, 4h->6, 24h->7). Use when user asks about coin sentiment, sentiment trend, or how bullish/bearish a coin is. For ranking all coins by sentiment, use news_get_sentiment_ranking instead.",
       isWrite: false,
@@ -9866,6 +10069,7 @@ function registerNewsTools() {
     },
     {
       name: "news_get_sentiment_ranking",
+      title: "Get Sentiment Ranking",
       module: "news",
       description: "Get coin ranking by social hotness or sentiment direction. Use when user asks which coins are trending, most bullish/bearish coins. Sort by hot (mention count), bullish, or bearish. For sentiment data on a specific coin, use news_get_coin_sentiment instead.",
       isWrite: false,
@@ -9905,6 +10109,7 @@ function registerNewsTools() {
     // -----------------------------------------------------------------------
     {
       name: "news_list_calendar_regions",
+      title: "List Calendar Regions",
       module: "news",
       description: "List all valid region values for the economic calendar. Returns a string array of snake_case region codes. Call this when economic-calendar returns empty results to verify the region value, or to help the user pick a valid region. Do NOT use to list news source platforms - use news_get_domains instead.",
       isWrite: false,
@@ -9913,6 +10118,7 @@ function registerNewsTools() {
     },
     {
       name: "news_get_economic_calendar",
+      title: "Get Economic Calendar",
       module: "news",
       description: "Get macro-economic calendar data (GDP, CPI, NFP, interest rate decisions, PMI, etc.). Returns scheduled and released economic events with forecast, previous, and actual values. Use when user asks about economic calendar, macro data, or specific indicators like NFP/CPI/GDP/FOMC. Do NOT use for news articles or sentiment - use news_get_latest or news_search instead.",
       isWrite: false,
@@ -9973,6 +10179,8 @@ function registerOptionAlgoTools() {
   return [
     {
       name: "option_place_algo_order",
+      title: "Option Place Algo Order",
+      destructiveHint: false,
       module: "option",
       description: "Place OPTION TP/SL algo order (conditional/oco). [CAUTION] Executes real trades. conditional=single TP/SL; oco=TP+SL pair. -1=market.",
       isWrite: true,
@@ -10079,6 +10287,8 @@ function registerOptionAlgoTools() {
     },
     {
       name: "option_amend_algo_order",
+      title: "Option Amend Algo Order",
+      idempotentHint: true,
       module: "option",
       description: "Amend a pending OPTION algo order (modify TP/SL prices or size). Also covers TP/SL orders attached when placing the main order - look up algoId via option_get_algo_orders first.",
       isWrite: true,
@@ -10115,6 +10325,8 @@ function registerOptionAlgoTools() {
     },
     {
       name: "option_cancel_algo_orders",
+      title: "Option Cancel Algo Orders",
+      idempotentHint: true,
       module: "option",
       description: "Cancel OPTION algo orders (TP/SL). Each item: {algoId, instId}.",
       isWrite: true,
@@ -10158,6 +10370,7 @@ function registerOptionAlgoTools() {
     },
     {
       name: "option_get_algo_orders",
+      title: "Option Get Algo Orders",
       module: "option",
       description: "Query pending or completed OPTION algo orders (TP/SL, OCO).",
       isWrite: false,
@@ -10242,6 +10455,8 @@ function registerOptionTools() {
   return [
     {
       name: "option_place_order",
+      title: "Option Place Order",
+      destructiveHint: false,
       module: "option",
       description: "Place OPTION order. instId: {uly}-{expiry}-{strike}-C/P, e.g. BTC-USD-241227-50000-C. Before placing, use market_get_instruments to get ctVal (contract face value) - do NOT assume contract sizes. [CAUTION] Executes real trades.",
       isWrite: true,
@@ -10345,6 +10560,8 @@ function registerOptionTools() {
     },
     {
       name: "option_cancel_order",
+      title: "Option Cancel Order",
+      idempotentHint: true,
       module: "option",
       description: "Cancel an unfilled OPTION order. Provide ordId or clOrdId.",
       isWrite: true,
@@ -10373,6 +10590,8 @@ function registerOptionTools() {
     },
     {
       name: "option_batch_cancel",
+      title: "Option Batch Cancel Orders",
+      idempotentHint: true,
       module: "option",
       description: "[CAUTION] Batch cancel up to 20 OPTION orders.",
       isWrite: true,
@@ -10403,6 +10622,8 @@ function registerOptionTools() {
     },
     {
       name: "option_amend_order",
+      title: "Option Amend Order",
+      idempotentHint: true,
       module: "option",
       description: "Amend an unfilled OPTION order (price and/or size). Provide ordId or clOrdId. To modify attached TP/SL, use option_amend_algo_order with the algoId from option_get_algo_orders.",
       isWrite: true,
@@ -10435,6 +10656,7 @@ function registerOptionTools() {
     },
     {
       name: "option_get_order",
+      title: "Option Get Order",
       module: "option",
       description: "Get details of a single OPTION order by ordId or clOrdId.",
       isWrite: false,
@@ -10463,6 +10685,7 @@ function registerOptionTools() {
     },
     {
       name: "option_get_orders",
+      title: "Option Get Orders",
       module: "option",
       description: "List OPTION orders. status: live=pending (default), history=7d, archive=3mo.",
       isWrite: false,
@@ -10517,6 +10740,7 @@ function registerOptionTools() {
     },
     {
       name: "option_get_positions",
+      title: "Option Get Positions with Greeks",
       module: "option",
       description: "Get current OPTION positions including Greeks (delta, gamma, theta, vega).",
       isWrite: false,
@@ -10543,6 +10767,7 @@ function registerOptionTools() {
     },
     {
       name: "option_get_fills",
+      title: "Option Get Fills",
       module: "option",
       description: "Get OPTION fill history. archive=false: last 3 days (default); archive=true: up to 3 months.",
       isWrite: false,
@@ -10585,6 +10810,7 @@ function registerOptionTools() {
     },
     {
       name: "option_get_instruments",
+      title: "Option List Instruments (Chain)",
       module: "option",
       description: "List available OPTION contracts for a given underlying (option chain). Use to find valid instIds before placing orders.",
       isWrite: false,
@@ -10618,6 +10844,7 @@ function registerOptionTools() {
     },
     {
       name: "option_get_greeks",
+      title: "Option Get Greeks",
       module: "option",
       description: "Get implied volatility and Greeks (delta, gamma, theta, vega) for OPTION contracts by underlying.",
       isWrite: false,
@@ -10654,6 +10881,8 @@ function registerSpotTradeTools() {
   return [
     {
       name: "spot_place_order",
+      title: "Spot Place Order",
+      destructiveHint: false,
       module: "spot",
       description: "Place a spot order. Attach TP/SL via tpTriggerPx/slTriggerPx. [CAUTION] Executes real trades.",
       isWrite: true,
@@ -10748,6 +10977,8 @@ function registerSpotTradeTools() {
     },
     {
       name: "spot_cancel_order",
+      title: "Spot Cancel Order",
+      idempotentHint: true,
       module: "spot",
       description: "Cancel an unfilled spot order.",
       isWrite: true,
@@ -10783,6 +11014,8 @@ function registerSpotTradeTools() {
     },
     {
       name: "spot_amend_order",
+      title: "Spot Amend Order",
+      idempotentHint: true,
       module: "spot",
       description: "Amend an unfilled spot order (modify price or size). To modify attached TP/SL, use the corresponding algo amend tool: spot_amend_algo_order (spot), swap_amend_algo_order (swap), futures_amend_algo_order (futures), option_amend_algo_order (option). Use spot_get_algo_orders to find the algoId for spot orders.",
       isWrite: true,
@@ -10833,6 +11066,7 @@ function registerSpotTradeTools() {
     },
     {
       name: "spot_get_orders",
+      title: "Spot Get Orders",
       module: "spot",
       description: "Query spot orders. status: open(active)|history(7d)|archive(3mo).",
       isWrite: false,
@@ -10901,6 +11135,8 @@ function registerSpotTradeTools() {
     },
     {
       name: "spot_place_algo_order",
+      title: "Spot Place Algo Order",
+      destructiveHint: false,
       module: "spot",
       description: "Place a spot algo order. [CAUTION] Executes real trades. conditional: single TP/SL. oco: TP+SL pair. move_order_stop: trailing stop. trigger: pending order at triggerPx. chase: follow best bid/ask. iceberg: split large order into child orders. twap: time-weighted split.",
       isWrite: true,
@@ -11016,6 +11252,8 @@ function registerSpotTradeTools() {
     },
     {
       name: "spot_amend_algo_order",
+      title: "Spot Amend Algo Order",
+      idempotentHint: true,
       module: "spot",
       description: "Amend a pending spot algo order (modify TP/SL prices or size). Also covers TP/SL orders attached when placing the main order - look up algoId via spot_get_algo_orders first.",
       isWrite: true,
@@ -11052,6 +11290,8 @@ function registerSpotTradeTools() {
     },
     {
       name: "spot_cancel_algo_order",
+      title: "Spot Cancel Algo Order",
+      idempotentHint: true,
       module: "spot",
       description: "Cancel a spot algo order (TP/SL).",
       isWrite: true,
@@ -11085,6 +11325,7 @@ function registerSpotTradeTools() {
     },
     {
       name: "spot_get_algo_orders",
+      title: "Spot Get Algo Orders",
       module: "spot",
       description: "Query spot algo orders (TP/SL) - pending or history.",
       isWrite: false,
@@ -11162,6 +11403,7 @@ function registerSpotTradeTools() {
     },
     {
       name: "spot_get_fills",
+      title: "Spot Get Fills",
       module: "spot",
       description: "Get spot transaction fills. archive=false(3d, default)|true(up to 3mo).",
       isWrite: false,
@@ -11225,6 +11467,7 @@ function registerSpotTradeTools() {
     },
     {
       name: "spot_batch_orders",
+      title: "Spot Batch Orders",
       module: "spot",
       description: "[CAUTION] Batch place/cancel/amend up to 20 spot orders. action: place|cancel|amend.",
       isWrite: true,
@@ -11283,6 +11526,7 @@ function registerSpotTradeTools() {
     },
     {
       name: "spot_get_order",
+      title: "Spot Get Order",
       module: "spot",
       description: "Get details of a single spot order.",
       isWrite: false,
@@ -11320,6 +11564,8 @@ function registerSpotTradeTools() {
     },
     {
       name: "spot_batch_amend",
+      title: "Spot Batch Amend Orders",
+      idempotentHint: true,
       module: "spot",
       description: "[CAUTION] Batch amend up to 20 unfilled spot orders.",
       isWrite: true,
@@ -11350,6 +11596,8 @@ function registerSpotTradeTools() {
     },
     {
       name: "spot_batch_cancel",
+      title: "Spot Batch Cancel Orders",
+      idempotentHint: true,
       module: "spot",
       description: "[CAUTION] Batch cancel up to 20 spot orders.",
       isWrite: true,
@@ -11387,6 +11635,8 @@ function registerSpotTradeTools() {
     // Not applicable: posSide (spot has no long/short hedge).
     {
       name: "spot_set_leverage",
+      title: "Spot Set Leverage",
+      idempotentHint: true,
       module: "spot",
       description: "Set leverage for SPOT margin trading. Provide exactly ONE of instId (pair-level) or ccy (currency-level cross, requires borrow-enabled account / multi-ccy / portfolio margin). [CAUTION] Changes risk parameters.\nScenarios:\n  \u2022 instId + mgnMode=isolated -> pair-level isolated margin\n  \u2022 instId + mgnMode=cross    -> pair-level cross margin (contract-mode account)\n  \u2022 ccy    + mgnMode=cross    -> currency-level cross margin (spot-with-borrow / multi-ccy / portfolio margin)\nWhen ccy is supplied, mgnMode MUST be cross. posSide is never applicable to spot margin.",
       isWrite: true,
@@ -11461,6 +11711,7 @@ function registerSwapTradeTools() {
     prefix: "swap",
     module: "swap",
     label: "SWAP/FUTURES",
+    titleLabel: "Perpetual Futures",
     instTypes: ["SWAP", "FUTURES"],
     instIdExample: "e.g. BTC-USDT-SWAP"
   });
@@ -11470,6 +11721,8 @@ function registerSwapTradeTools() {
     // Unique to swap: amend a pending TP/SL algo order attached to a position.
     {
       name: "swap_amend_algo_order",
+      title: "Perpetual Futures Amend Algo Order",
+      idempotentHint: true,
       module: "swap",
       description: "Amend a pending SWAP/FUTURES algo order (modify TP/SL prices or size). Also covers TP/SL orders attached when placing the main order - look up algoId via swap_get_algo_orders first.",
       isWrite: true,
@@ -11508,6 +11761,7 @@ function registerSwapTradeTools() {
     // Unique to swap: 3-in-1 batch tool (place / cancel / amend via action param).
     {
       name: "swap_batch_orders",
+      title: "Perpetual Futures Batch Orders",
       module: "swap",
       description: "[CAUTION] Batch place/cancel/amend SWAP/FUTURES orders (max 20). action=place|cancel|amend.",
       isWrite: true,
@@ -11598,26 +11852,30 @@ function buildTools(config) {
   return tools.filter((tool) => !tool.isWrite);
 }
 function toMcpTool(tool) {
+  const destructive = tool.destructiveHint ?? tool.isWrite;
+  const idempotent = tool.idempotentHint ?? !tool.isWrite;
   return {
     name: tool.name,
+    title: tool.title,
     description: tool.description,
     inputSchema: tool.inputSchema,
     ...tool.outputSchema ? { outputSchema: tool.outputSchema } : {},
     annotations: {
+      title: tool.title,
       readOnlyHint: !tool.isWrite,
-      destructiveHint: tool.isWrite,
-      idempotentHint: !tool.isWrite,
+      destructiveHint: destructive,
+      idempotentHint: idempotent,
       openWorldHint: true
     }
   };
 }
 function configFilePath() {
-  return join7(homedir5(), ".okx", "config.toml");
+  return join9(homedir5(), ".okx", "config.toml");
 }
 function readFullConfig() {
   const path4 = configFilePath();
   if (!existsSync3(path4)) return { profiles: {} };
-  const raw = readFileSync4(path4, "utf-8");
+  const raw = readFileSync6(path4, "utf-8");
   try {
     return parse(raw);
   } catch (err) {
@@ -11752,7 +12010,7 @@ async function loadConfig(cli) {
     verbose: cli.verbose ?? false
   };
 }
-var CACHE_FILE = join8(homedir6(), ".okx", "update-check.json");
+var CACHE_FILE = join10(homedir6(), ".okx", "update-check.json");
 var CHECK_INTERVAL_MS = 24 * 60 * 60 * 1e3;
 var NEGATIVE_CHECK_INTERVAL_MS = 60 * 60 * 1e3;
 var DEFAULT_REGISTRY = "https://registry.npmjs.org/";
@@ -11760,7 +12018,7 @@ var FETCH_TIMEOUT_MS = 3e3;
 function readCache2() {
   try {
     if (existsSync4(CACHE_FILE)) {
-      return JSON.parse(readFileSync5(CACHE_FILE, "utf-8"));
+      return JSON.parse(readFileSync7(CACHE_FILE, "utf-8"));
     }
   } catch {
   }
@@ -11768,7 +12026,7 @@ function readCache2() {
 }
 function writeCache2(cache) {
   try {
-    mkdirSync6(join8(homedir6(), ".okx"), { recursive: true });
+    mkdirSync6(join10(homedir6(), ".okx"), { recursive: true });
     writeFileSync5(CACHE_FILE, JSON.stringify(cache, null, 2), "utf-8");
   } catch {
   }
@@ -11798,13 +12056,13 @@ function buildNpmrcCandidates() {
   let dir = process.cwd();
   const root = dir.startsWith("/") ? "/" : dir.slice(0, 3);
   while (true) {
-    add(join8(dir, ".npmrc"));
+    add(join10(dir, ".npmrc"));
     if (dir === root) break;
-    const parent = join8(dir, "..");
+    const parent = join10(dir, "..");
     if (parent === dir) break;
     dir = parent;
   }
-  add(join8(homedir6(), ".npmrc"));
+  add(join10(homedir6(), ".npmrc"));
   if (process.platform !== "win32") {
     add("/etc/npmrc");
   }
@@ -11813,7 +12071,7 @@ function buildNpmrcCandidates() {
 function readNpmrcRegistry(filePath) {
   try {
     if (!existsSync4(filePath)) return null;
-    const lines = readFileSync5(filePath, "utf-8").split(/\r?\n/);
+    const lines = readFileSync7(filePath, "utf-8").split(/\r?\n/);
     for (const line of lines) {
       const trimmed = line.trim();
       if (trimmed.startsWith("#") || !trimmed.includes("=")) continue;
@@ -12130,7 +12388,7 @@ function runSetup(options) {
 `);
   }
 }
-var CACHE_PATH = join12(homedir10(), ".okx", "auth-binary-check.json");
+var CACHE_PATH = join14(homedir10(), ".okx", "auth-binary-check.json");
 var CHECK_INTERVAL_MS2 = 2 * 60 * 60 * 1e3;
 
 // src/constants.ts
@@ -12139,7 +12397,7 @@ var _require = createRequire(import.meta.url);
 var pkg = _require("../package.json");
 var SERVER_NAME = "okx-trade-mcp";
 var SERVER_VERSION = pkg.version;
-var GIT_HASH = true ? "c34b282c" : "dev";
+var GIT_HASH = true ? "92abfa77" : "dev";
 
 // src/server.ts
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
@@ -12150,12 +12408,14 @@ import {
 var SYSTEM_CAPABILITIES_TOOL_NAME = "system_get_capabilities";
 var SYSTEM_CAPABILITIES_TOOL = {
   name: SYSTEM_CAPABILITIES_TOOL_NAME,
+  title: "Server Capabilities Snapshot",
   description: "Return machine-readable server capabilities and module availability for agent planning.",
   inputSchema: {
     type: "object",
     additionalProperties: false
   },
   annotations: {
+    title: "Server Capabilities Snapshot",
     readOnlyHint: true,
     destructiveHint: false,
     idempotentHint: true,