@michaleffffff/mcp-trading-server 2.3.5 → 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.5" }, { 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.5 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,60 +12,63 @@ 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);
     }
-    return quote.getLpPrice(chainId, poolId);
+    if (poolType === "QUOTE") {
+        return quote.getLpPrice(chainId, poolId);
+    }
+    throw new Error("poolType must be 'BASE' or 'QUOTE'.");
 }

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,14 +40,15 @@ export const getTradeFlowTool = {
     name: "get_trade_flow",
     description: "Get account trade flow / transaction history.",
     schema: {
-        page: z.number().optional().describe("Page number (default 1)"),
-        limit: z.number().optional().describe("Results per page (default 20)"),
+        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)"),
     },
     handler: async (args) => {
         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/accountTransfer.js

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { resolveClient, getChainId, getQuoteToken } from "../auth/resolveClient.js";
 import { normalizeAddress } from "../utils/address.js";
+import { booleanLike } from "../utils/schema.js";
 export const accountDepositTool = {
     name: "account_deposit",
     description: "Deposit funds from wallet into the MYX trading account.",
@@ -31,7 +32,7 @@ export const accountWithdrawTool = {
     schema: {
         poolId: z.string().describe("Pool ID to withdraw from"),
         amount: z.string().describe("Amount to withdraw (in token decimals)"),
-        isQuoteToken: z.boolean().optional().describe("Whether to withdraw as quote token (default true)"),
+        isQuoteToken: booleanLike.optional().describe("Whether to withdraw as quote token (default true)"),
     },
     handler: async (args) => {
         try {

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/checkApproval.js

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { resolveClient, getChainId, getQuoteToken } from "../auth/resolveClient.js";
 import { normalizeAddress } from "../utils/address.js";
+import { booleanLike } from "../utils/schema.js";
 const MAX_UINT256 = "115792089237316195423570985008687907853269984665640564039457584007913129639935";
 export const checkApprovalTool = {
     name: "check_approval",
@@ -8,8 +9,8 @@ export const checkApprovalTool = {
     schema: {
         amount: z.string().describe("Amount to check approval for (in token decimals)"),
         quoteToken: z.string().optional().describe("Token address to check. Uses default if omitted."),
-        autoApprove: z.boolean().optional().describe("If true, automatically approve when needed."),
-        approveMax: z.boolean().optional().describe("If true with autoApprove, approve unlimited MaxUint256 (default false: approve exact amount only)."),
+        autoApprove: booleanLike.optional().describe("If true, automatically approve when needed."),
+        approveMax: booleanLike.optional().describe("If true with autoApprove, approve unlimited MaxUint256 (default false: approve exact amount only)."),
     },
     handler: async (args) => {
         try {

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,17 +1,20 @@
 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.",
     schema: {
         poolId: z.string().describe("Pool ID"),
         positionId: z.string().describe("Position ID to close"),
-        direction: z.union([z.literal(0), z.literal(1)]).describe("0 = LONG, 1 = SHORT (must match position direction)"),
-        leverage: z.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'"),
+        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 (must match position direction)"),
+        leverage: z.coerce.number().describe("Position leverage"),
+        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,21 +1,24 @@
 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.",
     schema: {
         poolId: z.string().describe("Pool ID to trade in"),
-        direction: z.union([z.literal(0), z.literal(1)]).describe("0 = LONG, 1 = SHORT"),
-        collateralAmount: z.string().describe("Collateral in human-readable units (e.g. '100' for 100 USDC)"),
-        leverage: z.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."),
+        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("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("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.number().optional().describe("Quote token decimals (default 6)."),
-        slippagePct: z.string().optional().describe("Slippage in bps, default '100' = 1%"),
+        quoteDecimals: z.coerce.number().optional().describe("Quote token decimals (default 6)."),
+        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/getAccountVipInfo.js

@@ -4,7 +4,7 @@ export const getAccountVipInfoTool = {
     name: "get_account_vip_info",
     description: "Get account VIP/fee-tier information.",
     schema: {
-        chainId: z.number().optional().describe("Optional chainId override"),
+        chainId: z.coerce.number().optional().describe("Optional chainId override"),
     },
     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"),
-        chainId: z.number().optional().describe("Optional chainId override"),
+        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/getKline.js

@@ -6,7 +6,7 @@ export const getKlineTool = {
     schema: {
         poolId: z.string().describe("Pool ID"),
         interval: z.string().describe("K-line interval: '1m','5m','15m','30m','1h','4h','1d','1w','1M'"),
-        limit: z.number().optional().describe("Number of bars (default 100)"),
+        limit: z.coerce.number().optional().describe("Number of bars (default 100)"),
     },
     handler: async (args) => {
         try {

package/dist/tools/getMarketList.js

@@ -5,7 +5,7 @@ export const getMarketListTool = {
     name: "get_market_list",
     description: "Get tradable markets/pools (state=2 Active). Supports configurable result limit; backend may still enforce its own cap.",
     schema: {
-        limit: z.number().optional().describe("Max results to request (default 1000)."),
+        limit: z.coerce.number().optional().describe("Max results to request (default 1000)."),
     },
     handler: async (args) => {
         try {

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/getNetworkFee.js

@@ -5,7 +5,7 @@ export const getNetworkFeeTool = {
     description: "Estimate network fee requirements for a market.",
     schema: {
         marketId: z.string().describe("Market ID"),
-        chainId: z.number().optional().describe("Optional chainId override"),
+        chainId: z.coerce.number().optional().describe("Optional chainId override"),
     },
     handler: async (args) => {
         try {

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/getUserTradingFeeRate.js

@@ -4,9 +4,9 @@ export const getUserTradingFeeRateTool = {
     name: "get_user_trading_fee_rate",
     description: "Get maker/taker fee rates for a given assetClass and riskTier.",
     schema: {
-        assetClass: z.number().describe("Asset class ID"),
-        riskTier: z.number().describe("Risk tier"),
-        chainId: z.number().optional().describe("Optional chainId override"),
+        assetClass: z.coerce.number().describe("Asset class ID"),
+        riskTier: z.coerce.number().describe("Risk tier"),
+        chainId: z.coerce.number().optional().describe("Optional chainId override"),
     },
     handler: async (args) => {
         try {

package/dist/tools/manageLiquidity.js

@@ -1,25 +1,27 @@
 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().describe("'deposit' or 'withdraw'"),
-        poolType: z.string().describe("'BASE' or 'QUOTE'"),
+        action: z.string().trim().toLowerCase().refine((value) => value === "deposit" || value === "withdraw", {
+            message: "action must be 'deposit' or 'withdraw'.",
+        }).describe("'deposit' or 'withdraw'"),
+        poolType: z.string().trim().toUpperCase().refine((value) => value === "BASE" || value === "QUOTE", {
+            message: "poolType must be 'BASE' or 'QUOTE'.",
+        }).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");
-            if (!["deposit", "withdraw"].includes(action))
-                throw new Error("action must be 'deposit' or 'withdraw'.");
-            if (!["BASE", "QUOTE"].includes(poolType))
-                throw new Error("poolType must be 'BASE' or 'QUOTE'.");
+            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) }] };
         }
@@ -46,12 +48,15 @@ export const getLpPriceTool = {
     name: "get_lp_price",
     description: "Get the current internal net asset value (NAV) price of an LP token for a BASE or QUOTE pool. Note: This is NOT the underlying token's external Oracle market price (e.g. WETH's price), but rather the internal exchange rate / net worth of the LP token itself which fluctuates based on pool PnL and fees.",
     schema: {
-        poolType: z.string().describe("'BASE' or 'QUOTE'"),
+        poolType: z.string().trim().toUpperCase().refine((value) => value === "BASE" || value === "QUOTE", {
+            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/orderQueries.js

@@ -27,8 +27,8 @@ export const getOrderHistoryTool = {
     description: "Get historical orders with optional pool filter and pagination.",
     schema: {
         poolId: z.string().optional().describe("Filter by pool ID"),
-        page: z.number().optional().describe("Page number (default 1)"),
-        limit: z.number().optional().describe("Results per page (default 20)"),
+        page: z.coerce.number().optional().describe("Page number (default 1)"),
+        limit: z.coerce.number().optional().describe("Results per page (default 20)"),
     },
     handler: async (args) => {
         try {

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/positionHistory.js

@@ -6,8 +6,8 @@ export const getPositionHistoryTool = {
     description: "Get historical closed positions with optional pool filter and pagination.",
     schema: {
         poolId: z.string().optional().describe("Filter by pool ID"),
-        page: z.number().optional().describe("Page number (default 1)"),
-        limit: z.number().optional().describe("Results per page (default 20)"),
+        page: z.coerce.number().optional().describe("Page number (default 1)"),
+        limit: z.coerce.number().optional().describe("Results per page (default 20)"),
     },
     handler: async (args) => {
         try {

package/dist/tools/searchMarket.js

@@ -6,7 +6,7 @@ export const searchMarketTool = {
     description: "Search for an active market by keyword.",
     schema: {
         keyword: z.string().describe('Search keyword, e.g. "BTC", "ETH"'),
-        limit: z.number().optional().describe("Max results (default 100)"),
+        limit: z.coerce.number().optional().describe("Max results (default 100)"),
     },
     handler: async (args) => {
         try {

package/dist/tools/setTpSl.js

@@ -1,18 +1,22 @@
 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.",
     schema: {
         poolId: z.string().describe("Pool ID"),
         positionId: z.string().describe("Position ID"),
-        direction: z.union([z.literal(0), z.literal(1)]).describe("0 = LONG, 1 = SHORT (position direction)"),
-        leverage: z.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."),
+        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 (position direction)"),
+        leverage: z.coerce.number().describe("Position leverage"),
+        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

@@ -1,17 +1,21 @@
 import { z } from "zod";
 import { resolveClient } from "../auth/resolveClient.js";
 import { updateOrderTpSl } from "../services/tradeService.js";
+import { booleanLike } from "../utils/schema.js";
 export const updateOrderTpSlTool = {
     name: "update_order_tp_sl",
     description: "Update an existing take profit or stop loss order.",
     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."),
-        isTpSlOrder: z.boolean().optional().describe("Whether this is a TP/SL order (default true)"),
+        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"),
     },
     handler: async (args) => {

package/dist/utils/schema.js

@@ -0,0 +1,84 @@
+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
+ * - number: 1/0
+ * - string: true/false/1/0/yes/no/on/off (case-insensitive)
+ */
+export const booleanLike = z.union([
+    z.boolean(),
+    z.number().refine((value) => value === 0 || value === 1, {
+        message: "Expected 0 or 1 for boolean value.",
+    }).transform((value) => value === 1),
+    z.string().trim().toLowerCase().refine((value) => trueValues.has(value) || falseValues.has(value), {
+        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.5",
+  "version": "2.4.0",
   "type": "module",
   "bin": {
     "myx-mcp": "dist/server.js"