Card.ai

Add flashcards (question/answer, optional images) to one of the user's decks. Free accounts are limited to 20 flashcards per deck.

add_flashcards

Create a new (empty) deck and return its id. Free accounts are limited to 3 decks.

create_deck

Move one of the user's decks to the trash (soft delete, recoverable in the app).

delete_deck

Permanently delete flashcards from the user's decks. Ids that don't exist or belong to someone else are skipped and reported in failed_ids.

delete_flashcards

List the user's decks with id, name and flashcard count.

list_decks

List images extracted from documents the user uploaded to this deck's AI chat (PDFs, slides). Returns {id, url, page, width, height} — the url can go straight into add_flashcards question_image_url/answer_image_url.

list_document_images

Rename one of the user's decks.

rename_deck

Find, list, count or rank the user's flashcards with ONE PostgreSQL SELECT over a single table, `cards` (only this user's cards; no other table exists). Columns: id, deck_id, deck_name, position (order in its deck), type, question, answer (as stored, HTML), has_image, favorite_color, created_at, created_day, state ('new'|'learning'|'review'|'relearning'), due_at, due_today (review due by the end of today and not answered today), last_review_at, last_review_day, reviews, lapses (answers marked wrong), avg_difficulty (0..1, higher = struggles), mastered (recalled on 3 different days since the last miss), stability (days), hidden. Times are in Brazil's timezone (current_date = the user's today). Use list_decks for deck ids. At most 200 rows; page with LIMIT/OFFSET (`truncated` says more exist); COUNT/GROUP BY to measure. Select only the columns you need. Errors come back as text: fix the query and call again. Examples: SELECT id, question FROM cards WHERE deck_id = '…' ORDER BY position · SELECT deck_name, count(*) FROM cards WHERE due_today GROUP BY 1 · SELECT id, question, lapses FROM cards WHERE lapses >= 3 ORDER BY lapses DESC

search_flashcards

Search the web (Google Images) for images to use on flashcards. Returns {url, thumbnail, title} candidates — pass the chosen `url` to add_flashcards as question_image_url or answer_image_url (CardAi copies it to its storage).

search_images

Study/difficulty report. Without deck_id: account overview (streak, cards studied/created this week, mastery totals). With deck_id: per-card breakdown of that deck — hardest cards first — to help plan what to review.

study_report