add_card
ChatGPTadd card in the authenticated Rewards OS account. Changes persistent state.
bulk_add_cards
ChatGPTAdd selected supported cards together after the user reviews ambiguity and plan capacity. The write is atomic and idempotent. in the authenticated Rewards OS account. Changes persistent state.
get_benefit_summary
ChatGPTRead a compact summary of current benefits in the authenticated wallet. Prefer this for broad questions such as “what benefits do I have?” or “explore my benefits.” It distinguishes tracked remaining, marked unused, unknown usage, fully used, and untracked states. A conditional tracked-USD total is not a promise of spendable value. This read has an optional Benefit Explorer UI and a complete text fallback. in the authenticated Rewards OS account. Reads state only.
get_card_benefits
ChatGPTget card benefits in the authenticated Rewards OS account. Reads state only.
get_expiring_benefits
ChatGPTget expiring benefits in the authenticated Rewards OS account. Reads state only.
get_my_cards
ChatGPTget my cards in the authenticated Rewards OS account. Reads state only.
get_reminder_preferences
ChatGPTget reminder preferences in the authenticated Rewards OS account. Reads state only.
get_reminder_proposals
ChatGPTRead exact proposed reminder times for eligible benefits. A proposal does not activate delivery; private beta has no configured automatic notification channel. Show the dates and require user confirmation plus explicit host confirmation before reporting a host task as active. Never fall back silently to Web Push. in the authenticated Rewards OS account. Reads state only.
get_rewards_wallet
ChatGPTget rewards wallet in the authenticated Rewards OS account. Reads state only.
get_user_benefit_periods
ChatGPTRead current persisted benefit-period state. Distinguish catalog entitlement, tracked usage, and verified issuer activity; default zero use is unknown without user-reported provenance. in the authenticated Rewards OS account. Reads state only.
get_wallet_benefit_page
ChatGPTRead one ordered page of current wallet benefits. Use after get_benefit_summary for complete lists, or when the user asks for all benefits. Text-only clients should use the default five-item page; MCP App clients may request page_size 10. Preserve usage and timing states; unknown usage is not unused. Use the returned cursor to continue, and refresh the summary if the cursor is stale. Reads state only. in the authenticated Rewards OS account. Reads state only.
get_wallet_benefits
ChatGPTRead shared catalog benefits across active wallet cards. For wallet-wide summaries and complete user-state lists, prefer get_benefit_summary followed by get_wallet_benefit_page. in the authenticated Rewards OS account. Reads state only.
remove_card
ChatGPTremove card in the authenticated Rewards OS account. Changes persistent state.
resolve_card_list
ChatGPTResolve one or more card names before a bulk add. Return confirmed, ambiguous, already-owned, and unsupported matches. Ask for review when needed. in the authenticated Rewards OS account. Reads state only.
review_card_matches
ChatGPTRender one consolidated Bulk Card Review after resolving natural-language card mentions. Use for ambiguity, multiple cards, unsupported/already-added cards, or when the requested selection exceeds current capacity. A single clear card can be added conversationally without UI. The result also contains complete text fallback.
search_cards
ChatGPTsearch cards in the authenticated Rewards OS account. Reads state only.
set_benefit_reminder_override
ChatGPTSave or disable reminder timing preferences for one card benefit. Resolve its card and benefit IDs first. This does not create a task or activate automatic notifications; Web Push remains dormant for private beta. in the authenticated Rewards OS account. Changes persistent state.
set_reminder_preferences
ChatGPTSave global default offsets for future reminder suggestions. This preference does not create a task or activate automatic notifications. Web Push remains dormant for private beta. in the authenticated Rewards OS account. Changes persistent state.
update_card_dates
ChatGPTupdate card dates in the authenticated Rewards OS account. Changes persistent state.
update_user_benefit_period
ChatGPTRead tracking_mode before offering a state change. balance_trackable supports fixed-value amounts and partial use. usage_trackable supports only explicit unused (available) or used (redeemed), starts unknown, and may record redeemed_at; never send an amount or in_progress. catalog_only and needs_review are read-only for user usage state. For balance amounts, preserve the original signed token and specify cumulative or incremental semantics; incremental use requires a read-only proposal followed by explicit confirmation against the expected current amount. Never convert a negative amount into positive usage. For full redemption without an amount, request explicit confirmation. in the authenticated Rewards OS account. Changes persistent state.