Equity Guard
1 tool in this category.
Overview
Equity Guard includes 1 tool for this workflow area.
Available tools: manage_equity_guard.
Use the parameter tables and examples below as the canonical request contract.
manage_equity_guard
Manages the per-terminal equity circuit breaker, dispatched by action. One guard per (license, terminal) — if you have multiple terminals connected, each gets its own independent guard. The terminal is identified by the current MCP session. Requires the trade capability.
action=set: configures the guard for this terminal, enforced server-side (survives this session): when equity falls max_daily_loss_percent below the daily anchor (or max_total_drawdown_percent below initial equity), the guard breaches. breach_action: close_all = close all positions then block new live trades until the daily reset; block_new = block only; notify = record an alert event only (see manage_alerts, action=poll). Evaluation runs on a ~30s sampling loop while the terminal is connected; if disconnected at breach time, the trade block still applies and close_all executes on reconnect. This is best-effort protection above the broker's own stop-out, not a replacement for stop losses. Calling again replaces the guard for this terminal. Requires max_daily_loss_percent and breach_action.
action=status: returns the current guard config for this terminal, status (armed / breached / breached_pending / none), day_start_equity anchor, current equity, daily P&L percent, and the equity level at which the guard breaches.
action=remove: removes the equity guard for this terminal. If the guard is currently breached (or breached_pending), removal requires confirm=true — this prevents silently disabling an active safety rail; without it the call returns CONFIRM_REQUIRED.
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
action | string | Yes | — | (one of: set, status, remove) |
max_daily_loss_percent | number | No | — | Required for action=set. |
max_total_drawdown_percent | number | No | — | — |
breach_action | string | No | — | Required for action=set. (one of: close_all, block_new, notify) |
reset_timezone | string | No | "UTC" | IANA timezone for the daily reset boundary, e.g. 'UTC' or 'Europe/Prague'. |
initial_equity | number | No | — | Starting account equity for total drawdown calculation basis. |
initial_balance | number | No | — | Alias for initial_equity. |
confirm | boolean | No | false | Required (true) to remove a guard currently breached/breached_pending. |
Example Request
{
"tool": "manage_equity_guard",
"arguments": {
"action": "set"
}
}