@michaleffffff/mcp-trading-server 2.3.6 → 2.4.0

package/dist/server.js

@@ -81,7 +81,7 @@ function zodSchemaToJsonSchema(zodSchema) {
     };
 }
 // ─── MCP Server ───
-const server = new Server({ name: "myx-mcp-trading-server", version: "2.3.6" }, { capabilities: { tools: {}, resources: {}, prompts: {} } });
+const server = new Server({ name: "myx-mcp-trading-server", version: "2.4.0" }, { capabilities: { tools: {}, resources: {}, prompts: {} } });
 // List tools
 server.setRequestHandler(ListToolsRequestSchema, async () => {
     return {
@@ -181,7 +181,7 @@ server.setRequestHandler(GetPromptRequestSchema, async (request) => {
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    logger.info("🚀 MYX Trading MCP Server v2.3.6 running (stdio, pure on-chain, prod ready)");
+    logger.info("🚀 MYX Trading MCP Server v2.4.0 running (stdio, pure on-chain, prod ready)");
 }
 main().catch((err) => {
     logger.error("Fatal Server Startup Error", err);

package/dist/services/marketService.js

@@ -1,15 +1,15 @@
 import { getChainId } from "../auth/resolveClient.js";
 import { getMarketStateDesc } from "../utils/mappings.js";
-export async function getMarketPrice(client, poolId) {
-    const chainId = getChainId();
+export async function getMarketPrice(client, poolId, chainIdOverride) {
+    const chainId = chainIdOverride ?? getChainId();
     const ticker = await client.markets.getTickerList({
         chainId,
         poolIds: [poolId],
     });
     return ticker?.data?.[0] ?? null;
 }
-export async function getOraclePrice(client, poolId) {
-    const chainId = getChainId();
+export async function getOraclePrice(client, poolId, chainIdOverride) {
+    const chainId = chainIdOverride ?? getChainId();
     return client.utils.getOraclePrice(poolId, chainId);
 }
 export async function searchMarket(client, keyword, limit = 1000) {
@@ -57,8 +57,8 @@ export async function searchMarket(client, keyword, limit = 1000) {
         };
     });
 }
-export async function getMarketDetail(client, poolId) {
-    const chainId = getChainId();
+export async function getMarketDetail(client, poolId, chainIdOverride) {
+    const chainId = chainIdOverride ?? getChainId();
     const res = await client.markets.getMarketDetail({ chainId, poolId });
     // Ensure it's returned as { data: ... } for consistency with other services if needed, 
     // but looking at existing tools, they often stringify the whole result.
@@ -74,7 +74,7 @@ export async function getPoolList(client) {
 /**
  * 获取池子分级配置
  */
-export async function getPoolLevelConfig(client, poolId) {
-    const chainId = getChainId();
+export async function getPoolLevelConfig(client, poolId, chainIdOverride) {
+    const chainId = chainIdOverride ?? getChainId();
     return client.api.getPoolLevelConfig({ poolId, chainId });
 }

package/dist/services/poolService.js

@@ -12,58 +12,58 @@ export async function createPool(baseToken, marketId) {
 /**
  * 获取池子信息
  */
-export async function getPoolInfo(poolId) {
-    const chainId = getChainId();
+export async function getPoolInfo(poolId, chainIdOverride) {
+    const chainId = chainIdOverride ?? getChainId();
     return pool.getPoolInfo(chainId, poolId);
 }
 /**
  * 获取池子详情
  */
-export async function getPoolDetail(poolId) {
-    const chainId = getChainId();
+export async function getPoolDetail(poolId, chainIdOverride) {
+    const chainId = chainIdOverride ?? getChainId();
     return pool.getPoolDetail(chainId, poolId);
 }
 /**
  * 获取流动性信息
  */
-export async function getLiquidityInfo(client, poolId, marketPrice) {
-    const chainId = getChainId();
+export async function getLiquidityInfo(client, poolId, marketPrice, chainIdOverride) {
+    const chainId = chainIdOverride ?? getChainId();
     const price30 = ensureUnits(marketPrice, 30, "marketPrice");
     return client.utils.getLiquidityInfo({ chainId, poolId, marketPrice: price30 });
 }
 /**
  * Quote 池 deposit
  */
-export async function quoteDeposit(poolId, amount, slippage) {
-    const chainId = getChainId();
+export async function quoteDeposit(poolId, amount, slippage, chainIdOverride) {
+    const chainId = chainIdOverride ?? getChainId();
     return quote.deposit({ chainId, poolId, amount, slippage });
 }
 /**
  * Quote 池 withdraw
  */
-export async function quoteWithdraw(poolId, amount, slippage) {
-    const chainId = getChainId();
+export async function quoteWithdraw(poolId, amount, slippage, chainIdOverride) {
+    const chainId = chainIdOverride ?? getChainId();
     return quote.withdraw({ chainId, poolId, amount, slippage });
 }
 /**
  * Base 池 deposit
  */
-export async function baseDeposit(poolId, amount, slippage) {
-    const chainId = getChainId();
+export async function baseDeposit(poolId, amount, slippage, chainIdOverride) {
+    const chainId = chainIdOverride ?? getChainId();
     return base.deposit({ chainId, poolId, amount, slippage });
 }
 /**
  * Base 池 withdraw
  */
-export async function baseWithdraw(poolId, amount, slippage) {
-    const chainId = getChainId();
+export async function baseWithdraw(poolId, amount, slippage, chainIdOverride) {
+    const chainId = chainIdOverride ?? getChainId();
     return base.withdraw({ chainId, poolId, amount, slippage });
 }
 /**
  * 获取 LP 价格
  */
-export async function getLpPrice(poolType, poolId) {
-    const chainId = getChainId();
+export async function getLpPrice(poolType, poolId, chainIdOverride) {
+    const chainId = chainIdOverride ?? getChainId();
     if (poolType === "BASE") {
         return base.getLpPrice(chainId, poolId);
     }

package/dist/services/tradeService.js

@@ -1,7 +1,7 @@
 import { Direction, OrderType, TriggerType } from "@myx-trade/sdk";
 import { parseUnits } from "ethers";
 import { getChainId, getQuoteToken, getQuoteDecimals } from "../auth/resolveClient.js";
-import { ensureUnits, parseHumanUnits } from "../utils/units.js";
+import { ensureUnits } from "../utils/units.js";
 import { normalizeAddress } from "../utils/address.js";
 /**
  * 将人类可读数值转为指定精度的整数字串
@@ -35,7 +35,7 @@ export async function openPosition(client, address, args) {
     let calcPrice30;
     let orderPrice30;
     if (args.price) {
-        const limitPrice30 = parseHumanUnits(args.price, 30, "price");
+        const limitPrice30 = ensureUnits(args.price, 30, "price");
         calcPrice30 = limitPrice30;
         orderPrice30 = limitPrice30;
     }
@@ -46,7 +46,7 @@ export async function openPosition(client, address, args) {
         console.error(`[Market Order] Fetched oracle price for size math: ${calcPrice30}`);
     }
     // 保证金转为 quote token 精度
-    const collateralWei = parseHumanUnits(args.collateralAmount, quoteDecimals, "collateralAmount");
+    const collateralWei = ensureUnits(args.collateralAmount, quoteDecimals, "collateralAmount");
     // 仓位大小 (size): 在 MYX 这一版中，size 表示 Base Token（WETH）的数量，精度通常为 18
     // 计算公式：size = (collateral * leverage) / price
     // 为了防止浮点溢出，我们可以全部转为 BigInt 计算
@@ -85,11 +85,11 @@ export async function openPosition(client, address, args) {
     };
     // 可选止盈止损
     if (args.tpPrice) {
-        orderParams.tpPrice = parseHumanUnits(args.tpPrice, 30, "tpPrice");
+        orderParams.tpPrice = ensureUnits(args.tpPrice, 30, "tpPrice");
         orderParams.tpSize = size;
     }
     if (args.slPrice) {
-        orderParams.slPrice = parseHumanUnits(args.slPrice, 30, "slPrice");
+        orderParams.slPrice = ensureUnits(args.slPrice, 30, "slPrice");
         orderParams.slSize = size;
     }
     // tradingFee: SDK 第二个参数
@@ -111,7 +111,7 @@ export async function closePosition(client, address, args) {
     if (args.direction === undefined || args.direction === null) {
         throw new Error("direction is required (0=LONG, 1=SHORT), must match position direction.");
     }
-    const price30 = parseHumanUnits(args.price, 30, "price");
+    const price30 = ensureUnits(args.price, 30, "price");
     const sizeWei = ensureUnits(args.size, 18, "size");
     const dir = resolveDirection(args.direction);
     return client.order.createDecreaseOrder({
@@ -125,6 +125,7 @@ export async function closePosition(client, address, args) {
         collateralAmount: "0",
         size: sizeWei,
         price: price30,
+        timeInForce: 0,
         postOnly: false,
         slippagePct: args.slippagePct ?? "100",
         executionFeeToken: quoteToken,
@@ -151,14 +152,14 @@ export async function setPositionTpSl(client, address, args) {
         executionFeeToken: quoteToken,
         tpTriggerType: args.direction === 0 ? TriggerType.GTE : TriggerType.LTE,
         slTriggerType: args.direction === 0 ? TriggerType.LTE : TriggerType.GTE,
-        slippagePct: "100", // 默认 100 BPS = 1%
+        slippagePct: args.slippagePct ?? "100",
     };
     if (args.tpPrice) {
-        params.tpPrice = parseHumanUnits(args.tpPrice, 30, "tpPrice");
+        params.tpPrice = ensureUnits(args.tpPrice, 30, "tpPrice");
         params.tpSize = args.tpSize || "0";
     }
     if (args.slPrice) {
-        params.slPrice = parseHumanUnits(args.slPrice, 30, "slPrice");
+        params.slPrice = ensureUnits(args.slPrice, 30, "slPrice");
         params.slSize = args.slSize || "0";
     }
     return client.order.createPositionTpSlOrder(params);
@@ -173,7 +174,7 @@ export async function adjustMargin(client, address, args) {
     return client.position.adjustCollateral({
         poolId: args.poolId,
         positionId: args.positionId,
-        adjustAmount: parseHumanUnits(args.adjustAmount, quoteDecimals, "adjustAmount"),
+        adjustAmount: ensureUnits(args.adjustAmount, quoteDecimals, "adjustAmount"),
         quoteToken,
         chainId,
         address,
@@ -234,14 +235,14 @@ export async function updateOrderTpSl(client, address, args) {
     const quoteToken = normalizeAddress(args.quoteToken || getQuoteToken(), "quoteToken");
     const params = {
         orderId: args.orderId,
-        tpSize: args.tpSize || "0",
-        tpPrice: args.tpPrice ? parseHumanUnits(args.tpPrice, 30, "tpPrice") : "0",
-        slSize: args.slSize || "0",
-        slPrice: args.slPrice ? parseHumanUnits(args.slPrice, 30, "slPrice") : "0",
+        tpSize: args.tpSize ? ensureUnits(args.tpSize, 18, "tpSize") : "0",
+        tpPrice: args.tpPrice ? ensureUnits(args.tpPrice, 30, "tpPrice") : "0",
+        slSize: args.slSize ? ensureUnits(args.slSize, 18, "slSize") : "0",
+        slPrice: args.slPrice ? ensureUnits(args.slPrice, 30, "slPrice") : "0",
         useOrderCollateral: args.useOrderCollateral ?? true,
         executionFeeToken: quoteToken,
-        size: args.size || "0",
-        price: args.price || "0",
+        size: args.size ? ensureUnits(args.size, 18, "size") : "0",
+        price: args.price ? ensureUnits(args.price, 30, "price") : "0",
     };
     return client.order.updateOrderTpSl(params, quoteToken, chainId, address, args.marketId, args.isTpSlOrder ?? true);
 }

package/dist/tools/accountInfo.js

@@ -40,6 +40,7 @@ export const getTradeFlowTool = {
     name: "get_trade_flow",
     description: "Get account trade flow / transaction history.",
     schema: {
+        poolId: z.string().optional().describe("Optional pool ID filter."),
         page: z.coerce.number().optional().describe("Page number (default 1)"),
         limit: z.coerce.number().optional().describe("Results per page (default 20)"),
     },
@@ -47,7 +48,7 @@ export const getTradeFlowTool = {
         try {
             const { client, address } = await resolveClient();
             const chainId = getChainId();
-            const query = { chainId, page: args.page ?? 1, limit: args.limit ?? 20 };
+            const query = { chainId, poolId: args.poolId, page: args.page ?? 1, limit: args.limit ?? 20 };
             const result = await client.account.getTradeFlow(query, address);
             const enhancedData = (result?.data || []).map((flow) => ({
                 ...flow,

package/dist/tools/adjustMargin.js

@@ -7,7 +7,7 @@ export const adjustMarginTool = {
     schema: {
         poolId: z.string().describe("Pool ID"),
         positionId: z.string().describe("Position ID"),
-        adjustAmount: z.string().describe("Amount in token decimals. Positive = add, negative = remove."),
+        adjustAmount: z.string().describe("SDK standard: quote token raw units. Positive = add, negative = remove. Compatibility: human-readable decimals are also accepted."),
         quoteToken: z.string().optional().describe("Quote token address"),
     },
     handler: async (args) => {

package/dist/tools/cancelOrder.js

@@ -4,15 +4,16 @@ export const cancelOrderTool = {
     name: "cancel_order",
     description: "Cancel an open order by its order ID.",
     schema: {
-        orderIds: z.array(z.string()).describe("Array of order IDs to cancel"),
+        orderId: z.string().optional().describe("Single order ID to cancel"),
+        orderIds: z.array(z.string()).optional().describe("Array of order IDs to cancel"),
     },
     handler: async (args) => {
         try {
             const { client } = await resolveClient();
             const chainId = getChainId();
-            const ids = args.orderIds;
+            const ids = args.orderId ? [args.orderId] : (Array.isArray(args.orderIds) ? args.orderIds : []);
             if (!ids || ids.length === 0)
-                throw new Error("orderIds array is required.");
+                throw new Error("orderId or orderIds is required.");
             let result;
             if (ids.length === 1) {
                 result = await client.order.cancelOrder(ids[0], chainId);

package/dist/tools/closeAllPositions.js

@@ -2,12 +2,13 @@ import { z } from "zod";
 import { resolveClient, getChainId, getQuoteToken } from "../auth/resolveClient.js";
 import { getOraclePrice } from "../services/marketService.js";
 import { ensureUnits } from "../utils/units.js";
+import { bpsLikeString } from "../utils/schema.js";
 export const closeAllPositionsTool = {
     name: "close_all_positions",
     description: "Emergency: close ALL open positions in a pool at once. Use for risk management.",
     schema: {
         poolId: z.string().describe("Pool ID to close all positions in"),
-        slippagePct: z.string().optional().describe("Slippage in bps (default '200' = 2% for emergency)"),
+        slippagePct: bpsLikeString.optional().describe("Slippage in bps (4-digit precision): 1 = 0.01%, default 200 = 2% for emergency"),
     },
     handler: async (args) => {
         try {

package/dist/tools/closePosition.js

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { resolveClient } from "../auth/resolveClient.js";
 import { closePosition as closePos } from "../services/tradeService.js";
+import { bpsLikeString } from "../utils/schema.js";
 export const closePositionTool = {
     name: "close_position",
     description: "Close an open position.",
@@ -11,9 +12,9 @@ export const closePositionTool = {
             message: "direction must be 0 (LONG) or 1 (SHORT)",
         }).describe("0 = LONG, 1 = SHORT (must match position direction)"),
         leverage: z.coerce.number().describe("Position leverage"),
-        size: z.string().describe("Size to close (human-readable or 18-decimal raw units)"),
-        price: z.string().describe("Price in human-readable units"),
-        slippagePct: z.string().optional().describe("Slippage in bps, default '100'"),
+        size: z.string().describe("SDK standard: 18-decimal raw size. Compatibility: human-readable decimals are also accepted."),
+        price: z.string().describe("SDK standard: 30-decimal raw price. Compatibility: human-readable decimals are also accepted."),
+        slippagePct: bpsLikeString.optional().describe("Slippage in bps (4-digit precision): 1 = 0.01%, default 100 = 1%"),
         quoteToken: z.string().optional().describe("Quote token address"),
     },
     handler: async (args) => {

package/dist/tools/executeTrade.js

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { resolveClient } from "../auth/resolveClient.js";
 import { openPosition } from "../services/tradeService.js";
+import { bpsLikeString } from "../utils/schema.js";
 export const executeTradeTool = {
     name: "execute_trade",
     description: "Execute a new trade or add to an existing position.",
@@ -9,15 +10,15 @@ export const executeTradeTool = {
         direction: z.coerce.number().int().refine((value) => value === 0 || value === 1, {
             message: "direction must be 0 (LONG) or 1 (SHORT)",
         }).describe("0 = LONG, 1 = SHORT"),
-        collateralAmount: z.string().describe("Collateral in human-readable units (e.g. '100' for 100 USDC)"),
+        collateralAmount: z.string().describe("SDK standard: quote token raw units. Compatibility: human-readable decimals are also accepted."),
         leverage: z.coerce.number().optional().describe("Leverage multiplier (e.g. 10, default 10)"),
-        price: z.string().optional().describe("Limit price in human-readable units (e.g. '3000'). Required for LIMIT orders, omitted for MARKET orders."),
+        price: z.string().optional().describe("SDK standard: 30-decimal raw price for LIMIT orders. Compatibility: human-readable decimals are also accepted."),
         quoteToken: z.string().optional().describe("Quote token address. Uses env default if omitted."),
         quoteDecimals: z.coerce.number().optional().describe("Quote token decimals (default 6)."),
-        slippagePct: z.string().optional().describe("Slippage in bps, default '100' = 1%"),
+        slippagePct: bpsLikeString.optional().describe("Slippage in bps (4-digit precision): 1 = 0.01%, default 100 = 1%"),
         positionId: z.string().optional().describe("Existing position ID to add to. Default '0' = new position."),
-        tpPrice: z.string().optional().describe("Take-profit price (human-readable)"),
-        slPrice: z.string().optional().describe("Stop-loss price (human-readable)"),
+        tpPrice: z.string().optional().describe("SDK standard: 30-decimal raw TP price. Compatibility: human-readable decimals are also accepted."),
+        slPrice: z.string().optional().describe("SDK standard: 30-decimal raw SL price. Compatibility: human-readable decimals are also accepted."),
     },
     handler: async (args) => {
         try {

package/dist/tools/getBaseDetail.js

@@ -1,17 +1,71 @@
 import { z } from "zod";
 import { resolveClient, getChainId } from "../auth/resolveClient.js";
+function normalizeLower(value) {
+    return String(value ?? "").trim().toLowerCase();
+}
+function collectRows(input) {
+    if (Array.isArray(input)) {
+        return input.flatMap((item) => collectRows(item));
+    }
+    if (!input || typeof input !== "object") {
+        return [];
+    }
+    if (input.poolId || input.pool_id) {
+        return [input];
+    }
+    return Object.values(input).flatMap((value) => collectRows(value));
+}
+function findPoolIdByBaseAddress(rows, baseAddress) {
+    const target = normalizeLower(baseAddress);
+    if (!target)
+        return null;
+    for (const row of rows) {
+        const candidates = [
+            row.baseToken,
+            row.base_token,
+            row.baseAddress,
+            row.base_address,
+            row.base,
+            row.tokenAddress,
+            row.token_address,
+        ];
+        const hit = candidates.some((candidate) => normalizeLower(candidate) === target);
+        if (!hit)
+            continue;
+        const poolId = row.poolId || row.pool_id;
+        if (poolId) {
+            return String(poolId);
+        }
+    }
+    return null;
+}
 export const getBaseDetailTool = {
     name: "get_base_detail",
-    description: "Get base asset detail metrics for a pool.",
+    description: "Get base asset detail metrics. SDK doc uses baseAddress; MCP also accepts poolId for compatibility.",
     schema: {
-        poolId: z.string().describe("Pool ID"),
+        baseAddress: z.string().optional().describe("SDK doc parameter: base token address."),
+        poolId: z.string().optional().describe("Compatibility parameter: pool ID."),
         chainId: z.coerce.number().optional().describe("Optional chainId override"),
     },
     handler: async (args) => {
         try {
             const { client } = await resolveClient();
             const chainId = args.chainId ?? getChainId();
-            const result = await client.markets.getBaseDetail({ chainId, poolId: args.poolId });
+            let poolId = args.poolId;
+            if (!poolId && args.baseAddress) {
+                const sources = await Promise.allSettled([
+                    client.api.getPoolList(),
+                    client.api.getMarketList(),
+                ]);
+                const rows = sources
+                    .filter((result) => result.status === "fulfilled")
+                    .flatMap((result) => collectRows(result.value));
+                poolId = findPoolIdByBaseAddress(rows, args.baseAddress) || undefined;
+            }
+            if (!poolId) {
+                throw new Error("poolId is required. If using baseAddress, no matching pool was found.");
+            }
+            const result = await client.markets.getBaseDetail({ chainId, poolId });
             return { content: [{ type: "text", text: JSON.stringify({ status: "success", data: result }, (_, v) => typeof v === "bigint" ? v.toString() : v, 2) }] };
         }
         catch (error) {

package/dist/tools/getMarketPrice.js

@@ -1,16 +1,18 @@
 import { z } from "zod";
-import { resolveClient } from "../auth/resolveClient.js";
+import { resolveClient, getChainId } from "../auth/resolveClient.js";
 import { getMarketPrice } from "../services/marketService.js";
 export const getMarketPriceTool = {
     name: "get_market_price",
     description: "Get the current market price for a specific pool.",
     schema: {
         poolId: z.string().describe("Pool ID to get price for"),
+        chainId: z.coerce.number().optional().describe("Optional chainId override"),
     },
     handler: async (args) => {
         try {
             const { client } = await resolveClient();
-            const data = await getMarketPrice(client, args.poolId);
+            const chainId = args.chainId ?? getChainId();
+            const data = await getMarketPrice(client, args.poolId, chainId);
             return { content: [{ type: "text", text: JSON.stringify({ status: "success", data }, (k, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
         }
         catch (error) {

package/dist/tools/getOraclePrice.js

@@ -1,16 +1,18 @@
 import { z } from "zod";
-import { resolveClient } from "../auth/resolveClient.js";
+import { resolveClient, getChainId } from "../auth/resolveClient.js";
 import { getOraclePrice } from "../services/marketService.js";
 export const getOraclePriceTool = {
     name: "get_oracle_price",
     description: "Get the current oracle price for a specific pool.",
     schema: {
         poolId: z.string().describe("Pool ID to get oracle price for"),
+        chainId: z.coerce.number().optional().describe("Optional chainId override"),
     },
     handler: async (args) => {
         try {
             const { client } = await resolveClient();
-            const data = await getOraclePrice(client, args.poolId);
+            const chainId = args.chainId ?? getChainId();
+            const data = await getOraclePrice(client, args.poolId, chainId);
             return { content: [{ type: "text", text: JSON.stringify({ status: "success", data }, (k, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
         }
         catch (error) {

package/dist/tools/manageLiquidity.js

@@ -1,9 +1,10 @@
 import { z } from "zod";
 import { quoteDeposit, quoteWithdraw, baseDeposit, baseWithdraw, getLpPrice, } from "../services/poolService.js";
 import { parseSafeNumber } from "../utils/units.js";
+import { lpSlippageLike } from "../utils/schema.js";
 export const manageLiquidityTool = {
     name: "manage_liquidity",
-    description: "Add or withdraw liquidity from a BASE or QUOTE pool. Amount is in human-readable units (e.g. 2000 for USDC, 0.01 for ETH).",
+    description: "Add or withdraw liquidity from a BASE or QUOTE pool. Amount is in human-readable units. SDK-standard slippage is ratio (0.01 = 1%), and BPS input is auto-compatible.",
     schema: {
         action: z.string().trim().toLowerCase().refine((value) => value === "deposit" || value === "withdraw", {
             message: "action must be 'deposit' or 'withdraw'.",
@@ -13,13 +14,14 @@ export const manageLiquidityTool = {
         }).describe("'BASE' or 'QUOTE'"),
         poolId: z.string().describe("Pool ID"),
         amount: z.union([z.number(), z.string()]).describe("Amount in human-readable units (e.g. 2000 for USDC, 0.01 for ETH)"),
-        slippage: z.union([z.number(), z.string()]).describe("Slippage tolerance (e.g. 0.01 = 1%)"),
+        slippage: lpSlippageLike.describe("SDK-standard LP slippage ratio (0.01 = 1%). BPS input is also accepted for compatibility (100 => 1%)."),
+        chainId: z.coerce.number().optional().describe("Optional chainId override"),
     },
     handler: async (args) => {
         try {
             const { action, poolType, poolId } = args;
             const amount = parseSafeNumber(args.amount, "amount");
-            const slippage = parseSafeNumber(args.slippage, "slippage");
+            const slippage = args.slippage;
             if (amount <= 0)
                 throw new Error("amount must be a positive number.");
             if (slippage < 0)
@@ -27,13 +29,13 @@ export const manageLiquidityTool = {
             let result;
             if (poolType === "QUOTE") {
                 result = action === "deposit"
-                    ? await quoteDeposit(poolId, amount, slippage)
-                    : await quoteWithdraw(poolId, amount, slippage);
+                    ? await quoteDeposit(poolId, amount, slippage, args.chainId)
+                    : await quoteWithdraw(poolId, amount, slippage, args.chainId);
             }
             else {
                 result = action === "deposit"
-                    ? await baseDeposit(poolId, amount, slippage)
-                    : await baseWithdraw(poolId, amount, slippage);
+                    ? await baseDeposit(poolId, amount, slippage, args.chainId)
+                    : await baseWithdraw(poolId, amount, slippage, args.chainId);
             }
             return { content: [{ type: "text", text: JSON.stringify({ status: "success", data: result }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
         }
@@ -50,10 +52,11 @@ export const getLpPriceTool = {
             message: "poolType must be 'BASE' or 'QUOTE'.",
         }).describe("'BASE' or 'QUOTE'"),
         poolId: z.string().describe("Pool ID"),
+        chainId: z.coerce.number().optional().describe("Optional chainId override"),
     },
     handler: async (args) => {
         try {
-            const data = await getLpPrice(args.poolType, args.poolId);
+            const data = await getLpPrice(args.poolType, args.poolId, args.chainId);
             return { content: [{ type: "text", text: JSON.stringify({ status: "success", data }, (k, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
         }
         catch (error) {

package/dist/tools/marketInfo.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { resolveClient } from "../auth/resolveClient.js";
+import { resolveClient, getChainId } from "../auth/resolveClient.js";
 import { getMarketDetail } from "../services/marketService.js";
 import { getPoolInfo, getLiquidityInfo } from "../services/poolService.js";
 export const getMarketDetailTool = {
@@ -7,11 +7,13 @@ export const getMarketDetailTool = {
     description: "Get detailed information for a specific trading pool (fee rates, open interest, etc.).",
     schema: {
         poolId: z.string().describe("Pool ID"),
+        chainId: z.coerce.number().optional().describe("Optional chainId override"),
     },
     handler: async (args) => {
         try {
             const { client } = await resolveClient();
-            const data = await getMarketDetail(client, args.poolId);
+            const chainId = args.chainId ?? getChainId();
+            const data = await getMarketDetail(client, args.poolId, chainId);
             return { content: [{ type: "text", text: JSON.stringify({ status: "success", data }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
         }
         catch (error) {
@@ -24,10 +26,12 @@ export const getPoolInfoTool = {
     description: "Get pool on-chain information (reserves, utilization, etc.).",
     schema: {
         poolId: z.string().describe("Pool ID"),
+        chainId: z.coerce.number().optional().describe("Optional chainId override"),
     },
     handler: async (args) => {
         try {
-            const data = await getPoolInfo(args.poolId);
+            const chainId = args.chainId ?? getChainId();
+            const data = await getPoolInfo(args.poolId, chainId);
             return { content: [{ type: "text", text: JSON.stringify({ status: "success", data }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
         }
         catch (error) {
@@ -41,11 +45,13 @@ export const getLiquidityInfoTool = {
     schema: {
         poolId: z.string().describe("Pool ID"),
         marketPrice: z.string().describe("Current market price (can be human-readable e.g. '0.69' or 30-decimal raw units)"),
+        chainId: z.coerce.number().optional().describe("Optional chainId override"),
     },
     handler: async (args) => {
         try {
             const { client } = await resolveClient();
-            const data = await getLiquidityInfo(client, args.poolId, args.marketPrice);
+            const chainId = args.chainId ?? getChainId();
+            const data = await getLiquidityInfo(client, args.poolId, args.marketPrice, chainId);
             return { content: [{ type: "text", text: JSON.stringify({ status: "success", data }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
         }
         catch (error) {

package/dist/tools/poolConfig.js

@@ -1,16 +1,18 @@
 import { z } from "zod";
-import { resolveClient } from "../auth/resolveClient.js";
+import { resolveClient, getChainId } from "../auth/resolveClient.js";
 import { getPoolLevelConfig } from "../services/marketService.js";
 export const getPoolLevelConfigTool = {
     name: "get_pool_level_config",
     description: "Get the level configuration and trading limits for a specific pool.",
     schema: {
         poolId: z.string().describe("Pool ID"),
+        chainId: z.coerce.number().optional().describe("Optional chainId override"),
     },
     handler: async (args) => {
         try {
             const { client } = await resolveClient();
-            const result = await getPoolLevelConfig(client, args.poolId);
+            const chainId = args.chainId ?? getChainId();
+            const result = await getPoolLevelConfig(client, args.poolId, chainId);
             return { content: [{ type: "text", text: JSON.stringify({ status: "success", data: result }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
         }
         catch (error) {

package/dist/tools/setTpSl.js

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { resolveClient } from "../auth/resolveClient.js";
 import { setPositionTpSl } from "../services/tradeService.js";
+import { bpsLikeString } from "../utils/schema.js";
 export const setTpSlTool = {
     name: "set_tp_sl",
     description: "Set take profit and stop loss prices for an open position.",
@@ -11,10 +12,11 @@ export const setTpSlTool = {
             message: "direction must be 0 (LONG) or 1 (SHORT)",
         }).describe("0 = LONG, 1 = SHORT (position direction)"),
         leverage: z.coerce.number().describe("Position leverage"),
-        tpPrice: z.string().optional().describe("Take-profit trigger price (human-readable)"),
-        tpSize: z.string().optional().describe("TP size (18 decimals). Omit or '0' for full position."),
-        slPrice: z.string().optional().describe("Stop-loss trigger price (human-readable)"),
-        slSize: z.string().optional().describe("SL size (18 decimals). Omit or '0' for full position."),
+        tpPrice: z.string().optional().describe("SDK standard: 30-decimal raw TP price. Compatibility: human-readable decimals are also accepted."),
+        tpSize: z.string().optional().describe("SDK standard: 18-decimal raw TP size. Omit or '0' for full position."),
+        slPrice: z.string().optional().describe("SDK standard: 30-decimal raw SL price. Compatibility: human-readable decimals are also accepted."),
+        slSize: z.string().optional().describe("SDK standard: 18-decimal raw SL size. Omit or '0' for full position."),
+        slippagePct: bpsLikeString.optional().describe("Slippage in bps (4-digit precision): 1 = 0.01%, default 100 = 1%"),
         quoteToken: z.string().optional().describe("Quote token address"),
     },
     handler: async (args) => {

package/dist/tools/updateOrderTpSl.js

@@ -8,10 +8,13 @@ export const updateOrderTpSlTool = {
     schema: {
         orderId: z.string().describe("The ID of the order to update"),
         marketId: z.string().describe("The market ID (config hash) for the order"),
-        tpPrice: z.string().optional().describe("New take-profit trigger price (human-readable)"),
-        tpSize: z.string().optional().describe("New TP size (18 decimals). Omit or '0' for full position."),
-        slPrice: z.string().optional().describe("New stop-loss trigger price (human-readable)"),
-        slSize: z.string().optional().describe("New SL size (18 decimals). Omit or '0' for full position."),
+        size: z.string().optional().describe("SDK standard: 18-decimal raw order size."),
+        price: z.string().optional().describe("SDK standard: 30-decimal raw order price."),
+        tpPrice: z.string().optional().describe("SDK standard: 30-decimal raw TP price. Compatibility: human-readable decimals are also accepted."),
+        tpSize: z.string().optional().describe("SDK standard: 18-decimal raw TP size. Omit or '0' for full position."),
+        slPrice: z.string().optional().describe("SDK standard: 30-decimal raw SL price. Compatibility: human-readable decimals are also accepted."),
+        slSize: z.string().optional().describe("SDK standard: 18-decimal raw SL size. Omit or '0' for full position."),
+        useOrderCollateral: booleanLike.optional().describe("Whether to use the order collateral (SDK default true)."),
         isTpSlOrder: booleanLike.optional().describe("Whether this is a TP/SL order (default true)"),
         quoteToken: z.string().optional().describe("Quote token address"),
     },

package/dist/utils/schema.js

@@ -1,6 +1,8 @@
 import { z } from "zod";
 const trueValues = new Set(["true", "1", "yes", "y", "on"]);
 const falseValues = new Set(["false", "0", "no", "n", "off"]);
+const DECIMAL_RE = /^-?\d+(\.\d+)?$/;
+const EPSILON = 1e-8;
 /**
  * Safe boolean coercion for MCP inputs:
  * - boolean: true/false
@@ -16,3 +18,67 @@ export const booleanLike = z.union([
         message: "Expected boolean-like value: true/false/1/0/yes/no/on/off.",
     }).transform((value) => trueValues.has(value)),
 ]);
+function isNearlyInteger(value) {
+    return Math.abs(value - Math.round(value)) < EPSILON;
+}
+function parseBpsLike(value) {
+    const raw = String(value).trim();
+    if (!raw)
+        throw new Error("slippage is required.");
+    if (!DECIMAL_RE.test(raw))
+        throw new Error("slippage must be numeric.");
+    const parsed = Number(raw);
+    if (!Number.isFinite(parsed))
+        throw new Error("slippage must be finite.");
+    if (parsed < 0)
+        throw new Error("slippage must be >= 0.");
+    if (isNearlyInteger(parsed)) {
+        return Math.round(parsed);
+    }
+    // Backward compatibility: legacy ratio input (e.g. 0.01 = 1%) -> bps
+    if (parsed > 0 && parsed < 1) {
+        const bps = parsed * 10000;
+        if (!isNearlyInteger(bps)) {
+            throw new Error("legacy slippage ratio is too precise; use integer bps.");
+        }
+        return Math.round(bps);
+    }
+    throw new Error("slippage must be integer bps (1 = 0.01%).");
+}
+function parseLpSlippageLike(value) {
+    const raw = String(value).trim();
+    if (!raw)
+        throw new Error("slippage is required.");
+    if (!DECIMAL_RE.test(raw))
+        throw new Error("slippage must be numeric.");
+    const parsed = Number(raw);
+    if (!Number.isFinite(parsed))
+        throw new Error("slippage must be finite.");
+    if (parsed < 0)
+        throw new Error("slippage must be >= 0.");
+    // SDK doc convention for LP: ratio (e.g. 0.01 = 1%)
+    if (parsed <= 1) {
+        return parsed;
+    }
+    // Backward compatibility for MCP callers that send BPS (e.g. 100 = 1%)
+    return parsed / 10000;
+}
+export const bpsLikeNumber = z.union([z.number(), z.string()]).transform((value, ctx) => {
+    try {
+        return parseBpsLike(value);
+    }
+    catch (error) {
+        ctx.addIssue({ code: "custom", message: error.message || "Invalid slippage." });
+        return z.NEVER;
+    }
+});
+export const bpsLikeString = bpsLikeNumber.transform((value) => value.toString());
+export const lpSlippageLike = z.union([z.number(), z.string()]).transform((value, ctx) => {
+    try {
+        return parseLpSlippageLike(value);
+    }
+    catch (error) {
+        ctx.addIssue({ code: "custom", message: error.message || "Invalid LP slippage." });
+        return z.NEVER;
+    }
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@michaleffffff/mcp-trading-server",
-  "version": "2.3.6",
+  "version": "2.4.0",
   "type": "module",
   "bin": {
     "myx-mcp": "dist/server.js"