Anki SAT MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ANKI_SAT_EXPORT_DIR | No | Carpeta de salida para los archivos HTML exportados. La ubicación predeterminada es 'Anki SAT Exports' dentro de la carpeta de usuario. | |
| ANKI_CONNECT_API_KEY | No | Clave de AnkiConnect. También puede proporcionarse mediante el archivo local %LOCALAPPDATA%\AnkiSatMcp\ankiconnect.key en Windows. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Creates interactive SAT quizzes and flashcards in local Anki. Use preview_sat_quiz for a questionnaire with answer selection, grading and review. Use preview_sat_questions for individual flashcards. Present the preview before committing. Only commit_sat_preview changes Anki. Use export_sat_quiz for a self-contained offline HTML quiz.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_decksA | List the names of all decks in the local Anki collection. Read-only. |
| check_deckA | Check whether a deck exists. Matching ignores letter case, and the result gives the exact deck name. Read-only. |
| preview_sat_questionsA | Validate SAT multiple-choice questions (exactly four choices A to D and one answer letter) and show the Anki notes they would create, with all text HTML-escaped. Reports which questions already exist in Anki, matched by tag, and whether the deck exists. If the deck is missing, says that commit_sat_preview will create it. Writes nothing to Anki. Returns a previewToken that expires in 10 minutes and works only in this server process. Pass it to commit_sat_preview to add the new questions. |
| preview_sat_quizA | Preview one interactive Anki card containing the whole questionnaire. The student can choose answers, submit, see a score, and review explanations. Returns a one-time previewToken and does not write to Anki. |
| commit_sat_previewA | Save a preview_sat_quiz or preview_sat_questions result. Pass only previewToken. Each token works once, expires after 10 minutes, and is valid only in the server process that issued it. The server skips duplicates and creates the destination deck when needed. An interactive quiz uses a dedicated note type that is created on first use. |
| export_sat_quizA | Save a self-contained interactive questionnaire. Open the file in any modern browser to choose answers, submit, see a score and review explanations. Works offline and does not change Anki. |
| export_sat_tsvA | Save an import-ready TSV with the requested deck, styled question and answer cards, and tags. Works without AnkiConnect and does not change the Anki collection. Returns the file path. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
The preview tools split cleanly by output (preview_sat_questions for individual notes, preview_sat_quiz for one interactive card), and the two exports differ clearly (offline HTML vs import TSV). The only real overlap is list_decks vs check_deck, since existence could be inferred from a full listing, though the case-insensitive exact-name lookup gives check_deck a distinct role.
All seven tools follow a strict snake_case verb_noun pattern (list_decks, check_deck, preview_*, commit_*, export_*), with a consistent 'sat' domain qualifier on the domain-specific tools. The preview/commit and export pairings are named symmetrically, making the workflow legible from names alone.
Seven tools is well-scoped for a focused workflow: discover decks, preview in two modes, commit once, and export in two formats. Every tool maps to a distinct step and none appears redundant.
The core lifecycle (list/check deck, preview with duplicate detection, commit with token safety, two export paths) is fully covered for getting SAT questions into Anki. There are minor gaps: no way to update or delete existing notes/questions, and no dedicated tool to list current SAT notes beyond the tag matching inside preview.