@michaleffffff/mcp-trading-server 2.3.3 → 2.3.5

package/README.md

@@ -187,25 +187,32 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 
 # Tools
 
-The server exposes 28 precise tools categorized for AI:
+The server exposes 37 tools categorized for AI:
 
 ### Trading Operations
 * **execute_trade**: Execute a new trade or add to an existing position.
 * **close_position**: Close an open position.
 * **close_all_positions**: Emergency: close ALL open positions in a pool at once.
 * **cancel_order**: Cancel an open order by its order ID.
+* **cancel_all_orders**: Cancel all open orders at once (or a provided order ID list).
 * **set_tp_sl**: Set take profit and stop loss prices for an open position.
 * **adjust_margin**: Adjust the margin (collateral) of an open position.
+* **get_user_trading_fee_rate**: Query current maker/taker fee rates by asset class and risk tier.
+* **get_network_fee**: Query estimated network fee requirements for a market.
 
 ### Market Data
 * **search_market**: Search for an active market (e.g., "BTC") to retrieve its unique `poolId` (Crucial prerequisite).
 * **get_market_price**: Get the current ticker market price for a specific pool.
 * **get_oracle_price**: Get the current EVM oracle price for a specific pool.
-* **get_market_list**, **get_kline**, **get_pool_info**...
+* **get_kline_latest_bar**: Get only the latest bar for an interval.
+* **get_all_tickers**: Get all ticker snapshots in one request.
+* **get_market_list**, **get_market_list_raw**, **get_kline**, **get_pool_info**...
+* **get_pool_symbol_all**, **get_base_detail**, **get_pool_level_config**...
 
 ### Account & Portfolio
 * **get_positions**: Get all open positions for the current account.
 * **get_balances**: Get the account balances for different tokens.
+* **get_account_vip_info**: Query account VIP tier details.
 * **position_history**, **open_orders**...
 
 ### Liquidity Provision (LP)
@@ -269,7 +276,8 @@ npm run dev
 Run tests:
 
 ```bash
-npx tsx tests/test_bsc.ts
+npm test
+npm run test:new-tools
 ```
 
 ---

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.1" }, { capabilities: { tools: {}, resources: {}, prompts: {} } });
+const server = new Server({ name: "myx-mcp-trading-server", version: "2.3.5" }, { 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.1 running (stdio, pure on-chain, prod ready)");
+    logger.info("🚀 MYX Trading MCP Server v2.3.5 running (stdio, pure on-chain, prod ready)");
 }
 main().catch((err) => {
     logger.error("Fatal Server Startup Error", err);

package/dist/services/poolService.js

@@ -1,5 +1,6 @@
 import { pool, quote, base } from "@myx-trade/sdk";
 import { getChainId, resolveClient } from "../auth/resolveClient.js";
+import { ensureUnits } from "../utils/units.js";
 /**
  * 创建合约市场池子
  */
@@ -27,7 +28,8 @@ export async function getPoolDetail(poolId) {
  */
 export async function getLiquidityInfo(client, poolId, marketPrice) {
     const chainId = getChainId();
-    return client.utils.getLiquidityInfo({ chainId, poolId, marketPrice });
+    const price30 = ensureUnits(marketPrice, 30, "marketPrice");
+    return client.utils.getLiquidityInfo({ chainId, poolId, marketPrice: price30 });
 }
 /**
  * Quote 池 deposit

package/dist/services/tradeService.js

@@ -112,6 +112,7 @@ export async function closePosition(client, address, args) {
         throw new Error("direction is required (0=LONG, 1=SHORT), must match position direction.");
     }
     const price30 = parseHumanUnits(args.price, 30, "price");
+    const sizeWei = ensureUnits(args.size, 18, "size");
     const dir = resolveDirection(args.direction);
     return client.order.createDecreaseOrder({
         chainId,
@@ -122,7 +123,7 @@ export async function closePosition(client, address, args) {
         triggerType: TriggerType.NONE,
         direction: dir,
         collateralAmount: "0",
-        size: args.size,
+        size: sizeWei,
         price: price30,
         postOnly: false,
         slippagePct: args.slippagePct ?? "100",

package/dist/tools/cancelAllOrders.js

@@ -0,0 +1,36 @@
+import { z } from "zod";
+import { resolveClient, getChainId } from "../auth/resolveClient.js";
+export const cancelAllOrdersTool = {
+    name: "cancel_all_orders",
+    description: "Cancel all open orders, or cancel the provided orderIds in one call.",
+    schema: {
+        orderIds: z.array(z.string()).optional().describe("Optional explicit order IDs. If omitted, all open orders will be cancelled."),
+    },
+    handler: async (args) => {
+        try {
+            const { client, address } = await resolveClient();
+            const chainId = getChainId();
+            let orderIds = Array.isArray(args.orderIds) ? args.orderIds : [];
+            if (orderIds.length === 0) {
+                const openOrders = await client.order.getOrders(address);
+                const rows = Array.isArray(openOrders?.data) ? openOrders.data : [];
+                orderIds = rows
+                    .map((o) => o.orderId ?? o.id ?? o.order_id)
+                    .filter((id) => id !== undefined && id !== null)
+                    .map((id) => String(id));
+            }
+            if (orderIds.length === 0) {
+                return {
+                    content: [{ type: "text", text: JSON.stringify({ status: "success", data: { message: "No open orders to cancel.", cancelled: 0 } }, (_, v) => typeof v === "bigint" ? v.toString() : v, 2) }],
+                };
+            }
+            const result = await client.order.cancelAllOrders(orderIds, chainId);
+            return {
+                content: [{ type: "text", text: JSON.stringify({ status: "success", data: { cancelled: orderIds.length, orderIds, result } }, (_, v) => typeof v === "bigint" ? v.toString() : v, 2) }],
+            };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: `Error: ${error.message}` }], isError: true };
+        }
+    },
+};

package/dist/tools/closePosition.js

@@ -9,7 +9,7 @@ export const closePositionTool = {
         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 (18 decimals)"),
+        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'"),
         quoteToken: z.string().optional().describe("Quote token address"),

package/dist/tools/getAccountVipInfo.js

@@ -0,0 +1,20 @@
+import { z } from "zod";
+import { resolveClient, getChainId } from "../auth/resolveClient.js";
+export const getAccountVipInfoTool = {
+    name: "get_account_vip_info",
+    description: "Get account VIP/fee-tier information.",
+    schema: {
+        chainId: z.number().optional().describe("Optional chainId override"),
+    },
+    handler: async (args) => {
+        try {
+            const { client, address } = await resolveClient();
+            const chainId = args.chainId ?? getChainId();
+            const result = await client.account.getAccountVipInfo(chainId, address);
+            return { content: [{ type: "text", text: JSON.stringify({ status: "success", data: result }, (_, v) => typeof v === "bigint" ? v.toString() : v, 2) }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: `Error: ${error.message}` }], isError: true };
+        }
+    },
+};

package/dist/tools/getAllTickers.js

@@ -0,0 +1,35 @@
+import { resolveClient, getChainId } from "../auth/resolveClient.js";
+export const getAllTickersTool = {
+    name: "get_all_tickers",
+    description: "Get ticker snapshots for all markets.",
+    schema: {},
+    handler: async () => {
+        try {
+            const { client } = await resolveClient();
+            try {
+                const result = await client.api.getAllTickers();
+                return { content: [{ type: "text", text: JSON.stringify({ status: "success", data: result }, (_, v) => typeof v === "bigint" ? v.toString() : v, 2) }] };
+            }
+            catch {
+                // Fallback for networks/environments where getAllTickers endpoint is unavailable.
+                const chainId = getChainId();
+                const poolList = await client.api.getPoolList();
+                const pools = Array.isArray(poolList?.data) ? poolList.data : [];
+                const poolIds = pools.map((p) => p.poolId).filter((id) => !!id);
+                if (poolIds.length === 0) {
+                    throw new Error("Failed to fetch all tickers and no pools were available for fallback query.");
+                }
+                const tickerRows = await client.markets.getTickerList({ chainId, poolIds });
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({ status: "success", data: { source: "markets.getTickerList_fallback", rows: tickerRows } }, (_, v) => typeof v === "bigint" ? v.toString() : v, 2),
+                        }],
+                };
+            }
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: `Error: ${error.message}` }], isError: true };
+        }
+    },
+};

package/dist/tools/getBaseDetail.js

@@ -0,0 +1,21 @@
+import { z } from "zod";
+import { resolveClient, getChainId } from "../auth/resolveClient.js";
+export const getBaseDetailTool = {
+    name: "get_base_detail",
+    description: "Get base asset detail metrics for a pool.",
+    schema: {
+        poolId: z.string().describe("Pool ID"),
+        chainId: z.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 });
+            return { content: [{ type: "text", text: JSON.stringify({ status: "success", data: result }, (_, v) => typeof v === "bigint" ? v.toString() : v, 2) }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: `Error: ${error.message}` }], isError: true };
+        }
+    },
+};

package/dist/tools/getKlineLatestBar.js

@@ -0,0 +1,27 @@
+import { z } from "zod";
+import { resolveClient, getChainId } from "../auth/resolveClient.js";
+export const getKlineLatestBarTool = {
+    name: "get_kline_latest_bar",
+    description: "Get the latest single K-line/candlestick bar for a pool.",
+    schema: {
+        poolId: z.string().describe("Pool ID"),
+        interval: z.string().describe("K-line interval: '1m','5m','15m','30m','1h','4h','1d','1w','1M'"),
+    },
+    handler: async (args) => {
+        try {
+            const { client } = await resolveClient();
+            const chainId = getChainId();
+            const result = await client.markets.getKlineLatestBar({
+                poolId: args.poolId,
+                chainId,
+                interval: args.interval,
+                limit: 1,
+                endTime: Date.now(),
+            });
+            return { content: [{ type: "text", text: JSON.stringify({ status: "success", data: result }, (_, v) => typeof v === "bigint" ? v.toString() : v, 2) }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: `Error: ${error.message}` }], isError: true };
+        }
+    },
+};

package/dist/tools/getMarketListRaw.js

@@ -0,0 +1,16 @@
+import { resolveClient } from "../auth/resolveClient.js";
+export const getMarketListRawTool = {
+    name: "get_market_list_raw",
+    description: "Get raw market list directly from MYX API without MCP-side filtering.",
+    schema: {},
+    handler: async () => {
+        try {
+            const { client } = await resolveClient();
+            const result = await client.api.getMarketList();
+            return { content: [{ type: "text", text: JSON.stringify({ status: "success", data: result }, (_, v) => typeof v === "bigint" ? v.toString() : v, 2) }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: `Error: ${error.message}` }], isError: true };
+        }
+    },
+};

package/dist/tools/getNetworkFee.js

@@ -0,0 +1,21 @@
+import { z } from "zod";
+import { resolveClient, getChainId } from "../auth/resolveClient.js";
+export const getNetworkFeeTool = {
+    name: "get_network_fee",
+    description: "Estimate network fee requirements for a market.",
+    schema: {
+        marketId: z.string().describe("Market ID"),
+        chainId: z.number().optional().describe("Optional chainId override"),
+    },
+    handler: async (args) => {
+        try {
+            const { client } = await resolveClient();
+            const chainId = args.chainId ?? getChainId();
+            const result = await client.utils.getNetworkFee(args.marketId, chainId);
+            return { content: [{ type: "text", text: JSON.stringify({ status: "success", data: result }, (_, v) => typeof v === "bigint" ? v.toString() : v, 2) }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: `Error: ${error.message}` }], isError: true };
+        }
+    },
+};

package/dist/tools/getPoolSymbolAll.js

@@ -0,0 +1,16 @@
+import { resolveClient } from "../auth/resolveClient.js";
+export const getPoolSymbolAllTool = {
+    name: "get_pool_symbol_all",
+    description: "Get symbol/icon metadata for all pools.",
+    schema: {},
+    handler: async () => {
+        try {
+            const { client } = await resolveClient();
+            const result = await client.markets.getPoolSymbolAll();
+            return { content: [{ type: "text", text: JSON.stringify({ status: "success", data: result }, (_, v) => typeof v === "bigint" ? v.toString() : v, 2) }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: `Error: ${error.message}` }], isError: true };
+        }
+    },
+};

package/dist/tools/getUserTradingFeeRate.js

@@ -0,0 +1,22 @@
+import { z } from "zod";
+import { resolveClient, getChainId } from "../auth/resolveClient.js";
+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"),
+    },
+    handler: async (args) => {
+        try {
+            const { client } = await resolveClient();
+            const chainId = args.chainId ?? getChainId();
+            const result = await client.utils.getUserTradingFeeRate(args.assetClass, args.riskTier, chainId);
+            return { content: [{ type: "text", text: JSON.stringify({ status: "success", data: result }, (_, v) => typeof v === "bigint" ? v.toString() : v, 2) }] };
+        }
+        catch (error) {
+            return { content: [{ type: "text", text: `Error: ${error.message}` }], isError: true };
+        }
+    },
+};

package/dist/tools/index.js

@@ -1,20 +1,27 @@
 // Tools — 交易
 export { executeTradeTool } from "./executeTrade.js";
 export { cancelOrderTool } from "./cancelOrder.js";
+export { cancelAllOrdersTool } from "./cancelAllOrders.js";
 export { closePositionTool } from "./closePosition.js";
 export { setTpSlTool } from "./setTpSl.js";
 export { updateOrderTpSlTool } from "./updateOrderTpSl.js";
 export { adjustMarginTool } from "./adjustMargin.js";
 export { closeAllPositionsTool } from "./closeAllPositions.js";
 export { checkApprovalTool } from "./checkApproval.js";
+export { getUserTradingFeeRateTool } from "./getUserTradingFeeRate.js";
+export { getNetworkFeeTool } from "./getNetworkFee.js";
 // Tools — 市场数据
 export { getMarketPriceTool } from "./getMarketPrice.js";
 export { getOraclePriceTool } from "./getOraclePrice.js";
 export { searchMarketTool } from "./searchMarket.js";
 export { getKlineTool } from "./getKline.js";
+export { getKlineLatestBarTool } from "./getKlineLatestBar.js";
+export { getAllTickersTool } from "./getAllTickers.js";
 export { getMarketDetailTool, getPoolInfoTool, getLiquidityInfoTool } from "./marketInfo.js";
 export { getPoolListTool } from "./getPoolList.js";
+export { getPoolSymbolAllTool } from "./getPoolSymbolAll.js";
 export { getPoolLevelConfigTool } from "./poolConfig.js";
+export { getBaseDetailTool } from "./getBaseDetail.js";
 // Tools — 池子 & 流动性
 export { createPerpMarketTool } from "./createPerpMarket.js";
 export { manageLiquidityTool, getLpPriceTool } from "./manageLiquidity.js";
@@ -24,5 +31,7 @@ export { getBalancesTool } from "./getBalances.js";
 export { getOpenOrdersTool, getOrderHistoryTool } from "./orderQueries.js";
 export { getPositionHistoryTool } from "./positionHistory.js";
 export { getAccountInfoTool, getTradeFlowTool, getMarginBalanceTool } from "./accountInfo.js";
+export { getAccountVipInfoTool } from "./getAccountVipInfo.js";
 export { accountDepositTool, accountWithdrawTool } from "./accountTransfer.js";
 export { getMarketListTool } from "./getMarketList.js";
+export { getMarketListRawTool } from "./getMarketListRaw.js";

package/dist/tools/marketInfo.js

@@ -40,7 +40,7 @@ export const getLiquidityInfoTool = {
     description: "Get pool liquidity utilization and depth information.",
     schema: {
         poolId: z.string().describe("Pool ID"),
-        marketPrice: z.string().describe("Current market price (30 decimals)"),
+        marketPrice: z.string().describe("Current market price (can be human-readable e.g. '0.69' or 30-decimal raw units)"),
     },
     handler: async (args) => {
         try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@michaleffffff/mcp-trading-server",
-  "version": "2.3.3",
+  "version": "2.3.5",
   "type": "module",
   "bin": {
     "myx-mcp": "dist/server.js"
@@ -12,7 +12,8 @@
     "build": "rm -rf dist && tsc",
     "start": "node dist/server.js",
     "dev": "tsx src/server.ts",
-    "test": "tsx tests/test_sepolia.ts"
+    "test": "tsx tests/test_sepolia.ts",
+    "test:new-tools": "tsx tests/test_new_tools_p0_p1.ts"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.27.1",