IPS gate — planning-step constraint check (hard gate)
ips_gateUSE WHEN you have an Investment Policy Statement (drawdown tolerance, horizon, liquidity need) and want a portfolio checked against it. Flags a violation when the MEDIAN sustained drawdown exceeds max_drawdown_tolerance (a fraction, e.g. 0.15) or the tolerance is breached in a third or more of paths (the worst path and p90 may lie beyond it; see worst_stress); when time_horizon_years < 3 with a median drawdown of 15% or more; or when material holdings are less liquid than liquidity_need. A hard gate, not a score. Descriptive, not advisory.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"holdings": "<holdings>"
},
"name": "ips_gate"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| holdings | Yes | Portfolio legs: list of {asset, weight} objects, e.g. [{'asset': 'SPY', 'weight': 0.6}, {'asset': 'TLT', 'weight': 0.4}]. Assets: SPY, TLT, GOLD, BTC (aliases GLD, BTC-USD). Weights are non-negative and normalised to sum to 1; at most 50 legs, no duplicates. | |
| liquidity_need | No | 'low' | 'medium' | 'high' — violated when material holdings are less liquid than the stated need. | |
| time_horizon_years | No | Investment horizon stated in the IPS; short horizons cannot absorb deep drawdowns. | |
| max_drawdown_tolerance | No | IPS drawdown tolerance as a fraction, e.g. 0.15 = a -15% maximum acceptable drawdown. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |