{"$schema":"https://static.modelcontextprotocol.io/schemas/v1/server-card.schema.json","name":"com.algotradertools/mcp","version":"1.0.0","description":"Manage MetaTrader 4 and 5 trade copying: accounts, copiers, followers and their copy rules.","title":"Algo Trader Tools","websiteUrl":"https://algotradertools.com/docs/mcp","icons":[{"src":"https://algotradertools.com/logo.png","mimeType":"image/png","sizes":["512x512"]}],"remotes":[{"type":"streamable-http","url":"https://mcp.algotradertools.com/mcp","headers":[{"name":"X-API-Key","description":"Algo Trader Tools API key (att_…), created under API keys in the app: https://app.algotradertools.com/api-keys. Its scopes decide which tools are listed.","isRequired":true,"isSecret":true}],"supportedProtocolVersions":["2026-07-28","2025-11-25","2025-06-18","2025-03-26"]}],"serverInfo":{"name":"algotradertools","title":"Algo Trader Tools","version":"1.0.0","description":"Manage MetaTrader 4 and MetaTrader 5 trade copying: trading accounts, copiers, followers and each follower's copy rules (sizing, reverse, stops, symbol filters and mapping, trading sessions).","websiteUrl":"https://algotradertools.com/docs/mcp","icons":[{"src":"https://algotradertools.com/logo.png","mimeType":"image/png","sizes":["512x512"]}]},"authentication":{"required":true,"schemes":["apiKey"]},"instructions":"Algo Trader Tools copies trades between MetaTrader 4 and 5 accounts. These tools manage the accounts, copiers and followers of the user this API key belongs to, with the same rules as the app. A copier copies one master account to its followers, and each follower has its own rules: sizing, reverse, stops, symbol filters and mapping, trading sessions.\n\nStart with list_accounts and list_copiers to get ids. An account id goes into create_copier as master_id and into add_follower as account_id. Lists come in pages: while has_more is true, pass next_cursor as cursor. Only the tools this key's scopes allow are listed. Without a key every tool is listed, and each call fails with authentication_required: the user creates a key at https://app.algotradertools.com/api-keys and adds it to this client's settings.\n\nChanges reach live trading at once. Pausing stops new copies; delete_copier and remove_follower with close_positions=true close the copies at market; disconnect_account deletes the account with its history. Confirm with the user before changing or deleting anything.\n\nA failed call returns the API's error: code says what went wrong, detail how to fix it, and errors lists each invalid field with a JSON Pointer to it.\n\nConnecting or reconnecting an account needs the broker password, which should not pass through a chat, so there is no tool for it: the user connects accounts in the app at https://app.algotradertools.com/accounts.","tools":[{"name":"list_accounts","title":"List accounts","description":"Your connected MetaTrader accounts, newest first.","inputSchema":{"type":"object","properties":{"limit":{"description":"Items per page, 1 to 100 (default 50).","type":"integer","minimum":1,"maximum":100,"default":50},"cursor":{"description":"The `next_cursor` of the previous page. Leave it out for the first page.","type":"string"}},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"object":{"type":"string","enum":["list"],"description":"Always `list`."},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The account's ID.","format":"uuid","examples":["6f1c2d4e-8a9b-4c3d-9e2f-1a2b3c4d5e6f"]},"object":{"type":"string","enum":["account"],"description":"What this object is."},"name":{"type":"string","description":"Its nickname, or the platform and login.","examples":["Gold master"]},"nickname":{"type":"string","description":"Empty when none was given.","examples":["Gold master"]},"platform":{"type":"string","enum":["mt4","mt5"]},"server":{"type":"string","description":"The broker's server.","examples":["ICMarketsSC-Demo"]},"login":{"type":"integer","description":"The MetaTrader account number.","examples":[51234567]},"credential_kind":{"type":"string","enum":["investor","master"],"description":"Which password it was connected with: `master` can trade, `investor` only reads."},"can_trade":{"type":"boolean","description":"Whether it can place trades, so it can be a follower. Any account can be a master."},"status":{"type":"string","enum":["connecting","connected","error","disconnected"],"description":"`connecting` while its terminal starts and logs in (two to three minutes), `connected` once it's ready, `error` when the login failed (see `error`), `disconnected` when its terminal lost the broker or was released."},"error":{"type":["string","null"],"description":"Why it's in `error` or `disconnected`, if known."},"released":{"type":"boolean","description":"Its terminal was released after the subscription lapsed. The account and its history are kept: reconnect it to resume."},"proxy_type":{"type":["string","null"],"enum":["socks5","socks4","http",null],"description":"The proxy's protocol; null without one."},"proxy_address":{"type":["string","null"],"description":"The proxy its terminal reaches the broker through, as `host:port`; null for a direct connection.","examples":["198.51.100.10:1080"]},"role":{"type":["string","null"],"enum":["master","follower",null],"description":"Whether a copier uses it, and how. An account is never both."},"figures":{"anyOf":[{"type":"object","properties":{"balance":{"type":"number","examples":[10000.0]},"equity":{"type":"number","examples":[10250.5]},"profit":{"type":"number","description":"Floating profit or loss of the open positions.","examples":[250.5]},"margin":{"type":"number","examples":[400.0]},"free_margin":{"type":"number","examples":[9850.5]},"margin_level":{"type":["number","null"],"description":"In percent; null while no margin is used."},"currency":{"type":"string","description":"As the broker reports it: usually ISO 4217, but also codes such as `USC` (US cents) or `USDT`.","examples":["USD"]},"open_positions":{"type":"integer","examples":[2]},"as_of":{"type":"string","description":"When the terminal reported these figures.","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]},"source":{"type":"string","enum":["live","snapshot"],"description":"`live`: streamed by the copier engine, at most 30 seconds old. `snapshot`: the last stored snapshot, taken every few minutes."}},"description":"The account's freshest figures.","required":["balance","equity","profit","margin","free_margin","margin_level","currency","open_positions","as_of","source"]},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]}},"description":"A MetaTrader 4 or 5 account, connected through its own hosted terminal.","required":["id","object","name","nickname","platform","server","login","credential_kind","can_trade","status","error","released","proxy_type","proxy_address","role","figures","created_at"]},"description":"Newest first."},"has_more":{"type":"boolean","description":"Whether there's another page: pass `next_cursor` as `cursor`."},"next_cursor":{"type":["string","null"],"description":"The cursor of the next page; null on the last one."}},"required":["object","data","has_more","next_cursor"]},"annotations":{"title":"List accounts","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"get_account","title":"Retrieve an account","description":"The account with its status, role and freshest figures.","inputSchema":{"type":"object","properties":{"account_id":{"description":"The account's ID.","type":"string","format":"uuid","examples":["6f1c2d4e-8a9b-4c3d-9e2f-1a2b3c4d5e6f"]}},"required":["account_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"id":{"type":"string","description":"The account's ID.","format":"uuid","examples":["6f1c2d4e-8a9b-4c3d-9e2f-1a2b3c4d5e6f"]},"object":{"type":"string","enum":["account"],"description":"What this object is."},"name":{"type":"string","description":"Its nickname, or the platform and login.","examples":["Gold master"]},"nickname":{"type":"string","description":"Empty when none was given.","examples":["Gold master"]},"platform":{"type":"string","enum":["mt4","mt5"]},"server":{"type":"string","description":"The broker's server.","examples":["ICMarketsSC-Demo"]},"login":{"type":"integer","description":"The MetaTrader account number.","examples":[51234567]},"credential_kind":{"type":"string","enum":["investor","master"],"description":"Which password it was connected with: `master` can trade, `investor` only reads."},"can_trade":{"type":"boolean","description":"Whether it can place trades, so it can be a follower. Any account can be a master."},"status":{"type":"string","enum":["connecting","connected","error","disconnected"],"description":"`connecting` while its terminal starts and logs in (two to three minutes), `connected` once it's ready, `error` when the login failed (see `error`), `disconnected` when its terminal lost the broker or was released."},"error":{"type":["string","null"],"description":"Why it's in `error` or `disconnected`, if known."},"released":{"type":"boolean","description":"Its terminal was released after the subscription lapsed. The account and its history are kept: reconnect it to resume."},"proxy_type":{"type":["string","null"],"enum":["socks5","socks4","http",null],"description":"The proxy's protocol; null without one."},"proxy_address":{"type":["string","null"],"description":"The proxy its terminal reaches the broker through, as `host:port`; null for a direct connection.","examples":["198.51.100.10:1080"]},"role":{"type":["string","null"],"enum":["master","follower",null],"description":"Whether a copier uses it, and how. An account is never both."},"figures":{"anyOf":[{"type":"object","properties":{"balance":{"type":"number","examples":[10000.0]},"equity":{"type":"number","examples":[10250.5]},"profit":{"type":"number","description":"Floating profit or loss of the open positions.","examples":[250.5]},"margin":{"type":"number","examples":[400.0]},"free_margin":{"type":"number","examples":[9850.5]},"margin_level":{"type":["number","null"],"description":"In percent; null while no margin is used."},"currency":{"type":"string","description":"As the broker reports it: usually ISO 4217, but also codes such as `USC` (US cents) or `USDT`.","examples":["USD"]},"open_positions":{"type":"integer","examples":[2]},"as_of":{"type":"string","description":"When the terminal reported these figures.","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]},"source":{"type":"string","enum":["live","snapshot"],"description":"`live`: streamed by the copier engine, at most 30 seconds old. `snapshot`: the last stored snapshot, taken every few minutes."}},"description":"The account's freshest figures.","required":["balance","equity","profit","margin","free_margin","margin_level","currency","open_positions","as_of","source"]},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]}},"description":"A MetaTrader 4 or 5 account, connected through its own hosted terminal.","required":["id","object","name","nickname","platform","server","login","credential_kind","can_trade","status","error","released","proxy_type","proxy_address","role","figures","created_at"]},"annotations":{"title":"Retrieve an account","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"disconnect_account","title":"Disconnect an account","description":"Stops the account's terminal and deletes the account with its stored history. An account a copier uses is refused with `account_in_use`: delete the copier or remove the follower first.","inputSchema":{"type":"object","properties":{"account_id":{"description":"The account's ID.","type":"string","format":"uuid","examples":["6f1c2d4e-8a9b-4c3d-9e2f-1a2b3c4d5e6f"]}},"required":["account_id"],"additionalProperties":false},"outputSchema":{"type":"object","description":"The deletion went through.","properties":{"deleted":{"type":"boolean","const":true,"description":"Always true. A deletion that fails comes back as an error instead."}},"required":["deleted"],"additionalProperties":false},"annotations":{"title":"Disconnect an account","readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"list_copiers","title":"List copiers","description":"Your copiers with their followers, oldest first.","inputSchema":{"type":"object","properties":{"limit":{"description":"Items per page, 1 to 100 (default 50).","type":"integer","minimum":1,"maximum":100,"default":50},"cursor":{"description":"The `next_cursor` of the previous page. Leave it out for the first page.","type":"string"}},"additionalProperties":false},"outputSchema":{"type":"object","properties":{"object":{"type":"string","enum":["list"],"description":"Always `list`."},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The copier's ID.","format":"uuid","examples":["3d2c1b0a-9f8e-4d7c-8b6a-5f4e3d2c1b0a"]},"object":{"type":"string","enum":["copier"],"description":"What this object is."},"name":{"type":"string","examples":["Gold strategy"]},"is_active":{"type":"boolean","description":"False while the copier is paused."},"master_id":{"type":"string","description":"The account that is copied.","format":"uuid","examples":["6f1c2d4e-8a9b-4c3d-9e2f-1a2b3c4d5e6f"]},"master":{"type":"object","properties":{"id":{"type":"string","description":"The account's ID.","format":"uuid","examples":["6f1c2d4e-8a9b-4c3d-9e2f-1a2b3c4d5e6f"]},"name":{"type":"string","description":"Its nickname, or the platform and login.","examples":["Gold master"]},"platform":{"type":"string","enum":["mt4","mt5"]},"server":{"type":"string","description":"The broker's server.","examples":["ICMarketsSC-Demo"]},"login":{"type":"integer","description":"The MetaTrader account number.","examples":[51234567]},"status":{"type":"string","enum":["connecting","connected","error","disconnected"],"description":"Whether its terminal is connected."}},"description":"An account as other objects show it. Get the account for the rest.","required":["id","name","platform","server","login","status"]},"followers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The follower's ID.","format":"uuid","examples":["9a8b7c6d-5e4f-4a3b-9c2d-1e0f9a8b7c6d"]},"object":{"type":"string","enum":["follower"],"description":"What this object is."},"copier_id":{"type":"string","description":"Its copier.","format":"uuid","examples":["3d2c1b0a-9f8e-4d7c-8b6a-5f4e3d2c1b0a"]},"account_id":{"type":"string","description":"The account that copies.","format":"uuid","examples":["0b7e5c1a-2f3d-4e6a-8b9c-7d6e5f4a3b2c"]},"account":{"type":"object","properties":{"id":{"type":"string","description":"The account's ID.","format":"uuid","examples":["6f1c2d4e-8a9b-4c3d-9e2f-1a2b3c4d5e6f"]},"name":{"type":"string","description":"Its nickname, or the platform and login.","examples":["Gold master"]},"platform":{"type":"string","enum":["mt4","mt5"]},"server":{"type":"string","description":"The broker's server.","examples":["ICMarketsSC-Demo"]},"login":{"type":"integer","description":"The MetaTrader account number.","examples":[51234567]},"status":{"type":"string","enum":["connecting","connected","error","disconnected"],"description":"Whether its terminal is connected."}},"description":"An account as other objects show it. Get the account for the rest.","required":["id","name","platform","server","login","status"]},"is_active":{"type":"boolean","description":"False while this follower is paused."},"magic":{"type":"integer","description":"The magic number on every order placed for this follower. Each copy's comment is `att:` and the master's ticket in base 36.","examples":[1844674407]},"lot_mode":{"type":"string","enum":["multiplier","fixed","balance_ratio","equity_ratio","risk_percent"],"description":"How each copy is sized. `multiplier`: the master's lots times `lot_value`. `fixed`: `lot_value` lots on every copy. `balance_ratio` / `equity_ratio`: the master's lots scaled by this account's balance or equity against the master's, times `lot_value`. `risk_percent`: sized so the master's stop loss risks `lot_value` percent of this account's equity; trades without a stop loss are skipped."},"lot_value":{"type":"number","description":"The multiplier, the lot size or the risk percentage, by `lot_mode`. Above 0 and up to 1000; up to 100 for `risk_percent`. Up to four decimal places.","examples":[1]},"adjust_contract_size":{"type":"boolean","description":"Even out different contract sizes between the brokers (gold can be 100 oz a lot at one broker and 10 oz at another). Applies to `multiplier` and the ratio modes."},"below_minimum":{"type":"string","enum":["minimum","skip"],"description":"When a copy comes out below the broker's minimum lot: trade the minimum, or skip it."},"max_lot":{"type":["number","null"],"description":"The most lots one copy may have; null for no limit."},"reverse":{"type":"boolean","description":"Sell when the master buys and the other way round; stop loss and take profit swap."},"copy_stops":{"type":"boolean","description":"Copy stop loss and take profit, including later changes."},"max_slippage_pips":{"type":["number","null"],"description":"The slippage allowed per order; null uses the broker's default."},"max_delay_seconds":{"type":"integer","description":"How late a master trade may still be copied, for example after a reconnect; older ones are skipped."},"copy_existing":{"type":"boolean","description":"Also copy the positions and pending orders the master already has when the follower is attached. Nothing the master opens or places during a pause is ever copied."},"copy_pending":{"type":"boolean","description":"Place the master's pending orders on the follower as pending orders, and follow their changes, rather than copying them once they fill. Needs both terminals on the current version."},"symbol_filter":{"type":"string","enum":["all","include","exclude"],"description":"`all` copies every symbol, `include` only those in `symbols`, `exclude` all but them."},"symbols":{"type":"array","items":{"type":"string"},"description":"The master's symbol names for `symbol_filter`, which needs at least one unless it is `all`. `XAUUSD` also covers decorated names such as `XAUUSD.m`.","examples":[["XAUUSD","EURUSD"]]},"sessions":{"type":"array","items":{"type":"object","properties":{"days":{"type":"array","items":{"type":"integer"},"description":"0 is Monday, 6 Sunday.","examples":[[0,1,2,3,4]]},"start":{"type":"string","description":"`HH:MM`, 24-hour.","examples":["07:00"]},"end":{"type":"string","description":"`HH:MM`. An end before its start runs past midnight.","examples":["16:30"]}},"description":"A window in which new trades are copied.","required":["days","start","end"]},"description":"When new trades are copied; empty means any time. Closes and changes to copies already open are always copied."},"timezone":{"type":"string","description":"The clock `sessions` are read on: `broker` (the master broker's server time, as its MetaTrader charts show it) or a time zone name such as `Europe/London`.","examples":["broker"]},"symbol_map":{"type":"object","additionalProperties":{"type":"string"},"description":"Master symbol to follower symbol, for names that don't match by themselves. Matching tries this map, then the same name, the name without the broker's decorations (`EURUSD.m`, `US30.cash`), then known aliases (`XAUUSD` and `GOLD`); anything still ambiguous is skipped, never guessed.","examples":[{"XAUUSD":"GOLD.m"}]},"status":{"anyOf":[{"type":"object","properties":{"state":{"type":"string","enum":["starting","copying","paused","error"],"description":"`starting` while the engine connects, `copying`, `paused` (the follower or its copier is paused, or Equity Guard holds copying back), or `error` (see `message`)."},"message":{"type":"string","description":"Why it needs attention, or `Paused by Equity Guard.` while Equity Guard holds copying back; empty otherwise."},"master_connected":{"type":"boolean","description":"The engine's stream from the master's terminal is up."},"follower_connected":{"type":"boolean","description":"The engine's stream from this account's terminal is up."},"open_copies":{"type":"integer","description":"Copies open on this account now.","examples":[2]},"last_event_at":{"type":["string","null"],"description":"When the engine last did something here.","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]},"balance":{"type":["number","null"],"description":"This account's balance as the engine last saw it."},"equity":{"type":["number","null"],"description":"This account's equity as the engine last saw it."},"currency":{"type":"string","examples":["USD"]},"heartbeat_at":{"type":"string","description":"When the engine last reported; at least every 15 seconds.","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]},"engine_online":{"type":"boolean","description":"False when the engine hasn't reported for 60 seconds."}},"description":"What the copier engine reports about a follower, as of `heartbeat_at`.","required":["state","message","master_connected","follower_connected","open_copies","last_event_at","balance","equity","currency","heartbeat_at","engine_online"]},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]},"updated_at":{"type":"string","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]}},"description":"An account that copies a copier's master, with its own rules.","required":["id","object","copier_id","account_id","account","is_active","magic","lot_mode","lot_value","adjust_contract_size","below_minimum","max_lot","reverse","copy_stops","max_slippage_pips","max_delay_seconds","copy_existing","copy_pending","symbol_filter","symbols","sessions","timezone","symbol_map","status","created_at","updated_at"]},"description":"Oldest first."},"open_copies":{"type":"integer","description":"Copies open across all followers now.","examples":[2]},"created_at":{"type":"string","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]},"updated_at":{"type":"string","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]}},"description":"One master account and the followers that copy it.","required":["id","object","name","is_active","master_id","master","followers","open_copies","created_at","updated_at"]},"description":"Oldest first."},"has_more":{"type":"boolean","description":"Whether there's another page: pass `next_cursor` as `cursor`."},"next_cursor":{"type":["string","null"],"description":"The cursor of the next page; null on the last one."}},"required":["object","data","has_more","next_cursor"]},"annotations":{"title":"List copiers","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"create_copier","title":"Create a copier","description":"A copier copies one master account to its followers. It starts without any: add them next. Masters must be hedging accounts (all of MT4, and MT5 hedging accounts). Retrying a failed request can create a second copier; list your copiers first.","inputSchema":{"type":"object","properties":{"name":{"type":"string","description":"A name to tell it apart.","minLength":1,"maxLength":64,"examples":["Gold strategy"]},"master_id":{"type":"string","description":"One of your connected accounts that doesn't follow anything. Investor-password accounts can be masters. Several copiers can share a master.","format":"uuid","examples":["6f1c2d4e-8a9b-4c3d-9e2f-1a2b3c4d5e6f"]},"is_active":{"type":"boolean","description":"Start paused with `false`.","default":true}},"required":["name","master_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"id":{"type":"string","description":"The copier's ID.","format":"uuid","examples":["3d2c1b0a-9f8e-4d7c-8b6a-5f4e3d2c1b0a"]},"object":{"type":"string","enum":["copier"],"description":"What this object is."},"name":{"type":"string","examples":["Gold strategy"]},"is_active":{"type":"boolean","description":"False while the copier is paused."},"master_id":{"type":"string","description":"The account that is copied.","format":"uuid","examples":["6f1c2d4e-8a9b-4c3d-9e2f-1a2b3c4d5e6f"]},"master":{"type":"object","properties":{"id":{"type":"string","description":"The account's ID.","format":"uuid","examples":["6f1c2d4e-8a9b-4c3d-9e2f-1a2b3c4d5e6f"]},"name":{"type":"string","description":"Its nickname, or the platform and login.","examples":["Gold master"]},"platform":{"type":"string","enum":["mt4","mt5"]},"server":{"type":"string","description":"The broker's server.","examples":["ICMarketsSC-Demo"]},"login":{"type":"integer","description":"The MetaTrader account number.","examples":[51234567]},"status":{"type":"string","enum":["connecting","connected","error","disconnected"],"description":"Whether its terminal is connected."}},"description":"An account as other objects show it. Get the account for the rest.","required":["id","name","platform","server","login","status"]},"followers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The follower's ID.","format":"uuid","examples":["9a8b7c6d-5e4f-4a3b-9c2d-1e0f9a8b7c6d"]},"object":{"type":"string","enum":["follower"],"description":"What this object is."},"copier_id":{"type":"string","description":"Its copier.","format":"uuid","examples":["3d2c1b0a-9f8e-4d7c-8b6a-5f4e3d2c1b0a"]},"account_id":{"type":"string","description":"The account that copies.","format":"uuid","examples":["0b7e5c1a-2f3d-4e6a-8b9c-7d6e5f4a3b2c"]},"account":{"type":"object","properties":{"id":{"type":"string","description":"The account's ID.","format":"uuid","examples":["6f1c2d4e-8a9b-4c3d-9e2f-1a2b3c4d5e6f"]},"name":{"type":"string","description":"Its nickname, or the platform and login.","examples":["Gold master"]},"platform":{"type":"string","enum":["mt4","mt5"]},"server":{"type":"string","description":"The broker's server.","examples":["ICMarketsSC-Demo"]},"login":{"type":"integer","description":"The MetaTrader account number.","examples":[51234567]},"status":{"type":"string","enum":["connecting","connected","error","disconnected"],"description":"Whether its terminal is connected."}},"description":"An account as other objects show it. Get the account for the rest.","required":["id","name","platform","server","login","status"]},"is_active":{"type":"boolean","description":"False while this follower is paused."},"magic":{"type":"integer","description":"The magic number on every order placed for this follower. Each copy's comment is `att:` and the master's ticket in base 36.","examples":[1844674407]},"lot_mode":{"type":"string","enum":["multiplier","fixed","balance_ratio","equity_ratio","risk_percent"],"description":"How each copy is sized. `multiplier`: the master's lots times `lot_value`. `fixed`: `lot_value` lots on every copy. `balance_ratio` / `equity_ratio`: the master's lots scaled by this account's balance or equity against the master's, times `lot_value`. `risk_percent`: sized so the master's stop loss risks `lot_value` percent of this account's equity; trades without a stop loss are skipped."},"lot_value":{"type":"number","description":"The multiplier, the lot size or the risk percentage, by `lot_mode`. Above 0 and up to 1000; up to 100 for `risk_percent`. Up to four decimal places.","examples":[1]},"adjust_contract_size":{"type":"boolean","description":"Even out different contract sizes between the brokers (gold can be 100 oz a lot at one broker and 10 oz at another). Applies to `multiplier` and the ratio modes."},"below_minimum":{"type":"string","enum":["minimum","skip"],"description":"When a copy comes out below the broker's minimum lot: trade the minimum, or skip it."},"max_lot":{"type":["number","null"],"description":"The most lots one copy may have; null for no limit."},"reverse":{"type":"boolean","description":"Sell when the master buys and the other way round; stop loss and take profit swap."},"copy_stops":{"type":"boolean","description":"Copy stop loss and take profit, including later changes."},"max_slippage_pips":{"type":["number","null"],"description":"The slippage allowed per order; null uses the broker's default."},"max_delay_seconds":{"type":"integer","description":"How late a master trade may still be copied, for example after a reconnect; older ones are skipped."},"copy_existing":{"type":"boolean","description":"Also copy the positions and pending orders the master already has when the follower is attached. Nothing the master opens or places during a pause is ever copied."},"copy_pending":{"type":"boolean","description":"Place the master's pending orders on the follower as pending orders, and follow their changes, rather than copying them once they fill. Needs both terminals on the current version."},"symbol_filter":{"type":"string","enum":["all","include","exclude"],"description":"`all` copies every symbol, `include` only those in `symbols`, `exclude` all but them."},"symbols":{"type":"array","items":{"type":"string"},"description":"The master's symbol names for `symbol_filter`, which needs at least one unless it is `all`. `XAUUSD` also covers decorated names such as `XAUUSD.m`.","examples":[["XAUUSD","EURUSD"]]},"sessions":{"type":"array","items":{"type":"object","properties":{"days":{"type":"array","items":{"type":"integer"},"description":"0 is Monday, 6 Sunday.","examples":[[0,1,2,3,4]]},"start":{"type":"string","description":"`HH:MM`, 24-hour.","examples":["07:00"]},"end":{"type":"string","description":"`HH:MM`. An end before its start runs past midnight.","examples":["16:30"]}},"description":"A window in which new trades are copied.","required":["days","start","end"]},"description":"When new trades are copied; empty means any time. Closes and changes to copies already open are always copied."},"timezone":{"type":"string","description":"The clock `sessions` are read on: `broker` (the master broker's server time, as its MetaTrader charts show it) or a time zone name such as `Europe/London`.","examples":["broker"]},"symbol_map":{"type":"object","additionalProperties":{"type":"string"},"description":"Master symbol to follower symbol, for names that don't match by themselves. Matching tries this map, then the same name, the name without the broker's decorations (`EURUSD.m`, `US30.cash`), then known aliases (`XAUUSD` and `GOLD`); anything still ambiguous is skipped, never guessed.","examples":[{"XAUUSD":"GOLD.m"}]},"status":{"anyOf":[{"type":"object","properties":{"state":{"type":"string","enum":["starting","copying","paused","error"],"description":"`starting` while the engine connects, `copying`, `paused` (the follower or its copier is paused, or Equity Guard holds copying back), or `error` (see `message`)."},"message":{"type":"string","description":"Why it needs attention, or `Paused by Equity Guard.` while Equity Guard holds copying back; empty otherwise."},"master_connected":{"type":"boolean","description":"The engine's stream from the master's terminal is up."},"follower_connected":{"type":"boolean","description":"The engine's stream from this account's terminal is up."},"open_copies":{"type":"integer","description":"Copies open on this account now.","examples":[2]},"last_event_at":{"type":["string","null"],"description":"When the engine last did something here.","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]},"balance":{"type":["number","null"],"description":"This account's balance as the engine last saw it."},"equity":{"type":["number","null"],"description":"This account's equity as the engine last saw it."},"currency":{"type":"string","examples":["USD"]},"heartbeat_at":{"type":"string","description":"When the engine last reported; at least every 15 seconds.","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]},"engine_online":{"type":"boolean","description":"False when the engine hasn't reported for 60 seconds."}},"description":"What the copier engine reports about a follower, as of `heartbeat_at`.","required":["state","message","master_connected","follower_connected","open_copies","last_event_at","balance","equity","currency","heartbeat_at","engine_online"]},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]},"updated_at":{"type":"string","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]}},"description":"An account that copies a copier's master, with its own rules.","required":["id","object","copier_id","account_id","account","is_active","magic","lot_mode","lot_value","adjust_contract_size","below_minimum","max_lot","reverse","copy_stops","max_slippage_pips","max_delay_seconds","copy_existing","copy_pending","symbol_filter","symbols","sessions","timezone","symbol_map","status","created_at","updated_at"]},"description":"Oldest first."},"open_copies":{"type":"integer","description":"Copies open across all followers now.","examples":[2]},"created_at":{"type":"string","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]},"updated_at":{"type":"string","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]}},"description":"One master account and the followers that copy it.","required":["id","object","name","is_active","master_id","master","followers","open_copies","created_at","updated_at"]},"annotations":{"title":"Create a copier","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get_copier","title":"Retrieve a copier","description":"The copier with its master, its followers and what the engine reports about each.","inputSchema":{"type":"object","properties":{"copier_id":{"description":"The copier's ID.","type":"string","format":"uuid","examples":["3d2c1b0a-9f8e-4d7c-8b6a-5f4e3d2c1b0a"]}},"required":["copier_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"id":{"type":"string","description":"The copier's ID.","format":"uuid","examples":["3d2c1b0a-9f8e-4d7c-8b6a-5f4e3d2c1b0a"]},"object":{"type":"string","enum":["copier"],"description":"What this object is."},"name":{"type":"string","examples":["Gold strategy"]},"is_active":{"type":"boolean","description":"False while the copier is paused."},"master_id":{"type":"string","description":"The account that is copied.","format":"uuid","examples":["6f1c2d4e-8a9b-4c3d-9e2f-1a2b3c4d5e6f"]},"master":{"type":"object","properties":{"id":{"type":"string","description":"The account's ID.","format":"uuid","examples":["6f1c2d4e-8a9b-4c3d-9e2f-1a2b3c4d5e6f"]},"name":{"type":"string","description":"Its nickname, or the platform and login.","examples":["Gold master"]},"platform":{"type":"string","enum":["mt4","mt5"]},"server":{"type":"string","description":"The broker's server.","examples":["ICMarketsSC-Demo"]},"login":{"type":"integer","description":"The MetaTrader account number.","examples":[51234567]},"status":{"type":"string","enum":["connecting","connected","error","disconnected"],"description":"Whether its terminal is connected."}},"description":"An account as other objects show it. Get the account for the rest.","required":["id","name","platform","server","login","status"]},"followers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The follower's ID.","format":"uuid","examples":["9a8b7c6d-5e4f-4a3b-9c2d-1e0f9a8b7c6d"]},"object":{"type":"string","enum":["follower"],"description":"What this object is."},"copier_id":{"type":"string","description":"Its copier.","format":"uuid","examples":["3d2c1b0a-9f8e-4d7c-8b6a-5f4e3d2c1b0a"]},"account_id":{"type":"string","description":"The account that copies.","format":"uuid","examples":["0b7e5c1a-2f3d-4e6a-8b9c-7d6e5f4a3b2c"]},"account":{"type":"object","properties":{"id":{"type":"string","description":"The account's ID.","format":"uuid","examples":["6f1c2d4e-8a9b-4c3d-9e2f-1a2b3c4d5e6f"]},"name":{"type":"string","description":"Its nickname, or the platform and login.","examples":["Gold master"]},"platform":{"type":"string","enum":["mt4","mt5"]},"server":{"type":"string","description":"The broker's server.","examples":["ICMarketsSC-Demo"]},"login":{"type":"integer","description":"The MetaTrader account number.","examples":[51234567]},"status":{"type":"string","enum":["connecting","connected","error","disconnected"],"description":"Whether its terminal is connected."}},"description":"An account as other objects show it. Get the account for the rest.","required":["id","name","platform","server","login","status"]},"is_active":{"type":"boolean","description":"False while this follower is paused."},"magic":{"type":"integer","description":"The magic number on every order placed for this follower. Each copy's comment is `att:` and the master's ticket in base 36.","examples":[1844674407]},"lot_mode":{"type":"string","enum":["multiplier","fixed","balance_ratio","equity_ratio","risk_percent"],"description":"How each copy is sized. `multiplier`: the master's lots times `lot_value`. `fixed`: `lot_value` lots on every copy. `balance_ratio` / `equity_ratio`: the master's lots scaled by this account's balance or equity against the master's, times `lot_value`. `risk_percent`: sized so the master's stop loss risks `lot_value` percent of this account's equity; trades without a stop loss are skipped."},"lot_value":{"type":"number","description":"The multiplier, the lot size or the risk percentage, by `lot_mode`. Above 0 and up to 1000; up to 100 for `risk_percent`. Up to four decimal places.","examples":[1]},"adjust_contract_size":{"type":"boolean","description":"Even out different contract sizes between the brokers (gold can be 100 oz a lot at one broker and 10 oz at another). Applies to `multiplier` and the ratio modes."},"below_minimum":{"type":"string","enum":["minimum","skip"],"description":"When a copy comes out below the broker's minimum lot: trade the minimum, or skip it."},"max_lot":{"type":["number","null"],"description":"The most lots one copy may have; null for no limit."},"reverse":{"type":"boolean","description":"Sell when the master buys and the other way round; stop loss and take profit swap."},"copy_stops":{"type":"boolean","description":"Copy stop loss and take profit, including later changes."},"max_slippage_pips":{"type":["number","null"],"description":"The slippage allowed per order; null uses the broker's default."},"max_delay_seconds":{"type":"integer","description":"How late a master trade may still be copied, for example after a reconnect; older ones are skipped."},"copy_existing":{"type":"boolean","description":"Also copy the positions and pending orders the master already has when the follower is attached. Nothing the master opens or places during a pause is ever copied."},"copy_pending":{"type":"boolean","description":"Place the master's pending orders on the follower as pending orders, and follow their changes, rather than copying them once they fill. Needs both terminals on the current version."},"symbol_filter":{"type":"string","enum":["all","include","exclude"],"description":"`all` copies every symbol, `include` only those in `symbols`, `exclude` all but them."},"symbols":{"type":"array","items":{"type":"string"},"description":"The master's symbol names for `symbol_filter`, which needs at least one unless it is `all`. `XAUUSD` also covers decorated names such as `XAUUSD.m`.","examples":[["XAUUSD","EURUSD"]]},"sessions":{"type":"array","items":{"type":"object","properties":{"days":{"type":"array","items":{"type":"integer"},"description":"0 is Monday, 6 Sunday.","examples":[[0,1,2,3,4]]},"start":{"type":"string","description":"`HH:MM`, 24-hour.","examples":["07:00"]},"end":{"type":"string","description":"`HH:MM`. An end before its start runs past midnight.","examples":["16:30"]}},"description":"A window in which new trades are copied.","required":["days","start","end"]},"description":"When new trades are copied; empty means any time. Closes and changes to copies already open are always copied."},"timezone":{"type":"string","description":"The clock `sessions` are read on: `broker` (the master broker's server time, as its MetaTrader charts show it) or a time zone name such as `Europe/London`.","examples":["broker"]},"symbol_map":{"type":"object","additionalProperties":{"type":"string"},"description":"Master symbol to follower symbol, for names that don't match by themselves. Matching tries this map, then the same name, the name without the broker's decorations (`EURUSD.m`, `US30.cash`), then known aliases (`XAUUSD` and `GOLD`); anything still ambiguous is skipped, never guessed.","examples":[{"XAUUSD":"GOLD.m"}]},"status":{"anyOf":[{"type":"object","properties":{"state":{"type":"string","enum":["starting","copying","paused","error"],"description":"`starting` while the engine connects, `copying`, `paused` (the follower or its copier is paused, or Equity Guard holds copying back), or `error` (see `message`)."},"message":{"type":"string","description":"Why it needs attention, or `Paused by Equity Guard.` while Equity Guard holds copying back; empty otherwise."},"master_connected":{"type":"boolean","description":"The engine's stream from the master's terminal is up."},"follower_connected":{"type":"boolean","description":"The engine's stream from this account's terminal is up."},"open_copies":{"type":"integer","description":"Copies open on this account now.","examples":[2]},"last_event_at":{"type":["string","null"],"description":"When the engine last did something here.","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]},"balance":{"type":["number","null"],"description":"This account's balance as the engine last saw it."},"equity":{"type":["number","null"],"description":"This account's equity as the engine last saw it."},"currency":{"type":"string","examples":["USD"]},"heartbeat_at":{"type":"string","description":"When the engine last reported; at least every 15 seconds.","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]},"engine_online":{"type":"boolean","description":"False when the engine hasn't reported for 60 seconds."}},"description":"What the copier engine reports about a follower, as of `heartbeat_at`.","required":["state","message","master_connected","follower_connected","open_copies","last_event_at","balance","equity","currency","heartbeat_at","engine_online"]},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]},"updated_at":{"type":"string","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]}},"description":"An account that copies a copier's master, with its own rules.","required":["id","object","copier_id","account_id","account","is_active","magic","lot_mode","lot_value","adjust_contract_size","below_minimum","max_lot","reverse","copy_stops","max_slippage_pips","max_delay_seconds","copy_existing","copy_pending","symbol_filter","symbols","sessions","timezone","symbol_map","status","created_at","updated_at"]},"description":"Oldest first."},"open_copies":{"type":"integer","description":"Copies open across all followers now.","examples":[2]},"created_at":{"type":"string","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]},"updated_at":{"type":"string","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]}},"description":"One master account and the followers that copy it.","required":["id","object","name","is_active","master_id","master","followers","open_copies","created_at","updated_at"]},"annotations":{"title":"Retrieve a copier","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"update_copier","title":"Update a copier","description":"Rename, pause or resume a copier. Pausing stops new copies on every follower; copies already open stay and still follow the master's closes and changes. Resuming copies only what the master opens from then on.","inputSchema":{"type":"object","properties":{"copier_id":{"description":"The copier's ID.","type":"string","format":"uuid","examples":["3d2c1b0a-9f8e-4d7c-8b6a-5f4e3d2c1b0a"]},"name":{"type":"string","minLength":1,"maxLength":64,"examples":["Gold strategy v2"]},"is_active":{"type":"boolean","description":"Pause every follower with `false`. Copies already open stay and still follow the master's closes and changes. Resuming copies only what the master opens from then on."}},"required":["copier_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"id":{"type":"string","description":"The copier's ID.","format":"uuid","examples":["3d2c1b0a-9f8e-4d7c-8b6a-5f4e3d2c1b0a"]},"object":{"type":"string","enum":["copier"],"description":"What this object is."},"name":{"type":"string","examples":["Gold strategy"]},"is_active":{"type":"boolean","description":"False while the copier is paused."},"master_id":{"type":"string","description":"The account that is copied.","format":"uuid","examples":["6f1c2d4e-8a9b-4c3d-9e2f-1a2b3c4d5e6f"]},"master":{"type":"object","properties":{"id":{"type":"string","description":"The account's ID.","format":"uuid","examples":["6f1c2d4e-8a9b-4c3d-9e2f-1a2b3c4d5e6f"]},"name":{"type":"string","description":"Its nickname, or the platform and login.","examples":["Gold master"]},"platform":{"type":"string","enum":["mt4","mt5"]},"server":{"type":"string","description":"The broker's server.","examples":["ICMarketsSC-Demo"]},"login":{"type":"integer","description":"The MetaTrader account number.","examples":[51234567]},"status":{"type":"string","enum":["connecting","connected","error","disconnected"],"description":"Whether its terminal is connected."}},"description":"An account as other objects show it. Get the account for the rest.","required":["id","name","platform","server","login","status"]},"followers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The follower's ID.","format":"uuid","examples":["9a8b7c6d-5e4f-4a3b-9c2d-1e0f9a8b7c6d"]},"object":{"type":"string","enum":["follower"],"description":"What this object is."},"copier_id":{"type":"string","description":"Its copier.","format":"uuid","examples":["3d2c1b0a-9f8e-4d7c-8b6a-5f4e3d2c1b0a"]},"account_id":{"type":"string","description":"The account that copies.","format":"uuid","examples":["0b7e5c1a-2f3d-4e6a-8b9c-7d6e5f4a3b2c"]},"account":{"type":"object","properties":{"id":{"type":"string","description":"The account's ID.","format":"uuid","examples":["6f1c2d4e-8a9b-4c3d-9e2f-1a2b3c4d5e6f"]},"name":{"type":"string","description":"Its nickname, or the platform and login.","examples":["Gold master"]},"platform":{"type":"string","enum":["mt4","mt5"]},"server":{"type":"string","description":"The broker's server.","examples":["ICMarketsSC-Demo"]},"login":{"type":"integer","description":"The MetaTrader account number.","examples":[51234567]},"status":{"type":"string","enum":["connecting","connected","error","disconnected"],"description":"Whether its terminal is connected."}},"description":"An account as other objects show it. Get the account for the rest.","required":["id","name","platform","server","login","status"]},"is_active":{"type":"boolean","description":"False while this follower is paused."},"magic":{"type":"integer","description":"The magic number on every order placed for this follower. Each copy's comment is `att:` and the master's ticket in base 36.","examples":[1844674407]},"lot_mode":{"type":"string","enum":["multiplier","fixed","balance_ratio","equity_ratio","risk_percent"],"description":"How each copy is sized. `multiplier`: the master's lots times `lot_value`. `fixed`: `lot_value` lots on every copy. `balance_ratio` / `equity_ratio`: the master's lots scaled by this account's balance or equity against the master's, times `lot_value`. `risk_percent`: sized so the master's stop loss risks `lot_value` percent of this account's equity; trades without a stop loss are skipped."},"lot_value":{"type":"number","description":"The multiplier, the lot size or the risk percentage, by `lot_mode`. Above 0 and up to 1000; up to 100 for `risk_percent`. Up to four decimal places.","examples":[1]},"adjust_contract_size":{"type":"boolean","description":"Even out different contract sizes between the brokers (gold can be 100 oz a lot at one broker and 10 oz at another). Applies to `multiplier` and the ratio modes."},"below_minimum":{"type":"string","enum":["minimum","skip"],"description":"When a copy comes out below the broker's minimum lot: trade the minimum, or skip it."},"max_lot":{"type":["number","null"],"description":"The most lots one copy may have; null for no limit."},"reverse":{"type":"boolean","description":"Sell when the master buys and the other way round; stop loss and take profit swap."},"copy_stops":{"type":"boolean","description":"Copy stop loss and take profit, including later changes."},"max_slippage_pips":{"type":["number","null"],"description":"The slippage allowed per order; null uses the broker's default."},"max_delay_seconds":{"type":"integer","description":"How late a master trade may still be copied, for example after a reconnect; older ones are skipped."},"copy_existing":{"type":"boolean","description":"Also copy the positions and pending orders the master already has when the follower is attached. Nothing the master opens or places during a pause is ever copied."},"copy_pending":{"type":"boolean","description":"Place the master's pending orders on the follower as pending orders, and follow their changes, rather than copying them once they fill. Needs both terminals on the current version."},"symbol_filter":{"type":"string","enum":["all","include","exclude"],"description":"`all` copies every symbol, `include` only those in `symbols`, `exclude` all but them."},"symbols":{"type":"array","items":{"type":"string"},"description":"The master's symbol names for `symbol_filter`, which needs at least one unless it is `all`. `XAUUSD` also covers decorated names such as `XAUUSD.m`.","examples":[["XAUUSD","EURUSD"]]},"sessions":{"type":"array","items":{"type":"object","properties":{"days":{"type":"array","items":{"type":"integer"},"description":"0 is Monday, 6 Sunday.","examples":[[0,1,2,3,4]]},"start":{"type":"string","description":"`HH:MM`, 24-hour.","examples":["07:00"]},"end":{"type":"string","description":"`HH:MM`. An end before its start runs past midnight.","examples":["16:30"]}},"description":"A window in which new trades are copied.","required":["days","start","end"]},"description":"When new trades are copied; empty means any time. Closes and changes to copies already open are always copied."},"timezone":{"type":"string","description":"The clock `sessions` are read on: `broker` (the master broker's server time, as its MetaTrader charts show it) or a time zone name such as `Europe/London`.","examples":["broker"]},"symbol_map":{"type":"object","additionalProperties":{"type":"string"},"description":"Master symbol to follower symbol, for names that don't match by themselves. Matching tries this map, then the same name, the name without the broker's decorations (`EURUSD.m`, `US30.cash`), then known aliases (`XAUUSD` and `GOLD`); anything still ambiguous is skipped, never guessed.","examples":[{"XAUUSD":"GOLD.m"}]},"status":{"anyOf":[{"type":"object","properties":{"state":{"type":"string","enum":["starting","copying","paused","error"],"description":"`starting` while the engine connects, `copying`, `paused` (the follower or its copier is paused, or Equity Guard holds copying back), or `error` (see `message`)."},"message":{"type":"string","description":"Why it needs attention, or `Paused by Equity Guard.` while Equity Guard holds copying back; empty otherwise."},"master_connected":{"type":"boolean","description":"The engine's stream from the master's terminal is up."},"follower_connected":{"type":"boolean","description":"The engine's stream from this account's terminal is up."},"open_copies":{"type":"integer","description":"Copies open on this account now.","examples":[2]},"last_event_at":{"type":["string","null"],"description":"When the engine last did something here.","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]},"balance":{"type":["number","null"],"description":"This account's balance as the engine last saw it."},"equity":{"type":["number","null"],"description":"This account's equity as the engine last saw it."},"currency":{"type":"string","examples":["USD"]},"heartbeat_at":{"type":"string","description":"When the engine last reported; at least every 15 seconds.","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]},"engine_online":{"type":"boolean","description":"False when the engine hasn't reported for 60 seconds."}},"description":"What the copier engine reports about a follower, as of `heartbeat_at`.","required":["state","message","master_connected","follower_connected","open_copies","last_event_at","balance","equity","currency","heartbeat_at","engine_online"]},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]},"updated_at":{"type":"string","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]}},"description":"An account that copies a copier's master, with its own rules.","required":["id","object","copier_id","account_id","account","is_active","magic","lot_mode","lot_value","adjust_contract_size","below_minimum","max_lot","reverse","copy_stops","max_slippage_pips","max_delay_seconds","copy_existing","copy_pending","symbol_filter","symbols","sessions","timezone","symbol_map","status","created_at","updated_at"]},"description":"Oldest first."},"open_copies":{"type":"integer","description":"Copies open across all followers now.","examples":[2]},"created_at":{"type":"string","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]},"updated_at":{"type":"string","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]}},"description":"One master account and the followers that copy it.","required":["id","object","name","is_active","master_id","master","followers","open_copies","created_at","updated_at"]},"annotations":{"title":"Update a copier","readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"delete_copier","title":"Delete a copier","description":"Deletes the copier, its followers and their activity log. The accounts stay connected. With `close_positions=true` every copy is closed first.","inputSchema":{"type":"object","properties":{"copier_id":{"description":"The copier's ID.","type":"string","format":"uuid","examples":["3d2c1b0a-9f8e-4d7c-8b6a-5f4e3d2c1b0a"]},"close_positions":{"description":"`true` pauses copying and closes every copy at market before deleting; if a terminal refuses, nothing is deleted (`close_failed`). `false` leaves the copies open on the followers as ordinary positions.","type":"boolean","default":false}},"required":["copier_id"],"additionalProperties":false},"outputSchema":{"type":"object","description":"The deletion went through.","properties":{"deleted":{"type":"boolean","const":true,"description":"Always true. A deletion that fails comes back as an error instead."}},"required":["deleted"],"additionalProperties":false},"annotations":{"title":"Delete a copier","readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"list_followers","title":"List followers","description":"The copier's followers, oldest first.","inputSchema":{"type":"object","properties":{"copier_id":{"description":"The copier's ID.","type":"string","format":"uuid","examples":["3d2c1b0a-9f8e-4d7c-8b6a-5f4e3d2c1b0a"]},"limit":{"description":"Items per page, 1 to 100 (default 50).","type":"integer","minimum":1,"maximum":100,"default":50},"cursor":{"description":"The `next_cursor` of the previous page. Leave it out for the first page.","type":"string"}},"required":["copier_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"object":{"type":"string","enum":["list"],"description":"Always `list`."},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The follower's ID.","format":"uuid","examples":["9a8b7c6d-5e4f-4a3b-9c2d-1e0f9a8b7c6d"]},"object":{"type":"string","enum":["follower"],"description":"What this object is."},"copier_id":{"type":"string","description":"Its copier.","format":"uuid","examples":["3d2c1b0a-9f8e-4d7c-8b6a-5f4e3d2c1b0a"]},"account_id":{"type":"string","description":"The account that copies.","format":"uuid","examples":["0b7e5c1a-2f3d-4e6a-8b9c-7d6e5f4a3b2c"]},"account":{"type":"object","properties":{"id":{"type":"string","description":"The account's ID.","format":"uuid","examples":["6f1c2d4e-8a9b-4c3d-9e2f-1a2b3c4d5e6f"]},"name":{"type":"string","description":"Its nickname, or the platform and login.","examples":["Gold master"]},"platform":{"type":"string","enum":["mt4","mt5"]},"server":{"type":"string","description":"The broker's server.","examples":["ICMarketsSC-Demo"]},"login":{"type":"integer","description":"The MetaTrader account number.","examples":[51234567]},"status":{"type":"string","enum":["connecting","connected","error","disconnected"],"description":"Whether its terminal is connected."}},"description":"An account as other objects show it. Get the account for the rest.","required":["id","name","platform","server","login","status"]},"is_active":{"type":"boolean","description":"False while this follower is paused."},"magic":{"type":"integer","description":"The magic number on every order placed for this follower. Each copy's comment is `att:` and the master's ticket in base 36.","examples":[1844674407]},"lot_mode":{"type":"string","enum":["multiplier","fixed","balance_ratio","equity_ratio","risk_percent"],"description":"How each copy is sized. `multiplier`: the master's lots times `lot_value`. `fixed`: `lot_value` lots on every copy. `balance_ratio` / `equity_ratio`: the master's lots scaled by this account's balance or equity against the master's, times `lot_value`. `risk_percent`: sized so the master's stop loss risks `lot_value` percent of this account's equity; trades without a stop loss are skipped."},"lot_value":{"type":"number","description":"The multiplier, the lot size or the risk percentage, by `lot_mode`. Above 0 and up to 1000; up to 100 for `risk_percent`. Up to four decimal places.","examples":[1]},"adjust_contract_size":{"type":"boolean","description":"Even out different contract sizes between the brokers (gold can be 100 oz a lot at one broker and 10 oz at another). Applies to `multiplier` and the ratio modes."},"below_minimum":{"type":"string","enum":["minimum","skip"],"description":"When a copy comes out below the broker's minimum lot: trade the minimum, or skip it."},"max_lot":{"type":["number","null"],"description":"The most lots one copy may have; null for no limit."},"reverse":{"type":"boolean","description":"Sell when the master buys and the other way round; stop loss and take profit swap."},"copy_stops":{"type":"boolean","description":"Copy stop loss and take profit, including later changes."},"max_slippage_pips":{"type":["number","null"],"description":"The slippage allowed per order; null uses the broker's default."},"max_delay_seconds":{"type":"integer","description":"How late a master trade may still be copied, for example after a reconnect; older ones are skipped."},"copy_existing":{"type":"boolean","description":"Also copy the positions and pending orders the master already has when the follower is attached. Nothing the master opens or places during a pause is ever copied."},"copy_pending":{"type":"boolean","description":"Place the master's pending orders on the follower as pending orders, and follow their changes, rather than copying them once they fill. Needs both terminals on the current version."},"symbol_filter":{"type":"string","enum":["all","include","exclude"],"description":"`all` copies every symbol, `include` only those in `symbols`, `exclude` all but them."},"symbols":{"type":"array","items":{"type":"string"},"description":"The master's symbol names for `symbol_filter`, which needs at least one unless it is `all`. `XAUUSD` also covers decorated names such as `XAUUSD.m`.","examples":[["XAUUSD","EURUSD"]]},"sessions":{"type":"array","items":{"type":"object","properties":{"days":{"type":"array","items":{"type":"integer"},"description":"0 is Monday, 6 Sunday.","examples":[[0,1,2,3,4]]},"start":{"type":"string","description":"`HH:MM`, 24-hour.","examples":["07:00"]},"end":{"type":"string","description":"`HH:MM`. An end before its start runs past midnight.","examples":["16:30"]}},"description":"A window in which new trades are copied.","required":["days","start","end"]},"description":"When new trades are copied; empty means any time. Closes and changes to copies already open are always copied."},"timezone":{"type":"string","description":"The clock `sessions` are read on: `broker` (the master broker's server time, as its MetaTrader charts show it) or a time zone name such as `Europe/London`.","examples":["broker"]},"symbol_map":{"type":"object","additionalProperties":{"type":"string"},"description":"Master symbol to follower symbol, for names that don't match by themselves. Matching tries this map, then the same name, the name without the broker's decorations (`EURUSD.m`, `US30.cash`), then known aliases (`XAUUSD` and `GOLD`); anything still ambiguous is skipped, never guessed.","examples":[{"XAUUSD":"GOLD.m"}]},"status":{"anyOf":[{"type":"object","properties":{"state":{"type":"string","enum":["starting","copying","paused","error"],"description":"`starting` while the engine connects, `copying`, `paused` (the follower or its copier is paused, or Equity Guard holds copying back), or `error` (see `message`)."},"message":{"type":"string","description":"Why it needs attention, or `Paused by Equity Guard.` while Equity Guard holds copying back; empty otherwise."},"master_connected":{"type":"boolean","description":"The engine's stream from the master's terminal is up."},"follower_connected":{"type":"boolean","description":"The engine's stream from this account's terminal is up."},"open_copies":{"type":"integer","description":"Copies open on this account now.","examples":[2]},"last_event_at":{"type":["string","null"],"description":"When the engine last did something here.","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]},"balance":{"type":["number","null"],"description":"This account's balance as the engine last saw it."},"equity":{"type":["number","null"],"description":"This account's equity as the engine last saw it."},"currency":{"type":"string","examples":["USD"]},"heartbeat_at":{"type":"string","description":"When the engine last reported; at least every 15 seconds.","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]},"engine_online":{"type":"boolean","description":"False when the engine hasn't reported for 60 seconds."}},"description":"What the copier engine reports about a follower, as of `heartbeat_at`.","required":["state","message","master_connected","follower_connected","open_copies","last_event_at","balance","equity","currency","heartbeat_at","engine_online"]},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]},"updated_at":{"type":"string","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]}},"description":"An account that copies a copier's master, with its own rules.","required":["id","object","copier_id","account_id","account","is_active","magic","lot_mode","lot_value","adjust_contract_size","below_minimum","max_lot","reverse","copy_stops","max_slippage_pips","max_delay_seconds","copy_existing","copy_pending","symbol_filter","symbols","sessions","timezone","symbol_map","status","created_at","updated_at"]},"description":"Oldest first."},"has_more":{"type":"boolean","description":"Whether there's another page: pass `next_cursor` as `cursor`."},"next_cursor":{"type":["string","null"],"description":"The cursor of the next page; null on the last one."}},"required":["object","data","has_more","next_cursor"]},"annotations":{"title":"List followers","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"add_follower","title":"Add a follower","description":"Attaches one of your accounts to the copier with its own rules; leave a rule out for its default. Copying starts at once (unless `is_active` is false), with what the master opens from then on. Retrying is safe: a second attempt fails with `already_following`.","inputSchema":{"type":"object","properties":{"copier_id":{"description":"The copier's ID.","type":"string","format":"uuid","examples":["3d2c1b0a-9f8e-4d7c-8b6a-5f4e3d2c1b0a"]},"account_id":{"type":"string","description":"One of your connected accounts: connected with its master password, not this copier's master, not a master anywhere and not already copying this master.","format":"uuid","examples":["0b7e5c1a-2f3d-4e6a-8b9c-7d6e5f4a3b2c"]},"is_active":{"type":"boolean","description":"Start paused with `false`.","default":true},"lot_mode":{"type":"string","enum":["multiplier","fixed","balance_ratio","equity_ratio","risk_percent"],"description":"How each copy is sized. `multiplier`: the master's lots times `lot_value`. `fixed`: `lot_value` lots on every copy. `balance_ratio` / `equity_ratio`: the master's lots scaled by this account's balance or equity against the master's, times `lot_value`. `risk_percent`: sized so the master's stop loss risks `lot_value` percent of this account's equity; trades without a stop loss are skipped.","default":"multiplier"},"lot_value":{"type":"number","description":"The multiplier, the lot size or the risk percentage, by `lot_mode`. Above 0 and up to 1000; up to 100 for `risk_percent`. Up to four decimal places.","exclusiveMinimum":0,"maximum":1000,"default":1,"examples":[1]},"adjust_contract_size":{"type":"boolean","description":"Even out different contract sizes between the brokers (gold can be 100 oz a lot at one broker and 10 oz at another). Applies to `multiplier` and the ratio modes.","default":true},"below_minimum":{"type":"string","enum":["minimum","skip"],"description":"When a copy comes out below the broker's minimum lot: trade the minimum, or skip it.","default":"minimum"},"max_lot":{"type":["number","null"],"description":"The most lots one copy may have; null for no limit.","exclusiveMinimum":0,"default":null},"reverse":{"type":"boolean","description":"Sell when the master buys and the other way round; stop loss and take profit swap.","default":false},"copy_stops":{"type":"boolean","description":"Copy stop loss and take profit, including later changes.","default":true},"max_slippage_pips":{"type":["number","null"],"description":"The slippage allowed per order; null uses the broker's default.","minimum":0},"max_delay_seconds":{"type":"integer","description":"How late a master trade may still be copied, for example after a reconnect; older ones are skipped.","minimum":0,"maximum":3600,"default":60},"copy_existing":{"type":"boolean","description":"Also copy the positions and pending orders the master already has when the follower is attached. Nothing the master opens or places during a pause is ever copied.","default":false},"copy_pending":{"type":"boolean","description":"Place the master's pending orders on the follower as pending orders, and follow their changes, rather than copying them once they fill. Needs both terminals on the current version.","default":false},"symbol_filter":{"type":"string","enum":["all","include","exclude"],"description":"`all` copies every symbol, `include` only those in `symbols`, `exclude` all but them.","default":"all"},"symbols":{"type":"array","items":{"type":"string","maxLength":32},"maxItems":200,"default":[],"description":"The master's symbol names for `symbol_filter`, which needs at least one unless it is `all`. `XAUUSD` also covers decorated names such as `XAUUSD.m`.","examples":[["XAUUSD","EURUSD"]]},"sessions":{"type":"array","items":{"type":"object","properties":{"days":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6},"minItems":1,"description":"0 is Monday, 6 Sunday.","examples":[[0,1,2,3,4]]},"start":{"type":"string","description":"`HH:MM`, 24-hour.","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$","examples":["07:00"]},"end":{"type":"string","description":"`HH:MM`. An end before its start runs past midnight.","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$","examples":["16:30"]}},"description":"A window in which new trades are copied.","required":["days","start","end"]},"maxItems":14,"default":[],"description":"When new trades are copied; empty means any time. Closes and changes to copies already open are always copied."},"timezone":{"type":"string","description":"The clock `sessions` are read on: `broker` (the master broker's server time, as its MetaTrader charts show it) or a time zone name such as `Europe/London`.","default":"broker","examples":["broker"]},"symbol_map":{"type":"object","additionalProperties":{"type":"string","maxLength":32},"maxProperties":200,"default":{},"description":"Master symbol to follower symbol, for names that don't match by themselves. Matching tries this map, then the same name, the name without the broker's decorations (`EURUSD.m`, `US30.cash`), then known aliases (`XAUUSD` and `GOLD`); anything still ambiguous is skipped, never guessed.","examples":[{"XAUUSD":"GOLD.m"}]}},"required":["copier_id","account_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"id":{"type":"string","description":"The follower's ID.","format":"uuid","examples":["9a8b7c6d-5e4f-4a3b-9c2d-1e0f9a8b7c6d"]},"object":{"type":"string","enum":["follower"],"description":"What this object is."},"copier_id":{"type":"string","description":"Its copier.","format":"uuid","examples":["3d2c1b0a-9f8e-4d7c-8b6a-5f4e3d2c1b0a"]},"account_id":{"type":"string","description":"The account that copies.","format":"uuid","examples":["0b7e5c1a-2f3d-4e6a-8b9c-7d6e5f4a3b2c"]},"account":{"type":"object","properties":{"id":{"type":"string","description":"The account's ID.","format":"uuid","examples":["6f1c2d4e-8a9b-4c3d-9e2f-1a2b3c4d5e6f"]},"name":{"type":"string","description":"Its nickname, or the platform and login.","examples":["Gold master"]},"platform":{"type":"string","enum":["mt4","mt5"]},"server":{"type":"string","description":"The broker's server.","examples":["ICMarketsSC-Demo"]},"login":{"type":"integer","description":"The MetaTrader account number.","examples":[51234567]},"status":{"type":"string","enum":["connecting","connected","error","disconnected"],"description":"Whether its terminal is connected."}},"description":"An account as other objects show it. Get the account for the rest.","required":["id","name","platform","server","login","status"]},"is_active":{"type":"boolean","description":"False while this follower is paused."},"magic":{"type":"integer","description":"The magic number on every order placed for this follower. Each copy's comment is `att:` and the master's ticket in base 36.","examples":[1844674407]},"lot_mode":{"type":"string","enum":["multiplier","fixed","balance_ratio","equity_ratio","risk_percent"],"description":"How each copy is sized. `multiplier`: the master's lots times `lot_value`. `fixed`: `lot_value` lots on every copy. `balance_ratio` / `equity_ratio`: the master's lots scaled by this account's balance or equity against the master's, times `lot_value`. `risk_percent`: sized so the master's stop loss risks `lot_value` percent of this account's equity; trades without a stop loss are skipped."},"lot_value":{"type":"number","description":"The multiplier, the lot size or the risk percentage, by `lot_mode`. Above 0 and up to 1000; up to 100 for `risk_percent`. Up to four decimal places.","examples":[1]},"adjust_contract_size":{"type":"boolean","description":"Even out different contract sizes between the brokers (gold can be 100 oz a lot at one broker and 10 oz at another). Applies to `multiplier` and the ratio modes."},"below_minimum":{"type":"string","enum":["minimum","skip"],"description":"When a copy comes out below the broker's minimum lot: trade the minimum, or skip it."},"max_lot":{"type":["number","null"],"description":"The most lots one copy may have; null for no limit."},"reverse":{"type":"boolean","description":"Sell when the master buys and the other way round; stop loss and take profit swap."},"copy_stops":{"type":"boolean","description":"Copy stop loss and take profit, including later changes."},"max_slippage_pips":{"type":["number","null"],"description":"The slippage allowed per order; null uses the broker's default."},"max_delay_seconds":{"type":"integer","description":"How late a master trade may still be copied, for example after a reconnect; older ones are skipped."},"copy_existing":{"type":"boolean","description":"Also copy the positions and pending orders the master already has when the follower is attached. Nothing the master opens or places during a pause is ever copied."},"copy_pending":{"type":"boolean","description":"Place the master's pending orders on the follower as pending orders, and follow their changes, rather than copying them once they fill. Needs both terminals on the current version."},"symbol_filter":{"type":"string","enum":["all","include","exclude"],"description":"`all` copies every symbol, `include` only those in `symbols`, `exclude` all but them."},"symbols":{"type":"array","items":{"type":"string"},"description":"The master's symbol names for `symbol_filter`, which needs at least one unless it is `all`. `XAUUSD` also covers decorated names such as `XAUUSD.m`.","examples":[["XAUUSD","EURUSD"]]},"sessions":{"type":"array","items":{"type":"object","properties":{"days":{"type":"array","items":{"type":"integer"},"description":"0 is Monday, 6 Sunday.","examples":[[0,1,2,3,4]]},"start":{"type":"string","description":"`HH:MM`, 24-hour.","examples":["07:00"]},"end":{"type":"string","description":"`HH:MM`. An end before its start runs past midnight.","examples":["16:30"]}},"description":"A window in which new trades are copied.","required":["days","start","end"]},"description":"When new trades are copied; empty means any time. Closes and changes to copies already open are always copied."},"timezone":{"type":"string","description":"The clock `sessions` are read on: `broker` (the master broker's server time, as its MetaTrader charts show it) or a time zone name such as `Europe/London`.","examples":["broker"]},"symbol_map":{"type":"object","additionalProperties":{"type":"string"},"description":"Master symbol to follower symbol, for names that don't match by themselves. Matching tries this map, then the same name, the name without the broker's decorations (`EURUSD.m`, `US30.cash`), then known aliases (`XAUUSD` and `GOLD`); anything still ambiguous is skipped, never guessed.","examples":[{"XAUUSD":"GOLD.m"}]},"status":{"anyOf":[{"type":"object","properties":{"state":{"type":"string","enum":["starting","copying","paused","error"],"description":"`starting` while the engine connects, `copying`, `paused` (the follower or its copier is paused, or Equity Guard holds copying back), or `error` (see `message`)."},"message":{"type":"string","description":"Why it needs attention, or `Paused by Equity Guard.` while Equity Guard holds copying back; empty otherwise."},"master_connected":{"type":"boolean","description":"The engine's stream from the master's terminal is up."},"follower_connected":{"type":"boolean","description":"The engine's stream from this account's terminal is up."},"open_copies":{"type":"integer","description":"Copies open on this account now.","examples":[2]},"last_event_at":{"type":["string","null"],"description":"When the engine last did something here.","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]},"balance":{"type":["number","null"],"description":"This account's balance as the engine last saw it."},"equity":{"type":["number","null"],"description":"This account's equity as the engine last saw it."},"currency":{"type":"string","examples":["USD"]},"heartbeat_at":{"type":"string","description":"When the engine last reported; at least every 15 seconds.","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]},"engine_online":{"type":"boolean","description":"False when the engine hasn't reported for 60 seconds."}},"description":"What the copier engine reports about a follower, as of `heartbeat_at`.","required":["state","message","master_connected","follower_connected","open_copies","last_event_at","balance","equity","currency","heartbeat_at","engine_online"]},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]},"updated_at":{"type":"string","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]}},"description":"An account that copies a copier's master, with its own rules.","required":["id","object","copier_id","account_id","account","is_active","magic","lot_mode","lot_value","adjust_contract_size","below_minimum","max_lot","reverse","copy_stops","max_slippage_pips","max_delay_seconds","copy_existing","copy_pending","symbol_filter","symbols","sessions","timezone","symbol_map","status","created_at","updated_at"]},"annotations":{"title":"Add a follower","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false}},{"name":"get_follower","title":"Retrieve a follower","description":"The follower's rules and what the engine reports about it.","inputSchema":{"type":"object","properties":{"copier_id":{"description":"The copier's ID.","type":"string","format":"uuid","examples":["3d2c1b0a-9f8e-4d7c-8b6a-5f4e3d2c1b0a"]},"follower_id":{"description":"The follower's ID (not its account's).","type":"string","format":"uuid","examples":["9a8b7c6d-5e4f-4a3b-9c2d-1e0f9a8b7c6d"]}},"required":["copier_id","follower_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"id":{"type":"string","description":"The follower's ID.","format":"uuid","examples":["9a8b7c6d-5e4f-4a3b-9c2d-1e0f9a8b7c6d"]},"object":{"type":"string","enum":["follower"],"description":"What this object is."},"copier_id":{"type":"string","description":"Its copier.","format":"uuid","examples":["3d2c1b0a-9f8e-4d7c-8b6a-5f4e3d2c1b0a"]},"account_id":{"type":"string","description":"The account that copies.","format":"uuid","examples":["0b7e5c1a-2f3d-4e6a-8b9c-7d6e5f4a3b2c"]},"account":{"type":"object","properties":{"id":{"type":"string","description":"The account's ID.","format":"uuid","examples":["6f1c2d4e-8a9b-4c3d-9e2f-1a2b3c4d5e6f"]},"name":{"type":"string","description":"Its nickname, or the platform and login.","examples":["Gold master"]},"platform":{"type":"string","enum":["mt4","mt5"]},"server":{"type":"string","description":"The broker's server.","examples":["ICMarketsSC-Demo"]},"login":{"type":"integer","description":"The MetaTrader account number.","examples":[51234567]},"status":{"type":"string","enum":["connecting","connected","error","disconnected"],"description":"Whether its terminal is connected."}},"description":"An account as other objects show it. Get the account for the rest.","required":["id","name","platform","server","login","status"]},"is_active":{"type":"boolean","description":"False while this follower is paused."},"magic":{"type":"integer","description":"The magic number on every order placed for this follower. Each copy's comment is `att:` and the master's ticket in base 36.","examples":[1844674407]},"lot_mode":{"type":"string","enum":["multiplier","fixed","balance_ratio","equity_ratio","risk_percent"],"description":"How each copy is sized. `multiplier`: the master's lots times `lot_value`. `fixed`: `lot_value` lots on every copy. `balance_ratio` / `equity_ratio`: the master's lots scaled by this account's balance or equity against the master's, times `lot_value`. `risk_percent`: sized so the master's stop loss risks `lot_value` percent of this account's equity; trades without a stop loss are skipped."},"lot_value":{"type":"number","description":"The multiplier, the lot size or the risk percentage, by `lot_mode`. Above 0 and up to 1000; up to 100 for `risk_percent`. Up to four decimal places.","examples":[1]},"adjust_contract_size":{"type":"boolean","description":"Even out different contract sizes between the brokers (gold can be 100 oz a lot at one broker and 10 oz at another). Applies to `multiplier` and the ratio modes."},"below_minimum":{"type":"string","enum":["minimum","skip"],"description":"When a copy comes out below the broker's minimum lot: trade the minimum, or skip it."},"max_lot":{"type":["number","null"],"description":"The most lots one copy may have; null for no limit."},"reverse":{"type":"boolean","description":"Sell when the master buys and the other way round; stop loss and take profit swap."},"copy_stops":{"type":"boolean","description":"Copy stop loss and take profit, including later changes."},"max_slippage_pips":{"type":["number","null"],"description":"The slippage allowed per order; null uses the broker's default."},"max_delay_seconds":{"type":"integer","description":"How late a master trade may still be copied, for example after a reconnect; older ones are skipped."},"copy_existing":{"type":"boolean","description":"Also copy the positions and pending orders the master already has when the follower is attached. Nothing the master opens or places during a pause is ever copied."},"copy_pending":{"type":"boolean","description":"Place the master's pending orders on the follower as pending orders, and follow their changes, rather than copying them once they fill. Needs both terminals on the current version."},"symbol_filter":{"type":"string","enum":["all","include","exclude"],"description":"`all` copies every symbol, `include` only those in `symbols`, `exclude` all but them."},"symbols":{"type":"array","items":{"type":"string"},"description":"The master's symbol names for `symbol_filter`, which needs at least one unless it is `all`. `XAUUSD` also covers decorated names such as `XAUUSD.m`.","examples":[["XAUUSD","EURUSD"]]},"sessions":{"type":"array","items":{"type":"object","properties":{"days":{"type":"array","items":{"type":"integer"},"description":"0 is Monday, 6 Sunday.","examples":[[0,1,2,3,4]]},"start":{"type":"string","description":"`HH:MM`, 24-hour.","examples":["07:00"]},"end":{"type":"string","description":"`HH:MM`. An end before its start runs past midnight.","examples":["16:30"]}},"description":"A window in which new trades are copied.","required":["days","start","end"]},"description":"When new trades are copied; empty means any time. Closes and changes to copies already open are always copied."},"timezone":{"type":"string","description":"The clock `sessions` are read on: `broker` (the master broker's server time, as its MetaTrader charts show it) or a time zone name such as `Europe/London`.","examples":["broker"]},"symbol_map":{"type":"object","additionalProperties":{"type":"string"},"description":"Master symbol to follower symbol, for names that don't match by themselves. Matching tries this map, then the same name, the name without the broker's decorations (`EURUSD.m`, `US30.cash`), then known aliases (`XAUUSD` and `GOLD`); anything still ambiguous is skipped, never guessed.","examples":[{"XAUUSD":"GOLD.m"}]},"status":{"anyOf":[{"type":"object","properties":{"state":{"type":"string","enum":["starting","copying","paused","error"],"description":"`starting` while the engine connects, `copying`, `paused` (the follower or its copier is paused, or Equity Guard holds copying back), or `error` (see `message`)."},"message":{"type":"string","description":"Why it needs attention, or `Paused by Equity Guard.` while Equity Guard holds copying back; empty otherwise."},"master_connected":{"type":"boolean","description":"The engine's stream from the master's terminal is up."},"follower_connected":{"type":"boolean","description":"The engine's stream from this account's terminal is up."},"open_copies":{"type":"integer","description":"Copies open on this account now.","examples":[2]},"last_event_at":{"type":["string","null"],"description":"When the engine last did something here.","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]},"balance":{"type":["number","null"],"description":"This account's balance as the engine last saw it."},"equity":{"type":["number","null"],"description":"This account's equity as the engine last saw it."},"currency":{"type":"string","examples":["USD"]},"heartbeat_at":{"type":"string","description":"When the engine last reported; at least every 15 seconds.","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]},"engine_online":{"type":"boolean","description":"False when the engine hasn't reported for 60 seconds."}},"description":"What the copier engine reports about a follower, as of `heartbeat_at`.","required":["state","message","master_connected","follower_connected","open_copies","last_event_at","balance","equity","currency","heartbeat_at","engine_online"]},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]},"updated_at":{"type":"string","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]}},"description":"An account that copies a copier's master, with its own rules.","required":["id","object","copier_id","account_id","account","is_active","magic","lot_mode","lot_value","adjust_contract_size","below_minimum","max_lot","reverse","copy_stops","max_slippage_pips","max_delay_seconds","copy_existing","copy_pending","symbol_filter","symbols","sessions","timezone","symbol_map","status","created_at","updated_at"]},"annotations":{"title":"Retrieve a follower","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"update_follower","title":"Update a follower","description":"Change rules, or pause and resume this follower. Changes apply to what's copied from then on.","inputSchema":{"type":"object","properties":{"copier_id":{"description":"The copier's ID.","type":"string","format":"uuid","examples":["3d2c1b0a-9f8e-4d7c-8b6a-5f4e3d2c1b0a"]},"follower_id":{"description":"The follower's ID (not its account's).","type":"string","format":"uuid","examples":["9a8b7c6d-5e4f-4a3b-9c2d-1e0f9a8b7c6d"]},"is_active":{"type":"boolean","description":"Pause with `false`. Resuming copies only what the master opens from then on, also with `copy_existing`."},"lot_mode":{"type":"string","enum":["multiplier","fixed","balance_ratio","equity_ratio","risk_percent"],"description":"How each copy is sized. `multiplier`: the master's lots times `lot_value`. `fixed`: `lot_value` lots on every copy. `balance_ratio` / `equity_ratio`: the master's lots scaled by this account's balance or equity against the master's, times `lot_value`. `risk_percent`: sized so the master's stop loss risks `lot_value` percent of this account's equity; trades without a stop loss are skipped."},"lot_value":{"type":"number","description":"The multiplier, the lot size or the risk percentage, by `lot_mode`. Above 0 and up to 1000; up to 100 for `risk_percent`. Up to four decimal places.","exclusiveMinimum":0,"maximum":1000,"examples":[1]},"adjust_contract_size":{"type":"boolean","description":"Even out different contract sizes between the brokers (gold can be 100 oz a lot at one broker and 10 oz at another). Applies to `multiplier` and the ratio modes."},"below_minimum":{"type":"string","enum":["minimum","skip"],"description":"When a copy comes out below the broker's minimum lot: trade the minimum, or skip it."},"max_lot":{"type":["number","null"],"description":"The most lots one copy may have; null for no limit.","exclusiveMinimum":0},"reverse":{"type":"boolean","description":"Sell when the master buys and the other way round; stop loss and take profit swap."},"copy_stops":{"type":"boolean","description":"Copy stop loss and take profit, including later changes."},"max_slippage_pips":{"type":["number","null"],"description":"The slippage allowed per order; null uses the broker's default.","minimum":0},"max_delay_seconds":{"type":"integer","description":"How late a master trade may still be copied, for example after a reconnect; older ones are skipped.","minimum":0,"maximum":3600},"copy_existing":{"type":"boolean","description":"Also copy the positions and pending orders the master already has when the follower is attached. Nothing the master opens or places during a pause is ever copied."},"copy_pending":{"type":"boolean","description":"Place the master's pending orders on the follower as pending orders, and follow their changes, rather than copying them once they fill. Needs both terminals on the current version."},"symbol_filter":{"type":"string","enum":["all","include","exclude"],"description":"`all` copies every symbol, `include` only those in `symbols`, `exclude` all but them."},"symbols":{"type":"array","items":{"type":"string","maxLength":32},"maxItems":200,"description":"The master's symbol names for `symbol_filter`, which needs at least one unless it is `all`. `XAUUSD` also covers decorated names such as `XAUUSD.m`.","examples":[["XAUUSD","EURUSD"]]},"sessions":{"type":"array","items":{"type":"object","properties":{"days":{"type":"array","items":{"type":"integer","minimum":0,"maximum":6},"minItems":1,"description":"0 is Monday, 6 Sunday.","examples":[[0,1,2,3,4]]},"start":{"type":"string","description":"`HH:MM`, 24-hour.","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$","examples":["07:00"]},"end":{"type":"string","description":"`HH:MM`. An end before its start runs past midnight.","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$","examples":["16:30"]}},"description":"A window in which new trades are copied.","required":["days","start","end"]},"maxItems":14,"description":"When new trades are copied; empty means any time. Closes and changes to copies already open are always copied."},"timezone":{"type":"string","description":"The clock `sessions` are read on: `broker` (the master broker's server time, as its MetaTrader charts show it) or a time zone name such as `Europe/London`.","examples":["broker"]},"symbol_map":{"type":"object","additionalProperties":{"type":"string","maxLength":32},"maxProperties":200,"description":"Master symbol to follower symbol, for names that don't match by themselves. Matching tries this map, then the same name, the name without the broker's decorations (`EURUSD.m`, `US30.cash`), then known aliases (`XAUUSD` and `GOLD`); anything still ambiguous is skipped, never guessed.","examples":[{"XAUUSD":"GOLD.m"}]}},"required":["copier_id","follower_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"id":{"type":"string","description":"The follower's ID.","format":"uuid","examples":["9a8b7c6d-5e4f-4a3b-9c2d-1e0f9a8b7c6d"]},"object":{"type":"string","enum":["follower"],"description":"What this object is."},"copier_id":{"type":"string","description":"Its copier.","format":"uuid","examples":["3d2c1b0a-9f8e-4d7c-8b6a-5f4e3d2c1b0a"]},"account_id":{"type":"string","description":"The account that copies.","format":"uuid","examples":["0b7e5c1a-2f3d-4e6a-8b9c-7d6e5f4a3b2c"]},"account":{"type":"object","properties":{"id":{"type":"string","description":"The account's ID.","format":"uuid","examples":["6f1c2d4e-8a9b-4c3d-9e2f-1a2b3c4d5e6f"]},"name":{"type":"string","description":"Its nickname, or the platform and login.","examples":["Gold master"]},"platform":{"type":"string","enum":["mt4","mt5"]},"server":{"type":"string","description":"The broker's server.","examples":["ICMarketsSC-Demo"]},"login":{"type":"integer","description":"The MetaTrader account number.","examples":[51234567]},"status":{"type":"string","enum":["connecting","connected","error","disconnected"],"description":"Whether its terminal is connected."}},"description":"An account as other objects show it. Get the account for the rest.","required":["id","name","platform","server","login","status"]},"is_active":{"type":"boolean","description":"False while this follower is paused."},"magic":{"type":"integer","description":"The magic number on every order placed for this follower. Each copy's comment is `att:` and the master's ticket in base 36.","examples":[1844674407]},"lot_mode":{"type":"string","enum":["multiplier","fixed","balance_ratio","equity_ratio","risk_percent"],"description":"How each copy is sized. `multiplier`: the master's lots times `lot_value`. `fixed`: `lot_value` lots on every copy. `balance_ratio` / `equity_ratio`: the master's lots scaled by this account's balance or equity against the master's, times `lot_value`. `risk_percent`: sized so the master's stop loss risks `lot_value` percent of this account's equity; trades without a stop loss are skipped."},"lot_value":{"type":"number","description":"The multiplier, the lot size or the risk percentage, by `lot_mode`. Above 0 and up to 1000; up to 100 for `risk_percent`. Up to four decimal places.","examples":[1]},"adjust_contract_size":{"type":"boolean","description":"Even out different contract sizes between the brokers (gold can be 100 oz a lot at one broker and 10 oz at another). Applies to `multiplier` and the ratio modes."},"below_minimum":{"type":"string","enum":["minimum","skip"],"description":"When a copy comes out below the broker's minimum lot: trade the minimum, or skip it."},"max_lot":{"type":["number","null"],"description":"The most lots one copy may have; null for no limit."},"reverse":{"type":"boolean","description":"Sell when the master buys and the other way round; stop loss and take profit swap."},"copy_stops":{"type":"boolean","description":"Copy stop loss and take profit, including later changes."},"max_slippage_pips":{"type":["number","null"],"description":"The slippage allowed per order; null uses the broker's default."},"max_delay_seconds":{"type":"integer","description":"How late a master trade may still be copied, for example after a reconnect; older ones are skipped."},"copy_existing":{"type":"boolean","description":"Also copy the positions and pending orders the master already has when the follower is attached. Nothing the master opens or places during a pause is ever copied."},"copy_pending":{"type":"boolean","description":"Place the master's pending orders on the follower as pending orders, and follow their changes, rather than copying them once they fill. Needs both terminals on the current version."},"symbol_filter":{"type":"string","enum":["all","include","exclude"],"description":"`all` copies every symbol, `include` only those in `symbols`, `exclude` all but them."},"symbols":{"type":"array","items":{"type":"string"},"description":"The master's symbol names for `symbol_filter`, which needs at least one unless it is `all`. `XAUUSD` also covers decorated names such as `XAUUSD.m`.","examples":[["XAUUSD","EURUSD"]]},"sessions":{"type":"array","items":{"type":"object","properties":{"days":{"type":"array","items":{"type":"integer"},"description":"0 is Monday, 6 Sunday.","examples":[[0,1,2,3,4]]},"start":{"type":"string","description":"`HH:MM`, 24-hour.","examples":["07:00"]},"end":{"type":"string","description":"`HH:MM`. An end before its start runs past midnight.","examples":["16:30"]}},"description":"A window in which new trades are copied.","required":["days","start","end"]},"description":"When new trades are copied; empty means any time. Closes and changes to copies already open are always copied."},"timezone":{"type":"string","description":"The clock `sessions` are read on: `broker` (the master broker's server time, as its MetaTrader charts show it) or a time zone name such as `Europe/London`.","examples":["broker"]},"symbol_map":{"type":"object","additionalProperties":{"type":"string"},"description":"Master symbol to follower symbol, for names that don't match by themselves. Matching tries this map, then the same name, the name without the broker's decorations (`EURUSD.m`, `US30.cash`), then known aliases (`XAUUSD` and `GOLD`); anything still ambiguous is skipped, never guessed.","examples":[{"XAUUSD":"GOLD.m"}]},"status":{"anyOf":[{"type":"object","properties":{"state":{"type":"string","enum":["starting","copying","paused","error"],"description":"`starting` while the engine connects, `copying`, `paused` (the follower or its copier is paused, or Equity Guard holds copying back), or `error` (see `message`)."},"message":{"type":"string","description":"Why it needs attention, or `Paused by Equity Guard.` while Equity Guard holds copying back; empty otherwise."},"master_connected":{"type":"boolean","description":"The engine's stream from the master's terminal is up."},"follower_connected":{"type":"boolean","description":"The engine's stream from this account's terminal is up."},"open_copies":{"type":"integer","description":"Copies open on this account now.","examples":[2]},"last_event_at":{"type":["string","null"],"description":"When the engine last did something here.","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]},"balance":{"type":["number","null"],"description":"This account's balance as the engine last saw it."},"equity":{"type":["number","null"],"description":"This account's equity as the engine last saw it."},"currency":{"type":"string","examples":["USD"]},"heartbeat_at":{"type":"string","description":"When the engine last reported; at least every 15 seconds.","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]},"engine_online":{"type":"boolean","description":"False when the engine hasn't reported for 60 seconds."}},"description":"What the copier engine reports about a follower, as of `heartbeat_at`.","required":["state","message","master_connected","follower_connected","open_copies","last_event_at","balance","equity","currency","heartbeat_at","engine_online"]},{"type":"null"}]},"created_at":{"type":"string","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]},"updated_at":{"type":"string","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]}},"description":"An account that copies a copier's master, with its own rules.","required":["id","object","copier_id","account_id","account","is_active","magic","lot_mode","lot_value","adjust_contract_size","below_minimum","max_lot","reverse","copy_stops","max_slippage_pips","max_delay_seconds","copy_existing","copy_pending","symbol_filter","symbols","sessions","timezone","symbol_map","status","created_at","updated_at"]},"annotations":{"title":"Update a follower","readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"remove_follower","title":"Remove a follower","description":"Detaches the account from the copier and deletes its activity log. The account stays connected. With `close_positions=true` its copies are closed first.","inputSchema":{"type":"object","properties":{"copier_id":{"description":"The copier's ID.","type":"string","format":"uuid","examples":["3d2c1b0a-9f8e-4d7c-8b6a-5f4e3d2c1b0a"]},"follower_id":{"description":"The follower's ID (not its account's).","type":"string","format":"uuid","examples":["9a8b7c6d-5e4f-4a3b-9c2d-1e0f9a8b7c6d"]},"close_positions":{"description":"`true` pauses copying and closes every copy at market before deleting; if a terminal refuses, nothing is deleted (`close_failed`). `false` leaves the copies open on the followers as ordinary positions.","type":"boolean","default":false}},"required":["copier_id","follower_id"],"additionalProperties":false},"outputSchema":{"type":"object","description":"The deletion went through.","properties":{"deleted":{"type":"boolean","const":true,"description":"Always true. A deletion that fails comes back as an error instead."}},"required":["deleted"],"additionalProperties":false},"annotations":{"title":"Remove a follower","readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false}},{"name":"list_copy_events","title":"List copy events","description":"What the copier engine did, or decided not to do, on the copier's followers, newest first. Events are kept for 90 days.","inputSchema":{"type":"object","properties":{"copier_id":{"description":"The copier's ID.","type":"string","format":"uuid","examples":["3d2c1b0a-9f8e-4d7c-8b6a-5f4e3d2c1b0a"]},"follower_id":{"description":"Only this follower's events.","type":"string","format":"uuid","examples":["9a8b7c6d-5e4f-4a3b-9c2d-1e0f9a8b7c6d"]},"limit":{"description":"Items per page, 1 to 100 (default 50).","type":"integer","minimum":1,"maximum":100,"default":50},"cursor":{"description":"The `next_cursor` of the previous page. Leave it out for the first page.","type":"string"}},"required":["copier_id"],"additionalProperties":false},"outputSchema":{"type":"object","properties":{"object":{"type":"string","enum":["list"],"description":"Always `list`."},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","examples":[48213]},"object":{"type":"string","enum":["copy_event"],"description":"What this object is."},"follower_id":{"type":"string","description":"The follower it happened on.","format":"uuid","examples":["9a8b7c6d-5e4f-4a3b-9c2d-1e0f9a8b7c6d"]},"account_id":{"type":"string","description":"That follower's account.","format":"uuid","examples":["0b7e5c1a-2f3d-4e6a-8b9c-7d6e5f4a3b2c"]},"master_ticket":{"type":"integer","description":"The master position it's about.","examples":[771203398]},"action":{"type":"string","enum":["open","close","partial_close","modify","skip","adopt","place","cancel"],"description":"`open`, `close`, `partial_close`, `modify` (stop loss or take profit, or a pending order moved), `skip` (decided not to copy; see `message`), `adopt` (took over a copy it found on the follower after a restart), `place` (placed a pending order for the master's) or `cancel` (cancelled one)."},"ok":{"type":"boolean","description":"Whether it worked."},"message":{"type":"string","examples":["Opened 0.20 lots XAUUSD"]},"detail":{"type":"object","additionalProperties":true,"description":"The request and the terminal's answer. Keys vary by action, for example `symbol`, `side`, `volume`, `price`, `ticket`, `stopLoss`, `takeProfit`, `retcode` and `outcome`.","examples":[{"symbol":"XAUUSD","side":"buy","volume":0.2,"ticket":99120443}]},"received_at":{"type":"string","description":"When the engine heard about the master's change.","format":"date-time","examples":["2026-10-25T14:03:51.204Z"]},"engine_ms":{"type":["number","null"],"description":"The engine's own time to the order going out."},"execution_ms":{"type":["number","null"],"description":"The follower broker's time to answer the order."},"total_ms":{"type":["number","null"],"description":"Both together."}},"description":"One thing the copier engine did, or decided not to do, on a follower.","required":["id","object","follower_id","account_id","master_ticket","action","ok","message","detail","received_at","engine_ms","execution_ms","total_ms"]},"description":"Newest first."},"has_more":{"type":"boolean","description":"Whether there's another page: pass `next_cursor` as `cursor`."},"next_cursor":{"type":["string","null"],"description":"The cursor of the next page; null on the last one."}},"required":["object","data","has_more","next_cursor"]},"annotations":{"title":"List copy events","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}}],"resources":[],"prompts":[]}