Back to Browse

Mathpack MCP Server

Developer ToolsUse Caution4.7MCP RegistryLocal
Free

Server data from the Official MCP Registry

Printable K-12 math worksheet packs from Mathter: skills list, allowance, and pack generation.

About

Printable K-12 math worksheet packs from Mathter: skills list, allowance, and pack generation.

Security Report

4.7
Use Caution4.7High Risk

mathpack is a small, transparent client for the Mathter service. The API key is sent only as a bearer header to the allowance and generate endpoints, and it is filtered from all returned text. The main concern is that the caller-supplied skill value is placed unsanitized into the output filename, which allows path traversal when writing PDFs, and the MATHTER_BASE_URL override can redirect the bearer key to an arbitrary host. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 2 high severity). Package verification found 1 issue.

8 files analyzed · 8 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

File System Write

Writes or modifies files on your machine. Check that this is expected for the tool.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

MATHTER_API_KEYRequired
MATHTER_BASE_URLRequired
MATHTER_OUT_DIRRequired

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "mathpack": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/mathpack@0.1.0"
      ],
      "env": {
        "MATHTER_API_KEY": "your-mathter-api-key-here",
        "MATHTER_OUT_DIR": "your-mathter-out-dir-here",
        "MATHTER_BASE_URL": "your-mathter-base-url-here"
      }
    }
  }
}

Some servers take additional arguments. See the repository for details.

Documentation

View on GitHub

From the project's GitHub README.

mathpack

Printable math practice for grades K through 12, without opening a browser or wrestling a PDF editor. mathpack talks to the Mathter service and gives you three things: the list of skills that exist right now and the grades each one covers, a straight answer about how many packs your account has left this month, and the pack itself — a PDF written straight into your output folder, ready to print.

The three tools:

  • list_skills — which skills are on offer and which grades each covers. This list is public, so no API key is sent on this call.
  • check_allowance — how many packs the account has left, which plan it is on, and the date the allowance resets.
  • generate_worksheet_pack — build a pack for one skill and grade, with control over theme, style, difficulty, title, worksheet and problem counts, answer keys, cover and lesson pages, worked solutions, single-number focus drills, charts, timed mode, diagrams, blank graphs, unit system, and a seed that reproduces an identical pack. Only skill and grade are required.

Generated files are named mathter-grade-<grade>-<skill>-<YYYY-MM-DD-HHmm>.pdf after the moment they were made, and a name that is already taken gains a -2, -3, … suffix — names never collide, and a finished pack is never overwritten. The tool answers with the absolute path of the file it wrote, and nothing else.

Configuration

export MATHTER_API_KEY="..."     # required for check_allowance and generate_worksheet_pack
export MATHTER_BASE_URL="https://mathter.ca"   # optional override
export MATHTER_OUT_DIR="/path/to/folder"       # optional; defaults to your Downloads folder

The key goes out only as the bearer header of the allowance and generate calls — never to the public skills endpoint, never into a file, and never into an answer: every result and error text is filtered for the key value before it comes back. When a call fails, the answer is a plain sentence about what happened: the key was not accepted, the month's credits are gone, that style is not on the account's plan, Mathter is rate-limiting, the renderer is busy, the configuration was rejected, or the service is unreachable.

CLI

npx @reneturcios/mathpack list_skills
npx @reneturcios/mathpack check_allowance
npx @reneturcios/mathpack generate_worksheet_pack '{"skill":"multiplication","grade":4,"title":"Times tables","chart":"blank"}'
npx @reneturcios/mathpack --version

The generate subcommand prints the absolute path of the PDF it wrote. Exit codes: 0 on success, 1 on a runtime error, 2 on a usage error.

MCP server

npx -y @reneturcios/mathpack mcp

MCP client config:

{
  "mcpServers": {
    "mathpack": {
      "command": "npx",
      "args": ["-y", "@reneturcios/mathpack", "mcp"],
      "env": {
        "MATHTER_API_KEY": "..."
      }
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/mathpack
docker run --rm -e MATHTER_API_KEY="..." ghcr.io/cloudcorprecords/mathpack check_allowance

Development

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch, fake writer, fake clock, no network)
npm run dev     # run the CLI from source

License

MIT — Copyright (c) 2026 Rene Turcios

Reviews

No reviews yet

Be the first to review this server!