flash-trade-mcp 0.3.1 → 0.3.3

package/dist/index.js

@@ -49207,6 +49207,18 @@ class FlashApiClient {
   async reversePosition(req) {
     return this.post("/transaction-builder/reverse-position", req);
   }
+  async placeTriggerOrder(req) {
+    return this.post("/transaction-builder/place-trigger-order", req);
+  }
+  async editTriggerOrder(req) {
+    return this.post("/transaction-builder/edit-trigger-order", req);
+  }
+  async cancelTriggerOrder(req) {
+    return this.post("/transaction-builder/cancel-trigger-order", req);
+  }
+  async cancelAllTriggerOrders(req) {
+    return this.post("/transaction-builder/cancel-all-trigger-orders", req);
+  }
   async previewLimitOrderFees(req) {
     return this.post("/preview/limit-order-fees", req);
   }
@@ -49229,8 +49241,9 @@ function registerHealthTools(server, client) {
     const health = await client.getHealth();
     const lines = [`Status: ${health.status}`];
     for (const [key, val] of Object.entries(health)) {
-      if (key !== "status")
-        lines.push(`${key}: ${val}`);
+      if (key !== "status") {
+        lines.push(`${key}: ${typeof val === "object" ? JSON.stringify(val) : val}`);
+      }
     }
     return { content: [{ type: "text", text: lines.join(`
 `) }] };
@@ -49329,7 +49342,21 @@ function registerPoolTools(server, client) {
     description: "List all liquidity pools on Flash Trade. Pools hold the collateral that backs perpetual positions. Returns pool addresses and configuration."
   }, async () => {
     const pools = await client.getPools();
-    return { content: [{ type: "text", text: JSON.stringify(pools, null, 2) }] };
+    const lines = [
+      `${pools.length} pools available:
+`,
+      "Pool Name      | Custodies | Pubkey",
+      "---------------|-----------|----------------------------------------------"
+    ];
+    for (const p of pools) {
+      const name = (p.account?.name ?? "Unknown").padEnd(15);
+      const custodyCount = String(p.account?.custodies?.length ?? 0).padEnd(10);
+      lines.push(`${name}| ${custodyCount}| ${p.pubkey}`);
+    }
+    lines.push(`
+Use get_pool with a pubkey for full details. Use get_pool_data for AUM and utilization metrics.`);
+    return { content: [{ type: "text", text: lines.join(`
+`) }] };
   });
   server.registerTool("get_pool", {
     description: "Get detailed information about a specific pool by its on-chain account pubkey.",
@@ -49379,14 +49406,14 @@ function registerPriceTools(server, client) {
   }, async ({ symbol: symbol2 }) => {
     const data = await client.getPrice(symbol2);
     const usd = formatPrice(data.price, data.exponent);
-    return {
-      content: [{
-        type: "text",
-        text: `${symbol2.toUpperCase()}: $${usd}
-Raw: ${data.price} (exp: ${data.exponent})
-Timestamp: ${data.timestamp}`
-      }]
-    };
+    const lines = [
+      `${symbol2.toUpperCase()}: $${usd}`,
+      `Raw: ${data.price} (exp: ${data.exponent})`
+    ];
+    if (data.timestamp)
+      lines.push(`Timestamp: ${data.timestamp}`);
+    return { content: [{ type: "text", text: lines.join(`
+`) }] };
   });
 }
 
@@ -49494,8 +49521,26 @@ function registerPoolDataTools(server, client) {
       const snapshot = await client.getPoolSnapshot(pool_pubkey);
       return { content: [{ type: "text", text: JSON.stringify(snapshot, null, 2) }] };
     }
-    const data = await client.getPoolData();
-    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+    const raw = await client.getPoolData();
+    const pools = raw.pools ?? raw;
+    const lines = [
+      `${pools.length} pools:
+`,
+      "Pool           | AUM          | LP Price | Stable% | Custodies",
+      "---------------|--------------|----------|---------|----------"
+    ];
+    for (const p of pools) {
+      const name = (p.poolName ?? "Unknown").padEnd(15);
+      const aum = `$${p.lpStats?.totalPoolValueUsd ?? "?"}`.padEnd(14);
+      const lp = `$${p.lpStats?.lpPrice ?? "?"}`.padEnd(9);
+      const stable = `${p.lpStats?.stableCoinPercentage ?? "?"}%`.padEnd(8);
+      const custodies = (p.custodyStats ?? []).map((c) => c.symbol).join(", ");
+      lines.push(`${name}| ${aum}| ${lp}| ${stable}| ${custodies}`);
+    }
+    lines.push(`
+Use get_pool_data with pool_pubkey for full custody stats.`);
+    return { content: [{ type: "text", text: lines.join(`
+`) }] };
   });
 }
 
@@ -49556,7 +49601,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.boolean().optional().describe("Enable degen mode (higher leverage limits)")
+      degen_mode: exports_external.coerce.boolean().optional().describe("Enable degen mode (higher leverage limits)")
     }
   }, async (params) => {
     const res = await client.openPosition({
@@ -49573,12 +49618,21 @@ function registerOpenPositionTool(server, client) {
       stopLoss: params.stop_loss,
       degenMode: params.degen_mode
     });
-    const text = formatOpenPreview({
+    let text = formatOpenPreview({
       outputTokenSymbol: params.output_token_symbol,
       tradeType: params.trade_type,
       inputTokenSymbol: params.input_token_symbol,
       inputAmountUi: params.input_amount
     }, res);
+    if (params.take_profit || params.stop_loss) {
+      const collateral = parseFloat(res.youPayUsdUi || "0");
+      const fee = parseFloat(res.entryFee || "0");
+      if (collateral - fee < 10) {
+        text += `
+
+WARNING: Collateral after fees is below $10. Take-profit and stop-loss orders require >$10 collateral and will FAIL on-chain. Use at least $11-12 input_amount.`;
+      }
+    }
     return { content: [{ type: "text", text }] };
   });
 }
@@ -49621,7 +49675,7 @@ function registerClosePositionTool(server, client) {
       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.boolean().optional().describe("Keep leverage constant during partial close"),
+      keep_leverage_same: exports_external.coerce.boolean().optional().describe("Keep leverage constant during partial close"),
       slippage_percentage: exports_external.string().max(8).optional().describe('Default: "0.5" (0.5%)')
     }
   }, async (params) => {
@@ -49755,7 +49809,7 @@ function registerReversePositionTool(server, client) {
       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.boolean().optional().describe("Enable degen mode for the new position")
+      degen_mode: exports_external.coerce.boolean().optional().describe("Enable degen mode for the new position")
     }
   }, async (params) => {
     const res = await client.reversePosition({
@@ -56893,6 +56947,152 @@ 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.",
+    inputSchema: {
+      market_symbol: exports_external.string().max(16).describe('Market symbol, e.g. "SOL", "BTC", "ETH"'),
+      collateral_symbol: exports_external.string().max(16).describe('Collateral token, e.g. "USDC", "JITOSOL"'),
+      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"),
+      owner: exports_external.string().regex(/^[1-9A-HJ-NP-Za-km-z]{32,44}$/).describe("Wallet pubkey (must own the position)")
+    }
+  }, async (params) => {
+    const res = await client.placeTriggerOrder({
+      marketSymbol: params.market_symbol,
+      collateralSymbol: params.collateral_symbol,
+      side: params.side,
+      triggerPriceUi: params.trigger_price,
+      sizeAmountUi: params.size_amount,
+      isStopLoss: params.is_stop_loss,
+      owner: params.owner
+    });
+    const lines = [
+      `=== Place ${params.is_stop_loss ? "Stop-Loss" : "Take-Profit"} Order ===`,
+      `Market: ${params.market_symbol} ${params.side}`,
+      `Trigger: $${params.trigger_price}`,
+      `Size: ${params.size_amount} ${params.market_symbol}`
+    ];
+    if (res.err)
+      lines.push(`
+WARNING: ${res.err}`);
+    if (res.transactionBase64) {
+      lines.push(`
+Transaction (base64, unsigned — sign with wallet):`);
+      lines.push(res.transactionBase64);
+    }
+    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.",
+    inputSchema: {
+      market_symbol: exports_external.string().max(16).describe('Market symbol, e.g. "SOL", "BTC", "ETH"'),
+      collateral_symbol: exports_external.string().max(16).describe('Collateral token, e.g. "USDC", "JITOSOL"'),
+      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"),
+      owner: exports_external.string().regex(/^[1-9A-HJ-NP-Za-km-z]{32,44}$/).describe("Wallet pubkey (must be original order owner)")
+    }
+  }, async (params) => {
+    const res = await client.editTriggerOrder({
+      marketSymbol: params.market_symbol,
+      collateralSymbol: params.collateral_symbol,
+      side: params.side,
+      orderId: params.order_id,
+      triggerPriceUi: params.trigger_price,
+      sizeAmountUi: params.size_amount,
+      isStopLoss: params.is_stop_loss,
+      owner: params.owner
+    });
+    const lines = [
+      `=== Edit ${params.is_stop_loss ? "Stop-Loss" : "Take-Profit"} Order #${params.order_id} ===`,
+      `Market: ${params.market_symbol} ${params.side}`,
+      `New Trigger: $${params.trigger_price}`,
+      `New Size: ${params.size_amount} ${params.market_symbol}`
+    ];
+    if (res.err)
+      lines.push(`
+WARNING: ${res.err}`);
+    if (res.transactionBase64) {
+      lines.push(`
+Transaction (base64, unsigned — sign with wallet):`);
+      lines.push(res.transactionBase64);
+    }
+    return { content: [{ type: "text", text: lines.join(`
+`) }] };
+  });
+  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.",
+    inputSchema: {
+      market_symbol: exports_external.string().max(16).describe('Market symbol, e.g. "SOL", "BTC", "ETH"'),
+      collateral_symbol: exports_external.string().max(16).describe('Collateral token, e.g. "USDC", "JITOSOL"'),
+      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"),
+      owner: exports_external.string().regex(/^[1-9A-HJ-NP-Za-km-z]{32,44}$/).describe("Wallet pubkey (must own the order)")
+    }
+  }, async (params) => {
+    const res = await client.cancelTriggerOrder({
+      marketSymbol: params.market_symbol,
+      collateralSymbol: params.collateral_symbol,
+      side: params.side,
+      orderId: params.order_id,
+      isStopLoss: params.is_stop_loss,
+      owner: params.owner
+    });
+    const lines = [
+      `=== Cancel ${params.is_stop_loss ? "Stop-Loss" : "Take-Profit"} Order #${params.order_id} ===`,
+      `Market: ${params.market_symbol} ${params.side}`
+    ];
+    if (res.err)
+      lines.push(`
+WARNING: ${res.err}`);
+    if (res.transactionBase64) {
+      lines.push(`
+Transaction (base64, unsigned — sign with wallet):`);
+      lines.push(res.transactionBase64);
+    }
+    return { content: [{ type: "text", text: lines.join(`
+`) }] };
+  });
+  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.",
+    inputSchema: {
+      market_symbol: exports_external.string().max(16).describe('Market symbol, e.g. "SOL", "BTC", "ETH"'),
+      collateral_symbol: exports_external.string().max(16).describe('Collateral token, e.g. "USDC", "JITOSOL"'),
+      side: exports_external.enum(["LONG", "SHORT"]).describe("Position side"),
+      owner: exports_external.string().regex(/^[1-9A-HJ-NP-Za-km-z]{32,44}$/).describe("Wallet pubkey (must own the orders)")
+    }
+  }, async (params) => {
+    const res = await client.cancelAllTriggerOrders({
+      marketSymbol: params.market_symbol,
+      collateralSymbol: params.collateral_symbol,
+      side: params.side,
+      owner: params.owner
+    });
+    const lines = [
+      `=== Cancel All Trigger Orders ===`,
+      `Market: ${params.market_symbol} ${params.side}`
+    ];
+    if (res.err)
+      lines.push(`
+WARNING: ${res.err}`);
+    if (res.transactionBase64) {
+      lines.push(`
+Transaction (base64, unsigned — sign with wallet):`);
+      lines.push(res.transactionBase64);
+    }
+    return { content: [{ type: "text", text: lines.join(`
+`) }] };
+  });
+}
+
 // src/tools/index.ts
 function registerReadTools(server, client) {
   registerHealthTools(server, client);
@@ -56909,6 +57109,7 @@ function registerTransactionTools(server, client) {
   registerClosePositionTool(server, client);
   registerCollateralTools(server, client);
   registerReversePositionTool(server, client);
+  registerTriggerOrderTools(server, client);
   registerSignAndSendTool(server);
 }
 
@@ -56985,7 +57186,7 @@ try {
   const client = new FlashApiClient(config2);
   const server = new McpServer({
     name: "flash-trade",
-    version: "0.3.1"
+    version: "0.3.3"
   }, {
     capabilities: {
       tools: {},

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flash-trade-mcp",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "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",