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

io.github.birkanyavuz由 GitHub 帳號 birkanyavuz 發布v1.6.2更新於 Nov 7, 2026

Zero-auth K-12 + early-childhood datasets: Dolch words, TR-EN flashcards, Spanish, creator data.

已驗證Streamable HTTP可網頁執行效率與工作流知識與記憶

概覽

AI 產生的概覽

唯讀、免驗證的 MCP 伺服器,提供 K-9 課堂活動目錄與已出版的課程字表(Dolch、CVC、西班牙語音節、土英對照)。

可以做什麼
  • 依科目、年級、關鍵字或 Common Core 標準代碼搜尋、列出並取得課堂活動
  • 取得九個資料集的完整課程資料,也就是實際字表內容
  • 用一次呼叫依一般主題取得字表,支援級別、數量與位移分頁
  • 每筆結果附帶創作者資訊、工具識別碼與引用摘要
適用情境
適合需要為課程、學習單或測驗取得精確的已出版字表,或想依年級與標準尋找數學、閱讀、西班牙語、美術互動活動的情況。
執行需求
可作為免 API 金鑰的遠端 Streamable HTTP 端點使用,也可作為本機 npm 套件透過 stdio 執行。未宣告帳號、環境變數或請求標頭;使用遠端端點需要網路存取。
安裝前請注意
文件稱其為唯讀且無狀態,不要求任何憑證。內容來自單一創作者的目錄與已出版字表,用於課堂前請自行確認適用性;字表依原樣提供,不含釋義。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 K-12 Educational Tools & Curriculum Catalog (Math, Reading, Spanish),將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.birkanyavuz%2Feducational-tools/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "k-12-educational-tools-curriculum-catalo": {
      "type": "http",
      "url": "https://educational-tools.vercel.app/mcp"
    }
  }
}

README

Birkan Educational Tools Agent

Zero-auth, read-only MCP server + A2A agent by Birkan Yavuz: a catalog of 24 real classroom activities (math visualizers, reading and Sight Words modules, Spanish syllables, art) for Kindergarten–Grade 9, 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. 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.

Example tool-call traces

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

Repo layout

  • api/index.py — the deployed server (Vercel serverless)
  • public_server.py — the same server for standalone hosting
  • catalog.json — the 24-tool catalog
  • 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).

來源:README.md,提交 a8fa1d9

工具

5

search_classroom_tools

Search K-12 Interactive Educational Tools

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.

輸入參數gradequerysubjectstandard_code

list_classroom_tools

List All K-12 Classroom Tools

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.

無需輸入參數。

get_classroom_tool

Get One Classroom Tool

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.

輸入參數id必填

get_curriculum_dataset

Get Curriculum Dataset (Word Lists and Syllables)

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.

輸入參數dataset_id必填level_or_family

get_word_list

Get Word List by Topic (One Call)

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.

輸入參數countleveltopic必填offset

版本歷史

6
  1. v1.6.2最新Nov 7, 2026
  2. v1.6.0Nov 5, 2026
  3. v1.5.0Nov 5, 2026
  4. v1.4.0Nov 3, 2026
  5. v1.3.4Oct 30, 2026
  6. v1.3.2Oct 29, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分