create_note
ChatGPTSave information the player wants remembered across conversations — build guides, goals, farming plans, session context, or strategy notes. Attach to a specific save. Maximum 10 notes per save.
delete_note
ChatGPTPermanently remove a note. Only when the player explicitly asks to delete — prefer updating to revise outdated content.
get_note
ChatGPTFull content of a player's note — build guides, goals, session memories, farming plans, or strategy context they saved for future conversations. Read relevant notes before giving advice so you build on prior discussion.
get_save
ChatGPTDetailed view of a single character or save — summary, overview stats, list of available data sections, and attached notes. Use when the player asks about a specific character, playthrough, or save file.
get_section
ChatGPTDeep data for specific aspects of a save — equipment, skills, quests, stats, inventory, abilities, or any game-specific section. Returns actual in-game state the player has experienced. Only request sections you will directly reference in your response.
list_games
ChatGPTThe player's complete game library — all games, characters, saves, notes, and reference modules they have access to. Start here when beginning any conversation about the player's game state. If a character seems missing, check removed_saves — it may have been removed rather than deleted.
query_reference
ChatGPTAuthoritative game calculations — drop rates, stat thresholds, build comparisons, draft ratings, mana curves, or any quantitative query where estimation would be unreliable. Use when the module has no visual component, or when you need raw data to answer a pointed question with a sentence rather than a view. For modules with visual=true, prefer show_reference instead — the player gets an interactive display and you can still narrate. Batch multiple queries in a single call to avoid round-trips. Max 50 queries per call. Modules that accept card/deck lists can also accept a section reference (e.g., deck_section + save_id) to pull data directly from the player's save instead of passing cards inline.
refresh_save
ChatGPTPull the latest game data for a save — re-parse the save file or fetch fresh API data. Use when the player says something just changed in-game: found an item, leveled up, equipped gear, finished a quest.
search_saves
ChatGPTFull-text keyword search across all saves and notes — find items, skills, quests, characters, or any game data without knowing which save contains it. Ideal for cross-character and cross-game queries. Results distinguish between save data and player-written notes.
setup_help
ChatGPTSavecraft setup, installation, pairing, and project information. Use when the player has no saves yet, mentions a pairing code, asks how to connect a game, or asks about privacy and security. Also shows connected sources and their status.
show_games
ChatGPTVisual card layout of the player's games, saves, characters, and reference modules. Default choice when the player asks to see their games, check what they have connected, or during onboarding. Renders game icons, character summaries, and available analysis tools as interactive cards.
show_reference
ChatGPTInteractive visual display of reference data — renders results as charts, tables, dashboards, and interactive views directly in the conversation. Default choice for any reference query when the module has visual=true in the query_reference schema. Same parameters as query_reference. The player sees a richer result and you can still narrate and discuss around it.
show_save
ChatGPTVisual character card with overview stats, data sections, and notes for a single save. Default choice when the player asks to see their character, pull up a save, or wants a summary of a specific playthrough. Renders the character's key stats, available sections, and attached notes as an interactive card.
update_note
ChatGPTRevise an existing note when the player's plans, goals, or game state has changed. Preferred over deleting — keeps the note's identity stable across sessions.