add_card
Add a credit card to the wallet with a preview and confirmation step, ensuring reward rates and statement dates are correct before saving.
Instructions
Add a credit card to the wallet, then call add_earn_rate for each category or merchant where it earns more than its base rate.
Wrong terms silently skew every later recommendation, so saving needs the user's
agreement: call once without `confirmed` to get a preview, show it to the user
(including anything found with search_card_terms and their statement day), and
call again with confirmed=true only after they agree.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": {
"name": "<name>",
"issuer": "<issuer>",
"reward_kind": "<reward_kind>",
"base_rate": "<base_rate>"
},
"name": "add_card"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Card name as the user calls it, e.g. 'HDFC Millennia' | |
| notes | No | Fees, perks, anything worth remembering | |
| issuer | Yes | Issuing bank | |
| network | No | Visa, Mastercard, RuPay, Amex, Diners | |
| base_rate | Yes | Units earned per block_inr on regular spends. 1% cashback = 1 with block_inr 100; '4 points per ₹150' = 4. | |
| block_inr | No | Spend (₹) that earns base_rate units, e.g. 150 | |
| confirmed | No | Set true only after the user has seen and agreed to these terms. Without it the card is previewed, not saved. | |
| reward_kind | Yes | ||
| statement_day | No | Day of the month the billing cycle starts | |
| unit_value_inr | No | Rupee value of one point. Required for points cards; cashback defaults to 1. | |
| excluded_categories | No | Categories that earn nothing on this card. Defaults to fuel, government, rent, wallet |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||