add_flashcard
ChatGPTAdd a new flashcard to your study deck, optionally placing it in a named deck (creates the deck if it does not exist)
archive_deck
ChatGPTArchive or unarchive one of your decks (by deck id or deck name). Archiving a deck also archives all cards in that deck; unarchiving reverses this. Returns the deck id/name, the new archived state, and the number of affected cards.
archive_flashcard
ChatGPTArchive or unarchive a flashcard. Archived cards are hidden from study/review but are not deleted and can be unarchived later.
create_deck
ChatGPTCreate a new deck.
delete_deck
ChatGPTDelete a deck (by deck id or deck name). This removes the deck and its card associations, but does NOT delete the flashcards themselves.
fetch
ChatGPTFetch the full contents of a document by id
get_aligned_cards
ChatGPTGet your flashcards ranked by how well they align with one learning target (goal), rendered in the review widget. Same card shape as get_review_cards, plus per-card alignment fields. Read-only and cache-only — uses already-computed alignment scores and never calls an LLM. Cards still awaiting a score report alignment_score: null.
get_card_html
ChatGPTUI-only: fetch the saved interactive HTML visualization (QAPair.html_widget) for a single flashcard. Returns the raw HTML string so the review widget can render it inside a sandboxed iframe. This tool returns data for the widget to display; it does not replace/render the widget itself and is not meant to be called by the model directly.
get_deck
ChatGPTGet details of a single deck (by deck id or deck name), including a summary list of the cards it contains.
get_due_flashcards
ChatGPTGet flashcards that are due for review today (spaced repetition)
get_flashcard_statistics
ChatGPTGet statistics about your flashcard deck and learning progress
get_memory_curve
ChatGPTGet the forgetting/memory curve for a single flashcard: the predicted retention (recall probability) over the next ~30 days based on the adaptive (FSRS-lite) memory model. Used by the review widget to draw an inline retention chart for a card.
get_progress
ChatGPTGet current readiness for one learning target (goal): overall readiness, coverage, mastery, per-area breakdown, and honest pending/stale flags. Returns cached readiness; if any scores are pending or stale, background re-scoring is kicked off.
get_recent_flashcards
ChatGPTGet recently added flashcards sorted by creation date
get_review_cards
ChatGPTGet review flashcards for a specific deck (or all decks) and the user's deck list for the widget's deck selector. Optionally limit to cards due for review (spaced repetition).
get_review_history
ChatGPTGet your past review history (scores and feedback over time), optionally filtered to a single flashcard. Read-only.
get_statistics_overview
ChatGPTGet a rich learning statistics overview: totals, streaks, average score, due counts, plus optional daily activity, retention curve, and tag performance. Read-only.
list_decks
ChatGPTList your decks with basic info (id, name, category, description, card count).
list_flashcards
ChatGPTRetrieve flashcards from your study deck
list_targets
ChatGPTList your learning targets (goals) with their latest readiness snapshot (if any) and a breakdown of how many of your cards are aligned (fresh), stale, or still pending. Read-only; does not compute readiness or score cards.
prepare_flashcards
ChatGPTPrepare draft flashcards for the user to review before adding. Returns guidance for drafting high-quality Q&A flashcards; does NOT save anything. After the user approves the drafts, the model should call add_flashcard.
rate_flashcard_response
ChatGPTSave a flashcard review with score and feedback. ChatGPT evaluates the user answer and provides score (0-100) and feedback, then this tool saves it to the database and updates the spaced repetition schedule.
refine_intention_from_text
ChatGPTRefine an existing learning target (goal) by merging the capabilities found in a new source document (e.g. another job description) into its competency areas. Each capability the document evidences strengthens its area by one; genuinely new capabilities become new areas; near-duplicates fold into existing areas. Does not score cards immediately; existing alignment scores are marked stale for background re-scoring.
remove_card_from_deck
ChatGPTRemove a flashcard from a named deck. This only removes the association between the card and the deck; the flashcard itself is NOT deleted and remains in other decks and your library.
save_flashcard_visualization
ChatGPTSave visualization HTML to an existing flashcard so it can be rendered later in SFT Brain. Replaces any existing visualization for that flashcard.
search
ChatGPTReturn a list of relevant search results for a query
set_deck_sharing
ChatGPTSet the sharing/visibility of one of your decks (by deck id or deck name). Modes: "private" (not shared; clears the share link), "view_only" (shared via link, others can view but NOT clone), "cloneable" (shared via link, others can view AND clone a copy), "public_view_only" (publicly discoverable, view only, not cloneable), "public_cloneable" (publicly discoverable, view and cloneable). For any shared mode a share link is ensured and the full share URL is returned so you can give it to the user.
set_target
ChatGPTSet a learning target (goal) to align your flashcards against — a company, role, skill, position (job posting), job description, or free-text intent. Creates the target, extracts its competency profile, and queues your cards for background alignment scoring. Does not score cards immediately; use get_progress and get_aligned_cards afterwards.
spread_organic_importance
ChatGPTRecord an organic encounter with an existing flashcard (card_id) or a free-text concept you bumped into while studying something else, raising its organic importance and spreading a similarity-weighted boost to the most similar cards. Does NOT create/merge cards, grade a review, or change the review schedule/FSRS.
update_flashcard
ChatGPTUpdate an existing flashcard