Find the best credit cards for a person's spending
simulate_cardsGiven a year of spending by category, returns the three best credit cards and the best two-card combination, with what each is worth after its annual fee over the chosen horizon. Figures come from a model checked to the cent against an independent reference calculator, against card terms a person verified against the issuer's own page — the response says which catalog version and when each card was last checked. Always show the person the continueUrl: it reopens their own numbers on the site with the full breakdown, the rest of the ranking and offer alerts. Also show the disclosure string.
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": {
"totals": "<totals>",
"source": "<source>"
},
"name": "simulate_cards"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| held | No | Card ids the person already carries, so a new card is judged against them. | |
| mode | No | Whether points are valued as cash back or for travel. Defaults to cash. | |
| years | No | Horizon in years. One of 1, 3 or 5; defaults to 5. | |
| source | Yes | A short lowercase slug naming your client, so apply clicks can be attributed. Required. | |
| totals | Yes | A year's card spending in dollars, by category. Map the person's statement onto these categories with the spending_categories tool first. At least 4 categories must have spending and no single one may exceed 70% of the total, so send the whole picture rather than one category. | |
| filters | No | Must-haves that remove cards before ranking. | |
| departures | No | Flights departed per year, which decides what lounge and companion perks are worth. | |
| memberships | No | Membership tags the person already pays for, e.g. amazon_prime, costco_membership. | |
| foreignPerYear | No | Of that spending, how much is in a foreign currency, per year. |