Anki SAT MCP
Creates SAT Reading & Writing quiz decks and cards in Anki through the AnkiConnect add-on. Provides tools to preview quiz batches before saving, commit the preview as a new note type (SAT Interactive Quiz v1) with interactive answer forms in a deck, list decks in the open profile, check whether a deck exists, and skip duplicates. Also exports self-contained HTML quizzes answerable in a browser and TSV cards for import into Anki, which work even when Anki is closed.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Anki SAT MCP Preview a 5-question SAT Reading quiz in my SAT deck before saving"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Anki Quiz MCP
Un servidor MCP local para convertir preguntas de lectura y escritura en inglés en cuestionarios interactivos y tarjetas de repaso. En un cuestionario puedes marcar una opción por pregunta, navegar por el lote, entregar, ver tu puntuación y revisar los errores. El ejemplo incluido tiene diez preguntas originales en inglés.
Pruébalo en un navegador
Necesitas Node.js 22 o posterior y npm. Desde la carpeta del repositorio, ejecuta:
npm ci
npm run build
npm run quiz -- examples/sat-reading-writing.jsonEl último comando imprime la ruta de un archivo HTML. Ábrelo en tu navegador y contesta el cuestionario. El archivo incluye su propio estilo y código. Funciona sin conexión y las respuestas se borran al cerrar o recargar la página. Puedes elegir una carpeta de salida con un segundo argumento o con la variable ANKI_SAT_EXPORT_DIR. La ubicación predeterminada es Anki SAT Exports dentro de tu carpeta de usuario.
Related MCP server: anki-mcp
Usarlo en Anki desde un cliente MCP
Instala Anki Desktop y el complemento de terceros AnkiConnect. En Anki, el código del complemento es
2055492159. Reinicia Anki y deja abierto el perfil que quieres usar.Registra un servidor MCP con transporte stdio. Usa
nodecomo comando y la ruta absoluta dedist/src/index.jscomo argumento. En Codex puedes registrarlo con este comando desde la carpeta del repositorio:codex mcp add anki-sat -- (Get-Command node.exe).Source (Resolve-Path .\dist\src\index.js).PathPide al cliente un cuestionario y solicita una vista previa con
preview_sat_quiz. Revisa el mazo y el número de preguntas antes de guardar concommit_sat_preview.Abre el mazo en Anki y pulsa Study Now. En el frente de la tarjeta, responde y pulsa Submit quiz en la última pregunta. Anki coloca la clave en Show Answer. Puedes usar esa clave al terminar y registrar el repaso con los botones habituales de Anki.
El primer guardado interactivo crea el tipo de nota SAT Interactive Quiz v1. Cada formulario ocupa una tarjeta de Anki. La puntuación del cuestionario se calcula en el formulario y la calificación de repaso la decides en Anki. El manual de Anki documenta el uso de JavaScript en las tarjetas y advierte que puede variar entre clientes. Si un cliente no ejecuta el formulario, usa el HTML exportado.
Herramientas MCP
Herramienta | Entrada | Qué hace |
|
| Previsualiza un cuestionario completo para Anki y devuelve un token. |
|
| Guarda un cuestionario HTML que se puede contestar en un navegador. |
|
| Previsualiza tarjetas individuales y devuelve un token. |
|
| Guarda una vista previa, crea el mazo si hace falta y omite duplicados. |
|
| Guarda tarjetas individuales para importar en Anki con el tipo de nota |
| — | Lista los mazos del perfil abierto. |
|
| Comprueba si existe un mazo. |
Las vistas previas consultan Anki. La exportación HTML y TSV funciona con Anki cerrado. Los tokens caducan a los diez minutos y se usan una sola vez en el proceso que los emitió.
Formato de preguntas
Usa de una a cincuenta preguntas en cada lote. Proporciona el texto, cuatro opciones, una letra correcta y, si quieres, una explicación. El cliente MCP puede preparar estos datos a partir de preguntas que le proporciones.
{
"deck": "English Reading and Writing",
"questions": [
{
"stem": "Both researchers submitted ____ reports on time.",
"choices": { "A": "their", "B": "there", "C": "they’re", "D": "theirs" },
"answer": "A",
"explanation": "Their is the possessive determiner that modifies reports."
}
]
}Privacidad y permisos
El servidor habla con AnkiConnect en
127.0.0.1:8765. AnkiConnect puede usar una clave. Suminístrala medianteANKI_CONNECT_API_KEYo el archivo local%LOCALAPPDATA%\AnkiSatMcp\ankiconnect.keyen Windows. Guarda la clave fuera del repositorio.El HTML exportado no carga recursos externos ni envía las respuestas. Incluye la clave de respuestas para corregir localmente. Sirve para práctica personal.
Configura tu cliente MCP para pedir confirmación al llamar a
commit_sat_preview, la única herramienta que cambia la colección. Si tu cliente usa un modelo en la nube, sus políticas se aplican al contenido que le compartas.Usa preguntas originales o materiales cuyos permisos cubran el uso que les darás. Los ejemplos son originales, creados con asistencia de IA. El proyecto es independiente. Consulta las marcas, derechos de contenido y dependencias y el aviso de privacidad.
npm test compila el proyecto y ejecuta las pruebas locales. Consulta la licencia MIT.
Available Tools
7 toolscheck_deckCheck an Anki deckARead-onlyIdempotent
Check whether a deck exists. Matching ignores letter case, and the result gives the exact deck name. Read-only.
Inputs: deck (required).
commit_sat_previewSave a previewed SAT quiz or flashcard batch to AnkiA
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.
Inputs: previewToken (required).
export_sat_quizExport a fillable SAT quiz as HTMLA
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.
Inputs: deck (required), questions (required).
export_sat_tsvExport individual SAT flashcards for AnkiA
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.
Inputs: deck (required), questions (required).
list_decksList Anki decksARead-onlyIdempotent
List the names of all decks in the local Anki collection. Read-only.
Inputs: no named parameters.
preview_sat_questionsPreview SAT multiple-choice questionsARead-only
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.
Inputs: deck (required), questions (required).
preview_sat_quizPreview an interactive SAT questionnaireARead-only
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.
Inputs: deck (required), questions (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
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.
Maintenance
Related MCP Connectors
Turn text, files, URLs, or photos into Anki flashcard decks from your AI assistant.
Free: turn your AI chats into spaced-repetition vocabulary. 13 tools, reads and writes.
Voice-led, FSRS-scheduled flashcards from YouTube, PDFs, web, or text. Auto-graded quizzes.
Spaced-repetition flashcards your AI writes, quizzes you on by voice, and schedules with FSRS.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAutomatically generates Anki flashcards from Notion pages by extracting questions and answers from toggle blocks. Uses OpenAI to enhance card quality and imports them directly into Anki via AnkiConnect for spaced repetition learning.MIT
- AlicenseNot gradedqualityNot gradedmaintenanceEnables intelligent Anki vocabulary management with automatic TTS audio generation, batch card creation, and advanced search and analysis.7ISC
- AlicenseAqualityDmaintenanceEnables safe, review-first Anki authoring with tools to inspect structure, create note types, add notes, preview renderings, and manage cards via AnkiConnect.166 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables to interact with your Anki collection through natural language, allowing you to study, edit, and analyze flashcards without external dependencies.2MIT