StudyRiver / Docs / MCP

Printable drills, straight from your AI

Connect StudyRiver MCP to your AI (Claude Code, Claude Desktop, Codex…) and say things like "20 multiplication problems and a maze, one page". Your AI does the coaching; StudyRiver typesets a clean A4 PDF — problems on page 1, answers on page 2. Setup takes about 3 minutes, once.

Easiest: Claude Desktop one-click

Using Claude Desktop? No terminal, no Node.js:

1. Download studyriver.mcpb (~1 MB)
2. Double-click the file → Claude Desktop opens → click Install
3. Pick a folder for your PDFs (default: StudyRiver in your home folder) and enable it

Done — jump to Try it. The sections below are for terminal-based clients.

Terminal setup

Requires Node.js 18+. StudyRiver runs entirely on your machine: no account, no API key, free, nothing leaves your computer.

Claude Code

claude mcp add study-river -- npx -y studyriver-mcp

Claude Desktop (manual)

{
  "mcpServers": {
    "study-river": { "command": "npx", "args": ["-y", "studyriver-mcp"] }
  }
}

Codex

Add to ~/.codex/config.toml:

[mcp_servers.study-river]
command = "npx"
args = ["-y", "studyriver-mcp"]

On Windows use "command": "cmd", "args": ["/c", "npx", "-y", "studyriver-mcp"].

Try it

Show me what drills StudyRiver can make

Make a 15-minute page: times tables plus one logic puzzle. English labels.

I got #3 and #5 wrong yesterday. What's next?

Tip: ask for labels: "en" and the sheet header prints Name / Date / Answers. The content itself — math, logic, mazes — is language-neutral and monochrome, made for home printers.

What it can generate

Category	Content
Math	Addition through long division (vertical forms, carrying/borrowing constraints), decimals, fractions, 100-square grids, integers, expressions and one/two-step equations
Logic	8 puzzle types × 3 levels: grid rules, rotation, odd one out, paper folding, cube nets, block counting, missing piece, symbol math
Words	Picture dictionary (143 words × 10 categories, OpenMoji line art): trace or write — in English or Spanish
Japanese	Hiragana / katakana tracing with romaji hints, kanji tracing (grade 1–6 sets, all 1,026 kanji), vertical-text reading (aloud / copy / comprehension)
Play	Mazes (S/M/L), with solution paths on the answer page

See everything at once in the sample pack (PDF).

Every sheet is deterministic: the same request + seed reproduces the exact same page, so checking answers only means recording which numbers were wrong. Your learning record is a local JSON file that any AI can read.

Web app (no AI needed)

Prefer buttons over conversations? The free web app does the same thing: pick skills, pick minutes, print. No account; records stay on your device.