Connecting an agent
If you use an AI tool that supports MCP (Model Context Protocol), such as Claude Code, you can connect it to your MemGym cards. It can then read your cards, write new ones, and practise them with you.
This is separate from MemGym's own AI drafting, which is switched off. The agent is yours, and it works with your cards because you allow it.
The most useful part: the tool you're already talking to about a subject can turn that conversation into cards, and practise them with you later.
Setting it up
Claude Code
Run this once:
claude mcp add --transport http memgym https://memgym.com/api/mcp
The first time it uses MemGym, your browser opens MemGym's approval page.
Other AI tools
MCP is an open standard, so other AI tools that support it, including Claude in the browser, connect the same way. Add MemGym using the address https://memgym.com/api/mcp, and approve it on the same page. Each tool's settings call this something different, such as a connector or an MCP server.
Approving it
If you're not signed in to MemGym, you'll sign in first. The approval page then shows which account you're signed in as, the name of the app asking, and where the access goes. For Claude Code that says "an app on this computer". Any app can give itself any name, so only approve if you recognise where the access is going.
It asks you to approve four things:
- View your deck and collections, including your practice history
- Add cards
- Record practice outcomes
- Organise and retire cards
Tap Approve, and it's connected. There's no key to copy or paste.
What it can do
This is the whole list:
| Tool | What it does |
|---|---|
whoami |
Says which MemGym account it's connected to (your email address) and how many cards you have. Worth asking before it changes anything |
list_deck |
Lists your cards: the question, its context tag, its status (such as due, backlog or retired) and how many times you've practised it. It can list just the due cards or just the backlog |
get_card |
Reads one card in full, including every prediction and score |
list_collections |
Lists your collections and folders |
add_card |
Writes a new card. It goes straight into practice |
record_outcome |
Records one practice rep: your prediction and how it went |
promote_card |
Moves a card from your backlog into practice |
retire_card |
Takes a card out of practice |
It can't delete a card, change your account or clear your history.
It still needs your prediction
Recording a rep takes two numbers: how sure you were before you looked, and how it went. Each is 1, 3 or 5, the same three steps as the buttons in the app: Low, Medium or High before, and Missed, Partial or Nailed after.
An agent can't record a rep without a prediction. So your Progress page means the same thing whether you practised in the app or with an agent.
Only you know how sure you were, so the agent should ask rather than guess. You could tell it: "Ask me the card. Before I answer, ask how sure I am. Then show me the answer, ask how it went, and record both."
How long access lasts
- 7 days. After that, the agent asks you to approve it again.
- All your cards. Access covers every card and its history. You can't limit it to one collection.
- No early cancel yet. To stop an agent sooner, remove MemGym from the agent's own settings. The access still runs out at the end of its 7 days, but the agent stops using it.
- Only with your approval. An agent reaches your cards only after you approve it on that page. It can't sign in to MemGym as you.