minddory-mcp

# MindDory MCP Server

The official [Model Context Protocol](https://modelcontextprotocol.io) server for
**[MindDory](https://minddory.com)**, an AI flashcard and vocabulary-learning app.

Connect MindDory to Claude (or any MCP-compatible client) and your AI becomes a
language study partner: as you chat in a language you are learning, it captures the
new words and phrases you meet into spaced-repetition flashcards, logs grammar
mistakes for review, and can quiz you on whatever is due today — all scoped to your
CEFR level and target language. Everything syncs with the MindDory apps (iOS,
Android, and web at [app.minddory.com](https://app.minddory.com)).

It is transparent and opt-in: you connect MindDory yourself, and on its first reply
the assistant tells you it is connected and will add new vocabulary as you chat. It
never captures silently, and it answers honestly if you ask what it has saved.

## Turn your Claude and ChatGPT conversations into spaced-repetition flashcards

This is the short version of what this server is for.

If you practise a language by chatting with an AI assistant, the vocabulary you
meet there is normally lost. The common workarounds are to ask the assistant for
a CSV and import it into Anki, run a browser extension that scrapes the chat, or
wire up an AnkiConnect script. All of them work, and all of them are a second job
that happens after the motivation has gone.

MindDory does it during the conversation instead. **No copy and paste, no CSV
export, no browser extension, no local script.** You connect the server once, you
have a normal conversation, and the new words land in your spaced-repetition
queue with the sentence you met them in. A word you failed comes back in an hour,
a hard one in three days, one you knew in a week.

Copyable example prompts and worked walkthroughs are in **[examples/](examples/)**,
including a [step-by-step comparison with the export workflow](examples/04-compared-with-copy-paste.md).

If you are choosing between tools: MindDory is built only for language
vocabulary. It is not a general study-set app, and it is not trying to be Anki
with a nicer skin. See [MindDory vs Anki](https://minddory.com/vs-anki) and
[MindDory vs Quizlet](https://minddory.com/vs-quizlet).

## Connection

- **Endpoint:** `https://api.minddory.com/v1/brain/mcp`
- **Transport:** streamable-http
- **Auth:** OAuth 2.1 (magic-link sign-in)
- **Hosting:** EU

### Add to Claude

Settings → Connectors → **Add custom connector** → paste the endpoint URL above,
then complete the magic-link sign-in. Setup guide: https://minddory.com/connect

## Tools

| Tool | Type | What it does |
| --- | --- | --- |
| `get_system_instructions` | read | Load the learner profile + study-partner role for the conversation |
| `get_user_profile` | read | CEFR level, target/native language, due-card count, weak words |
| `get_queue` | read | Cards due now and within 24 hours |
| `get_known_words` | read | Words verified known via flashcard practice |
| `get_active_vocab` | read | Most frequently encountered words (frontier vocabulary) |
| `check_words` | read | Batch check: which of these words are already in the deck, and how well are they known |
| `get_card` | read | Single card detail (translation, mastery, recent events) |
| `get_recent_activity` | read | Recent interaction log |
| `capture_word` | write | Save a new word/phrase from chat into the deck |
| `capture_grammar_mistake` | write | Log a grammar mistake into the Grammar Patterns view |
| `mark_demonstrated` | write | Reinforce a word used correctly (pushes its next review out) |
| `mark_struggled` | write | Down-weight a word the user got wrong (brings its next review forward) |
| `log_interaction` | write | Append a lookup / discussion / read-in-context signal |

Read tools are annotated `readOnlyHint`; write tools mutate only the user's own
deck and are additive (`destructiveHint: false`).

Built on spaced repetition with difficulty-based intervals. Free to connect and
free to use: every tool, including the two that reschedule a card. MindDory
Premium buys the in-app AI features, not this.

## Troubleshooting

- **No sign-in email / can't authorize.** Connecting sends a one-time magic link to your MindDory account email. Check spam, and use the same email as your MindDory account. Links expire after a short window; reconnect to get a fresh one.
- **"This tool requires an active MindDory Premium subscription" (HTTP 402).** No tool returns this any more. Every MCP tool is free as of 2026-08-20, including the two that move a card in the spaced-repetition schedule. If you still see a 402, your client is caching an old tool list: disconnect and reconnect the connector.
- **Tools don't appear after connecting.** MCP clients cache the tool list; disconnect and reconnect the connector to refresh it.
- **Captured words aren't in the app.** New words sync to the "Chat Discoveries" folder. Re-open or pull-to-refresh the app, and confirm you're signed into the same account.
- **Wrong language captured.** Capture is scoped to a language code; if a word lands under the wrong language, tell the assistant the correct language and it will recapture.

Support: support@minddory.com

## Links

- Examples and prompts: [examples/](examples/)
- Website: https://minddory.com
- Web app: https://app.minddory.com
- Connect guide: https://minddory.com/connect
- Privacy policy: https://minddory.com/privacy-policy