Which card to use
which_cardRecommend which of the signed-in user's own credit cards to use for a given store or spending category, and show the earning behind the call: the effective earn rate, which reflects how much of that category cap the user has spent this period, or assumes none if PointBagel cannot see it, the estimated value per dollar, the runner-up cards in their wallet, any merchant-specific promotional rate with its terms, the booking channels that change the answer for travel, and any welcome-bonus spend in progress. Assumes a small default purchase when no amount is given. Values are estimates. Read-only; the user's own wallet only. For cards the user names but has not saved, use which_card_for_named_cards if it is available.
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": {
"query": "<query>"
},
"name": "which_card"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | A store or spending category, e.g. "Costco", "dining", or "gas". | |
| scope | No | Leave unset unless the member asks to limit to personal or business cards. | |
| style | No | Redemption style for valuing points. Defaults to "balanced". | |
| amount | No | Purchase amount in US dollars. Defaults to a small purchase. | |
| portal | No | The name of the travel portal the user says they are booking through, such as "Chase Travel", with bookingChannel set to portal. | |
| business | No | A business name, as named in PointBagel, to rank only that business's cards. Implies scope "business", so it is part of the PRO plan. | |
| bookingChannel | No | How the user says they are booking this purchase: direct with the supplier, through a portal (name it in portal), or other for any other way, such as an online travel agency. Put only the purchase in query. Leave this unset when the user has not said, has only said what they are not using, or is unsure; never assume it. | |
| purchaseAbroad | No | Set to true only when the user says the purchase is abroad or in a foreign currency; never assume it. For a spending category the answer then adds a ranking of the user's cards by what each earns minus its fee abroad. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| asOf | Yes | ||
| data | Yes | ||
| status | Yes | ||
| summary | Yes | ||
| nextActions | No | ||
| userWarnings | No |