AlgoApp

Save selected cards in a deck. ## Return Value Returns saved, deck_id, knol_count (verified cards), knol_ids (all attempted IDs, in input order), and per-card results. Only saved=true confirms every card was read back with the requested values. Keep knol_ids for subsequent update_cards calls. If saved=false, inspect those IDs with list_cards before retrying to avoid duplicates. ## Parameters - deck_id: The hex deck ID to add cards into (from create_deck or list_decks). - knols: Array of objects with a values map (keys MUST match deck field names). ## Usage Call this when the user has asked to save/create these cards, including approval in the draft widget or chat. An explicit request to create and save cards can be completed directly through MCP; the widget is optional. Pass the deck_id from create_deck (or list_decks) and only the requested knols. Include values for each field except TTS fields with a source. This adds NEW cards (maximum 100 per call); use update_cards for existing cards to preserve IDs and review history. Retrying can create duplicates. After a successful call, confirm cards were saved and include the https://web.algoapp.ai link. For original audio, call upload_audio first and place its field_value string verbatim in values under a deck field with type "audio". Example values: {"Audio":"<field_value from upload_audio>","Spanish":"¿Dónde está la estación?","Meaning":"Where is the station?","Notes":"Dónde asks about location."}. Use create_deck/update_deck to configure these fields and custom formatting. Bare audio IDs, URLs, and base64 data are not audio field values. Refer to the create_deck tool description for examples of deck configs. Example input: { "deck_id": "<HEX_DECK_ID>", "knols": [ { "values": { "Text": "hola", "Translation": "hello" } } ] }

save_cards

Share an existing AlgoApp deck into a study group the authenticated user belongs to. A new share can send push notifications to existing group members that cannot be recalled.

Invite one or more members to an AlgoApp study group by email. Sends invitation emails that cannot be recalled; repeating a request may resend them.

Cancel the authenticated user's active renewable subscription. Stripe subscriptions are scheduled to stop auto-renewing at the end of the current billing period. Apple subscriptions cannot be canceled here, so the tool returns Apple management instructions instead.

Prepare unsaved draft cards for an existing AlgoApp deck and open the editable card table widget. Does not save cards or modify the deck. Never call this immediately after create_deck in the same request, because create_deck already returns draft cards and opens the widget. Pass the deck_id, the full deck config including config.fields, and the draft card values. Include values for every field except TTS fields with a source, and populate translation fields too. For original audio, call upload_audio first and copy its field_value into a field configured as type audio. When the user explicitly asks to save/create the cards, save_cards can persist them directly through MCP without widget interaction. Otherwise show drafts in the widget or chat for approval before saving. Use update_cards for changes to existing saved cards. Do not call this when the user asks not to create cards.

Create a new AlgoApp deck and draft cards. Use this when the user asks to create a new deck in AlgoApp. For draft cards in an existing deck, use create_cards. This immediately saves an empty private deck; card values remain unsaved drafts until save_cards is called with the user's authorization. Retrying creates another deck. ## Return Value Returns structured data containing deck_id and card_count, and opens the editable draft cards widget. ## Usage In a single call, provide name, full config, and knols to draft. This tool creates the deck and opens the draft cards widget. Do not call create_cards after this in the same request; this tool already provides the draft cards for the widget. When the widget is available, keep chat output brief and let the user review and save selected cards there. When the user explicitly requests creation AND saving, complete save_cards directly using the returned deck_id; no widget interaction is required. Otherwise show the returned drafts in the widget or chat for approval before saving. ## Parameters Refer to input schema for formal definition. At a higher level, a deck has a name and a config, which specifies the "fields" of the deck. New decks default to FSRS when config.settings.reviewMode is omitted or null. To request Classic/grades, set config.settings.reviewMode to {"name":"srs"}. Other explicit choices include {"name":"fsrs"}, {"name":"shuffled"}, and {"name":"in_created_order","skip":0}. An explicit mode and its options, such as FSRS desiredRetention, are preserved. Each field has at least these attributes: - name - type - sides -- This MUST ALWAYS be an array with 2 elements, containing 0's and 1's only. It indicates whether the field shows on the front side and/or the back side. A "1" in the first element means "show on the front side". A "1" in the second element means "show on the back side". NOTE: a deck must *always* have at least one field that shows on the front (e.g. via { ..., "sides": [1, 1] }) and one that shows on the back but not on the front (e.g. { ..., "sides": [0, 1] }). In general, a field that is visible on the front should *also* be visible on the back (i.e. use "sides": [1, 1] rather than "sides": [1, 0]). knols is required. Include values for every field except TTS fields with a source. A TTS field without a source needs a text value. Populate translation fields too so the user can review them before saving. ## Example Deck Configs ### Original Spanish audio with subtitles, meanings, and notes First call upload_audio with the original recording bytes and its MIME type. Use the returned field_value verbatim as knols[].values.Audio. It is native audio markup, not a URL or a TTS prompt. Example config (supports custom CSS and front/back templates): { "fields": [ {"name":"Audio","type":"audio","sides":[1,1]}, {"name":"Spanish","type":"text","sides":[1,1],"attributes":{"lang":"es-ES","fontSizePx":24}}, {"name":"Meaning","type":"text","sides":[0,1],"attributes":{"lang":"en-US"}}, {"name":"Notes","type":"richtext","sides":[0,1]} ], "templates": [ "<div class=\"listening\">{{Audio}}<div class=\"subtitle\">{{Spanish}}</div></div>", "{{FrontSide}}<hr /><div class=\"meaning\">{{Meaning}}</div><div class=\"notes\">{{Notes}}</div>" ], "css": ".subtitle { font-size: 24px; margin-top: 1em; } .notes { font-size: 16px; opacity: .85; }" } Example card values: {"Audio":"<field_value from upload_audio>","Spanish":"¿Dónde está la estación?","Meaning":"Where is the station?","Notes":"Dónde asks about location; está is a form of estar."}. After create_deck, call save_cards with the returned deck_id to persist authorized cards; it returns their IDs for future update_cards calls. ### Language (Japanese) Example Japanese language deck config, with Japanese text on the front with the default furigana setting of "hint" to show the furigana when a user long-presses the flip button, English on the back (auto-translated from the Japanese), and also a TTS field that automatically picks up the contents of the Japanese field from the front and reads it aloud: { "fields": [ { "name": "Japanese", "type": "japanese", "sides": [ 1, 1 ], "attributes": { "furiganaMode": "hint" } }, { "name": "Meaning", "type": "text", "sides": [ 0, 1 ], "attributes": { "lang": "en-US" }, "source": { "type": "translation", "source": { "type": "ref", "name": "Japanese" } } }, { "name": "Japanese-tts", "type": "tts", "sides": [ 1, 1 ], "source": { "type": "ref", "name": "Japanese" } } ], "base": "japanese", "name": "Japanese", "settings": { "reviewMode": { "name": "fsrs" } } } ### Language (General) Example language deck config (Spanish front with TTS, English back auto-translated from that Spanish field (which is named "Text")): { "fields": [ { "name": "Text", "type": "tts", "sides": [ 1, 1 ], "attributes": { "lang": "es-ES" } }, { "name": "Translation", "type": "text", "sides": [ 0, 1 ], "attributes": { "lang": "en-US" }, "source": { "type": "translation", "source": { "type": "ref", "name": "Text" } } } ], "base": "language", "name": "Language" }

Create a persistent empty AlgoApp folder, including a nested folder, without creating or changing any decks or cards. Uses folder_path (up to 512 characters excluding a shared-folder prefix) with :: between levels. Existing folders are returned with created=false and their settings preserved. Returns folder_path, created, and verified; success is reported only after the folder can be read back. Use list_folders first to find existing folders. A path under an existing study-group folder creates shared structure and requires that folder's organization permission; it does not invite members or change permissions. Creating a shared root or sharing a personal folder is not supported here. Archive and study-plan names are reserved. Personal example: {"folder_path":"Languages::Japanese"}. Shared subfolder example: append ::Practice to an exact shared folder_path from list_folders. Use move_decks_to_folder afterward to file existing decks.

Create a new AlgoApp study group for the authenticated user. Providing invite_emails sends invitation emails that cannot be recalled.

Create an AlgoApp support ticket for the authenticated user when they explicitly ask to contact support. Sends the request and account details to support staff and triggers a confirmation email to the account address.

Remove one or more selected decks from the authenticated user's library by exact deck ID. Use list_decks to identify the user's selection; include_archived=true also finds archived decks. Requires an explicit mode and supports up to 100 unique IDs. mode="archive" hides decks from the active library, preserving cards, review history, folder assignments, and sharing. They can be restored in AlgoApp's Archive. mode="permanent" uses AlgoApp's permanent library removal: removes this user's ownership/subscription, folder tags, and incoming direct shares, and dismisses group decks for this user. For owned decks it also removes study-group deck shares and may remove emptied legacy folder shares, affecting group members' access. This is not an archive and cannot be undone through Archive. It does not promise physical erasure of cards, review records, or other users' copies. Use permanent only when the user requests permanent removal. Returns removed_deck_ids containing only IDs whose removal was verified, and one result per requested ID. removed=true means every requested deck reached the requested state. On partial or uncertain results, inspect the errors and list_decks with include_archived=true before retrying. Archive one: {"deck_ids":["0123456789abcdef0123456789abcdef"],"mode":"archive"}. Permanently remove several: {"deck_ids":["0123456789abcdef0123456789abcdef","fedcba9876543210fedcba9876543210"],"mode":"permanent"}.