@alfe.ai/ctrader-mcp 0.3.2 → 0.3.4

package/dist/server.js

@@ -1187,7 +1187,7 @@ async function withLiveSubscription(pool, numericAccountId, symbolId, kind, hand
 * required-when-multiple rule at runtime so the model gets a helpful listing
 * instead of a bare validation error.
 */
-const accountIdField = z.string().optional().describe("ctidTraderAccountId of the account to act on (from get_accounts). Optional when exactly one account is connected; REQUIRED when several are — this tool never defaults to an arbitrary account.");
+const accountIdField = z.coerce.string().optional().describe("ctidTraderAccountId of the account to act on (from get_accounts). Optional when exactly one account is connected; REQUIRED when several are — this tool never defaults to an arbitrary account.");
 function registerTools(server, pool) {
 	const register = server.registerTool.bind(server);
 	register("get_accounts", {
@@ -1323,9 +1323,9 @@ function registerTools(server, pool) {
 		description: "Get recent OHLC candles (trendbars) for a symbol on a connected cTrader account. Specify symbolId (from get_symbols), a period, and how many bars. Prices are returned as real decimal prices. Pass `accountId` when several accounts are connected.",
 		inputSchema: {
 			accountId: accountIdField,
-			symbolId: z.number().int().positive().describe("The symbol id from get_symbols"),
+			symbolId: z.coerce.number().int().positive().describe("The symbol id from get_symbols"),
 			period: z.enum(Object.keys(TRENDBAR_PERIOD)).default("H1").describe("Candle period: M1, M5, M15, M30, H1, H4, D1, W1, MN1, etc."),
-			count: z.number().int().min(1).max(1e3).default(50).describe("Number of most-recent bars to return (1-1000)")
+			count: z.coerce.number().int().min(1).max(1e3).default(50).describe("Number of most-recent bars to return (1-1000)")
 		}
 	}, async (args) => {
 		const resolved = resolveAccount(pool, args.accountId);
@@ -1352,7 +1352,7 @@ function registerTools(server, pool) {
 		description: "Get full trading details for one symbol on a connected cTrader account: price digits, pip position, lot size, min/max/step volume (in lots), swap rates, and short-selling availability. Pass `accountId` when several accounts are connected.",
 		inputSchema: {
 			accountId: accountIdField,
-			symbolId: z.number().int().positive().describe("Symbol id from get_symbols")
+			symbolId: z.coerce.number().int().positive().describe("Symbol id from get_symbols")
 		}
 	}, async (args) => {
 		const resolved = resolveAccount(pool, args.accountId);
@@ -1385,8 +1385,8 @@ function registerTools(server, pool) {
 		description: "Get the LIVE bid/ask for a symbol on a connected cTrader account via a brief spot subscription (ticks merge until both sides are seen, up to waitMs). Returns bid, ask, and spread as real decimal prices. Pass `accountId` when several accounts are connected.",
 		inputSchema: {
 			accountId: accountIdField,
-			symbolId: z.number().int().positive().describe("Symbol id from get_symbols"),
-			waitMs: z.number().int().min(200).max(1e4).default(3e3).describe("Max milliseconds to wait for both bid and ask ticks (returns early once both are seen)")
+			symbolId: z.coerce.number().int().positive().describe("Symbol id from get_symbols"),
+			waitMs: z.coerce.number().int().min(200).max(1e4).default(3e3).describe("Max milliseconds to wait for both bid and ask ticks (returns early once both are seen)")
 		}
 	}, async (args) => {
 		const resolved = resolveAccount(pool, args.accountId);
@@ -1428,9 +1428,9 @@ function registerTools(server, pool) {
 		description: "Get the LIVE Level 2 order book (depth of market) for a symbol on a connected cTrader account. Subscribes briefly, assembles the bid/ask ladder (sizes aggregated per price level), then unsubscribes. Returns bids (descending) and asks (ascending) with sizes in base-asset units and lots, plus best bid/ask and spread. Not every broker/symbol publishes depth — a NO_DEPTH_DATA error means none arrived. Pass `accountId` when several accounts are connected.",
 		inputSchema: {
 			accountId: accountIdField,
-			symbolId: z.number().int().positive().describe("Symbol id from get_symbols"),
-			levels: z.number().int().min(1).max(50).default(10).describe("Max price levels per side to return"),
-			collectMs: z.number().int().min(200).max(5e3).default(1e3).describe("How long to collect depth events before snapshotting (the full book arrives on subscribe; longer windows fold in more updates)")
+			symbolId: z.coerce.number().int().positive().describe("Symbol id from get_symbols"),
+			levels: z.coerce.number().int().min(1).max(50).default(10).describe("Max price levels per side to return"),
+			collectMs: z.coerce.number().int().min(200).max(5e3).default(1e3).describe("How long to collect depth events before snapshotting (the full book arrives on subscribe; longer windows fold in more updates)")
 		}
 	}, async (args) => {
 		const resolved = resolveAccount(pool, args.accountId);
@@ -1503,7 +1503,7 @@ function registerTools(server, pool) {
 		description: "Get historical tick-by-tick prices (BID or ASK side) for a symbol on a connected cTrader account. Defaults to the last 5 minutes — keep ranges short, tick volumes are large; `hasMore` signals truncation. Ticks are returned newest-first with real decimal prices.",
 		inputSchema: {
 			accountId: accountIdField,
-			symbolId: z.number().int().positive().describe("Symbol id from get_symbols"),
+			symbolId: z.coerce.number().int().positive().describe("Symbol id from get_symbols"),
 			type: z.enum(["BID", "ASK"]).default("BID").describe("Which side's ticks to fetch"),
 			from: z.string().optional().describe("ISO 8601 range start (default: 5 minutes before `to`)"),
 			to: z.string().optional().describe("ISO 8601 range end (default: now)")
@@ -1542,7 +1542,7 @@ function registerTools(server, pool) {
 			accountId: accountIdField,
 			from: z.string().optional().describe("ISO 8601 range start (default: 7 days before `to`)"),
 			to: z.string().optional().describe("ISO 8601 range end (default: now)"),
-			maxRows: z.number().int().min(1).max(1e3).default(100).describe("Max deals to return")
+			maxRows: z.coerce.number().int().min(1).max(1e3).default(100).describe("Max deals to return")
 		}
 	}, async (args) => {
 		const resolved = resolveAccount(pool, args.accountId);
@@ -1620,8 +1620,8 @@ function registerTools(server, pool) {
 		description: "Get the margin that would be required to open BUY/SELL positions of given sizes (in lots) on a symbol, in the account's deposit currency. Useful before place_order to check affordability. Pass `accountId` when several accounts are connected.",
 		inputSchema: {
 			accountId: accountIdField,
-			symbolId: z.number().int().positive().describe("Symbol id from get_symbols"),
-			volumesLots: z.array(z.number().positive()).min(1).max(10).describe("Position sizes in lots to quote margin for, e.g. [0.1, 0.5, 1]")
+			symbolId: z.coerce.number().int().positive().describe("Symbol id from get_symbols"),
+			volumesLots: z.array(z.coerce.number().positive()).min(1).max(10).describe("Position sizes in lots to quote margin for, e.g. [0.1, 0.5, 1]")
 		}
 	}, async (args) => {
 		const resolved = resolveAccount(pool, args.accountId);
@@ -1692,7 +1692,7 @@ function registerTools(server, pool) {
 		description: "Place a MARKET, LIMIT, STOP, or STOP_LIMIT order on a connected cTrader account. Volume is in LOTS and is converted to the symbol's protocol volume (validated against min/max/step). LIMIT requires limitPrice; STOP requires stopPrice; STOP_LIMIT requires stopPrice + slippageInPoints. SL/TP: pass ABSOLUTE prices via stopLoss/takeProfit, or price DISTANCES via stopLossDistance/takeProfitDistance (required for a trailing stop). timeInForce defaults to GOOD_TILL_CANCEL; GOOD_TILL_DATE requires expiresAt. Pass `accountId` when several accounts are connected. WARNING: on a live account this moves real money.",
 		inputSchema: {
 			accountId: accountIdField,
-			symbolId: z.number().int().positive().describe("Symbol id from get_symbols"),
+			symbolId: z.coerce.number().int().positive().describe("Symbol id from get_symbols"),
 			side: z.enum(["BUY", "SELL"]).describe("Trade side"),
 			orderType: z.enum([
 				"MARKET",
@@ -1700,14 +1700,14 @@ function registerTools(server, pool) {
 				"STOP",
 				"STOP_LIMIT"
 			]).default("MARKET").describe("MARKET fills now; LIMIT rests at limitPrice; STOP triggers at stopPrice; STOP_LIMIT triggers at stopPrice with a max slippage of slippageInPoints"),
-			volumeLots: z.number().positive().describe("Order size in lots (e.g. 0.1). Converted to protocol volume via the symbol lotSize."),
-			limitPrice: z.number().positive().optional().describe("Required for LIMIT orders — the price to rest the order at"),
-			stopPrice: z.number().positive().optional().describe("Required for STOP and STOP_LIMIT orders — the trigger price"),
-			slippageInPoints: z.number().int().min(0).optional().describe("Required for STOP_LIMIT — max slippage from stopPrice, in points"),
-			stopLoss: z.number().positive().optional().describe("Absolute stop-loss price (mutually exclusive with stopLossDistance)"),
-			takeProfit: z.number().positive().optional().describe("Absolute take-profit price (mutually exclusive with takeProfitDistance)"),
-			stopLossDistance: z.number().positive().optional().describe("Stop-loss as a price DISTANCE from entry (e.g. 0.0010 = 10 pips on a 5-digit FX pair). Required when trailingStopLoss is true."),
-			takeProfitDistance: z.number().positive().optional().describe("Take-profit as a price DISTANCE from entry"),
+			volumeLots: z.coerce.number().positive().describe("Order size in lots (e.g. 0.1). Converted to protocol volume via the symbol lotSize."),
+			limitPrice: z.coerce.number().positive().optional().describe("Required for LIMIT orders — the price to rest the order at"),
+			stopPrice: z.coerce.number().positive().optional().describe("Required for STOP and STOP_LIMIT orders — the trigger price"),
+			slippageInPoints: z.coerce.number().int().min(0).optional().describe("Required for STOP_LIMIT — max slippage from stopPrice, in points"),
+			stopLoss: z.coerce.number().positive().optional().describe("Absolute stop-loss price (mutually exclusive with stopLossDistance)"),
+			takeProfit: z.coerce.number().positive().optional().describe("Absolute take-profit price (mutually exclusive with takeProfitDistance)"),
+			stopLossDistance: z.coerce.number().positive().optional().describe("Stop-loss as a price DISTANCE from entry (e.g. 0.0010 = 10 pips on a 5-digit FX pair). Required when trailingStopLoss is true."),
+			takeProfitDistance: z.coerce.number().positive().optional().describe("Take-profit as a price DISTANCE from entry"),
 			trailingStopLoss: z.boolean().optional().describe("Trail the stop-loss as price moves in your favour. Requires stopLossDistance (not an absolute stopLoss)."),
 			timeInForce: z.enum([
 				"GOOD_TILL_CANCEL",
@@ -1777,12 +1777,12 @@ function registerTools(server, pool) {
 		description: "Modify an existing order on a connected cTrader account. For a PENDING order (by orderId) you can change limitPrice/stopPrice/SL/TP. For an OPEN position's protection, pass positionId to set stopLoss/takeProfit. Provide exactly one of orderId or positionId. Pass `accountId` when several accounts are connected.",
 		inputSchema: {
 			accountId: accountIdField,
-			orderId: z.number().int().positive().optional().describe("Pending order id (from get_orders) to amend"),
-			positionId: z.number().int().positive().optional().describe("Open position id (from get_positions) to set SL/TP on"),
-			limitPrice: z.number().positive().optional().describe("New limit price (pending order only)"),
-			stopPrice: z.number().positive().optional().describe("New stop price (pending order only)"),
-			stopLoss: z.number().positive().optional().describe("New absolute stop-loss price"),
-			takeProfit: z.number().positive().optional().describe("New absolute take-profit price")
+			orderId: z.coerce.number().int().positive().optional().describe("Pending order id (from get_orders) to amend"),
+			positionId: z.coerce.number().int().positive().optional().describe("Open position id (from get_positions) to set SL/TP on"),
+			limitPrice: z.coerce.number().positive().optional().describe("New limit price (pending order only)"),
+			stopPrice: z.coerce.number().positive().optional().describe("New stop price (pending order only)"),
+			stopLoss: z.coerce.number().positive().optional().describe("New absolute stop-loss price"),
+			takeProfit: z.coerce.number().positive().optional().describe("New absolute take-profit price")
 		}
 	}, async (args) => {
 		const resolved = resolveAccount(pool, args.accountId);
@@ -1828,8 +1828,8 @@ function registerTools(server, pool) {
 		description: "Close an open position (fully or partially) on a connected cTrader account. Pass the positionId from get_positions. volumeLots defaults to the full position size when omitted. Pass `accountId` when several accounts are connected.",
 		inputSchema: {
 			accountId: accountIdField,
-			positionId: z.number().int().positive().describe("Position id from get_positions"),
-			volumeLots: z.number().positive().optional().describe("Lots to close; omit to close the whole position")
+			positionId: z.coerce.number().int().positive().describe("Position id from get_positions"),
+			volumeLots: z.coerce.number().positive().optional().describe("Lots to close; omit to close the whole position")
 		}
 	}, async (args) => {
 		const resolved = resolveAccount(pool, args.accountId);
@@ -1869,7 +1869,7 @@ function registerTools(server, pool) {
 		description: "Cancel a pending (not-yet-filled) order on a connected cTrader account. Pass the orderId from get_orders. Pass `accountId` when several accounts are connected.",
 		inputSchema: {
 			accountId: accountIdField,
-			orderId: z.number().int().positive().describe("Pending order id from get_orders")
+			orderId: z.coerce.number().int().positive().describe("Pending order id from get_orders")
 		}
 	}, async (args) => {
 		const resolved = resolveAccount(pool, args.accountId);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfe.ai/ctrader-mcp",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "cTrader MCP server — full trading (market/limit/stop/stop-limit orders, trailing stops), Level 2 depth, live quotes, trade history, PnL & margin over the cTrader Open API (protobuf/TLS)",
   "type": "module",
   "main": "./dist/server.js",
@@ -21,7 +21,7 @@
     "@modelcontextprotocol/sdk": "^1.29.0",
     "protobufjs": "^8.7.0",
     "zod": "^4.0.5",
-    "@alfe.ai/agent-api-client": "0.11.2",
+    "@alfe.ai/agent-api-client": "0.13.0",
     "@alfe.ai/config": "0.3.0"
   },
   "license": "UNLICENSED",