Make printable math worksheets with an answer key for a student or a whole class.
Scored across 1 tool
There is only one tool, so there is no possibility of misselection or overlapping purpose. An agent always knows exactly which tool to call for any worksheet-generation request.
The single tool uses a clear snake_case verb_noun pattern (generate_math_worksheet) that names both the action and the artifact. There are no competing conventions to conflict with it.
The tool is exceptionally feature-rich (grade, digit count, operation, regrouping, fractions, answer key, seeded PDF) and covers the entire stated domain in one call. However, a one-tool surface is thin by the rubric's standard and leaves no room for related operations like listing or regenerating prior worksheets.
Core arithmetic worksheet generation is thoroughly covered, including answer keys and reproducible PDFs. But the description explicitly excludes word problems, geometry, money, time, algebra, and grading completed sheets, which are natural parts of a K-6 math worksheet domain, leaving notable gaps an agent will hit.
Use this when the user wants printable math worksheets ("math worksheets grade 2", "multiplication worksheets", "times tables worksheet", "subtraction worksheet no regrouping", "long division worksheet", "missing number worksheet", "fraction worksheet", "math worksheet with answer key"). If the user pastes or uploads their own problems (text or an image), first convert them into the problems list, one string per problem like "45 - 18", then call. Generates a seeded, reproducible PDF for Letter or A4 with Name, Date and Score lines, problems in column form or on one line, and an answer key on separate pages; answers are computed with whole-number and fraction arithmetic and no problem repeats. Rules: grade K-6, digits like 2 or "3x1", within, min/max numbers, a times table, regrouping none/required, no negative answers, same or different denominators. Returns the problem list with answers, the set number and a PDF link. Does not write word problems, does not grade a child's completed sheet, and does not cover geometry, money, time or algebra.
| Name | Required | Description | Default |
|---|---|---|---|
| seed | No | Set number from an earlier result to print exactly the same problems again, e.g. 48213. Default: a new random set. | |
| count | No | Problems per worksheet, 1 to 100. Default 20 (12 for long division). Example: 30 | |
| grade | No | School grade K to 6 that sets sensible number sizes, e.g. 2 or "3rd grade" or "K". UK "Year 3" is read as grade 2. | |
| paper | No | Paper size: letter (default) or a4. | |
| table | No | Times table or fact family to focus on: one number or a list, e.g. 7 or "6, 7, 8" or [3, 4]. For division it is the divisor. | |
| title | No | Title printed at the top, e.g. "Emma's Subtraction Practice". Default: a title from the rules. | |
| digits | No | Digits per number: 2 for 2-digit numbers, or "3x1" for 3-digit by 1-digit (multiplication and long division). Example: "2". | |
| layout | No | vertical (stacked column form, default; division uses the long-division bracket) or horizontal (on one line). | |
| within | No | Keep addition sums and subtraction starting numbers at or below this, e.g. 20 for "addition within 20". | |
| problems | No | Your own problems instead of generated ones: a list like ["12 + 7", "45 - 18", "6 x 7", "84 ÷ 4", "3/4 + 1/8", "7 + ? = 12"] or [{"a":12,"op":"+","b":7}], or pasted text with one problem per line. Up to 100. The tool computes every answer. | |
| versions | No | Number of different worksheets with the same rules (each with its own answer key), 1 to 10. Default 1. | |
| name_line | No | Print Name, Date and Score lines. Default true. | |
| operation | No | What to practise: addition, subtraction, multiplication (times tables), division, division with remainders, mixed (all four), "addition and subtraction", missing number, or fractions (adding fractions, subtracting fractions, multiplying fractions). Example: "subtraction". Default: from the grade, else addition. | |
| answer_key | No | Add answer key pages at the end of the PDF. Default true. | |
| max_number | No | Largest number to use in the problems, e.g. 12 for times tables up to 12. | |
| min_number | No | Smallest number to use in the problems (factors for multiplication, divisor and answer for division facts), e.g. 2. | |
| regrouping | No | Carrying/borrowing rule for addition, subtraction and 1-digit multiplication: none (no regrouping), required (every problem regroups) or any (default). Example: "none" | |
| denominators | No | Fractions only: like (same denominator), unlike or any. Default like up to grade 4, unlike from grade 5. | |
| allow_repeats | No | When the rules allow fewer different problems than count, repeat some to reach count. Default false (the worksheet is shortened instead). | |
| allow_negative | No | Allow subtraction answers below zero. Default false (no negative answers). | |
| missing_number | No | true for fill-in-the-blank problems like 7 + ? = 12. Default false. | |
| max_denominator | No | Fractions only: largest denominator, 2 to 20. Default 12 (8 up to grade 3). |
| Name | Required | Description |
|---|---|---|
| kind | Yes | |
| seed | Yes | |
| count | Yes | |
| notes | Yes | |
| paper | Yes | |
| rules | Yes | |
| title | Yes | |
| inputs | Yes | |
| layout | Yes | |
| columns | Yes | |
| problems | Yes | |
| versions | Yes | |
| downloads | Yes | |
| key_pages | Yes | |
| name_line | Yes | |
| answer_key | Yes | |
| page_count | Yes | |
| instructions | Yes | |
| rows_per_page | Yes | |
| problems_count | No | |
| requested_count | Yes | |
| worksheet_pages | Yes |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare read-only, idempotent, non-destructive, closed-world behavior, and the description adds substantial behavioral context: seeded reproducibility, Letter/A4 output, column vs. inline layout, answer key pages, whole-number/fraction answer computation, no repeats, and the returned problem list, set number, and PDF link. Nothing contradicts the annotations.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is front-loaded with usage and then moves through generation behavior, parameter rules, returns, and exclusions. It is long but mostly justified by a 22-parameter tool; the parenthetical example lists are valuable for intent matching, though slightly dense.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the 22 optional parameters, complete schema descriptions, output schema, and annotations, the description covers purpose, input handling, output format, behavioral constraints, and exclusions. An agent has enough to decide when to call it and how to prepare inputs without needing more.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is already 100%, so the schema carries most parameter definitions. The description adds useful intent-level semantics: how to convert pasted or uploaded problems into the problems list, how grade/digits/within/regrouping/denominators map to worksheet rules, and how missing-number and negative-answer options behave.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description opens with a specific verb and resource ('generate printable math worksheets') and spells out the output: a seeded, reproducible PDF with Name/Date/Score lines, column or inline layout, and answer key pages. It also distinguishes the tool from out-of-scope requests like word problems, grading completed sheets, geometry, money, time, and algebra.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It explicitly states 'Use this when the user wants printable math worksheets' and lists many matching user phrases, then gives an important precondition for pasted or uploaded problems. The closing sentence lists what the tool does not do, which is a clear when-not guide; no sibling tools exist to route between.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
generate_math_worksheetFree Pre-K to 5th grade math worksheets, worksheet makers, quizzes, teaching tools and curricula.
Find free math worksheets (Pre-Algebra–Calculus, Statistics) as printable PDFs with answer keys.
Make printable math cage puzzles for teachers, students and puzzle fans as a PDF with an answer key.
Verified maths exercises for tutors and their students, each answer key right by construction.
Add one secure layer between your agents and this server.