Search / io.github.wilbek-source/timetable-builder
School Timetable Builder
R0· no sign-inBuild a full weekly timetable for a primary school (classes, teachers, rooms) via chat.
v1.0.0 · active · website · descriptor JSON · versions
Search / io.github.wilbek-source/timetable-builder
R0· no sign-inBuild a full weekly timetable for a primary school (classes, teachers, rooms) via chat.
v1.0.0 · active · website · descriptor JSON · versions
{
"mcpServers": {
"timetable-builder": {
"type": "http",
"url": "https://timetable-builder.wilbek.workers.dev/mcp"
}
}
}claude mcp add --transport http timetable-builder https://timetable-builder.wilbek.workers.dev/mcp[mcp_servers.timetable-builder]
url = "https://timetable-builder.wilbek.workers.dev/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"timetable-builder": {
"type": "remote",
"url": "https://timetable-builder.wilbek.workers.dev/mcp",
"enabled": true
}
}
}{
"mcpServers": {
"timetable-builder": {
"type": "http",
"url": "https://timetable-builder.wilbek.workers.dev/mcp"
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=timetable-builder&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vdGltZXRhYmxlLWJ1aWxkZXIud2lsYmVrLndvcmtlcnMuZGV2L21jcCJ9"
}{
"servers": {
"timetable-builder": {
"type": "http",
"url": "https://timetable-builder.wilbek.workers.dev/mcp"
}
}
}{
"mcpServers": {
"timetable-builder": {
"httpUrl": "https://timetable-builder.wilbek.workers.dev/mcp"
}
}
}extensions:
"timetable-builder":
enabled: true
name: "timetable-builder"
type: streamable_http
uri: "https://timetable-builder.wilbek.workers.dev/mcp"
timeout: 300
protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28protocol.statelessonly applies to 2026-07-28 serversprotocol.transportstreamable HTTPprotocol.list_ttlonly applies to 2026-07-28 serversauth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptionsevery tool has a descriptiontools.description_lengthdescriptions are concisetools.schemasevery tool has an object input schematools.annotations5 of 5 tools declare readOnlyHint or destructiveHinttools.directory_hintsevery tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHinttools.token_costabout 1,805 tokens to load every tooltools.api_dumptools are not a one-to-one API dumpstability.changes, stability.rug_pulltool history recorded for 3 of the 7 days neededdeps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI packageNo tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+website +reachable +uptime-100% +updated-4d-ago -no-repository
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
| remote | auth | reachable | uptime 30d | p50 | protocol | last ok |
|---|---|---|---|---|---|---|
https://timetable-builder.wilbek.workers.dev/mcp streamable-http | none | yes | 100% | 538 ms | 2025-11-25 | 2026-10-20 |
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_interview_guideread-only | 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. |
get_schedule_resultread-only | 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]. |
validate_inputread-only | 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. |
Schemas: list_tools.
{
"name": "io.github.wilbek-source/timetable-builder",
"title": "School Timetable Builder",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"remotes": [
{
"url": "https://timetable-builder.wilbek.workers.dev/mcp",
"type": "streamable-http"
}
],
"version": "1.0.0",
"websiteUrl": "https://wilbek-source.github.io/timetable-builder/",
"description": "Build a full weekly timetable for a primary school (classes, teachers, rooms) via chat."
}