Summary
Connects Claude to your Deckbase instance, letting you pull documentation, template blocks, and project context directly into conversations. You'd reach for this when you want Claude to work with your team's docs and templates without copy-pasting everything manually. The server exposes read access to your Deckbase content, so you can ask Claude to reference specific templates, search through documentation, or understand project context that lives in your Deckbase workspace. Useful if your team already uses Deckbase to organize docs and you want that knowledge available during AI-assisted development work.
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →Tools
Public tool metadata for what this MCP can expose to an agent.
35 tools
list_docsList Markdown files in docs/public/. Only docs in that folder are exposed. Use list_docs to see available filenames, then read_doc to fetch one.
List Markdown files in docs/public/. Only docs in that folder are exposed. Use list_docs to see available filenames, then read_doc to fetch one.
No parameter schema in public metadata yet.
read_docRead a doc from docs/public/ by path. Only docs in that folder are served. Use list_docs first to see available filenames (e.g. MCP.md).1 params
Read a doc from docs/public/ by path. Only docs in that folder are served. Use list_docs first to see available filenames (e.g. MCP.md).
Parameters* required
pathstringDoc path (e.g. MCP.md or deckbase://docs/public/MCP.md). Only files in docs/public/ are served.
list_template_block_typesList all Deckbase template block types (keys, numeric ids, labels, category). Use this so the user can choose multiple block types in order; then pass that list as block_types to create_template. **Quiz blocks:** category `quiz` — keys `quizMultiSelect` (8), `quizSingleSelect`...
List all Deckbase template block types (keys, numeric ids, labels, category). Use this so the user can choose multiple block types in order; then pass that list as block_types to create_template. **Quiz blocks:** category `quiz` — keys `quizMultiSelect` (8), `quizSingleSelect`...
No parameter schema in public metadata yet.
list_block_schemasReturn JSON structure for each block type: typical blocksSnapshot entry, matching value entry, and **configJson** fields. **Quiz types (`quizSingleSelect`, `quizMultiSelect`, `quizTextAnswer`) require a correct `configJson` on the block** (options, correct answer(s), etc.) — r...
Return JSON structure for each block type: typical blocksSnapshot entry, matching value entry, and **configJson** fields. **Quiz types (`quizSingleSelect`, `quizMultiSelect`, `quizTextAnswer`) require a correct `configJson` on the block** (options, correct answer(s), etc.) — r...
No parameter schema in public metadata yet.
list_elevenlabs_voicesList ElevenLabs TTS voice ids (group, label, id, gender, language) from the Deckbase curated catalog for generate_audio_for_card voice_id and template audio block defaultVoiceId. Optional filters: language (ISO 639 code), gender (female|male), search (substring on label/group/...3 params
List ElevenLabs TTS voice ids (group, label, id, gender, language) from the Deckbase curated catalog for generate_audio_for_card voice_id and template audio block defaultVoiceId. Optional filters: language (ISO 639 code), gender (female|male), search (substring on label/group/...
Parameters* required
genderstringOptional: only female or male voices.one of
female · malelanguagestringOptional ISO 639 language code to restrict results (e.g. en, uk, fil, zh, ja). See languageOptions in the response for valid codes.
searchstringOptional case-insensitive substring; matches voice label, language group name, voice id, or language code.
list_ai_image_modelsList allowed AI text-to-image models for generate_image_for_card model_id (id, label, credits) plus defaults. Use this to ask the user to choose a model before generating images.
List allowed AI text-to-image models for generate_image_for_card model_id (id, label, credits) plus defaults. Use this to ask the user to choose a model before generating images.
No parameter schema in public metadata yet.
list_decksList the user's flashcard decks (deckId, title, description, defaultTemplateId, iconEmoji). iconEmoji is optional Unicode emoji for deck list/header; omit/null when unset. Requires hosted MCP with API key. Use with list_templates before create_card.
List the user's flashcard decks (deckId, title, description, defaultTemplateId, iconEmoji). iconEmoji is optional Unicode emoji for deck list/header; omit/null when unset. Requires hosted MCP with API key. Use with list_templates before create_card.
No parameter schema in public metadata yet.
list_templatesList the user's card templates (templateId, name, description). Requires hosted MCP with API key. Use when create_card needs an explicit templateId (deck has no defaultTemplateId). If the list is empty, use create_template first. After the user picks a template, call get_templ...
List the user's card templates (templateId, name, description). Requires hosted MCP with API key. Use when create_card needs an explicit templateId (deck has no defaultTemplateId). If the list is empty, use create_template first. After the user picks a template, call get_templ...
No parameter schema in public metadata yet.
get_template_schemaAfter the user selects a template, returns exact JSON for that template: each blockId, type, label, configJson, category, plus `side` per block (**"front"** = shown first in study; **"back"** = after the learner flips the card), valuesExample, and create_card hints. **Back-sid...2 params
After the user selects a template, returns exact JSON for that template: each blockId, type, label, configJson, category, plus `side` per block (**"front"** = shown first in study; **"back"** = after the learner flips the card), valuesExample, and create_card hints. **Back-sid...
Parameters* required
deckIdstringOptional alternative: use with omitted templateId to resolve defaultTemplateId
templateIdstringFrom list_templates (preferred when user picked a template)
create_deckCreate a new flashcard deck for the user. Requires hosted MCP with API key. Returns deckId and icon fields for create_card. **Deck icon:** There is no Deckbase emoji list to fetch—use any standard Unicode emoji (one grapheme). Unless the user asked for no icon or a specific em...4 params
Create a new flashcard deck for the user. Requires hosted MCP with API key. Returns deckId and icon fields for create_card. **Deck icon:** There is no Deckbase emoji list to fetch—use any standard Unicode emoji (one grapheme). Unless the user asked for no icon or a specific em...
Parameters* required
descriptionstringOptional deck description
iconEmojistringAlias for icon_emoji (camelCase).
icon_emojistringOne emoji for deck list/header (Firestore `icon_emoji`). Prefer inferring from title/description when the user did not specify. Same as iconEmoji.
titlestringDeck title
update_deckUpdate an existing deck’s title, description, default template id, and/or deck icon emoji. Requires hosted MCP with API key. Pass only fields to change. To clear the deck icon, pass icon_emoji or iconEmoji as empty string.6 params
Update an existing deck’s title, description, default template id, and/or deck icon emoji. Requires hosted MCP with API key. Pass only fields to change. To clear the deck icon, pass icon_emoji or iconEmoji as empty string.
Parameters* required
deckIdstringDeck ID from list_decks
default_template_idstringOptional. Template ID for new cards when templateId is omitted in create_card. Empty string clears the default.
descriptionstringNew description (optional)
iconEmojistringOptional alias for icon_emoji (camelCase).
icon_emojistringOptional. Set or change deck list/header emoji (Firestore icon_emoji). Empty string after trim removes the icon. Same as iconEmoji.
titlestringNew title (optional)
update_cardUpdate an existing card’s content. Requires hosted MCP with API key. **Merge:** `front` / `block_text` (only listed blockIds change). **Preview lines:** optional **`main_block_id`** / **`sub_block_id`** (which blocks drive deck list + study preview; ids must exist on this card...34 params
Update an existing card’s content. Requires hosted MCP with API key. **Merge:** `front` / `block_text` (only listed blockIds change). **Preview lines:** optional **`main_block_id`** / **`sub_block_id`** (which blocks drive deck list + study preview; ids must exist on this card...
Parameters* required
appendBlockSidestringone of
front · backappendBlockTypesarrayAlias for append_block_types
appendBlocksarrayAlias for append_blocks
append_block_sidestringWhen appending: set side on all new blocksone of
front · backappend_block_typesarrayOptional: ordered block type keys or numeric ids (see list_template_block_types). Appends new blocks with new blockIds. Mutually exclusive with append_blocks.
append_blocksarrayOptional: full block definitions to append (blockId optional). Mutually exclusive with append_block_types.
audioGenderstringAlias for audio_genderone of
female · maleaudioLanguagestringAlias for audio_language
audio_genderstringWith audio_language when append has audioone of
female · maleaudio_languagestringISO 639 with audio_gender when voice_id omitted and append has audio
blockSidestringAlias for block_sideone of
front · backblock_sidestringStudy face: set on the moved block after placement (optional). With keep_position, flips face without reordering.one of
front · backblock_textobjectOptional map blockId → string merged into values for **only** those keys; other blocks are not modified
blocks_snapshotarrayOptional full replacement for layout (block defs). If set with values, each blockId must have a value entry. Mutually exclusive with append_*.
cardIdstringCard ID
deckIdstringDeck containing the card
frontstringOptional text for the main block only (same role as create_card.front)
insertAfterBlockIdstringAlias for insert_after_block_id
insertBeforeBlockIdstringAlias for insert_before_block_id
insertIndexintegerAlias for insert_index
+14 more parameters. See the server's own documentation for the full schema.
bulk_update_cards**Merge-only** bulk updates (max 50 cards). **Does not add new blocks** — use **bulk_append_blocks** first. **Does not clear fields** — **bulk_remove_card_fields**. **Modes:** (1) **Same patch for every card:** `card_ids` + `front` and/or `block_text` and/or **`main_block_id`...18 params
**Merge-only** bulk updates (max 50 cards). **Does not add new blocks** — use **bulk_append_blocks** first. **Does not clear fields** — **bulk_remove_card_fields**. **Modes:** (1) **Same patch for every card:** `card_ids` + `front` and/or `block_text` and/or **`main_block_id`...
Parameters* required
blockIdstringAlias for block_id
blockIdsarrayAlias for block_ids
block_idstringWith texts[]: apply this single blockId on every card (pair each card with texts[i]). Mutually exclusive with block_ids
block_idsarrayWith texts[]: one block id per card (same length as card_ids and texts). Mutually exclusive with block_id
block_labelstringWith texts[]: resolve block per card by label (trimmed, case-insensitive). Mutually exclusive with block_id/block_ids. Optional semantic_key to disambiguate
block_textobjectOptional: blockId → non-empty string; same patch for every card (same_patch mode only; not with texts[])
block_textsarrayAlias for texts
card_idsarrayCard IDs to update. For same_patch mode: deduped list (max 50). For parallel texts mode: ordered list, same length as texts (no duplicates)
deckIdstringDeck containing all cards
frontstringOptional: non-empty main-block text applied to every card in card_ids (same_patch mode only; not with texts[])
mainBlockIdstringAlias for main_block_id
main_block_idstringSame_patch only: set card main_block_id (preview main text) on every card; must be a blockId on each card’s layout (null clears). Alias: mainBlockId
new_textsarrayAlias for texts
per_cardarrayLegacy: [{ cardId, front?, block_text?, main_block_id?, sub_block_id? }, ...]; max 50
semantic_keystringWith block_label: match configJson.semanticKey / semantic_key on the block (optional)
subBlockIdstringAlias for sub_block_id
sub_block_idstringSame_patch only: set card sub_block_id on every card; must exist on layout (null clears). Alias: subBlockId
textsarrayParallel to card_ids: new non-empty text for block_id (or block_ids[i]). Same length as card_ids. Alias: block_texts, new_texts
bulk_append_blocksInsert **new empty blocks** on many cards (max 50). **Layout-only** — no `front` / `block_text` (use **bulk_update_cards** after). Same block definitions and **insert position** on every card: `append_block_types` or `append_blocks`; **insert_before_block_id**, **insert_after_...22 params
Insert **new empty blocks** on many cards (max 50). **Layout-only** — no `front` / `block_text` (use **bulk_update_cards** after). Same block definitions and **insert position** on every card: `append_block_types` or `append_blocks`; **insert_before_block_id**, **insert_after_...
Parameters* required
appendBlockSidestringone of
front · backappendBlockTypesarrayAlias for append_block_types
appendBlocksarrayAlias for append_blocks
append_block_sidestringSet side on all newly appended blocks (avoids a second move/side call)one of
front · backappend_block_typesarrayOrdered type keys or ids (see list_template_block_types); mutually exclusive with append_blocks
append_blocksarrayFull block defs; mutually exclusive with append_block_types
audioGenderstringone of
female · maleaudioLanguagestringaudio_genderstringone of
female · maleaudio_languagestringcard_idsarrayNon-empty list of card IDs (max 50, deduped)
deckIdstringDeck containing all cards
dryRunbooleandry_runbooleanIf true: no writes; returns appendedBlockIds and card count only
insertAfterBlockIdstringinsertBeforeBlockIdstringinsertIndexintegerinsert_after_block_idstringinsert_before_block_idstringinsert_indexinteger+2 more parameters. See the server's own documentation for the full schema.
bulk_move_blockMove **one existing block** on **many** cards (max 50) or flip its **front/back** face. **Layout-only** — no `front` / `block_text`. Optional **`block_side`** `front`|`back` (applied after move). **`keep_position`:** `true` with **`block_side`** flips face only (no `insert_*`)...16 params
Move **one existing block** on **many** cards (max 50) or flip its **front/back** face. **Layout-only** — no `front` / `block_text`. Optional **`block_side`** `front`|`back` (applied after move). **`keep_position`:** `true` with **`block_side`** flips face only (no `insert_*`)...
Parameters* required
blockSidestringone of
front · backblock_sidestringone of
front · backcard_idsarrayNon-empty list of card IDs (max 50, deduped)
deckIdstringDeck containing all cards
dryRunbooleandry_runbooleaninsertAfterBlockIdstringinsertBeforeBlockIdstringinsertIndexintegerinsert_after_block_idstringinsert_before_block_idstringinsert_indexintegerkeepPositionbooleankeep_positionbooleanmoveBlockIdstringAlias for move_block_id
move_block_idstringBlock to move (must exist on each card)
normalize_cards_to_templateRewrite each card’s layout + values to match the **current template** (block ids, order, side). Migrates content by label+type. Use when template and cards drifted. Optional **card_ids** to subset; **dry_run** to preview without writes. Hosted MCP.6 params
Rewrite each card’s layout + values to match the **current template** (block ids, order, side). Migrates content by label+type. Use when template and cards drifted. Optional **card_ids** to subset; **dry_run** to preview without writes. Hosted MCP.
Parameters* required
card_idsarraydeckIdstringdryRunbooleandry_runbooleantemplateIdstringtemplate_idstringvalidate_deck_layoutNon-destructive report: missing/extra blocks vs template, side/order issues, duplicate label groups across cards. Hosted MCP.3 params
Non-destructive report: missing/extra blocks vs template, side/order issues, duplicate label groups across cards. Hosted MCP.
Parameters* required
deckIdstringtemplateIdstringtemplate_idstringbulk_set_block_sideSet **front**/**back** for one **move_block_id** on many **card_ids** (explicit; same as bulk_move_block + keep_position). Optional **dry_run**. Hosted MCP.8 params
Set **front**/**back** for one **move_block_id** on many **card_ids** (explicit; same as bulk_move_block + keep_position). Optional **dry_run**. Hosted MCP.
Parameters* required
blockSidestringone of
front · backblock_sidestringone of
front · backcard_idsarraydeckIdstringdryRunbooleandry_runbooleanmoveBlockIdstringmove_block_idstringbulk_set_main_sub_blocksSet **main_block_id** and/or **sub_block_id** (deck preview / study sub line) on many cards. **Ids:** pass **main_block_id** / **sub_block_id** (same for every card; null clears). **Labels:** pass **main_block_label** / **sub_block_label** with optional **main_semantic_key** /...16 params
Set **main_block_id** and/or **sub_block_id** (deck preview / study sub line) on many cards. **Ids:** pass **main_block_id** / **sub_block_id** (same for every card; null clears). **Labels:** pass **main_block_label** / **sub_block_label** with optional **main_semantic_key** /...
Parameters* required
card_idsarraydeckIdstringdryRunbooleandry_runbooleanmainBlockIdstringmainBlockLabelstringmainSemanticKeystringmain_block_idstringSame main block for every card (must exist on each layout). Mutually exclusive with main_block_label. Alias: mainBlockId
main_block_labelstringResolve main block per card by label (case-insensitive). Optional main_semantic_key
main_semantic_keystringsubBlockIdstringsubBlockLabelstringsubSemanticKeystringsub_block_idstringSame sub block for every card. Mutually exclusive with sub_block_label. Alias: subBlockId
sub_block_labelstringResolve sub block per card by label. Optional sub_semantic_key
sub_semantic_keystringcopy_template_blocks_to_cardsAppend **copies** of template blocks (new UUIDs per card) via **template_block_ids** or **block_labels**. Supports **insert_***, **append_block_side**, **dry_run**. Hosted MCP.15 params
Append **copies** of template blocks (new UUIDs per card) via **template_block_ids** or **block_labels**. Supports **insert_***, **append_block_side**, **dry_run**. Hosted MCP.
Parameters* required
appendBlockSidestringone of
front · backappend_block_sidestringone of
front · backblockLabelsarrayblock_labelsarraycard_idsarraydeckIdstringdryRunbooleandry_runbooleaninsert_after_block_idstringinsert_before_block_idstringinsert_indexintegertemplateBlockIdsarraytemplateIdstringtemplate_block_idsarraytemplate_idstringremove_card_fieldsClear content for specific blocks on **one** card (text empty; quiz selections cleared; image/audio media cleared). **Separate from update_card** — use this only when the user wants to remove field content, not merge new text. **DESTRUCTIVE** to those fields. Requires hosted M...5 params
Clear content for specific blocks on **one** card (text empty; quiz selections cleared; image/audio media cleared). **Separate from update_card** — use this only when the user wants to remove field content, not merge new text. **DESTRUCTIVE** to those fields. Requires hosted M...
Parameters* required
cardIdstringCard ID
deckIdstringDeck containing the card
removeBlockIdsarrayAlias for remove_block_ids
remove_block_idsarrayNon-empty list of blockIds to clear (alias: removeBlockIds)
user_confirmedbooleanMust be true after explicit user consent to clear these fields
bulk_remove_card_fieldsClear the **same** blockIds on **many** cards in one deck. **Separate from bulk_update_cards** — merge and field removal are not mixed. **DESTRUCTIVE** to content in those blocks. Max 50 cards per request. **user_confirmed** must be true after the user explicitly agrees.5 params
Clear the **same** blockIds on **many** cards in one deck. **Separate from bulk_update_cards** — merge and field removal are not mixed. **DESTRUCTIVE** to content in those blocks. Max 50 cards per request. **user_confirmed** must be true after the user explicitly agrees.
Parameters* required
card_idsarrayNon-empty list of card IDs (max 50, deduped)
deckIdstringDeck containing all cards
removeBlockIdsarrayAlias for remove_block_ids
remove_block_idsarrayBlockIds to clear on every listed card (alias: removeBlockIds)
user_confirmedbooleanMust be true after explicit user consent
delete_cardSoft-delete one flashcard (sets is_deleted; same as app trash). **DESTRUCTIVE.** Requires hosted MCP. **You MUST ask the human for explicit confirmation before calling.** The server refuses unless `user_confirmed` is exactly true — only set it after the user clearly agreed to...3 params
Soft-delete one flashcard (sets is_deleted; same as app trash). **DESTRUCTIVE.** Requires hosted MCP. **You MUST ask the human for explicit confirmation before calling.** The server refuses unless `user_confirmed` is exactly true — only set it after the user clearly agreed to...
Parameters* required
cardIdstringCard ID (from export_deck or list flows)
deckIdstringDeck containing the card
user_confirmedbooleanMust be true. Only after the user explicitly confirmed deletion of this card.
delete_cardsSoft-delete multiple cards in one deck (same rules as delete_card). **Ask the user to confirm the exact card IDs before calling.** Refuses unless user_confirmed is true. Max 50 cards per request. Response lists deleted ids and per-id errors if any fail.3 params
Soft-delete multiple cards in one deck (same rules as delete_card). **Ask the user to confirm the exact card IDs before calling.** Refuses unless user_confirmed is true. Max 50 cards per request. Response lists deleted ids and per-id errors if any fail.
Parameters* required
card_idsarrayNon-empty list of card IDs to delete
deckIdstringDeck containing all listed cards
user_confirmedbooleanMust be true. Only after the user explicitly confirmed bulk deletion.
create_cardCreate a new card from a template’s block layout. Requires hosted MCP with API key. Required: deckId. If templateId is omitted, uses the deck’s default template (defaultTemplateId from list_decks); if the deck has none, pass templateId from list_templates. If no templates exis...8 params
Create a new card from a template’s block layout. Requires hosted MCP with API key. Required: deckId. If templateId is omitted, uses the deck’s default template (defaultTemplateId from list_decks); if the deck has none, pass templateId from list_templates. If no templates exis...
Parameters* required
audio_genderstringRequired with audio_language when voice_id is omitted (same conditions as audio_language).one of
female · maleaudio_languagestringISO 639 language code (e.g. en, uk, fil). Required with audio_gender when voice_id is omitted and generate_audio is true and the template has an audio block.
block_textobjectOptional map blockId → string for text (and similar) blocks. **Include back-face blocks:** use blockIds where the template has side "back" so the card has content after flip.
deckIdstringDeck ID (from list_decks or create_deck)
frontstringOptional text for the template main block only (mainBlockId from get_template_schema). Does not fill other front blocks or back blocks.
generate_audiobooleanOptional. Default true. If true and template includes an audio block, generate ElevenLabs TTS when source text exists. Set false to skip TTS.
templateIdstringOptional. Template ID from list_templates. Omit to use the deck’s default template (set in the dashboard).
voice_idstringElevenLabs voice id from list_elevenlabs_voices. Alternative to audio_language + audio_gender.
create_cardsBulk create cards in one deck using the same template resolution and validation as create_card (deck default or explicit templateId). Requires hosted MCP. Same front/back rules as create_card: use block_text per card for back-side blockIds from get_template_schema. For templat...7 params
Bulk create cards in one deck using the same template resolution and validation as create_card (deck default or explicit templateId). Requires hosted MCP. Same front/back rules as create_card: use block_text per card for back-side blockIds from get_template_schema. For templat...
Parameters* required
audio_genderstringOptional default gender when using audio_language.one of
female · maleaudio_languagestringOptional default ISO 639 code when using language+gender instead of voice_id.
cardsarrayNon-empty array of per-card payloads (front?, block_text?, generate_audio?, voice_id?, audio_language?, audio_gender?). Max 50 items.
deckIdstringgenerate_audiobooleanOptional. Default true. If false, skip ElevenLabs TTS for all cards (each card can still set generate_audio: false when this is true).
templateIdstringOptional; omit to use deck default template
voice_idstringOptional default voice id for all cards (see create_card). Per-card voice_id overrides.
generate_audio_for_cardGenerate ElevenLabs TTS audio and attach it to an existing card’s audio block (updates values.mediaIds). Requires hosted MCP with API key. Required: deckId, cardId. Ask the user for voice settings, then pass voice_id from list_elevenlabs_voices OR pass audio_language (ISO 639)...9 params
Generate ElevenLabs TTS audio and attach it to an existing card’s audio block (updates values.mediaIds). Requires hosted MCP with API key. Required: deckId, cardId. Ask the user for voice settings, then pass voice_id from list_elevenlabs_voices OR pass audio_language (ISO 639)...
Parameters* required
audio_genderstringUse with audio_language when voice_id is omitted.one of
female · maleaudio_languagestringISO 639 code; use with audio_gender when voice_id is omitted.
block_idstringRequired when the card has multiple audio blocks: target audio block blockId
cardIdstringCard ID
deckIdstringDeck containing the card
generate_audiobooleanDefault true. Set false to no-op (for symmetry with create_card)
replace_existingbooleanDefault false. Set true to replace audio when mediaIds already exist
textstringOptional. Spoken text; if omitted, resolved from card content
voice_idstringElevenLabs voice id from list_elevenlabs_voices. Alternative to audio_language + audio_gender.
list_image_subject_promptsList subject starter presets for AI image generation (unified_id, label, prompt, tags) plus the user’s saved subjects from Firestore. Same sources as the web wizard. Subscribers only in production. Pass unified_id values as library_entry_ids on generate_image_for_card (with li...
List subject starter presets for AI image generation (unified_id, label, prompt, tags) plus the user’s saved subjects from Firestore. Same sources as the web wizard. Subscribers only in production. Pass unified_id values as library_entry_ids on generate_image_for_card (with li...
No parameter schema in public metadata yet.
list_image_style_promptsList curated style presets for AI image generation (id, label, description, snippet, tags). Same catalog as the web app. Subscribers only. Optional tag (kebab-case, e.g. vocabulary, anime, physics) filters presets. Use unified_id style:… with generate_image_for_card library_en...1 params
List curated style presets for AI image generation (id, label, description, snippet, tags). Same catalog as the web app. Subscribers only. Optional tag (kebab-case, e.g. vocabulary, anime, physics) filters presets. Use unified_id style:… with generate_image_for_card library_en...
Parameters* required
tagstringOptional. Filter by tag (e.g. stem, watercolor, realistic).
generate_image_for_cardGenerate an AI image (fal.ai) and attach it to an existing card’s image block — **web wizard parity**: optional source_block_ids (default = image block defaultSourceBlockId + card mainBlockId like the dashboard), library_entry_ids (unified subject:… / style:… from list_image_s...15 params
Generate an AI image (fal.ai) and attach it to an existing card’s image block — **web wizard parity**: optional source_block_ids (default = image block defaultSourceBlockId + card mainBlockId like the dashboard), library_entry_ids (unified subject:… / style:… from list_image_s...
Parameters* required
block_idstringRequired when the card has multiple image blocks
cardIdstringCard ID
deckIdstringDeck containing the card
final_promptstringOptional. Exact merged prompt (Review step). When set, overrides block/library merge; style_prompt_id ignored.
library_entry_idsarrayOptional. Unified ids from list_image_subject_prompts (subject:…) and list_image_style_prompts entries as style:{id} (same as web unified catalog).
media_tagsarrayOptional normalized tags stored on the media doc (merged with library preset tags when merge_library_tag_defaults is true).
merge_library_tag_defaultsbooleanDefault true. When false, only media_tags are stored (no tag merge from library_entry_ids).
model_idstringOptional fal text-to-image model id when not using reference (default fal-ai/flux/schnell). Ignored for fal routing when a reference image is set (edit model).
promptstringLegacy: full T2I prompt, or fallback main text when using wizard fields with empty selected text blocks
reference_image_data_urlstringOptional data URL for reference edit (size-limited).
reference_image_urlstringOptional HTTPS URL for reference edit (same constraints as web API).
reference_media_idstringOptional. A mediaId already on this image block (mediaIds or originalMediaIds). Server uses a fresh signed URL for fal edit.
replace_existingbooleanDefault false: append generated image to the block. true: replace existing images with this one
source_block_idsarrayOptional. Text blockIds whose values join with \n\n for the main anchor (wizard step 1). Omit to use template image defaultSourceBlockId + card mainBlockId defaults.
style_prompt_idstringOptional single style preset id (legacy). Merged server-side for simple prompt-only calls; with library_entry_ids, snippet is appended after wizard merge. Not allowed with reference images.
export_deckExport a deck (metadata + cards). Requires hosted MCP with API key. **file_format** (default json): json = full payload in the tool response; csv | xlsx | apkg = small marker JSON for the Deckbase assistant UI to download that file type (ask the user which format they want if...6 params
Export a deck (metadata + cards). Requires hosted MCP with API key. **file_format** (default json): json = full payload in the tool response; csv | xlsx | apkg = small marker JSON for the Deckbase assistant UI to download that file type (ask the user which format they want if...
Parameters* required
deckIdstringDeck ID (from list_decks)
export_typestringOptional when file_format is json. "full" (default): each card includes blocksSnapshot and values. "values_only": values only (smaller). Ignored when file_format is csv, xlsx, or apkg (always full).
fileFormatstringAlias of file_format.
file_formatstringOptional. "json" (default) = return full JSON in the tool result. "csv" | "xlsx" | "apkg" = return a short marker for assistant chat file download (no card payload in the tool text). Aliases: fileF...
formatstringAlias of file_format.
max_cardsnumberOptional max cards to return (default 2000, hard cap 5000). Oldest-first ordering is not guaranteed.
export_cardsExport **only** the given cards in a deck (same per-card JSON shape as **export_deck**, plus `notFound` / `skippedWrongDeck` for bad ids). Use when the user wants a subset file or backup. **file_format** works like **export_deck** (json default; csv/xlsx/apkg only in the web A...7 params
Export **only** the given cards in a deck (same per-card JSON shape as **export_deck**, plus `notFound` / `skippedWrongDeck` for bad ids). Use when the user wants a subset file or backup. **file_format** works like **export_deck** (json default; csv/xlsx/apkg only in the web A...
Parameters* required
cardIdsarrayAlias of card_ids.
card_idsarrayNon-empty list of cardId strings (max 200). Aliases: cardIds.
deckIdstringDeck ID (from list_decks)
export_typestringOptional when file_format is json. "full" (default) or "values_only". Ignored for csv/xlsx/apkg (always full).
fileFormatstringAlias of file_format.
file_formatstringSame as export_deck: json (default), csv, xlsx, apkg; aliases fileFormat, format; excel → xlsx, anki → apkg.
formatstringAlias of file_format.
list_cardsList cards in a deck with **values** and (when export_type is full) **blocksSnapshot** per card — same per-card shape as **export_deck**, without repeating full deck metadata. Use for read/edit flows when you only need card payloads. Requires hosted MCP with API key. Default e...3 params
List cards in a deck with **values** and (when export_type is full) **blocksSnapshot** per card — same per-card shape as **export_deck**, without repeating full deck metadata. Use for read/edit flows when you only need card payloads. Requires hosted MCP with API key. Default e...
Parameters* required
deckIdstringDeck ID (from list_decks)
export_typestringOptional. "full" (default): each card includes blocksSnapshot and values. "values_only": values only (smaller).
max_cardsnumberOptional max cards to return (default 2000, hard cap 5000). Oldest-first ordering is not guaranteed.
create_templateCreate a flashcard template (block layout for new cards). Requires hosted MCP with API key. Call **list_template_block_types** first so the user can pick block types; pass the ordered selection as block_types. **When the user wants quizzes (multiple choice, single choice, or t...9 params
Create a flashcard template (block layout for new cards). Requires hosted MCP with API key. Call **list_template_block_types** first so the user can pick block types; pass the ordered selection as block_types. **When the user wants quizzes (multiple choice, single choice, or t...
Parameters* required
audio_genderstringfemale | male. Use with audio_language when voice_id is omitted (same conditions as create_card).
audio_languagestringISO 639 language code (e.g. en, ja, uk). Use with audio_gender when voice_id is omitted and the layout includes audio without per-block defaultVoiceId. Same as create_card.
block_typesarrayOrdered list of block type keys or numeric ids 0–16. Examples: ["header1", "hiddenText"] for Q&A; ["header1", "quizSingleSelect"] or [0, 9] for stem + single-choice quiz. Quiz keys: quizMultiSelect...
blocksarrayOptional full block definitions. Mutually exclusive with block_types. Each: blockId (optional), type, label, side ("front" | "back"; default front), required (optional), configJson (required for qu...
descriptionstringOptional description
mainBlockIdstringOptional; defaults from first block
namestringTemplate display name
subBlockIdstringOptional; defaults from second block
voice_idstringWhen template includes an audio block without defaultVoiceId on every audio block: ElevenLabs id from list_elevenlabs_voices after the user chooses. Applied to all audio blocks. Alternatively pass...
update_templateUpdate an existing template’s name, description, block layout (blocks or block_types), main/sub block ids, and/or default voice for audio blocks. Set each block’s `side` to "front" or "back". Requires hosted MCP. When adding or changing **quiz** blocks, use **list_block_schema...10 params
Update an existing template’s name, description, block layout (blocks or block_types), main/sub block ids, and/or default voice for audio blocks. Set each block’s `side` to "front" or "back". Requires hosted MCP. When adding or changing **quiz** blocks, use **list_block_schema...
Parameters* required
audio_genderstringfemale | male with audio_language when voice_id is omitted.
audio_languagestringISO 639 code with audio_gender when voice_id is omitted (same as create_template).
block_typesarrayOrdered block types to replace layout; mutually exclusive with non-empty blocks. Include quiz* keys or ids 8–10 when the user wants MCQ/quiz layout; use list_block_schemas for configJson when build...
blocksarrayFull block definitions to replace layout; mutually exclusive with block_types
descriptionstringNew description (optional)
mainBlockIdstringnamestringNew name (optional)
subBlockIdstringtemplateIdstringTemplate ID from list_templates
voice_idstringSets defaultVoiceId on all audio blocks (see create_template). Required if layout has audio without defaultVoiceId unless audio_language + audio_gender are passed instead.
Featured
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →