# PaperLesson (paperlesson.com) — Full Agent & LLM Reference Specification

> True-vector K-12 math drills, Zaner-Bloser handwriting paper & classroom printable PDF generator.

## Overview
PaperLesson generates razor-sharp, true-vector printable PDF worksheets for K-12 classrooms, homeschooling parents, and occupational therapy handwriting practice.

Unlike blurry bitmap screenshot generators, PaperLesson renders crisp vector paths on US Letter and A4 sheets with exact primary Zaner-Bloser / D’Nealian ruled line heights, seeded reproducible math drills with answer keys, and classroom roster batching.

Accessible free in the browser and via MCP and OpenAPI curriculum helpers.

## Official Endpoints & Agent Discovery
- Canonical Website: https://paperlesson.com
- Streamable HTTP MCP Endpoint (JSON-RPC 2.0, No Auth Required): https://paperlesson.com/api/mcp
- Public REST v1 Health & Auth Probe: https://paperlesson.com/api/v1/me
- OpenAPI 3.0.3 Specification: https://paperlesson.com/openapi.json
- Official MCP Registry ID: `com.paperlesson/mcp`
- Google Preferred Source Link: https://www.google.com/preferences/source?q=paperlesson.com

## Verified Official Brand Profiles (Entity Stack)
- https://glama.ai/mcp/connectors/com.paperlesson/mcp
- https://www.mcptry.com/servers/com.paperlesson/mcp
- https://telegra.ph/Why-True-Vector-PDFs-Matter-for-K-12-Math-Drills--Primary-Handwriting-Lines-11-10

## Deterministic Read-Only Tools (8 Tools)
### 1. `generate_seeded_math_drill_set` — Deterministic Seeded K-12 Math Drill & Answer Key Generator
- Description: Generate a reproducible set of K-12 arithmetic, fraction, or order-of-operations practice problems with exact answer keys using deterministic mulberry32 PRNG.
- REST Endpoint: `POST https://paperlesson.com/api/v1/tools/generate_seeded_math_drill_set`
- Input Schema: `{"type":"object","properties":{"topic":{"type":"string","enum":["addition","multiplication","dividing_fractions","rounding","pemdas"],"description":"Math skill topic"},"count":{"type":"integer","description":"Number of problems (5-20)","default":10},"seed":{"type":"integer","description":"Classroom variant seed integer","default":101}},"required":["topic"]}`
### 2. `lookup_handwriting_ruling_specs` — Zaner-Bloser & D’Nealian Grade-Level Handwriting Line Height Specs
- Description: Look up exact physical millimeter and PostScript point (72 pt/inch) baseline, midline (x-height), and descender spacing for Pre-K through Grade 5 handwriting paper.
- REST Endpoint: `POST https://paperlesson.com/api/v1/tools/lookup_handwriting_ruling_specs`
- Input Schema: `{"type":"object","properties":{"gradeLevel":{"type":"string","enum":["Pre-K","Kindergarten","Grade 1","Grade 2","Grade 3","Grade 4-5"],"description":"Student grade level"}},"required":["gradeLevel"]}`
### 3. `build_name_tracing_worksheet_config` — Custom Student Name & Classroom Roster Tracing Configurator
- Description: Configure custom student name tracing repetition rows, progressive fade-out scaffolding (solid guide -> dashed trace -> independent baseline), and paper orientation.
- REST Endpoint: `POST https://paperlesson.com/api/v1/tools/build_name_tracing_worksheet_config`
- Input Schema: `{"type":"object","properties":{"studentName":{"type":"string","description":"Student full or first name"},"style":{"type":"string","enum":["manuscript_print","cursive"],"default":"manuscript_print","description":"Letterform handwriting style (\"manuscript_print\" or \"cursive\")"}},"required":["studentName"]}`
### 4. `lookup_cursive_stroke_group_progression` — Cursive Handwriting Pedagogical Stroke Family Sequence
- Description: Retrieve the optimal stroke-family teaching order for cursive lowercase and uppercase letters (undercurve, downcurve, overcurve, slant connectors) rather than alphabetical order.
- REST Endpoint: `POST https://paperlesson.com/api/v1/tools/lookup_cursive_stroke_group_progression`
- Input Schema: `{"type":"object","properties":{"caseType":{"type":"string","enum":["lowercase","uppercase"],"default":"lowercase","description":"Letter case group (\"lowercase\" or \"uppercase\")"}}}`
### 5. `generate_fraction_number_line_coordinates` — Fractions on a Number Line Tick & Partition Calculator
- Description: Compute exact vector tick coordinates and benchmark labels for teaching proper fractions, improper fractions, and equivalent fractions on a 0-to-1 or 0-to-2 number line.
- REST Endpoint: `POST https://paperlesson.com/api/v1/tools/generate_fraction_number_line_coordinates`
- Input Schema: `{"type":"object","properties":{"denominator":{"type":"integer","description":"Fraction denominator (2, 3, 4, 5, 6, 8, 10, 12)"}},"required":["denominator"]}`
### 6. `explain_order_of_operations_step_tree` — PEMDAS / BODMAS Order of Operations Step-by-Step Evaluator
- Description: Break down multi-step arithmetic expressions with parentheses, exponents, multiplication/division, and addition/subtraction for Grade 5-6 worksheet answer keys.
- REST Endpoint: `POST https://paperlesson.com/api/v1/tools/explain_order_of_operations_step_tree`
- Input Schema: `{"type":"object","properties":{"difficulty":{"type":"string","enum":["grade5_no_exponents","grade6_with_exponents"],"default":"grade5_no_exponents","description":"Curriculum complexity tier (Grade 5 parentheses only vs Grade 6 with exponents)"}}}`
### 7. `calculate_us_letter_vs_a4_printable_margins` — US Letter vs ISO A4 Vector Printable Safe-Margin Calculator
- Description: Calculate exact PostScript vector coordinates (pt) and safe classroom printer margins (0.5 in / 12.7 mm) to prevent edge clipping across US Letter and ISO A4.
- REST Endpoint: `POST https://paperlesson.com/api/v1/tools/calculate_us_letter_vs_a4_printable_margins`
- Input Schema: `{"type":"object","properties":{"paperSize":{"type":"string","enum":["US_LETTER","ISO_A4"],"default":"US_LETTER","description":"Physical paper standard (\"US_LETTER\" 8.5x11 in or \"ISO_A4\" 210x297 mm)"}}}`
### 8. `list_paperlesson_printable_generators` — PaperLesson K-12 Printable Worksheet Generator Directory
- Description: List all free true-vector PDF worksheet generators on PaperLesson with direct pre-configured landing URLs.
- REST Endpoint: `POST https://paperlesson.com/api/v1/tools/list_paperlesson_printable_generators`
- Input Schema: `{"type":"object","properties":{"subject":{"type":"string","enum":["all","handwriting","math"],"default":"all","description":"Curriculum subject filter (\"all\", \"handwriting\", or \"math\")"}}}`