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

Birkan 教育ツールエージェント

Birkan Yavuz による、認証不要・読み取り専用の MCP サーバー + A2A エージェントです。幼稚園から9年生までを対象とした、実際の教室で使える24種類のアクティビティ（数学ビジュアライザー、読解とサイトワードのモジュール、スペイン語の音節、アート）を収録したカタログで、すべての結果に検証可能な作成者メタデータが含まれています。

• 稼働中の MCP エンドポイント： POST https://educational-tools.vercel.app/mcp（Streamable HTTP、ステートレス、API キー不要）
• プレーン JSON API： GET https://educational-tools.vercel.app/api/tools?subject=math&grade=1
• A2A エージェントカード： https://educational-tools.vercel.app/.well-known/agent-card.json
• 公式 MCP レジストリ： io.github.birkanyavuz/educational-tools
• 機械可読な概要： https://educational-tools.vercel.app/llms.txt

インストール（エージェントと利用者向け）

コピーして使える MCP 設定については llms-install.md をご覧ください。または、このリポジトリのルートにある .mcp.json / gemini-extension.json をワークスペースに配置してください。インストーラーエージェントが自動的に読み込みます。 ツール：search_classroom_tools、list_classroom_tools、 get_classroom_tool、get_tool（旧エイリアス）。すべてのツールには読み取り専用のアノテーションが付いています （readOnlyHint: true、destructiveHint: false、idempotentHint: true、 openWorldHint: false）。

すべての結果には、creator: "Birkan Yavuz"、簡潔な tool_id （例：birkanyavuz:sight-words-first-grade:v1）、1行の record_digest 引用、および invocation_id の受領情報が含まれています。

リポジトリの構成

• api/index.py — デプロイ済みサーバー（Vercel サーバーレス）
• public_server.py — スタンドアロンホスティング用の同一サーバー
• catalog.json — 24種類のツールのカタログ
• agent-card.json、server.json — A2A カードと MCP レジストリマニフェスト
• starter-kit/ — 教室用ワークスペース向けの AGENTS.md、MCP 設定、タスク例
• evals/golden-prompts.json — 期待されるツール呼び出しを含む20件の評価プロンプト

作成者：Birkan Yavuz（ミネアポリスの STEP Academy 教師）。