@michaleffffff/mcp-trading-server 2.9.2 → 3.0.0

package/dist/tools/index.js

@@ -28,10 +28,9 @@ export { createPerpMarketTool } from "./createPerpMarket.js";
 export { manageLiquidityTool, getLpPriceTool } from "./manageLiquidity.js";
 // Tools — 账户 & 查询
 export { getPositionsTool } from "./getPositions.js";
-export { getBalancesTool } from "./getBalances.js";
 export { getOpenOrdersTool, getOrderHistoryTool } from "./orderQueries.js";
 export { getPositionHistoryTool } from "./positionHistory.js";
-export { getAccountInfoTool, getTradeFlowTool, getMarginBalanceTool } from "./accountInfo.js";
+export { getAccountTool, getTradeFlowTool } from "./accountInfo.js";
 export { getAccountVipInfoTool } from "./getAccountVipInfo.js";
 export { accountDepositTool, accountWithdrawTool } from "./accountTransfer.js";
 export { getMarketListTool } from "./getMarketList.js";

package/dist/tools/manageLiquidity.js

@@ -1,23 +1,31 @@
 import { z } from "zod";
 import { quoteDeposit, quoteWithdraw, baseDeposit, baseWithdraw, getLpPrice, } from "../services/poolService.js";
 import { resolveClient } from "../auth/resolveClient.js";
+import { resolvePool } from "../services/marketService.js";
 import { finalizeMutationResult } from "../utils/mutationResult.js";
 export const manageLiquidityTool = {
     name: "manage_liquidity",
     description: "Add or withdraw liquidity from a BASE or QUOTE pool.",
     schema: {
-        action: z.enum(["deposit", "withdraw"]).describe("'deposit' or 'withdraw'"),
+        action: z.enum(["deposit", "withdraw", "add", "remove", "increase", "decrease"]).describe("'deposit' or 'withdraw' (aliases: add, remove, increase, decrease)"),
         poolType: z.enum(["BASE", "QUOTE"]).describe("'BASE' or 'QUOTE'"),
-        poolId: z.string().describe("Pool ID"),
+        poolId: z.string().describe("Pool ID or Base Token Address"),
         amount: z.coerce.number().positive().describe("Amount in human-readable units"),
         slippage: z.coerce.number().min(0).describe("LP slippage ratio (e.g. 0.01 = 1%)"),
         chainId: z.coerce.number().int().positive().optional().describe("Optional chainId override"),
     },
     handler: async (args) => {
         try {
-            const { signer } = await resolveClient();
-            const { action, poolType, poolId } = args;
+            const { client, signer } = await resolveClient();
+            let { action, poolType, poolId } = args;
             const { amount, slippage } = args;
+            // 1. Action Alias Mapping
+            if (action === "add" || action === "increase")
+                action = "deposit";
+            if (action === "remove" || action === "decrease")
+                action = "withdraw";
+            // 2. Smart Pool Resolution (Handles PoolId, Token Address, or Keywords)
+            poolId = await resolvePool(client, poolId);
             let raw;
             if (poolType === "QUOTE") {
                 raw = action === "deposit"

package/dist/tools/marketInfo.js

@@ -1,19 +1,22 @@
 import { z } from "zod";
 import { resolveClient, getChainId } from "../auth/resolveClient.js";
-import { getMarketDetail } from "../services/marketService.js";
+import { getMarketDetail, resolvePool } from "../services/marketService.js";
 import { getPoolInfo, getLiquidityInfo } from "../services/poolService.js";
 export const getMarketDetailTool = {
     name: "get_market_detail",
-    description: "Get detailed information for a specific trading pool (fee rates, open interest, etc.).",
+    description: "Get detailed information for a specific trading pool (fee rates, open interest, etc.). Supports PoolId, Token Address, or Keywords.",
     schema: {
-        poolId: z.string().describe("Pool ID"),
+        poolId: z.string().describe("Pool ID, Token Address, or Keyword"),
         chainId: z.number().int().positive().optional().describe("Optional chainId override"),
     },
     handler: async (args) => {
         try {
             const { client } = await resolveClient();
+            const poolId = await resolvePool(client, args.poolId);
             const chainId = args.chainId ?? getChainId();
-            const data = await getMarketDetail(client, args.poolId, chainId);
+            const data = await getMarketDetail(client, poolId, chainId);
+            if (!data)
+                throw new Error(`Market detail for ${poolId} not found.`);
             return { content: [{ type: "text", text: JSON.stringify({ status: "success", data }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
         }
         catch (error) {
@@ -23,15 +26,19 @@ export const getMarketDetailTool = {
 };
 export const getPoolInfoTool = {
     name: "get_pool_info",
-    description: "Get pool on-chain information (reserves, utilization, etc.).",
+    description: "Get pool on-chain information (reserves, utilization, etc.). Supports PoolId, Token Address, or Keywords.",
     schema: {
-        poolId: z.string().describe("Pool ID"),
+        poolId: z.string().describe("Pool ID, Token Address, or Keyword"),
         chainId: z.number().int().positive().optional().describe("Optional chainId override"),
     },
     handler: async (args) => {
         try {
+            const { client } = await resolveClient();
+            const poolId = await resolvePool(client, args.poolId);
             const chainId = args.chainId ?? getChainId();
-            const data = await getPoolInfo(args.poolId, chainId);
+            const data = await getPoolInfo(poolId, chainId);
+            if (!data)
+                throw new Error(`Pool info for ${poolId} returned undefined. The pool may not exist on chainId ${chainId}.`);
             return { content: [{ type: "text", text: JSON.stringify({ status: "success", data }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
         }
         catch (error) {
@@ -41,17 +48,20 @@ export const getPoolInfoTool = {
 };
 export const getLiquidityInfoTool = {
     name: "get_liquidity_info",
-    description: "Get pool liquidity utilization and depth information.",
+    description: "Get pool liquidity utilization and depth information. Supports PoolId, Token Address, or Keywords.",
     schema: {
-        poolId: z.string().describe("Pool ID"),
+        poolId: z.string().describe("Pool ID, Token Address, or Keyword"),
         marketPrice: z.string().regex(/^\d+$/).describe("Current market price in 30-decimal raw units"),
         chainId: z.number().int().positive().optional().describe("Optional chainId override"),
     },
     handler: async (args) => {
         try {
             const { client } = await resolveClient();
+            const poolId = await resolvePool(client, args.poolId);
             const chainId = args.chainId ?? getChainId();
-            const data = await getLiquidityInfo(client, args.poolId, args.marketPrice, chainId);
+            const data = await getLiquidityInfo(client, poolId, args.marketPrice, chainId);
+            if (!data)
+                throw new Error(`Liquidity info for ${poolId} not available.`);
             return { content: [{ type: "text", text: JSON.stringify({ status: "success", data }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
         }
         catch (error) {

package/dist/tools/searchMarket.js

@@ -3,15 +3,15 @@ import { resolveClient } from "../auth/resolveClient.js";
 import { searchMarket } from "../services/marketService.js";
 export const searchMarketTool = {
     name: "search_market",
-    description: "Search for an active market by keyword.",
+    description: "Search active markets by keyword. Leave keyword empty to list active markets.",
     schema: {
-        keyword: z.string().describe('Search keyword, e.g. "BTC", "ETH"'),
+        keyword: z.string().optional().describe('Search keyword, e.g. "BTC", "ETH". Leave empty to return active markets.'),
         limit: z.number().int().positive().optional().describe("Max results (default 100)"),
     },
     handler: async (args) => {
         try {
             const { client } = await resolveClient();
-            const activeMarkets = await searchMarket(client, args.keyword, args.limit);
+            const activeMarkets = await searchMarket(client, args.keyword ?? "", args.limit ?? 100);
             return { content: [{ type: "text", text: JSON.stringify({ status: "success", data: activeMarkets }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
         }
         catch (error) {

package/dist/utils/mutationResult.js

@@ -1,6 +1,14 @@
 import { decodeErrorSelector } from "./errors.js";
+import { getChainId } from "../auth/resolveClient.js";
 const TX_HASH_RE = /^0x[0-9a-fA-F]{64}$/;
 const TX_HASH_KEYS = new Set(["hash", "txHash", "transactionHash"]);
+function getExplorerLink(txHash, chainId) {
+    if (chainId === 421614)
+        return `https://sepolia.arbiscan.io/tx/${txHash}`;
+    if (chainId === 59141)
+        return `https://sepolia.lineascan.build/tx/${txHash}`;
+    return txHash; // Fallback to just hash
+}
 function isObject(value) {
     return !!value && typeof value === "object";
 }
@@ -59,26 +67,35 @@ function assertSdkCode(result, actionName) {
 export async function finalizeMutationResult(result, signer, actionName) {
     assertSdkCode(result, actionName);
     const txHash = findTxHashDeep(result);
+    const chainId = getChainId();
     if (!txHash) {
         return { result };
     }
     const provider = signer?.provider;
-    if (!provider?.waitForTransaction) {
-        return { result, confirmation: { txHash, status: "submitted" } };
-    }
-    const receipt = await provider.waitForTransaction(txHash, 1, 120000);
-    if (!receipt) {
-        throw new Error(`${actionName} failed: tx not confirmed within timeout (${txHash}).`);
-    }
-    if (receipt.status !== 1) {
-        throw new Error(`${actionName} failed on-chain: tx reverted (${txHash}).`);
+    let status = "submitted";
+    let receipt = null;
+    if (provider?.waitForTransaction) {
+        receipt = await provider.waitForTransaction(txHash, 1, 120000);
+        if (!receipt) {
+            throw new Error(`${actionName} failed: tx not confirmed within timeout (${txHash}).`);
+        }
+        if (receipt.status !== 1) {
+            throw new Error(`${actionName} failed on-chain: tx reverted (${txHash}).`);
+        }
+        status = "success";
     }
     return {
-        result,
-        confirmation: {
+        summary: {
+            action: actionName,
+            status: status,
+            txHash: txHash,
+            explorerUrl: getExplorerLink(txHash, chainId)
+        },
+        confirmation: receipt ? {
             txHash,
             blockNumber: receipt.blockNumber,
             status: receipt.status,
-        },
+        } : { txHash, status: "submitted" },
+        raw: result
     };
 }

package/package.json

@@ -1,12 +1,15 @@
 {
   "name": "@michaleffffff/mcp-trading-server",
-  "version": "2.9.2",
+  "version": "3.0.0",
   "type": "module",
   "bin": {
     "myx-mcp": "dist/server.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "README.md",
+    "TOOL_EXAMPLES.md",
+    "CHANGELOG.md"
   ],
   "scripts": {
     "build": "rm -rf dist && tsc",

package/dist/tools/getBalances.js

@@ -1,17 +0,0 @@
-import { resolveClient } from "../auth/resolveClient.js";
-import { getBalances } from "../services/balanceService.js";
-export const getBalancesTool = {
-    name: "get_balances",
-    description: "Get the account balances for different tokens.",
-    schema: {},
-    handler: async () => {
-        try {
-            const { client, address } = await resolveClient();
-            const data = await getBalances(client, address);
-            return { content: [{ type: "text", text: JSON.stringify({ status: "success", data }, (_, v) => typeof v === 'bigint' ? v.toString() : v, 2) }] };
-        }
-        catch (error) {
-            return { content: [{ type: "text", text: `Error: ${error.message}` }], isError: true };
-        }
-    },
-};