add_to_deck
ChatGPTAdds cards to one of the user's Cascade decks (a deck id from list_decks), by English name or card id, with quantity and board. Cards in the deck already get the added copies; commanders and the companion do not change. It only adds: it never removes or changes other cards. Tell the user what changed; undo_change with the changeId undoes it, and so does the account page on Cascade.
add_to_inventory
ChatGPTAdds copies of cards to the user's Cascade collection (the inventory), for example the cards from a pack that they opened. Each card is a card id, or an English name with a set code and collector number when the user knows them; a name alone takes the newest printing that is not a promo, so ask the user which printing when it matters. With binderId (from list_binders), the copies go into that binder. It only adds copies: it never removes or changes others. Tell the user what changed; undo_change with the changeId undoes it, and so does the account page on Cascade.
add_to_list
ChatGPTAdds cards (card ids, quantities, finishes) to one of the user's Cascade lists (a list id from list_lists). Cards in the list already get the added copies. It only adds: it never removes or changes other cards. Tell the user what changed; undo_change with the changeId undoes it, and so does the account page on Cascade.
add_to_watchlist
ChatGPTPuts cards (by card id) on the user's Cascade watchlist, which tracks the price of each printing. Cards on it already stay as they are. Tell the user what changed; undo_change with the changeId undoes it, and so does the account page on Cascade.
add_to_wishlist
ChatGPTPuts cards (by card id) on the user's Cascade wishlist. Cards on it already stay as they are. Tell the user what changed; undo_change with the changeId undoes it, and so does the account page on Cascade.
collection_price_movers
ChatGPTThe owned cards whose price changed most in the last day or week, biggest value change first (price change times the owned copies). The list is included when the account has access to it; otherwise it is empty.
collection_summary
ChatGPTThe user's whole Cascade collection: number of cards, market value, copies by color, rarity and type, and the 10 most valuable owned printings. The value change over 7 and 30 days (valueChange) is included when the account has access to it.
create_binder
ChatGPTCreates a new binder (a named group of owned copies) in the user's Cascade collection. Use add_to_inventory with its binderId, or move_to_binder, to put copies into it. Tell the user what changed; undo_change with the changeId undoes it, and so does the account page on Cascade.
create_deck
ChatGPTCreates a new deck in the user's Cascade account from a decklist: the format, the commanders (in a commander format), a companion and the cards by board, each by English name or card id. It never changes a deck that is there. Tell the user what changed; undo_change with the changeId undoes it, and so does the account page on Cascade.
create_list
ChatGPTCreates a new list in the user's Cascade account with the given cards (card ids, quantities, finishes). It never changes a list that is there. Tell the user what changed; undo_change with the changeId undoes it, and so does the account page on Cascade.
get_deck
ChatGPTOne of the user's decks with its cards by board (mainboard, sideboard, maybeboard), the commanders, the companion, the current prices and the deck value. For each card: the owned copies, the missing copies, and the copies that other built decks use. Use missingOnly to list only the cards the user still needs. 20 cards a page; every page has the commanders and the companion, also with missingOnly.
get_list
ChatGPTThe cards in one of the user's Cascade lists, 40 a page, by name or by price, with the copies by finish and the current prices.
get_meta_deck
ChatGPTOne meta deck archetype (source: mtgo.com): its representative decklist, the copies the user owns and the missing cards. The price of the missing cards (costToComplete, missingCopyPriceUsd) is included when the account has access to it.
get_trade
ChatGPTOne of the user's Cascade trades (a trade id from list_trades): the totals of both sides, the cash, and each card with finish, quantity, condition, value and the copies that the user owns now (40 lines a page).
get_watchlist
ChatGPTThe card prices that the user tracks in Cascade, with today's and yesterday's price. Every tracked card is included when the account has access to the full watchlist; otherwise the first 3, as in the apps.
get_wishlist
ChatGPTThe cards on the user's Cascade wishlist, by date added, name or price, with the current prices.
list_binders
ChatGPTThe binders in the user's Cascade collection (named groups of owned copies, in the user's order) with their copies and printings, and the owned copies that are in no binder. Use a binder id with search_collection to see its cards.
list_decks
ChatGPTThe user's Cascade decks, last edited first: id, name, format, the commanders and their color identity, card counts, the deck value, whether the deck is built and the time of the last edit. Use get_deck with an id for the cards.
list_lists
ChatGPTThe user's own Cascade card lists (A to Z): id, name, number of cards and value. Use get_list with an id for the cards. The wishlist and the watchlist have their own tools.
list_trades
ChatGPTThe user's Cascade trades, newest first: name, status (open or completed), the value of what the user gives and gets, and the difference. get_trade has the cards of one trade.
lookup_card
ChatGPTFind a card by name (or by a card id from another result): its printings, the copies the user owns of each, the current prices, and optionally the price history of one printing over a week, month or year.
meta_decks
ChatGPTThe archetypes of recent MTGO challenge decks (source: mtgo.com) with their meta share, and how many of the representative deck's mainboard cards the user owns. Use get_meta_deck for one archetype's cards.
move_to_binder
ChatGPTMoves owned copies (by card id) from one binder, or from no binder, to another binder, or out of a binder. The collection keeps every copy: only the binders change. All or nothing: when the source has too few copies, nothing moves. Tell the user what changed; undo_change with the changeId undoes it, and so does the account page on Cascade.
remove_from_deck
ChatGPTTakes copies of cards off one of the user's Cascade decks (a deck id from list_decks), by the card name as in the deck or by card id, with board, finish and quantity. Never more copies than the deck has; the deck, its commanders and its companion stay. Confirm the cards and quantities with the user before you call it. undo_change with the changeId (or the account page on Cascade) puts the cards back.
remove_from_inventory
ChatGPTTakes copies of cards (by card id, finish and quantity) out of the user's Cascade collection, for example cards that the user sold or traded away. Never more copies than the user owns; copies in no binder go first, then copies in binders. Confirm the cards and quantities with the user before you call it. undo_change with the changeId (or the account page on Cascade) puts the cards back.
remove_from_list
ChatGPTTakes copies of cards (by card id, finish and quantity) off one of the user's Cascade lists (a list id from list_lists). Never more copies than the list has; the list itself stays. Confirm the cards and quantities with the user before you call it. undo_change with the changeId (or the account page on Cascade) puts the cards back.
remove_from_watchlist
ChatGPTTakes cards (by card id) off the user's Cascade watchlist, so that their prices are no longer tracked. Confirm the cards and quantities with the user before you call it. undo_change with the changeId (or the account page on Cascade) puts the cards back.
remove_from_wishlist
ChatGPTTakes cards (by card id) off the user's Cascade wishlist. Confirm the cards and quantities with the user before you call it. undo_change with the changeId (or the account page on Cascade) puts the cards back.
search_collection
ChatGPTSearch the cards in the user's Cascade collection by name, color identity, type, set and rarity, and by deck use (in a built deck, in no deck, or with free copies), and by binder. Returns 40 cards a page with the owned copies by finish, the copies in each binder and the current prices. Page 1 also counts the copies and printings of all the matching cards (cardCount, printingCount): to count cards, use these and do not read every page.
set_completion
ChatGPTHow complete the user's collection is for each set, or for one set with its missing cards (40 a page). The price to complete the set (costToComplete, missingCopyPriceUsd) is included when the account has access to it.
undo_change
ChatGPTUndoes a change of the last 30 days that a write tool made: deletes the list or deck that create_list or create_deck created, takes the cards off the wishlist again, or takes the copies that add_to_inventory, add_to_list or add_to_deck added out again (never more copies than are there now). A list or deck that changed after it was created stays. Ask the user before you undo.