io.github.wilbek-source/timetable-builder·Public data

School Timetable Builder

Build a full weekly timetable for a primary school (classes, teachers, rooms) via chat.

Stars
—
Version
1.0.0
License
—
Review
Passed
Registry update
Oct 16, 2026

Connect

remote
Terminal
$claude mcp add --transport http timetable-builder https://timetable-builder.wilbek.workers.dev/mcp

Headers

Nothing to configure — it works as is.

Security review

Review passed

Reviewed 53m ago.

tools
5 tools scanned
metadata
scanned

No findings.

Tools

5
  • get_interview_guide

    Returns the interview guide: which questions to ask the user, default values, engine limits and the exact format of the 8 input files. Call this first.

  • validate_input

    Checks the 8 input files in a few seconds without creating a timetable: file structure, engine limits and a capacity analysis (enough teachers/time?). Returns VALID (with warnings) or INVALID (with reasons). Always run this before create_schedule.

  • create_schedule

    Starts calculating the full timetable from the 8 input files (validate them first). Returns a job_id at once; the calculation takes about 5-8 minutes. Then keep calling get_schedule_result with the job_id in the same reply until it is done.

  • get_schedule_result

    Gets the status or result of a job from create_schedule (or a slow validate_input). While running: progress. When done: a compact timetable as text plus a link (valid 1 hour) to the full JSON result. view='classes' (default) = one table per class, 'teachers' = one per teacher incl. preparation time, 'summary' = key figures and lists of classes/teachers only. Use 'names' to get only some classes/teachers (recommended for big schools). If impossible: the reasons.

  • send_feedback

    Passes the user's feedback about the timetable service on to its developer (what worked, what did not, wishes). Only call it when the user has said they want to give feedback, and send what the user said in their own words (you may shorten it; any language is fine). Never include teacher names, other personal data or the school's data files. Tell the user briefly that it was sent. Nobody replies through this channel - if the user wants an answer, give them the support email [email protected].

More in Public data

Listing from the official MCP Registry.