Annual fee verdict
fee_verdictAssess whether one card in the signed-in PointBagel user's own wallet is still worth its annual fee: the keep-or-cancel recommendation, the fee coverage, the benefit value captured, and the credits left unused, for the current membership year or a completed past year (period). A final partial year on a closed or converted card is reported as not scored, with the share of its fee covered instead of a fee coverage figure; a first-year card gets facts and a maturity note, not a verdict. Read-only and owned-scope. Requires the card to be tracked; untracked cards return catalog facts, why the verdict is not ready, and how to unlock it. Never-held cards are pointed to card_facts or card_impact. Values are estimates.
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": {
"card": "<card>"
},
"name": "fee_verdict"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| card | Yes | ||
| period | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| asOf | Yes | ||
| data | Yes | ||
| status | Yes | ||
| summary | Yes | ||
| nextActions | No | ||
| userWarnings | No |