@matsubokkuri/school-mcp

Model Context Protocol server for the Japanese school information API at https://school.teraren.com. Exposes the public REST endpoints (schools, education committees, prefectures, standard areas, school-type masters) as MCP tools so AI agents can answer questions like "find every elementary school in Chiyoda-ku, Tokyo" or "give me the record for school code B113310003122" without scraping HTML.

Install

npm install -g @matsubokkuri/school-mcp
# or run on demand
npx @matsubokkuri/school-mcp

Configure

The server speaks MCP over stdio, so any compatible host can launch it.

Claude Desktop / Claude Code

Add the following to your claude_desktop_config.json (or the equivalent .mcp.json for Claude Code):

{
  "mcpServers": {
    "school": {
      "command": "npx",
      "args": ["-y", "@matsubokkuri/school-mcp"]
    }
  }
}

Custom base URL

Point the server at a staging deployment by setting SCHOOL_API_BASE_URL:

{
  "mcpServers": {
    "school": {
      "command": "npx",
      "args": ["-y", "@matsubokkuri/school-mcp"],
      "env": {
        "SCHOOL_API_BASE_URL": "https://staging.school.example.com"
      }
    }
  }
}

Tools

| Tool | Description | | --- | --- | | list_schools | Search/paginate the school registry. | | get_school | Fetch one school by 13-character MEXT code. | | list_education_committees | Search/paginate municipal education committees. | | get_education_committee | Fetch one education committee by code. | | list_prefectures | All 47 prefectures. | | get_prefecture | Fetch one prefecture by 2-digit code. | | list_standard_areas | Search/paginate the MIC standard-area registry. | | get_standard_area | Fetch one standard area by 5-digit code. | | list_standard_areas_in_prefecture | Standard areas inside one prefecture. | | list_schools_in_area | Schools of a given type inside a standard area. | | list_school_types | Master table: school types. | | list_establishment_categories | Master table: establishment categories. | | list_main_branch_indicators | Master table: main vs branch campuses. |

Develop

bun install
bun run build
node dist/index.js   # speaks MCP over stdio

License

MIT — see LICENSE.