Health check: confirm AnkiConnect is reachable and return its API version (expected: 6). Call this first if other tools are failing.

List the names of all decks in the collection.

Create a new deck. Use '::' in the name to create a nested subdeck (e.g. 'Languages::Romanian'). Existing decks are left untouched.

Delete a deck. If cards_too is True (default) its cards are deleted as well; otherwise the cards are moved to the Default deck. Irreversible.

Get review statistics (new/learning/review counts, totals) for the given deck names.

List all note type (model) names, e.g. 'Basic', 'Cloze'.

List the field names of a note type, in order (e.g. Basic -> ['Front', 'Back']). Use this before add_note to supply the right fields.

Add a single note. 'fields' maps the note type's field names to their HTML/text values (e.g. {'Front': '...', 'Back': '...'}). The deck and note type (model) must already exist. Returns the new note ID.

Add many notes in one call. Each item is {'deck': str, 'model': str, 'fields': {..}, 'tags': [..]?, 'allow_duplicate': bool?}. Returns a note ID per note (null where a note could not be added, e.g. a duplicate).

Search notes with Anki's query syntax (e.g. 'deck:Default tag:new'). Returns the total count, all matching note IDs, and detailed field data for up to 'limit' notes.

Update one or more fields of an existing note. Only the fields you pass are changed; omitted fields keep their current values.

Permanently delete the given notes (and all their cards). Irreversible.

List every tag used anywhere in the collection.

Add one or more tags to the given notes.

Remove one or more tags from the given notes.

Search cards with Anki's query syntax. Returns the total count, all matching card IDs, and detailed info (deck, note, interval, due, suspended state) for up to 'limit' cards.

Suspend the given cards so they stop appearing in reviews.

Unsuspend the given cards so they return to the review queue.

Store a media file (image/audio) in the collection's media folder so it can be referenced from a note, e.g. '[sound:word.mp3]' or ''. Provide exactly one source: a local 'path', a 'url' to download, or base64 'data_b64'. Returns the stored filename.

Return how many cards have been reviewed so far today.

Sync the local collection with AnkiWeb (so changes reach AnkiDroid / other devices). Requires AnkiWeb login configured in Anki Desktop.