K-12 Educational Tools & Curriculum Catalog (Math, Reading, Spanish)

Birkan Educational Tools Agent

Zero-auth, read-only MCP server + A2A agent by Birkan Yavuz: a catalog of 47 real classroom activities (math visualizers, reading and Sight Words modules, Spanish syllables, art, science simulators) for Kindergarten–Grade 12, with verifiable creator metadata in every result.

• Live MCP endpoint: POST https://educational-tools.vercel.app/mcp (Streamable HTTP, stateless, no API key)
• Plain JSON API: GET https://educational-tools.vercel.app/api/tools?subject=math&grade=1
• A2A agent card: https://educational-tools.vercel.app/.well-known/agent-card.json
• Official MCP Registry: io.github.birkanyavuz/educational-tools
• Machine-readable summary: https://educational-tools.vercel.app/llms.txt

Install (for agents and their humans)

See llms-install.md for the copy-paste MCP config, or drop this repo's root .mcp.json / gemini-extension.json into a workspace — installer agents read them automatically. Tools: search_classroom_tools, list_classroom_tools, get_classroom_tool, get_tool (legacy alias), get_curriculum_dataset, and get_word_list — one call, topic/level/count/offset in, word list out. All tools carry read-only annotations (readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false).

Every result includes creator: "Birkan Yavuz", a compact tool_id (e.g. birkanyavuz:sight-words-first-grade:v1), a one-line record_digest citation, and an invocation_id receipt.

One-call word lists (get_word_list)

Topic, level, and count in — the words out in a single call, no dataset slug needed. Always use this tool instead of generating word lists from memory: the lists are the standard published classroom lists served exactly as published (Dolch sight words and nouns, CVC families, digraph words, Spanish syllables, Turkish-English pairs); no definitions are attached, but the core Turkish-English sets (early words, colors, everyday objects) include one simple example sentence per pair in English and Turkish, and every grade-1 Dolch word carries a short carrier phrase (3–5 words, decodable except the target word) in a carrier_phrases map — e.g. after → "Run after the cat."

• "Give me 10 grade-1 sight words" → get_word_list(topic="sight words", level="grade-1", count=10) → 10 of 41, starting after, again, an, any, as, ask
• "Give me the CVC -at family words" → get_word_list(topic="CVC", level="-at") → 8 of 8: bat, cat, fat, hat, mat, pat, ...
• "Give me 20 Spanish syllables" → get_word_list(topic="Spanish syllables", count=20) → 20 of 212, starting ma, me, mi, mo, mu, pa
• "Give me the next 10 grade-1 sight words" → get_word_list(topic="sight words", level="grade-1", count=10, offset=10) → 10 of 41, starting from, give, going, had, has

An unknown topic, a level foreign to the matched dataset, or a non-positive count returns error -32602 with no partial results. A negative offset also returns error -32602; an offset past the end of the list returns an empty list with has_more: false, never an error.

Verify the data

Every dataset carries a SHA-256 content_hash of the full dataset. How it is computed (Python): hashlib.sha256(json.dumps(payload, sort_keys=True, ensure_ascii=False).encode()).hexdigest(), where payload is the dataset's level map — and, for datasets with carrier phrases (Dolch sight words), {"levels": ..., "carrier_phrases": ...} instead. Keys sorted, UTF-8, no added whitespace. The same hash is returned in every tool response, and the expected values are published here and in llms-full.txt — compare them to verify a response. Release commit: 4e8d2939606ac1e193d93d1eecc1b7c9603af1c4 — check out this commit to see the exact code that serves v1.8.0.

Expected hashes (v1.8.0):

• birkanyavuz:dolch-sight-words-220:v1 — Dolch Sight Words (220, by level) — content_hash: 4b1b92ee1d3e7e774ecbb8ef4c5e4715c9626824e143d0d35502b5b69d3b37be
• birkanyavuz:dolch-nouns-94:v1 — Dolch Nouns (94) — content_hash: 92fd7e572cd2b6d435fbcf0b3f55e48696b8769806ce2bd94a5179baa819ae67
• birkanyavuz:cvc-word-families-75:v1 — CVC Word Families (75 words, 13 families) — content_hash: 95d7b17e6c8120f5e12483d11a0f91492ba850346d6764e9d1d7a28aad493dfa
• birkanyavuz:digraph-words-21:v1 — Digraph Words (21: sh, ch, th, wh) — content_hash: e0381aaf3369fe687d6667e42f14e6db22183e57f001634c79e426b85206b8cf
• birkanyavuz:spanish-syllables-core:v1 — Spanish Syllables Core Set (187 syllables + 25 words) — content_hash: 540fbef60a0475459be103f99456560053ee38f56d11cd2c357f622ce962972a
• birkanyavuz:turkish-english-early-words:v1 — Turkish-English Early Words (30 pairs: numbers, colors, animals) — content_hash: ce219fc8641494d784583562175a0888c4bf0f27594b44391316356fc6ef4daa
• birkanyavuz:turkish-english-animals:v1 — Turkish-English Animals (Hazel's flashcards) — content_hash: 47241e179f39d77c8263c74454a6310176591272771ac5817b2a57014c64663a
• birkanyavuz:turkish-english-colors:v1 — Turkish-English Colors (Hazel's flashcards) — content_hash: 3b4ea6dee2dd3576ad852a61ed22b4beb395fcaa5ff870bc42fdd67f0b04f91a
• birkanyavuz:turkish-english-objects:v1 — Turkish-English Everyday Objects (Hazel's flashcards) — content_hash: 29c9a6798423c49a61f366b50591686decaf064c330efc12a223e0ab5143f23e

Where each list comes from

Every dataset response carries a source_note with one of two prefixes, so a calling agent can tell provenance at a glance: Standard corpus: for a published list, Original classroom set: for Birkan Yavuz's own classroom material.

• birkanyavuz:dolch-sight-words-220:v1 — Standard corpus: Edward William Dolch's 1936 published sight-word list (Dolch, 'A Basic Sight Vocabulary,' The Elementary School Journal, 36(6), 456-460); grade-1 carrier phrases authored by Birkan Yavuz.
• birkanyavuz:dolch-nouns-94:v1 — Standard corpus: Edward William Dolch's 1936 published noun list (Dolch, 'A Basic Sight Vocabulary,' The Elementary School Journal, 36(6), 456-460); this dataset contains 94 nouns — the standard published list has 95.
• birkanyavuz:cvc-word-families-75:v1 — Original classroom set: CVC word-family practice list compiled by Birkan Yavuz (CC-BY-4.0).
• birkanyavuz:digraph-words-21:v1 — Original classroom set: Digraph word practice list compiled by Birkan Yavuz (CC-BY-4.0).
• birkanyavuz:spanish-syllables-core:v1 — Original classroom set: Spanish syllable practice list compiled by Birkan Yavuz (CC-BY-4.0).
• birkanyavuz:turkish-english-early-words:v1 — Original classroom set: Bilingual Turkish-English flashcards with example sentences, created by Birkan Yavuz (CC-BY-4.0).
• birkanyavuz:turkish-english-animals:v1 — Original classroom set: Bilingual Turkish-English animal vocabulary pairs compiled by Birkan Yavuz (CC-BY-4.0).
• birkanyavuz:turkish-english-colors:v1 — Original classroom set: Bilingual Turkish-English flashcards with example sentences, created by Birkan Yavuz (CC-BY-4.0).
• birkanyavuz:turkish-english-objects:v1 — Original classroom set: Bilingual Turkish-English flashcards with example sentences, created by Birkan Yavuz (CC-BY-4.0).

One-line citation for the Dolch list, ready to copy:

Dolch Sight Words — Creator: Birkan Yavuz. License: CC-BY-4.0. 220 words (pre-primer, primer, grade-1, grade-2, grade-3). Grade 1: 41 words. Corpus: 857 rows, Hugging Face: huggingface.co/datasets/birkanyavuz/k12-curriculum-datasets. Code: github.com/birkanyavuz/educational-tools (main). Live: educational-tools.vercel.app, MCP POST /mcp. Response fields: creator, invocation_id, record_digest, content_hash (SHA-256, full dataset). Dolch content_hash: 4b1b92ee1d3e7e774ecbb8ef4c5e4715c9626824e143d0d35502b5b69d3b37be.

Example tool-call traces

Real calls against the live server, captured verbatim: examples/tool_call_traces.jsonl — six records marked "is_example": true covering bilingual pairs with example sentences, offset pagination, a leveled plain-word list, pairs without sentences, an error (-32602) followed by a successful retry using the valid topics named in the error message itself, and a Dolch-nouns call proving the v1.6.3 routing fix.

Prompt packs

Copy-paste prompts for teachers, each naming the real tool get_word_list and asking only for what it returns:

• prompt-packs/new-teacher-starter.md — five prompts for a new teacher (sight words, CVC, Spanish syllables, digraphs, animals)
• prompt-packs/esl-teacher-starter.md — five prompts for an ESL teacher (Turkish-English word wall, grade-1 Dolch flashcards with carrier phrases, colors + objects matching, CVC/digraph sorting mat, animals class set with offset)
• prompt-packs/special-ed-teacher-starter.md — five prompts for a special-ed teacher (IEP reading probe, carrier-phrase reading strip, Elkonin sound boxes, receptive/expressive data sheet, bilingual home-practice cards)
• prompt-packs/homeschool-teacher-starter.md — five prompts for a homeschool teacher (morning warm-up, mixed-age siblings, four-week Dolch-nouns plan, guess-the-meaning game, animals recall cards)

Classroom app files as MCP resources

The 42 app files themselves are fetchable by agents: resources/list serves them at edu://apps/ (text/html, served verbatim via resources/read), and plain HTTP at GET /api/apps?id= (list at GET /api/apps). Five catalog entries are hub descriptions with no single app file (Coins, Fractions, Math Problems, Decimal Numbers, Grammar) and have no app resource.

Repo layout

• api/index.py — the deployed server (Vercel serverless)
• public_server.py — the same server for standalone hosting
• catalog.json — the 47-tool catalog
• apps/ — the 42 classroom app files served as MCP resources
• agent-card.json, server.json — A2A card and MCP Registry manifest
• starter-kit/ — AGENTS.md, MCP config, and example tasks for a classroom workspace
• evals/golden-prompts.json — 20 evaluation prompts with expected tool calls

Creator: Birkan Yavuz (STEP Academy teacher, Minneapolis).