Grade a portfolio
grade_portfolioRuns the free Portfolio Optimizer Pro checkup on a list of holdings and weights. Returns the A+ to F structural grade, the 0-100 score, any structural ceiling (cap) applied, each factor's sub-score with its measured fact, the top findings that held the grade down, the price-history dates used, a disclaimer and full_breakdown_url, a link that opens the same graded checkup on the website. Grades describe diversification, cost and past risk; they are educational, not advice or a forecast. Unknown tickers are listed in unknown_tickers, never guessed.
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": "grade_portfolio"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| holdings | Yes | The portfolio: 1 to 30 holdings, each ticker once, with its weight. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | ||
| grade | Yes | Letter grade A+ to F, or "Not graded". | |
| score | Yes | 0–100 structural score. | |
| factors | Yes | Each graded factor, worst first. | |
| notices | Yes | ||
| disclaimer | Yes | ||
| cap_applied | Yes | Lowest structural ceiling that applies, or null. | |
| risk_profile | Yes | ||
| top_findings | Yes | Top 1–3 things that held the grade down. | |
| holdings_graded | Yes | ||
| methodology_url | Yes | ||
| unknown_tickers | Yes | Tickers with no usable price history; they were left out and the grade is capped as partial. | |
| full_breakdown_url | Yes | Opens the free checkup already graded for these holdings, with the full explanation. |