Lifous

Flashcards

The flashcards endpoints of the Lifous API.

A * marks a required field. Path fields go in the address, query fields after a ?, body fields in JSON.

GET/api/v1/flashcards/decks

Your decks

Every deck with how many cards are new, learning and due now.

FieldInTypeMeaning
timezonequeryIANA zoneWhich calendar day "today" is. Your account’s zone when omitted.

MCP tool: list_decks

POST/api/v1/flashcards/decks

Make a deck

A flashcard deck of your own. Names are unique among your decks. Plan limits apply (Free 3, Pro 20, Max unlimited).

FieldInTypeMeaning
name *bodystringUp to 100 characters.
descriptionbodystringUp to 500 characters.
Body
{ "name": "German words", "description": "Everyday vocabulary" }

MCP tool: create_deck

PATCH/api/v1/flashcards/decks/{id}

Rename or set up a deck

Change a deck’s name, description or how many new cards a day it introduces. Only the fields sent change.

FieldInTypeMeaning
id *pathuuidOne of your decks.
namebodystringUp to 100 characters.
descriptionbodystringUp to 500 characters.
newPerDaybodyintegerNew cards a day, 0–999 (20 when a deck is made).
Body
{ "name": "German words (A2)", "newPerDay": 10 }

MCP tool: update_deck

GET/api/v1/flashcards/due

Cards due in a deck

The study queue of one deck: the cards due now, rendered front and back.

FieldInTypeMeaning
deck *queryuuidThe deck.
timezonequeryIANA zoneWhich calendar day "today" is. Your account’s zone when omitted.

MCP tool: due_flashcards

POST/api/v1/flashcards

Add a flashcard

A basic card (front and back) or a cloze (`{{c1::…}}` in the front) in one of your decks. Plan limits apply.

FieldInTypeMeaning
deckId *bodyuuidOne of your decks.
front *bodystringThe question, or the cloze text.
backbodystringThe answer; not used by a cloze.
typebodybasic | clozebasic when omitted.
tagsbodystring[]
Body
{ "deckId": "…", "front": "Capital of Portugal?", "back": "Lisbon" }

MCP tool: add_flashcard

GET/api/v1/flashcards

Cards in a deck

The cards of one of your decks, newest first: id, type, front, back and tags. `query` matches the front, the back or a tag. Use the ids to move or delete cards.

FieldInTypeMeaning
deckId *queryuuidOne of your decks.
queryquerystringWords to match, case aside.
limitqueryinteger1–200; 50 when omitted.
offsetqueryintegerCards to skip; 0 when omitted.
Answer
{ "cards": [{ "id": "…", "type": "basic", "front": "die Abmachung", "back": "agreement", "tags": [] }], "total": 30 }

MCP tool: list_flashcards

POST/api/v1/flashcards/move

Move cards to another deck

Up to 100 of your cards, by id, into one of your decks. Each keeps its schedule and history. Ids that are not yours are skipped; `moved` says how many moved.

FieldInTypeMeaning
ids *bodyuuid[]1–100 card ids from list_flashcards.
deckId *bodyuuidThe deck to move them into.
Body
{ "ids": ["…", "…"], "deckId": "…" }

MCP tool: move_flashcards

DELETE/api/v1/flashcards

Delete cards

Up to 100 of your cards, by id, for good — with their review history. Learning XP already earned stays. Ids that are not yours are skipped.

FieldInTypeMeaning
ids *queryuuid list1–100 card ids, separated by commas.

MCP tool: delete_flashcards