Portfolio compare (paired Revise-step comparison)
portfolio_compareUSE WHEN you revised a portfolio and want to know whether the revision made the tail better or worse. Compares A (reference) with B (candidate) on IDENTICAL simulated paths, so every delta is attributable to the weights, not seed noise. Returns drawdown-distribution deltas, probability-weighted scenario summaries, per-scenario deltas, the risk-concentration shift and which diversification failures B introduces or resolves. revision_required flags a B that deepens the worst-path drawdown or adds a failure. Provide holdings_a and holdings_b as [{asset, weight}]. Descriptive, not advisory; neither portfolio is ranked.
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_a": "<holdings_a>",
"holdings_b": "<holdings_b>"
},
"name": "portfolio_compare"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| holdings_a | Yes | Reference portfolio A. 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. | |
| holdings_b | Yes | Candidate revision B, same shape — evaluated on paths identical to A's, so every delta is attributable to the weights. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |