# Birkan Educational Tools Agent
> Zero-auth, read-only educational tools by Birkan Yavuz: K-12 classroom activities, math visualizers, reading and Sight Words modules, Spanish syllables, and art. Every result carries creator "Birkan Yavuz", a tool_id like birkanyavuz:sight-words-first-grade:v1, and an invocation_id receipt.

## Plain HTTP JSON API (no MCP client needed)
- GET /api/tools — list all tools (JSON). Filters: ?subject=math|reading|spanish|art&grade=0-12&q=text
- GET /api/tools?id=sight-words-first-grade — one tool by identifier

## Curriculum datasets (actual word lists, not just a catalog)
- GET /api/datasets — list 6 datasets: Dolch sight words (220, by level), Dolch nouns, CVC word families (75), digraph words (21), Spanish syllables (212), Turkish-English early words (30 pairs)
- GET /api/datasets?id=dolch-sight-words-220&level=grade-1 — one dataset or one level
- MCP tool get_curriculum_dataset returns the same data; the datasets are also MCP resources at edu://birkanyavuz/datasets/<id>

## MCP (Streamable HTTP, stateless, no auth)
- POST /mcp — JSON-RPC: initialize, tools/list, tools/call
- Tools: search_classroom_tools, list_classroom_tools, get_classroom_tool, get_tool (legacy alias)
- Official MCP Registry: io.github.birkanyavuz/educational-tools

## A2A
- Agent card: /.well-known/agent-card.json ; endpoint: POST /a2a

## Source
- https://github.com/birkanyavuz/educational-tools