The server exposes a focused set of high-level tools. Each one wraps a REST endpoint and inherits its validation, limits, and error behavior.
Card content is keyed by each deck field's key, so an assistant should call get_deck (or read the response of create_deck) to learn the keys before calling add_cards or update_cards.
Decks
| Tool | Description |
|---|
list_decks | List your decks, most recent first, with their due cards counts. |
get_deck | Retrieve a deck with its fields and its card layouts. |
create_deck | Create a deck, optionally with its fields and their AI Autofill. |
copy_deck | Copy a deck with its fields, layouts, and cards. |
update_deck | Rename a deck or change its study settings. |
pause_deck | Pause the study of a deck. |
unpause_deck | Resume the study of a paused deck. |
schedule_deck_cards | Schedule the deck's next batch of new cards for review now. |
get_deck_progress | The latest deck progress snapshot. |
list_deck_progress | The deck progress history over a date window. |
Deck fields
| Tool | Description |
|---|
add_deck_fields | Add fields to an existing deck. |
update_deck_field | Rename a field or change its AI Autofill configuration. |
generate_deck_field_values | Generate a field's value on every card with AI Autofill. |
delete_deck_field | Delete a field and its content on every card. |
Card layouts
| Tool | Description |
|---|
create_card_layout | Create a card layout, e.g. to test another direction of the same cards. |
update_card_layout | Set a card layout's review prompt, whether it is active, and whether it is primary. |
delete_card_layout | Delete a card layout and its variants' learning progress. |
edit_card_layout_fields | Add, restyle, move, or remove a layout's layout fields in a single call. |
Cards
| Tool | Description |
|---|
add_cards | Create up to 100 cards in a deck, with optional AI Autofill. |
list_cards | List cards, optionally filtered to a single deck. |
get_card | Retrieve a card with its card variants (scheduling state). |
update_cards | Update the content of one or more cards in a single call. |
delete_cards | Delete one or more cards and their review history. |
Scheduling
| Tool | Description |
|---|
list_card_variants | List card variants, filterable by deck, card, stage, or difficulty. |
update_card_scheduling | Apply a scheduling action to a variant: schedule, snooze, suspend, or unsuspend. |
list_card_reviews | List the review history, filterable by deck, card, or variant. |
Errors
Tool calls surface the same error object as the REST API. When a call fails, the assistant receives its message, code, and param, so it can explain what went wrong and how to fix it.