anki-process-engine-live

List every deck in the collection with its deck ID. Returns: {"total": number, "count": number, "items": [{"name": string, "id": number}], "truncated"?: true} Use when: discovering available deck names before creating a note or scoping a search query.

Create a new deck (or subdeck, using "::" separators). Creating a deck that already exists is a no-op and returns its existing ID. Returns: {"deck_id": number} Use when: setting up a new deck/subdeck before adding notes to it.

List every note type (model) name in the collection, e.g. "Basic", "Cloze". Returns: {"total": number, "count": number, "items": string[], "truncated"?: true} Use when: discovering which note types are available before calling anki_get_model_fields or anki_add_note.

List the field names for a given note type, in order. Returns: {"fields": string[]} Use when: you need the exact field names to pass to anki_add_note's "fields" object (e.g. Cloze uses "Text", Basic uses "Front"/"Back"). Field names are case-sensitive.

Create a single new note in Anki. Returns: {"note_id": number} on success. Use when: adding one flashcard. For more than a couple of notes, use anki_add_notes (bulk) instead — one call for the whole batch. Errors if: the first field is empty, the deck/model name doesn't exist (check with anki_list…

Create up to 500 notes in a single call. Returns: {"created_count": number, "note_ids": (number | null)[], "failed_indices": number[]} — note_ids is index-aligned with the input; null means that note failed (most commonly a duplicate, or a bad deck/model/field name). Use when: importing a batch of…

Search for notes using Anki's search syntax and return matching note IDs. Returns: {"total": number, "count": number, "items": number[], "truncated"?: true} — note IDs; feed into anki_get_notes_info for field/tag details. Use when: locating notes by deck, tag, or field content before reading or ed…

Fetch full field content, tags, and note type for a list of note IDs. Returns: {"total", "count", "items": [{"note_id", "model_name", "tags": string[], "fields": {fieldName: value}, "card_ids": number[]}], "missing_note_ids"?: number[], "truncated"?} — IDs that no longer exist (deleted since they w…

Overwrite one or more field values on an existing note. Tags and note type are unaffected. Field names are validated against the note's model before writing, so a typo'd field name errors instead of silently changing nothing. Returns: {"success": true, "updated_fields": string[]} on success. Use w…

Permanently delete one or more notes (and all their cards). This cannot be undone from here. Returns: {"deleted_count": number, "not_found_note_ids"?: number[]} — existence is checked before deleting, so deleted_count reflects notes that actually existed; stale IDs are reported in not_found_note_id…

Add one or more tags to a set of notes without touching existing tags. Returns: {"tagged_count": number, "not_found_note_ids"?: number[]} — stale/nonexistent IDs are reported instead of silently skipped. Use when: flagging notes for later review (e.g. tag "fix-me"), or applying week/subject tags i…

Remove one or more tags from a set of notes. Returns: {"untagged_count": number, "not_found_note_ids"?: number[]} — stale/nonexistent IDs are reported instead of silently skipped. Use when: clearing a "fix-me" flag once a card has been corrected.

Search for cards (not notes) using Anki's search syntax and return matching card IDs. Returns: {"total", "count", "items": number[], "truncated"?} — card IDs; feed into anki_get_cards_info or anki_get_card_reviews. Use when: you need per-card data (lapses, ease, review history) rather than note fi…

Fetch per-card scheduling and performance data: lapses, ease factor, interval, and deck/model. Returns: {"total", "count", "items": [{"card_id", "note_id", "deck_name", "model_name", "lapses", "ease_factor", "interval_days", "reps", "queue", "card_type", "due"}], "missing_card_ids"?: number[], "tru…

Fetch the most recent reviews for a set of cards: each time the card was shown and what button was pressed. Returns: {"total", "count", "items": [{"card_id": number, "total_reviews": number, "reviews": [{"reviewed_at_ms", "ease" (1=Again,2=Hard,3=Good,4=Easy), "new_interval_days", "previous_interva…

Get the number of reviews performed per day, across the whole collection. Returns: {"total", "count", "items": [{"date": "YYYY-MM-DD", "review_count": number}], "truncated"?} — review_count is total review events (a card reviewed 5 times counts 5, not unique cards), and days with zero reviews are O…

Run an AnkiWeb sync from the running Anki instance (same as clicking the sync button). Returns: {"success": true} after the sync completes. This BLOCKS until the sync finishes — it can take a while for large collections (up to a 5-minute timeout). Use when: you want changes made via this MCP serve…