# flashcards-mcp

An MCP server for making flashcards with your agents and being quizzed on them.
SM-2 spaced repetition. Effect on Durable Object SQLite, deployed with Alchemy.

## Setup

Needs a domain on your Cloudflare account and a Cloudflare Zero Trust
organisation (free up to 50 users).

Create a GitHub OAuth app at <https://github.com/settings/developers> with the
callback URL `https://YOUR-TEAM.cloudflareaccess.com/cdn-cgi/access/callback`,
then write `.env`:

```sh
GITHUB_CLIENT_ID=...
GITHUB_CLIENT_SECRET=...
ACCESS_TEAM=https://YOUR-TEAM.cloudflareaccess.com
```

Set `HOSTNAME` in `src/worker.ts` to your domain, then:

```sh
corepack enable
pnpm install
pnpm deploy
```

`pnpm logs` tails the Worker. `pnpm destroy` removes everything.

## Auth

Cloudflare Access sits in front of the domain; each signed-in email gets its
own deck in its own Durable Object. MCP clients log in via managed OAuth —
enable it on the Access application through the Cloudflare dashboard, and
re-check it after changing that resource, since updates can drop it.

```sh
claude mcp add --transport http flashcards https://YOUR-DOMAIN/mcp
```

## Tools

`add_card` · `list_decks` · `get_due_cards` · `reveal_card` · `grade_card` ·
`edit_card` · `search_cards` · `delete_card` · `card_history` · `stats`

Quiz flow: `get_due_cards` → ask the front → `reveal_card` → `grade_card`
(0–5; below 3 resets the interval).