MCP server for the FlashCardCreator application, enabling AI-powered flashcard generation, management, and study features through Claude integration
Server has 9 well-named tools with clear verb-noun patterns (generate_cards, add_card, update_card, delete_card, list_sessions, get_session, create_session, rename_session, delete_session). All tools have descriptions (10 - 200 chars, within baseline). Input schemas are present and typed for all tools. However, descriptions lack actionable context (when to use vs similar tools, prerequisites, recovery guidance). Parameter descriptions are minimal, many lack format/constraint details. Output schemas are not documented. Error handling is absent from tool definitions. No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear risk levels (READ_ONLY, WRITE, DESTRUCTIVE). Missing pagination guidance for list_sessions. No confirmation pattern for destructive operations (delete_card, delete_session).
Add one card with content you compose yourself to an existing session.
Create a new, empty session.
Delete a single card from a session.
Delete an entire session and all of its cards.
Generate brand-new flashcards from a topic, pasted text, or an attached document, and save them. Use this for any 'make/create cards about X' request.
Get one session and a slim view of its cards (id, front, truncated back). Use to find a specific card_id before editing or deleting.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear risk levels declared. LLM cannot distinguish safe reads from destructive writes without explicit hints.
Output schemas not documented. LLM cannot plan downstream calls or extract required fields (e.g., card_id from generate_cards, session_id from create_session).
Destructive operations (delete_card, delete_session) lack confirmation or dry-run pattern. Agents cannot preview consequences before irreversible deletion.
list_sessions has no pagination (limit, offset, cursor) or result count. Large session lists will blow context window.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 56 | 2026-07-28+ | v2 |
List all of the user's saved sessions with id, title and card counts.
Rename an existing session.
Update the front and/or back text of an existing card.
Parameter descriptions lack format/constraint details. E.g., 'count' in generate_cards has no min/max bounds; 'card_type' enum is present but not explained in description.