# Mathter

> Mathter is a freemium MCP server for files and documents. Generate printable K-12 math worksheet packs as PDFs from your AI assistant. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $5 a month
- **Platforms:** CLI, API, self-hosted
- **Website:** https://mathter.ca/api-docs
- **Repository:** https://github.com/gahrons/mathter-mcp
- **MCP Registry name:** ca.mathter/mathter
- **Categories:** files and documents
- **Listing updated:** 2026-11-14

## About

Mathter generates its questions and answer keys in code and checks them against each other, so the server hands back worksheets whose answers are computed, not written by a model. Ask for something like a grade 4 times-tables pack for Friday and the assistant returns a PDF, either as a download link good for 24 hours or saved in a folder you set with MATHTER_OUT_DIR.

Three tools cover the flow. list_skills asks mathter.ca which skills exist and which grades they cover, so the assistant picks a real one; no key is sent for that public list. check_allowance reports packs left, plan and reset date. generate_worksheet_pack needs only a skill and a grade, with options such as difficulty, page count and a title.

It runs over stdio through npx and needs Node 18 or newer plus a Mathter API key created on the account page. Packs are billed to your Mathter plan and credits. The site lists 72 skills from Kindergarten to Grade 12.

## Features

- **Computed answer keys:** Questions and answers are generated by code and cross-checked.
- **Skill discovery:** list_skills returns the current skills and grades before generating.
- **Allowance check:** Shows packs remaining, plan and reset date.
- **PDF delivery:** Returns a 24-hour download link or saves files to a chosen folder.
- **Plan-based options:** Cover pages, lesson pages and unit tests depend on the Mathter plan.

## Good for

- Make a times-tables pack for tomorrow's class
- Build a blank multiplication chart
- Produce a unit test with an answer key
- Check how many packs are left this month

## Install

### Claude Code (Terminal)

```sh
claude mcp add mathter --env MATHTER_API_KEY='<MATHTER_API_KEY>' -- npx -y mathter-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mathter": {
      "command": "npx",
      "args": [
        "-y",
        "mathter-mcp"
      ],
      "env": {
        "MATHTER_API_KEY": "<MATHTER_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mathter": {
      "command": "npx",
      "args": [
        "-y",
        "mathter-mcp"
      ],
      "env": {
        "MATHTER_API_KEY": "<MATHTER_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mathter": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mathter-mcp"
      ],
      "env": {
        "MATHTER_API_KEY": "<MATHTER_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mathter": {
      "command": "npx",
      "args": [
        "-y",
        "mathter-mcp"
      ],
      "env": {
        "MATHTER_API_KEY": "<MATHTER_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mathter": {
      "command": "npx",
      "args": [
        "-y",
        "mathter-mcp"
      ],
      "env": {
        "MATHTER_API_KEY": "<MATHTER_API_KEY>"
      }
    }
  }
}
```

## Tools

- `list_skills`: Lists the skills Mathter offers and the grades each covers.
- `check_allowance`: Shows packs left, plan and reset date.
- `generate_worksheet_pack`: Generates a worksheet pack PDF for a skill and grade.

## FAQ

### What do I need to run it?

Node 18 or newer and a Mathter API key from your account page.

### What does it cost?

Basic is $0 with 2 credits a month; Standard is $5 a month with 50 credits; Premium is $15 a month with 150 credits.

### What is a credit?

One credit is one pack or one unit test, not one worksheet.

### Where does the PDF go?

It comes back as a link valid for 24 hours, or is saved to MATHTER_OUT_DIR if set.

### Is Mathter free?

Mathter has a free plan, with paid plans for more usage or features. Paid plans start at $5 a month.

### How do I add Mathter to Claude Code?

Run this command in your terminal: claude mcp add mathter --env MATHTER_API_KEY='<MATHTER_API_KEY>' -- npx -y mathter-mcp

### What are the best alternatives to Mathter?

The closest alternatives to Mathter are ASTra, CARTESIAN ECU, Invoices, SigPen and ConvertAudioToText.

## Alternatives

- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.
- [SigPen](https://ai-powered.com/mcp/sigpen): SigPen is a freemium MCP server for files and documents.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [WhoScribe](https://ai-powered.com/mcp/whoscribe): WhoScribe is a freemium MCP server for design and media.
- [filex](https://ai-powered.com/mcp/filex): filex is an open-source MCP server for files and documents.
- [DocJacket](https://ai-powered.com/mcp/docjacket): DocJacket is a freemium MCP server for productivity.

---
Source: https://ai-powered.com/mcp/mathter
