Yowes — Canva Education Document Generator

Headless MCP server that generates teacher verification documents — employment letters, teacher ID cards, teaching licenses, payslips, and more — across 13 countries.

Portable, self-contained, and installable anywhere.

---

Table of Contents

• Sample outputs
• Features
• Supported countries
• Requirements
• Installation
• Usage — MCP server
• Legacy GUI
• Project structure
• Adding a new country
• License

---

Sample outputs

Documents are rendered as high-resolution PNGs. Examples generated by this tool:

Teacher ID (US)	Employment letter (US)

Teacher ID (UK)	Employment letter (UK)

---

Features

• Headless MCP server — document generation exposed as agent-callable tools over stdio.
• 13 countries, each with its own document types and local conventions.
• Real school databases with street addresses, districts, and contact info.
• Consistent profile photos per person — hash-based selection from a bundled, gender-aware photo pool.
• Cross-platform fonts — DejaVu Sans bundled; no system-font dependency.
• Packaged & portable — ships as a self-contained wheel (code + photos + fonts) installable with one command.

---

Supported countries

Code	Country	Document types
uk	United Kingdom	employment_letter, teacher_id, teaching_license
us	United States	employment_letter, teacher_id, teaching_license
france	France	installation_statement, iprof_screenshot, bylaws_extract, teaching_certificate
netherlands	Netherlands	employment_contract, teacher_registration, duo_declaration, school_id
indonesia	Indonesia	payslip, teaching_experience_letter, nuptk_card, appointment_letter
australia	Australia	signed_school_letter, school_id, teaching_license
canada	Canada	oct_card, teaching_license, signed_school_letter
spain	Spain	teaching_id, signed_school_letter, employment_contract
argentina	Argentina	payslip, employment_certificate, signed_school_letter
slovakia	Slovakia	payslip, employment_letter, signed_school_letter
mexico	Mexico	teaching_id, signed_school_letter, employment_certificate
philippines	Philippines	teaching_id, employment_certificate, teaching_license
thailand	Thailand	payslip, letter_of_employment

---

Requirements

• Python 3.10+
• Dependencies (installed automatically): Pillow, mcp

---

Installation

From the built wheel

pip install dist/yowes_doc_generator-0.1.0-py3-none-any.whl

From source (editable)

pip install -e .

Via uv

uvx --from . yowes-mcp

---

Usage — MCP server

The server speaks MCP over stdio — the transport used by most agent runtimes (Hermes, Claude Desktop, and any MCP client). Connect it, discover the tools, then call them.

Step 1 — Install & verify