Mathter

mathter-mcp

Ask your AI assistant for a math worksheet pack. Get a printable PDF on your computer.

*"Make me a grade 4 times-tables pack for Friday."*

→ mathter-grade-4-multiplication-2026-10-04-1532.pdf in your Downloads folder, answer keys

included. (Cover and lesson pages come with the Standard plan and up.)

This is a small Model Context Protocol server that connects Mathter to Claude Desktop, Claude Code, Cursor, or any other MCP client. It does one thing: it turns a plain-English request into a real worksheet pack from your own Mathter account, saved as a file you can open and print.

You need a Mathter account and an API key. Both are free to start: the free plan makes packs of up to 2 worksheets with answer keys, and paid plans raise the size and add cover and lesson pages.

Setup (about two minutes)

1. Get your key

Sign in at mathter.ca/account, find API access, and create a key. It looks like mk_live_… and is shown once — copy it before you close the page. If you lose it, revoke it and make another; that is normal and costs nothing.

2. Tell your assistant about it

Claude Desktop — open Settings → Developer → Edit Config, and add the mathter entry to the mcpServers section (or merge this block into your config file). If the file already holds other settings such as preferences, mcpServers goes next to them at the top level, not inside them — inside preferences it is silently ignored:

{

"mcpServers": { "mathter": { "command": "npx", "args": ["-y", "mathter-mcp"], "env": { "MATHTER_API_KEY": "mk_live_YOUR_KEY" } } } }

Then fully quit Claude Desktop (right-click its icon in the system tray and choose Quit — closing the window leaves it running) and open it again. (The config file lives at ~/Library/Application Support/Claude/claude_desktop_config.json on macOS and %APPDATA%\Claude\claude_desktop_config.json on Windows, if you would rather edit it directly.)

Claude Code — one command:

claude mcp add mathter --env MATHTER_API_KEY=mk_live_YOUR_KEY -- npx -y mathter-mcp

Cursor, Windsurf and friends — same JSON block as Claude Desktop, in whatever file that app uses for MCP servers. Some editors (Zed, for instance) wrap the entry differently — check their MCP docs for the exact shape; the command, arguments and MATHTER_API_KEY are the same everywhere. The server speaks stdio; there is nothing to host and no port to open.

You do not need to install anything first. npx -y mathter-mcp downloads it from npm on demand, so the first start takes a little longer than later ones. You need Node 18 or newer.

3. Ask for worksheets

"What math skills can Mathter do for grade 3?"

"Make a 5-page grade 3 subtraction pack called Warm-Ups, easy difficulty."

"A blank multiplication chart for grade 4."

"How many Mathter packs do I have left this month?"

"Ten worksheets of grade 6 fractions, hard, with worked solutions."

The assistant replies with the path to the PDF. Open it and print.

What the assistant can do

list_skills

Asks mathter.ca which skills exist right now and which grades each one covers. Your assistant should call this before generating, so it picks a real skill rather than guessing. No key is sent — that list is public.

check_allowance

Tells you how many packs your account has left, which plan it is on, and the date the allowance resets. It uses nothing, so ask any time: "How many Mathter packs do I have left?"

generate_worksheet_pack

Makes the pack. Only skill and grade are required; everything else has a sensible default.

Your logo comes from your Mathter account, not from here — upload it once at mathter.ca and every pack carries it, however the pack was made.

Configuration

Set MATHTER_OUT_DIR if you would rather packs landed in, say, a shared school folder:

"env": {

"MATHTER_API_KEY": "mk_live_YOUR_KEY", "MATHTER_OUT_DIR": "/Users/you/Documents/Worksheets" }

The folder is created if it does not exist. Names never collide: a second pack of the same kind in the same minute becomes …-2.pdf.

Billing, in one paragraph

Packs made here are billed to your Mathter account exactly as if you had made them on the website: same plan, same monthly allowance, same caps on pack size and styles. There is no per-call charge and no separate API plan. Run out of credits and the assistant will tell you so in those words. Plans are at mathter.ca/pricing.

Your key

Your key stays on your machine. This server sends it to one place — the Authorization header of POST https://mathter.ca/api/generate — and nowhere else. It is never sent to the public skills endpoint, never written to a file, and never included in anything the server prints or hands back to the assistant: all output is filtered for key-shaped text first, including error messages that came from the server. That matters because chat transcripts get pasted into emails and bug reports.

If a key is ever exposed anyway, revoke it at mathter.ca/account; revocation takes effect immediately. A key can spend your account's allowance; it cannot change your branding, your password, or your billing, and it cannot create other keys.

When something goes wrong

The server answers in sentences, not status codes. The ones you may meet:

Still stuck? mathter.ca/contact.

For developers

A thin HTTP client over two endpoints, stdio transport. One direct runtime dependency — @modelcontextprotocol/sdk — which brings its own tree, so a real install is around 90 packages, the SDK's HTTP-transport dependencies among them. No telemetry, no analytics, no network calls other than the two documented above. MATHTER_BASE_URL points it at a dev instance.

npm ci           # a lockfile is committed; plain `npm install` may need --legacy-peer-deps

npm test # vitest, against a local stub HTTP server — never the real API npm run typecheck npm run build # tsc -> dist/

The published tarball is dist/, this README and the licence; sources and tests stay in the repository.

MIT licensed. Mathter is at mathter.ca; the API itself is documented at mathter.ca/api.