In this section: Wallet

Wallet

The wallet itself: its cards, benefits, spending strategy, eligibility, and the tools that add or update a card.

add_card

Add one credit card, or a BATCH of them, to the user's wallet. Requires wallet-change access.

ScopeQuota
miles:writestandard
NameTypeRequired
card_namestring
nicknamestring
date_openedstring
anniversary_datestring
sign_up_bonusstring
signup_bonus_statusstring
signup_bonus_received_onstring
sub_deadlinestring
sub_targetnumber
notesstring
statusstring
closed_onstring
autopay_statusstring
retention_offersobject[]
card_settingsobject
benefit_selectionsobject
original_card_namestring
product_historyobject[]
cardholderstring
holder_typestring
card_number_last4string
intentional_duplicateboolean
entry_keystring
cardsobject[]

analyze_keep_cancel

Keep/downgrade/cancel analysis for a wallet card: marginal value vs annual fee, duplicate-benefit discounting, downgrade paths.

ScopeQuota
miles:readstandard
NameTypeRequired
card_namestringrequired

analyze_spending

Earning-potential analysis for a spending profile: for each category, the wallet's best card and the annual rewards value it produces -- pre-computed dollar figures, not estimates to redo.

ScopeQuota
miles:readstandard
NameTypeRequired
spendingobjectrequired
candidate_cardsstring[]
internationalboolean

get_eligibility

Application-rule status (Chase 5/24, issuer velocity limits) based on the user's wallet card-open dates.

ScopeQuota
miles:readstandard
NameTypeRequired
issuerstring
cardstring
memberstring

get_needs_attention

Everything that needs eyes on it right now -- in the wallet, and on the cards the user is only considering.

ScopeQuota
miles:readstandard
NameTypeRequired
credit_window_daysinteger
fee_window_daysinteger
sub_window_daysinteger

get_spending_strategy

Category-by-category map of which wallet card to use for every spending type.

ScopeQuota
miles:readstandard

No parameters.

get_travel_day_summary

A wallet-derived travel-day checklist: lounge access, checked-bag waivers, priority boarding, and other day-of-travel benefits your cards carry -- filtered to what actually applies on this trip. get_wallet_benefits filtering cannot substitute: a benefit that applies only "on this airline" or "on international travel" needs both pieces of context at once, which this tool supplies and a flat benefit list does not. airline: optional carrier to filter to. international: whether this is an international itinerary.

ScopeQuota
miles:readstandard
NameTypeRequired
airlinestring
internationalboolean

get_wallet_benefits

Credits and perks across the user's wallet (lounge access, travel credits, statement credits, protections).

ScopeQuota
miles:readstandard
NameTypeRequired
benefit_typestring
cardholderstring

get_wallet_cards

The wallet's cards, one per row -- the lean per-card reader. get_wallet_summary / get_wallet_benefits are whole-wallet; use this for "what X cards do I have" or a per-card field scan.

ScopeQuota
miles:readstandard
NameTypeRequired
issuerstring
rewards_categorystring
formatstring
include_closedboolean
cardholderstring

get_wallet_summary

The user's wallet: cards with fees, credits, and key benefits.

ScopeQuota
miles:readstandard
NameTypeRequired
cardholderstring

get_weekly_update

What changed in points and miles recently -- the digest as pull: a scheduled agent can poll this instead of waiting on the email digest. Local reads only (indexed article dates, a changelog artifact, in-memory dataset) -- no paid vendor, no query embedding, no Miles token spend.

ScopeQuota
miles:readstandard
NameTypeRequired
daysinteger
categoriesstring[]

remove_card

Remove a card from the user's wallet. Requires wallet-change access.

ScopeQuota
miles:writestandard
NameTypeRequired
lookup_card_namestring
card_idstring

update_card

Update a card in the user's wallet (nickname, status, notes, dates, or a product change). Requires wallet-change access.

ScopeQuota
miles:writestandard
NameTypeRequired
lookup_card_namestring
card_idstring
nicknamestring
date_openedstring
anniversary_datestring
sign_up_bonusstring
signup_bonus_statusstring
signup_bonus_received_onstring
sub_deadlinestring
sub_targetnumber
notesstring
statusstring
closed_onstring
autopay_statusstring
dispositionstring
review_bystring
fee_posts_onstring
retention_offersobject[]
card_settingsobject
benefit_selectionsobject
original_card_namestring
product_historyobject[]
cardholderstring
holder_typestring
card_number_last4string
product_changeboolean
new_card_namestring
changed_datestring
directionstring
product_change_notestring
new_anniversary_datestring
expected_updated_atstring