flashlearn-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| FLASHLEARN_API_KEY | Yes | API key from the developer dashboard. Sent as Authorization: Bearer. Never logged, never echoed in tool output. | |
| FLASHLEARN_API_BASE | No | API base URL. The default is the production URL from the FlashLearnAI OpenAPI spec; override it for a local or staging instance. | https://flashlearnai.witus.online |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| pingA | Check that the FlashLearn MCP server is alive and see how it is configured (API base URL and whether an API key is set). Makes no API call. |
| list_setsA | List the flashcard sets owned by the configured API key, newest first. Returns id, title, a short description, and card count per set, plus pagination. |
| get_setA | Fetch one flashcard set with all of its cards (front and back text). Works for sets owned by the key and for public sets. |
| get_usageA | Show the current billing-period usage and limits for the configured API key: API calls, AI generation calls, overage calls, and the tier limits. |
| generate_cardsA | Generate a flashcard deck about a topic using FlashLearnAI. If a public deck for the topic already exists it is reused (source: "shared") and no generation quota is spent; otherwise a new deck is created (source: "generated"). Counts against the monthly generation quota when it generates. |
| create_study_sessionA | Start a spaced-repetition study session for a set. Returns a sessionId and the shuffled cards to quiz the user with. Finish with submit_review to record results and update SM-2 scheduling. |
| submit_reviewA | Complete a study session by submitting one result per reviewed card. Updates the SM-2 spaced-repetition schedule and returns accuracy and duration stats. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| getting-started | How the FlashLearn tools fit together and the typical study loop. |
| openapi | The live OpenAPI specification of the underlying FlashLearnAI public API. |
TDQS
Scored across 7 tools
Each tool serves a distinct purpose: health check, listing sets, retrieving a set, usage info, generating cards, creating a study session, and submitting reviews. There is no functional overlap between any tools.
All tool names follow a clear verb_noun snake_case pattern (list_sets, get_set, get_usage, generate_cards, create_study_session, submit_review). Even 'ping' fits the imperative verb style, so the naming is fully consistent.
Seven tools is well-scoped for a flashcard MCP server. Each tool covers a necessary part of the workflow: discovery, content generation, retrieval, usage monitoring, and study session management, without bloat or missing essentials.
The core workflows are covered: listing, retrieving, generating, and studying sets, plus session creation and completion. The only minor gap is the lack of explicit update/delete operations for flashcard sets, which is a reasonable omission given the server's study-focused purpose.