flash-trade-mcp 0.3.4 → 0.4.0

package/dist/index.js

@@ -49236,7 +49236,7 @@ class FlashApiClient {
 // src/tools/health.ts
 function registerHealthTools(server, client) {
   server.registerTool("health_check", {
-    description: "Check if the Flash Trade API is running and responsive. Returns account counts and service status. Call this first to verify connectivity before using other tools."
+    description: "Verify Flash Trade API connectivity and status. Call this first before any other tool. Returns service status and account counts."
   }, async () => {
     const health = await client.getHealth();
     const lines = [`Status: ${health.status}`];
@@ -49250,7 +49250,7 @@ function registerHealthTools(server, client) {
   });
 }
 
-// src/tools/markets.ts
+// src/tools/shared/custody-map.ts
 var VIRTUAL_CUSTODY_MAP = {
   "6bthDsp8pcGBGKVKCKZjV5JfuSUNRo62RG4hQHj1u4CK": { symbol: "BNB", pool: "Crypto.1", maxLeverage: "60.00" },
   A8SKWb3pwbFUtxLQhnpUTfy7CkxBpWGvTLYyJyWHCMWv: { symbol: "PYTH", pool: "Governance.1", maxLeverage: "60.00" },
@@ -49270,6 +49270,13 @@ var VIRTUAL_CUSTODY_MAP = {
   RQNURQjDbq2Yah2udtFTNT7TjR15vsPV3oJNnwYher8: { symbol: "TSLA", pool: "Equity.1", maxLeverage: "12.00" },
   ArnD1faZVVkkewX4HUSoDuht46egAtVvhDTFMJn3DkFo: { symbol: "SAMO", pool: "Community.3", maxLeverage: "50.00" }
 };
+function formatPriceUsd(data) {
+  const price = parseFloat(data.price);
+  const exp = parseFloat(data.exponent);
+  if (isNaN(price) || isNaN(exp))
+    return "?";
+  return (price * Math.pow(10, exp)).toFixed(2);
+}
 function buildCustodySymbolMap(poolData) {
   const map3 = new Map;
   for (const pool of poolData.pools) {
@@ -49288,6 +49295,8 @@ function buildCustodySymbolMap(poolData) {
   }
   return map3;
 }
+
+// src/tools/markets.ts
 function formatMarketsSummary(markets, custodyInfo) {
   const lines = [
     `${markets.length} markets available:
@@ -49317,7 +49326,7 @@ Use get_market with a pubkey for full details. Use get_prices for current oracle
 }
 function registerMarketTools(server, client) {
   server.registerTool("get_markets", {
-    description: "List all available perpetual futures markets on Flash Trade. Returns a compact summary table with symbol, side (Long/Short), pool, max leverage, and market pubkey. For full details on a specific market, use get_market with the pubkey."
+    description: "List all available perpetual futures markets. Returns a summary table with symbol, side, pool, max leverage, and pubkey. For a trading-ready view with prices, use get_trading_overview instead."
   }, async () => {
     const [markets, poolData] = await Promise.all([
       client.getMarkets(),
@@ -49370,10 +49379,26 @@ Use get_pool with a pubkey for full details. Use get_pool_data for AUM and utili
 // src/tools/custodies.ts
 function registerCustodyTools(server, client) {
   server.registerTool("get_custodies", {
-    description: "List all custody accounts. Custodies hold the actual tokens for each asset in a pool (e.g., the USDC custody, the SOL custody). Returns custody pubkeys, token info, and utilization metrics."
+    description: "List all custody accounts (token vaults) across pools. Returns a compact summary with symbol, mint, and pubkey. Use get_custody with a specific pubkey for full details (utilization, fees, limits)."
   }, async () => {
     const custodies = await client.getCustodies();
-    return { content: [{ type: "text", text: JSON.stringify(custodies, null, 2) }] };
+    const lines = [
+      `${custodies.length} custody accounts:
+`,
+      "Symbol     | Mint                                         | Pubkey",
+      "-----------|----------------------------------------------|----------------------------------------------"
+    ];
+    for (const c of custodies) {
+      const acct = c.account ?? {};
+      const mintObj = typeof acct.mint === "object" ? acct.mint : null;
+      const symbol2 = (acct.symbol ?? mintObj?.symbol ?? "?").toString().padEnd(10);
+      const mint = (mintObj?.key ?? (typeof acct.mint === "string" ? acct.mint : "?")).toString().slice(0, 44).padEnd(44);
+      lines.push(`${symbol2} | ${mint} | ${c.pubkey}`);
+    }
+    lines.push(`
+Use get_custody with a pubkey for full details (utilization, fees, limits).`);
+    return { content: [{ type: "text", text: lines.join(`
+`) }] };
   });
   server.registerTool("get_custody", {
     description: "Get detailed custody information for a specific custody account. Includes utilization, fees, and limits.",
@@ -49434,7 +49459,7 @@ function formatEnrichedPosition(p) {
 }
 function registerPositionTools(server, client) {
   server.registerTool("get_positions", {
-    description: "List perpetual positions, optionally filtered by wallet owner. Without an owner filter, returns ALL open positions (may be large). With owner, returns enriched positions with computed PnL, leverage, and liquidation price.",
+    description: "List open perpetual positions. Without owner: returns all positions (large response). With owner: returns enriched positions with live PnL, leverage, and liquidation price. For a complete wallet overview, use get_account_summary instead.",
     inputSchema: {
       owner: exports_external.string().regex(/^[1-9A-HJ-NP-Za-km-z]{32,44}$/).optional().describe("Wallet pubkey to filter by. When provided, returns enriched positions with PnL, leverage, and liquidation price.")
     }
@@ -49455,7 +49480,7 @@ ${text}` }] };
     return { content: [{ type: "text", text: JSON.stringify(positions, null, 2) }] };
   });
   server.registerTool("get_position", {
-    description: "Get a single position by its on-chain account pubkey. Returns raw position data. For enriched data (PnL, leverage, liq price), use get_positions with the owner filter instead.",
+    description: "Get a single position by its on-chain pubkey. Returns raw position data. For enriched data with PnL and leverage, use get_positions with owner or get_account_summary.",
     inputSchema: { pubkey: exports_external.string().regex(/^[1-9A-HJ-NP-Za-km-z]{32,44}$/).describe("Position account pubkey") }
   }, async ({ pubkey }) => {
     const position = await client.getPosition(pubkey);
@@ -49480,7 +49505,7 @@ function formatEnrichedOrder(o) {
 }
 function registerOrderTools(server, client) {
   server.registerTool("get_orders", {
-    description: "List open orders (limit orders, take-profit, stop-loss), optionally filtered by wallet owner. When owner is provided, returns enriched order data with computed trigger prices and sizes.",
+    description: "List pending orders (limit, take-profit, stop-loss). With owner: returns enriched orders with computed trigger prices and sizes. Needed to find order_id (0-7) for edit_trigger_order or cancel_trigger_order.",
     inputSchema: {
       owner: exports_external.string().regex(/^[1-9A-HJ-NP-Za-km-z]{32,44}$/).optional().describe("Wallet pubkey to filter by. When provided, returns enriched orders.")
     }
@@ -49544,6 +49569,176 @@ Use get_pool_data with pool_pubkey for full custody stats.`);
   });
 }
 
+// src/sanitize.ts
+var zBool = exports_external.preprocess((v) => {
+  if (typeof v === "string")
+    return v === "true";
+  return v;
+}, exports_external.boolean());
+function sanitizeError(e) {
+  const msg = e instanceof Error ? e.message : String(e);
+  return msg.replace(/\[[\d,\s]{20,}\]/g, "[REDACTED]").replace(/[0-9a-fA-F]{40,}/g, "[REDACTED]").replace(/[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{40,}/g, "[REDACTED]").replace(/[A-Za-z0-9+/]{40,}={0,2}/g, "[REDACTED]");
+}
+
+// src/tools/account-summary.ts
+function registerAccountSummaryTool(server, client) {
+  server.registerTool("get_account_summary", {
+    description: "Get a complete wallet overview: all open positions (with PnL), all pending orders (limit/TP/SL), and current prices for held markets. " + "Recommended first call when managing a specific wallet — replaces calling get_positions + get_orders + get_prices separately.",
+    inputSchema: {
+      owner: exports_external.string().regex(/^[1-9A-HJ-NP-Za-km-z]{32,44}$/).describe("Wallet pubkey")
+    }
+  }, async ({ owner }) => {
+    const [posResult, ordResult, priceResult] = await Promise.allSettled([
+      client.getOwnerPositions(owner),
+      client.getOwnerOrders(owner),
+      client.getPrices()
+    ]);
+    const positions = posResult.status === "fulfilled" ? posResult.value : null;
+    const orders = ordResult.status === "fulfilled" ? ordResult.value : null;
+    const prices = priceResult.status === "fulfilled" ? priceResult.value : null;
+    const lines = [`=== Account Summary for ${owner} ===
+`];
+    const warnings = [];
+    if (!positions)
+      warnings.push(`Positions unavailable: ${sanitizeError(posResult.reason)}`);
+    if (!orders)
+      warnings.push(`Orders unavailable: ${sanitizeError(ordResult.reason)}`);
+    if (!prices)
+      warnings.push(`Prices unavailable: ${sanitizeError(priceResult.reason)}`);
+    if (!positions) {
+      lines.push(`Positions: unavailable
+`);
+    } else if (positions.length === 0) {
+      lines.push(`Positions: None
+`);
+    } else {
+      lines.push(`── ${positions.length} Position(s) ──`);
+      for (const p of positions) {
+        const pnl = p.pnlWithFeeUsdUi ? ` | PnL: $${p.pnlWithFeeUsdUi} (${p.pnlPercentageWithFee}%)` : "";
+        lines.push(`  ${p.sideUi} ${p.marketSymbol}: $${p.sizeUsdUi} @ $${p.entryPriceUi} (${p.leverageUi}x)${pnl}`);
+        lines.push(`    Key: ${p.key} | Liq: $${p.liquidationPriceUi}`);
+      }
+      lines.push("");
+    }
+    if (!orders) {
+      lines.push(`Orders: unavailable
+`);
+    } else if (orders.length === 0) {
+      lines.push(`Orders: None
+`);
+    } else {
+      lines.push(`── Orders ──`);
+      for (const o of orders) {
+        for (const lo of o.limitOrders ?? []) {
+          lines.push(`  LIMIT ${lo.sideUi} ${lo.symbol}: $${lo.sizeUsdUi} @ $${lo.entryPriceUi} (${lo.leverageUi}x)`);
+        }
+        for (const tp of o.takeProfitOrders ?? []) {
+          lines.push(`  TP ${tp.sideUi} ${tp.symbol}: $${tp.sizeUsdUi} @ $${tp.triggerPriceUi}`);
+        }
+        for (const sl of o.stopLossOrders ?? []) {
+          lines.push(`  SL ${sl.sideUi} ${sl.symbol}: $${sl.sizeUsdUi} @ $${sl.triggerPriceUi}`);
+        }
+      }
+      lines.push("");
+    }
+    if (positions && prices) {
+      const marketSymbols = [...new Set(positions.map((p) => p.marketSymbol).filter((s) => !!s))];
+      if (marketSymbols.length > 0) {
+        lines.push("── Current Prices ──");
+        for (const sym of marketSymbols) {
+          const priceData = prices[sym];
+          if (priceData) {
+            const usd = formatPriceUsd(priceData);
+            lines.push(`  ${sym}: ${usd === "?" ? "price unavailable" : `$${usd}`}`);
+          }
+        }
+        lines.push("");
+      }
+    }
+    if (warnings.length > 0) {
+      lines.push("── Warnings ──");
+      for (const w of warnings)
+        lines.push(`  ${w}`);
+    }
+    return { content: [{ type: "text", text: lines.join(`
+`) }] };
+  });
+}
+
+// src/tools/trading-overview.ts
+function registerTradingOverviewTool(server, client) {
+  server.registerTool("get_trading_overview", {
+    description: "Get a trading-ready market snapshot: all markets with current oracle prices, max leverage, and pool utilization. " + "Recommended first call when planning new trades — replaces calling get_markets + get_prices + get_pool_data separately."
+  }, async () => {
+    const [marketsResult, pricesResult, poolResult] = await Promise.allSettled([
+      client.getMarkets(),
+      client.getPrices(),
+      client.getPoolData()
+    ]);
+    const markets = marketsResult.status === "fulfilled" ? marketsResult.value : null;
+    const prices = pricesResult.status === "fulfilled" ? pricesResult.value : null;
+    const poolData = poolResult.status === "fulfilled" ? poolResult.value : null;
+    const lines = [`=== Trading Overview ===
+`];
+    const warnings = [];
+    if (!markets)
+      warnings.push(`Markets unavailable: ${sanitizeError(marketsResult.reason)}`);
+    if (!prices)
+      warnings.push(`Prices unavailable: ${sanitizeError(pricesResult.reason)}`);
+    if (!poolData)
+      warnings.push(`Pool data unavailable: ${sanitizeError(poolResult.reason)}`);
+    if (markets) {
+      const custodyInfo = poolData ? buildCustodySymbolMap(poolData) : new Map;
+      lines.push("── Markets ──");
+      lines.push("Symbol     | Price         | Side  | Max Lev | Pool");
+      lines.push("-----------|---------------|-------|---------|---------------");
+      const enriched = markets.map((m) => {
+        const info = custodyInfo.get(m.account.target_custody);
+        return {
+          symbol: info?.symbol ?? "UNKNOWN",
+          pool: info?.pool ?? "?",
+          maxLeverage: info?.maxLeverage ?? "?",
+          side: m.account.side,
+          open: m.account.permissions.allow_open_position
+        };
+      }).sort((a, b) => a.pool.localeCompare(b.pool) || a.symbol.localeCompare(b.symbol) || a.side.localeCompare(b.side));
+      for (const m of enriched) {
+        let priceStr = "?";
+        if (prices) {
+          const priceData = prices[m.symbol];
+          if (priceData)
+            priceStr = `$${formatPriceUsd(priceData)}`;
+        }
+        const status = m.open ? "" : " [CLOSED]";
+        lines.push(`${m.symbol.padEnd(10)} | ${priceStr.padEnd(13)} | ${m.side.padEnd(5)} | ${m.maxLeverage.padEnd(7)} | ${m.pool}${status}`);
+      }
+    }
+    if (poolData) {
+      lines.push(`
+── Pool Utilization ──`);
+      lines.push("Pool           | AUM            | LP Price  | Stable%");
+      lines.push("---------------|----------------|-----------|--------");
+      for (const p of poolData.pools) {
+        const name = (p.poolName ?? "Unknown").padEnd(14);
+        const aum = `$${p.lpStats?.totalPoolValueUsd ?? "?"}`.padEnd(14);
+        const lp = `$${p.lpStats?.lpPrice ?? "?"}`.padEnd(9);
+        const stable = `${p.lpStats?.stableCoinPercentage ?? "?"}%`;
+        lines.push(`${name} | ${aum} | ${lp} | ${stable}`);
+      }
+    }
+    if (warnings.length > 0) {
+      lines.push(`
+── Warnings ──`);
+      for (const w of warnings)
+        lines.push(`  ${w}`);
+    }
+    lines.push(`
+Use open_position to trade. Use get_account_summary to check existing positions.`);
+    return { content: [{ type: "text", text: lines.join(`
+`) }] };
+  });
+}
+
 // src/tools/open-position.ts
 function formatOpenPreview(req, res) {
   const lines = [
@@ -49588,7 +49783,7 @@ No transaction built (provide owner wallet pubkey to build transaction)`);
 }
 function registerOpenPositionTool(server, client) {
   server.registerTool("open_position", {
-    description: "Build a transaction to open a new perpetual position on Flash Trade. Returns a preview (entry price, fees, leverage, liquidation price) AND an unsigned transaction. The transaction must be signed by the user's wallet and submitted to Solana separately. IMPORTANT: Always present the preview to the user before they sign. This tool does NOT execute the trade. Supports both MARKET and LIMIT orders, with optional take-profit and stop-loss. COLLATERAL WARNING: Limit orders, take-profit, and stop-loss require >$10 collateral AFTER entry fees. A $10 position will have fees deducted, dropping collateral below $10 and preventing TP/SL/limit orders. Use at least $11-12 input_amount when planning to set TP/SL.",
+    description: "Build a transaction to open a new perpetual futures position. Returns a preview (entry price, fees, leverage, liquidation price) AND an unsigned transaction. " + "Show the preview to the user before signing. Supports MARKET and LIMIT orders with optional TP/SL. " + "IMPORTANT: Use at least $11 input_amount if setting take_profit or stop_loss — collateral after fees must exceed $10 for TP/SL to work on-chain.",
     inputSchema: {
       input_token_symbol: exports_external.string().max(16).describe('Token to pay with: "USDC", "SOL", etc.'),
       output_token_symbol: exports_external.string().max(16).describe('Market to trade: "SOL", "BTC", "ETH", etc.'),
@@ -49601,7 +49796,7 @@ function registerOpenPositionTool(server, client) {
       slippage_percentage: exports_external.string().max(8).optional().describe('Default: "0.5" (0.5%)'),
       take_profit: exports_external.string().max(32).optional().describe("TP trigger price in UI format"),
       stop_loss: exports_external.string().max(32).optional().describe("SL trigger price in UI format"),
-      degen_mode: exports_external.coerce.boolean().optional().describe("Enable degen mode (higher leverage limits)")
+      degen_mode: zBool.optional().describe("Enable degen mode (higher leverage limits)")
     }
   }, async (params) => {
     const res = await client.openPosition({
@@ -49670,12 +49865,12 @@ Transaction (base64, unsigned — sign with wallet):`);
 }
 function registerClosePositionTool(server, client) {
   server.registerTool("close_position", {
-    description: "Build a transaction to close (fully or partially) an existing perpetual position. Returns a preview with PnL, fees, and receive amount, plus an unsigned transaction. For a full close, set input_usd to the position's full size. For a partial close, use a smaller amount. The transaction must be signed and submitted separately.",
+    description: "Build a transaction to close (fully or partially) an existing position. Returns preview with PnL, fees, and receive amount, plus unsigned transaction. " + "For full close: set input_usd to position size. For partial: use smaller amount. Requires position_key from get_positions.",
     inputSchema: {
       position_key: exports_external.string().regex(/^[1-9A-HJ-NP-Za-km-z]{32,44}$/).describe("Position account pubkey to close"),
       input_usd: exports_external.string().max(32).describe('USD amount to close, e.g. "500.00" for full or "250.00" for partial'),
       withdraw_token_symbol: exports_external.string().max(16).describe('Token to receive: "USDC", "SOL", etc.'),
-      keep_leverage_same: exports_external.coerce.boolean().optional().describe("Keep leverage constant during partial close"),
+      keep_leverage_same: zBool.optional().describe("Keep leverage constant during partial close"),
       slippage_percentage: exports_external.string().max(8).optional().describe('Default: "0.5" (0.5%)')
     }
   }, async (params) => {
@@ -49804,12 +49999,12 @@ Transaction (base64, unsigned — sign with wallet):`);
 }
 function registerReversePositionTool(server, client) {
   server.registerTool("reverse_position", {
-    description: "Build a transaction to reverse a position (close current + open opposite direction). For example, close a LONG and open a SHORT with the same collateral. Returns combined close+open preview and a single unsigned transaction.",
+    description: "Build a transaction to reverse a position (close current + open opposite direction). For example, close a LONG and open a SHORT with same collateral. " + "Returns combined preview and a single unsigned transaction. Requires position_key from get_positions.",
     inputSchema: {
       position_key: exports_external.string().regex(/^[1-9A-HJ-NP-Za-km-z]{32,44}$/).describe("Position account pubkey to reverse"),
       owner: exports_external.string().regex(/^[1-9A-HJ-NP-Za-km-z]{32,44}$/).describe("Wallet pubkey"),
       slippage_percentage: exports_external.string().max(8).optional().describe('Default: "0.5" (0.5%)'),
-      degen_mode: exports_external.coerce.boolean().optional().describe("Enable degen mode for the new position")
+      degen_mode: zBool.optional().describe("Enable degen mode for the new position")
     }
   }, async (params) => {
     const res = await client.reversePosition({
@@ -56859,17 +57054,9 @@ var $VersionedTransaction = VersionedTransaction;
 
 // src/tools/sign-and-send.ts
 import fs from "node:fs";
-
-// src/sanitize.ts
-function sanitizeError(e) {
-  const msg = e instanceof Error ? e.message : String(e);
-  return msg.replace(/\[[\d,\s]{20,}\]/g, "[REDACTED]").replace(/[0-9a-fA-F]{40,}/g, "[REDACTED]").replace(/[123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{40,}/g, "[REDACTED]").replace(/[A-Za-z0-9+/]{40,}={0,2}/g, "[REDACTED]");
-}
-
-// src/tools/sign-and-send.ts
 function registerSignAndSendTool(server) {
   server.registerTool("sign_and_send", {
-    description: "Sign and submit a base64-encoded unsigned Solana transaction using the locally configured keypair. " + "Call this AFTER a transaction tool (open_position, close_position, add_collateral, remove_collateral, reverse_position) " + "returns a transactionBase64 string AND the user has reviewed and approved the preview. " + "The keypair is read from KEYPAIR_PATH (default: ~/.config/solana/id.json). " + "Returns the confirmed transaction signature and a Solscan link. " + "IMPORTANT: Always show the transaction preview to the user and get their approval BEFORE calling this tool. " + "This tool signs with the local keypair and submits to Solana mainnet — the action is IRREVERSIBLE. " + "NOTE: This tool never exposes private key material in its output.",
+    description: "Sign and submit a base64 transaction to Solana mainnet using the local keypair. " + "Call ONLY after a transaction tool returns transactionBase64 AND the user has approved the preview. " + "IRREVERSIBLE — always confirm with user first. Call immediately — blockhashes expire in ~60 seconds. " + "Returns the confirmed signature and a Solscan link.",
     inputSchema: {
       transaction_base64: exports_external.string().max(1e4).describe("The base64-encoded unsigned transaction returned by a transaction tool")
     }
@@ -56934,13 +57121,20 @@ Signature: ${signature2}` }],
       const lines = [
         "=== Transaction Confirmed ===",
         `Signature: ${signature2}`,
-        `Explorer: https://solscan.io/tx/${signature2}`
+        `Explorer: https://solscan.io/tx/${signature2}`,
+        "",
+        "Next: Call get_positions (with owner) to verify the position, or get_orders to check trigger orders."
       ];
       return { content: [{ type: "text", text: lines.join(`
 `) }] };
     } catch (e) {
+      const msg = sanitizeError(e);
+      const isBlockhashExpired = msg.includes("Blockhash not found") || msg.includes("block height exceeded");
+      const hint = isBlockhashExpired ? `
+
+The blockhash has expired (~60 seconds). Re-call the original transaction tool to get a fresh transaction, then call sign_and_send immediately.` : "";
       return {
-        content: [{ type: "text", text: `Transaction send failed: ${sanitizeError(e)}` }],
+        content: [{ type: "text", text: `Transaction send failed: ${msg}${hint}` }],
         isError: true
       };
     }
@@ -56950,13 +57144,13 @@ Signature: ${signature2}` }],
 // src/tools/trigger-orders.ts
 function registerTriggerOrderTools(server, client) {
   server.registerTool("place_trigger_order", {
-    description: "Place a take-profit (TP) or stop-loss (SL) trigger order on an existing position. The trigger order will automatically close part or all of the position when the price hits the trigger level. Requires an open position for the given market/side. Returns an unsigned transaction. Up to 5 trigger orders per position.",
+    description: "Place a take-profit (TP) or stop-loss (SL) trigger order on an existing position. Up to 5 per position. " + "Use preview_tp_sl first to calculate optimal trigger prices. Returns unsigned transaction.",
     inputSchema: {
       market_symbol: exports_external.string().max(16).describe('Market symbol, e.g. "SOL", "BTC", "ETH"'),
       side: exports_external.enum(["LONG", "SHORT"]).describe("Position side"),
       trigger_price: exports_external.string().max(32).describe('Trigger price in UI format, e.g. "160.00"'),
       size_amount: exports_external.string().max(32).describe('Size in target token to close when triggered, e.g. "0.5"'),
-      is_stop_loss: exports_external.coerce.boolean().describe("true = stop-loss, false = take-profit"),
+      is_stop_loss: zBool.describe("true = stop-loss, false = take-profit"),
       owner: exports_external.string().regex(/^[1-9A-HJ-NP-Za-km-z]{32,44}$/).describe("Wallet pubkey (must own the position)")
     }
   }, async (params) => {
@@ -56981,19 +57175,21 @@ WARNING: ${res.err}`);
       lines.push(`
 Transaction (base64, unsigned — sign with wallet):`);
       lines.push(res.transactionBase64);
+      lines.push(`
+Next: After signing, call get_orders with owner to see the order ID for editing/canceling.`);
     }
     return { content: [{ type: "text", text: lines.join(`
 `) }] };
   });
   server.registerTool("edit_trigger_order", {
-    description: "Edit an existing take-profit or stop-loss trigger order. Change the trigger price, size, or order type without canceling and re-placing. Requires the order_id (0-7) from get_orders. Returns an unsigned transaction.",
+    description: "Edit an existing TP or SL trigger order. Change trigger price, size, or type. Requires order_id (0-7) from get_orders. Returns unsigned transaction.",
     inputSchema: {
       market_symbol: exports_external.string().max(16).describe('Market symbol, e.g. "SOL", "BTC", "ETH"'),
       side: exports_external.enum(["LONG", "SHORT"]).describe("Position side"),
       order_id: exports_external.coerce.number().describe("Index of the trigger order to edit (0-7)"),
       trigger_price: exports_external.string().max(32).describe("New trigger price in UI format"),
       size_amount: exports_external.string().max(32).describe("New size in target token"),
-      is_stop_loss: exports_external.coerce.boolean().describe("true = stop-loss, false = take-profit"),
+      is_stop_loss: zBool.describe("true = stop-loss, false = take-profit"),
       owner: exports_external.string().regex(/^[1-9A-HJ-NP-Za-km-z]{32,44}$/).describe("Wallet pubkey (must be original order owner)")
     }
   }, async (params) => {
@@ -57024,12 +57220,12 @@ Transaction (base64, unsigned — sign with wallet):`);
 `) }] };
   });
   server.registerTool("cancel_trigger_order", {
-    description: "Cancel a single take-profit or stop-loss trigger order. Requires the order_id (0-7) from get_orders. Returns an unsigned transaction.",
+    description: "Cancel a single TP or SL trigger order. Requires order_id (0-7) from get_orders. Returns unsigned transaction.",
     inputSchema: {
       market_symbol: exports_external.string().max(16).describe('Market symbol, e.g. "SOL", "BTC", "ETH"'),
       side: exports_external.enum(["LONG", "SHORT"]).describe("Position side"),
       order_id: exports_external.coerce.number().describe("Index of the trigger order to cancel (0-7)"),
-      is_stop_loss: exports_external.coerce.boolean().describe("true = stop-loss, false = take-profit"),
+      is_stop_loss: zBool.describe("true = stop-loss, false = take-profit"),
       owner: exports_external.string().regex(/^[1-9A-HJ-NP-Za-km-z]{32,44}$/).describe("Wallet pubkey (must own the order)")
     }
   }, async (params) => {
@@ -57056,7 +57252,7 @@ Transaction (base64, unsigned — sign with wallet):`);
 `) }] };
   });
   server.registerTool("cancel_all_trigger_orders", {
-    description: "Cancel ALL take-profit and stop-loss trigger orders for a market+side. Removes all TP and SL orders in one transaction. Returns an unsigned transaction.",
+    description: "Cancel ALL TP and SL trigger orders for a market+side in one transaction. Returns unsigned transaction.",
     inputSchema: {
       market_symbol: exports_external.string().max(16).describe('Market symbol, e.g. "SOL", "BTC", "ETH"'),
       side: exports_external.enum(["LONG", "SHORT"]).describe("Position side"),
@@ -57095,6 +57291,8 @@ function registerReadTools(server, client) {
   registerPositionTools(server, client);
   registerOrderTools(server, client);
   registerPoolDataTools(server, client);
+  registerAccountSummaryTool(server, client);
+  registerTradingOverviewTool(server, client);
 }
 function registerTransactionTools(server, client) {
   registerOpenPositionTool(server, client);
@@ -57178,7 +57376,7 @@ try {
   const client = new FlashApiClient(config2);
   const server = new McpServer({
     name: "flash-trade",
-    version: "0.3.4"
+    version: "0.4.0"
   }, {
     capabilities: {
       tools: {},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flash-trade-mcp",
-  "version": "0.3.4",
+  "version": "0.4.0",
   "description": "MCP server for Flash Trade — perpetual futures DEX on Solana. Provides AI agents with typed tools for trading, position management, and market data.",
   "module": "src/index.ts",
   "main": "dist/index.js",