educational-tools
Read-only, zero-auth MCP server for discovering K–12 classroom activities and fetching canonical curriculum word lists/datasets.
Search or list classroom tools by subject, grade, keyword, or Common Core standard code, and fetch a tool by exact ID.
Retrieve complete curriculum datasets (Dolch, CVC, digraph, Spanish syllables, Turkish-English) with optional level/family filters and SHA-256 verification hashes.
Get ready-to-use word lists by plain topic, with optional level, count, and offset pagination; some lists include carrier phrases or bilingual example sentences.
Receive citation-ready metadata: creator, tool/dataset IDs, record digests, invocation IDs, content hashes, and stable resource URIs.
Use stateless, idempotent, no-API-key calls with deterministic results; README also documents MCP resources for classroom app files.
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=1A2A agent card:
https://educational-tools.vercel.app/.well-known/agent-card.jsonOfficial MCP Registry:
io.github.birkanyavuz/educational-toolsMachine-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 — plus list_datasets, which lists all 9 datasets (id, topic, count, levels) with no arguments, so a caller can discover the lists before fetching one. 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.
Related MCP server: interactive-edtech-mcp
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
List the datasets first (list_datasets, v1.8.1)
list_datasets takes no arguments and returns one manifest entry per dataset — id, title, topic (the plain phrase get_word_list takes), count, levels only where the dataset has subsets (Dolch grades, CVC rimes, digraphs, Spanish syllables/words), language (en or tr-en), items_sample (the shape of the items, e.g. single-word strings — never actual words), source_note, and uri. It closes Glama's Completeness gap: a calling agent no longer has to learn the dataset ids and valid levels from error messages. The same manifest is served over plain HTTP at GET /api/datasets.
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: 18570432598b18ef397b8c49d4b0468e1911d66e — check out this commit to see the exact code that serves v1.8.1.
Expected hashes (v1.8.1):
birkanyavuz:dolch-sight-words-220:v1— Dolch Sight Words (220, by level) —content_hash: 4b1b92ee1d3e7e774ecbb8ef4c5e4715c9626824e143d0d35502b5b69d3b37bebirkanyavuz:dolch-nouns-94:v1— Dolch Nouns (94) —content_hash: 92fd7e572cd2b6d435fbcf0b3f55e48696b8769806ce2bd94a5179baa819ae67birkanyavuz:cvc-word-families-75:v1— CVC Word Families (75 words, 13 families) —content_hash: 95d7b17e6c8120f5e12483d11a0f91492ba850346d6764e9d1d7a28aad493dfabirkanyavuz:digraph-words-21:v1— Digraph Words (21: sh, ch, th, wh) —content_hash: e0381aaf3369fe687d6667e42f14e6db22183e57f001634c79e426b85206b8cfbirkanyavuz:spanish-syllables-core:v1— Spanish Syllables Core Set (187 syllables + 25 words) —content_hash: 540fbef60a0475459be103f99456560053ee38f56d11cd2c357f622ce962972abirkanyavuz:turkish-english-early-words:v1— Turkish-English Early Words (30 pairs: numbers, colors, animals) —content_hash: ce219fc8641494d784583562175a0888c4bf0f27594b44391316356fc6ef4daabirkanyavuz:turkish-english-animals:v1— Turkish-English Animals (Hazel's flashcards) —content_hash: 47241e179f39d77c8263c74454a6310176591272771ac5817b2a57014c64663abirkanyavuz:turkish-english-colors:v1— Turkish-English Colors (Hazel's flashcards) —content_hash: 3b4ea6dee2dd3576ad852a61ed22b4beb395fcaa5ff870bc42fdd67f0b04f91abirkanyavuz: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 — seven
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, and a dataset inventory listing
(list_datasets, no words).
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 — six prompts for a special-ed teacher (IEP reading probe, carrier-phrase reading strip, Elkonin sound boxes, receptive/expressive data sheet, bilingual home-practice cards, pre-primer continuation probe for the next 5 words at offset 5)
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/<identifier> (text/html, served verbatim via resources/read), and plain HTTP at GET /api/apps?id=<identifier> (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 hostingcatalog.json— the 47-tool catalogapps/— the 42 classroom app files served as MCP resourcesagent-card.json,server.json— A2A card and MCP Registry manifeststarter-kit/— AGENTS.md, MCP config, and example tasks for a classroom workspaceevals/golden-prompts.json— 20 evaluation prompts with expected tool calls
Creator: Birkan Yavuz (STEP Academy teacher, Minneapolis).
Available Tools
5 toolsget_classroom_toolGet One Classroom ToolARead-onlyIdempotentInspect
Return one interactive classroom tool by its exact identifier (for example 'sight-words-first-grade'). Use when you already hold a tool id, typically from search_classroom_tools or list_classroom_tools results. Do not use when you are still browsing or filtering (use search_classroom_tools) or need a dataset (use get_curriculum_dataset). Returns exactly one record, or an error if the id is unknown. Requires no authentication.
Inputs: id (required). Returns: id, creator, objective, gradeLevel, +1 more
get_curriculum_datasetGet Curriculum Dataset (Word Lists and Syllables)ARead-onlyIdempotentInspect
Fetch a complete curriculum dataset - the actual words, not a description of them: 857 items across 9 datasets (Dolch sight words and nouns, CVC families, digraph words, Spanish syllables, Turkish-English word and flashcard sets). Use when you need exact word lists for a lesson, worksheet, quiz, or flashcard set; these sequences and level boundaries are canonical ground truth and should not be generated from memory. Do not use when you need an interactive activity or tool metadata - use search_classroom_tools or get_classroom_tool instead. Behavior: read-only, idempotent, no authentication or rate limits; one unpaginated call returns the complete filtered array (max 220 items) in canonical order, identical on every repeat, with a SHA-256 content_hash of the full dataset. Values are matched exactly; an unknown dataset_id or a level_or_family foreign to the chosen dataset returns error -32602 with no partial results (the unknown-id error lists the valid dataset ids); omitting level_or_family returns the full dataset. Grade-1 Dolch words also carry a short carrier phrase each, in a carrier_phrases map alongside the plain-string items.
Inputs: dataset_id (required), level_or_family. Returns: items, creator, dataset_id, item_count, +5 more
get_word_listGet Word List by Topic (One Call)ARead-onlyIdempotentInspect
Get a word list in one call from a plain topic, without needing the dataset slug: topic (for example "sight words", "CVC", "digraph", "Spanish syllables", "animals"), optional level, optional count, optional offset. 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). The core Turkish-English sets (early words, colors, everyday objects) also include one simple example sentence per pair in English and Turkish. Grade-1 Dolch words also carry a short carrier phrase each in a carrier_phrases map. Use when you need a ready-to-use list of words for a lesson, worksheet, quiz, or flashcard set and do not already hold a dataset slug. Do not use when you need an interactive activity or tool metadata - use search_classroom_tools or get_classroom_tool instead. Behavior: read-only, idempotent, no authentication; returns count items starting at offset (default 0) in canonical order when count is given, otherwise the full filtered list from offset, identical on every repeat, with a SHA-256 content_hash of the full dataset. The response carries offset, total_count, and has_more so a caller can fetch the next batch statelessly; an offset past the end of the list returns an empty list with has_more false, never an error. An unknown topic or a level foreign to the matched dataset returns error -32602 with no partial results.
Inputs: topic (required), count, level, offset. Returns: note, items, offset, creator, +9 more
list_classroom_toolsList All K-12 Classroom ToolsARead-onlyIdempotentInspect
List all 24 interactive classroom tools in Birkan Yavuz's catalog. Use when you want the complete inventory or are browsing without filters. Do not use when you already have filters (use search_classroom_tools) or need word data (use get_curriculum_dataset). Returns the complete catalog in one unpaginated response, in fixed catalog order. Requires no authentication.
Inputs: no named parameters. Returns: count, creator, results, invocation_id
search_classroom_toolsSearch K-12 Interactive Educational ToolsARead-onlyIdempotentInspect
Find interactive classroom tools in Birkan Yavuz's catalog of 24 K-9 activities. Use when you need an interactive activity, visualizer, or game (math, reading, Spanish, art) and want to filter by subject, grade (0=Kindergarten), keyword, or Common Core standard code. Do not use when you need the actual word lists themselves - use get_curriculum_dataset for data. Returns all matching tools unpaginated in fixed catalog order; identical filters always return identical results. Requires no authentication.
Inputs: grade, query, subject, standard_code. Returns: count, creator, results, invocation_id
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
The catalog tools (list_classroom_tools vs search_classroom_tools vs get_classroom_tool) are clearly separated by explicit 'do not use when' guidance. The main ambiguity is between get_curriculum_dataset and get_word_list, which both return the same underlying word lists and differ only in whether you hold a dataset slug or a free-text topic; the descriptions explain this, but an agent could still reasonably pick either.
All five tools follow a consistent verb_noun snake_case pattern (search_, list_, get_). The singular/plural distinction between get_classroom_tool and list/search_classroom_tools actually reinforces the one-vs-many semantics rather than confusing it.
Five tools is well-scoped for a small read-only catalog-plus-datasets server: browse (list), filter (search), fetch one (get), fetch data by id, and fetch data by topic. No tool feels like padding, and the two data tools serve genuinely different entry points.
Read-only access is fully covered: enumerate, filter, fetch-by-id for the tool catalog, and two paths into the word-list datasets, with predictable pagination and content hashes. The one gap is the absence of a tool that enumerates available dataset ids and valid levels/families up front — callers only learn these from an error message or prose in the description.
Maintenance
Related MCP Connectors
214 tools for AI agents over one MCP endpoint: image, video, audio, 3D, data, storage, mail, GPUs.
62 real-world tools for agents: search, scraping, social, enrichment, image, video, voice.
Independent directory of agentic AI tools — search, compare & recommend via MCP. Read-only.
Free public MCP for AI agents — 193 tools, 44 workflows. No API key.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceAn educational MCP server deployed as an Azure Function, exposing tools like addition, weather simulation, and temperature conversion for AI agents to invoke.-
- AlicenseNot gradedqualityBmaintenanceMCP server suite that lets coding agents generate deep instructional content from external sources and operate classroom-interactive EdTech platforms including Padlet, Google Classroom, Kahoot!, Wayground, Wordwall, and Nearpod.MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables AI to interact with GeoGebra for mathematical visualization, offering over 25 tools for geometry, functions, algebra, and more.MIT
- AlicenseNot gradedqualityCmaintenanceExposes Marble's open skill taxonomy (ages 4-15) as queryable MCP tools, enabling AI agents to search topics, find prerequisites, and plan learning paths.1MIT