Server definition
- Hash
- sha256:aa30047788db743d60cafc0b3f6932a2add792a77f647019f81a3490bec4c521
- What it is
- What a remote MCP server returned when asked what it offers: 30 tools
The blob, as servednamed by its sha256
{
"instructions": "Turnale runs recreational racket-sport tournaments end to end. Five things make one: SPORT · the PLAYER LIST or just a HEADCOUNT · SINGLES OR DOUBLES · the TIME BUDGET · SOCIAL OR COMPETITIVE. Ask for what you do not know yet, ONE question at a time.\n\nTHAT IS A LIST OF THINGS TO LEARN, NOT A FORM TO FILL IN ORDER. Read every reply for whatever it answers, not for what you asked: 'competitive' settles the vibe, 'knockout' or 'americano' settles the format, 'tomorrow at 18:00' settles the time, a pasted list settles the players. Take it, tick it off, and move to the next unknown — even when it answers a question you had not asked yet. If a reply does not answer YOUR question it has almost certainly answered a different one, so look for that; repeating a question the organiser has already moved past is always wrong, and asking the same thing twice is the single worst thing you can do in this interview.\n\nOnly two of the five must be settled before a format: the SPORT, and SINGLES OR DOUBLES (ASK it — never infer it from the sport; it decides which formats exist at all, since americano and mexicano are doubles). Everything else has a sensible default and can be changed later. A missing time budget is FINE — suggest_format works without one and assumes a normal evening; a tournament with no start time is FINE too. NEVER hold up a tournament over something optional: make the obvious assumption, create it, and say what you assumed.\n\nHeadcount only → create with signup_open so players add themselves via the page link; NEVER invent placeholder names. NEVER ask an open 'which format?' question. If the format is unsettled or the organiser uses only tennis vocabulary, call suggest_format and relay the `menu` text that comes back to the organiser word for word — unchanged if they are writing English, translated only if they are writing something else, and NEVER into a language they have not used themselves — it already contains each option's one-line explanation and time math, so they can read and choose in one step. After create_tournament, LEAD with the shareable page link — that is what the organiser opens and shares with players (schedule, live standings, self-signup). COPY EVERY LINK A TOOL GIVES YOU EXACTLY as it came — same https://, same host, same path, character for character. Never retype one from memory, never add 'www.', never drop the scheme, never shorten or prettify it. A rewritten link is a broken link, and the organiser sends it to twenty people before anyone tries it. Mention the organiser key once, secondarily, with the cannot-be-recovered warning: it is only used to manage the tournament through this chat, never by players. Re-share the page link at key moments — draw generated, tournament started, results coming in, tournament ended (get_briefing returns it any time). Mutations are idempotent (request_id) and mistakes are reversible via undo_last_change — prefer preview, then confirm. Set language to the language the organiser is WRITING to you in when create_tournament's list supports it (Spanish → language: 'es'), so the page, PDFs and player emails follow (default English; never set it on a hunch — only from the language they actually use). Always write to the organiser in the language THEY are writing to you in, and never in one they have not used.",
"tools": [
{
"description": "Add players to the roster in bulk (parse pasted lists or spreadsheets yourself and send structured entries — never invent placeholder names; use signup mode when names aren't known yet). Duplicate names are rejected for disambiguation. If an unlocked draw exists it is regenerated automatically.",
"inputSchema": {
"properties": {
"players": {
"items": {
"properties": {
"gender": {
"enum": [
"m",
"f",
"x"
],
"type": "string"
},
"level": {
"description": "Any consistent numeric level/rating — used only for seeding and balancing",
"maximum": 10000,
"minimum": -10000,
"type": "number"
},
"name": {
"maxLength": 120,
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"maxItems": 128,
"minItems": 1,
"type": "array"
},
"request_id": {
"description": "Optional idempotency id — retrying a call with the same id never applies it twice",
"maxLength": 64,
"type": "string"
},
"tournament_key": {
"description": "The tournament's organiser key (starts with tk_)",
"type": "string"
}
},
"required": [
"tournament_key",
"players"
],
"type": "object"
},
"name": "add_players",
"outputSchema": {
"additionalProperties": false,
"properties": {
"added": {
"items": {
"type": "string"
},
"type": "array"
},
"players_total": {
"type": "number"
},
"preview": {
"description": "True when this is a preview — nothing was changed",
"type": "boolean"
},
"summary": {
"description": "What happened, in one line",
"type": "string"
}
},
"required": [
"players_total",
"added",
"summary"
],
"type": "object"
}
},
{
"description": "Create a new tournament. Keep setup SHORT: ask the organiser only for sport, players, court count and start time — sensible defaults cover everything else. FORMAT: never ask an open 'which format?' question. If the organiser clearly named one, pass it; otherwise omit format — the call then returns a ready-to-show menu of options (nothing is created) for you to relay so the organiser can read and choose in one reply. Players can be added later with add_players. NEVER invent placeholder or fake player names ('Player 1', made-up names): if the organiser only knows the headcount, create with signup_open: true and signup_cap set to it — players add themselves by name via the page link. If the organiser gives a time budget instead of rounds (e.g. 'we have 2 hours'), derive rounds ≈ total minutes ÷ (match + break minutes) and confirm. If they ask for a format that is not listed, offer to note it with record_feedback. Returns the organiser key (tk_…): relay it with the warning that it cannot be recovered, plus the shareable page link.",
"inputSchema": {
"properties": {
"advance_per_group": {
"maximum": 4,
"minimum": 1,
"type": "integer"
},
"break_minutes": {
"description": "Changeover between matches/rounds, shown separately from play time (default 0)",
"maximum": 60,
"minimum": 0,
"type": "integer"
},
"court_names": {
"items": {
"maxLength": 60,
"type": "string"
},
"maxItems": 16,
"type": "array"
},
"courts": {
"description": "Default 2",
"maximum": 16,
"minimum": 1,
"type": "integer"
},
"discipline": {
"description": "Ask the organiser — never infer it from the sport. Americano/mexicano are always doubles. Defaults to singles for the bracket formats when they truly have no preference.",
"enum": [
"singles",
"doubles"
],
"type": "string"
},
"format": {
"description": "Tournament format. round_robin: everyone plays everyone. groups_playoff: round-robin groups then a knockout. single_elimination: knockout with byes. americano/mexicano: rotating-partner doubles, points per round (mexicano pairs each round from standings). OMIT when the organiser hasn't clearly chosen — the call then returns a menu of explained options to show them instead of creating anything.",
"enum": [
"round_robin",
"groups_playoff",
"single_elimination",
"americano",
"mexicano"
],
"type": "string"
},
"gender_balance": {
"description": "Americano/mexicano: prefer matches where both teams have the same make-up (MM v MM, MW v MW, WW v WW). Default prefer_symmetric. A preference, not a rule — an uneven field cannot supply it, and the draw says so rather than distorting the rotation.",
"enum": [
"prefer_symmetric",
"off"
],
"type": "string"
},
"group_count": {
"maximum": 8,
"minimum": 2,
"type": "integer"
},
"house_rules": {
"description": "Organiser's house rules, shown on the tournament page (e.g. 'Golden point at deuce')",
"items": {
"maxLength": 200,
"type": "string"
},
"maxItems": 12,
"type": "array"
},
"language": {
"description": "Language of the tournament page, PDFs and player emails (ISO 639-1). Default en; set it to the language the organiser is writing in when it is in this list.",
"enum": [
"en",
"bg",
"hr",
"cs",
"da",
"nl",
"et",
"fi",
"fr",
"de",
"el",
"hu",
"it",
"lv",
"lt",
"nb",
"pl",
"ro",
"sk",
"sl",
"sv",
"uk",
"es",
"pt",
"ar",
"bn",
"zh",
"hi",
"id",
"ja",
"ko",
"ru",
"tr",
"ur",
"vi"
],
"type": "string"
},
"level_gap_cap": {
"description": "Opt-in: the largest level gap the organiser wants between opponents, in their own level units. Soft — the draw prefers to respect it and reports when it cannot. Pass 0 to clear.",
"maximum": 1000,
"minimum": 0,
"type": "number"
},
"level_offset": {
"description": "by_group only: how much stronger an m is than an f carrying the SAME number, in the organiser's own level units. Default 1 — a starting point to adjust, not a fact. Used for balancing only; never shown on the page or in standings.",
"maximum": 1000,
"minimum": 0,
"type": "number"
},
"level_scale": {
"description": "How to read the numbers in `level`. absolute (default): one shared scale, a 3 is a 3 whoever holds it. by_group: men and women were each rated within their own group, so the numbers are not directly comparable — ask the organiser which they did rather than guessing. ignore: the numbers are notes, never used for the draw.",
"enum": [
"absolute",
"by_group",
"ignore"
],
"type": "string"
},
"location": {
"description": "Venue/location shown to players on the page, e.g. club name + city",
"maxLength": 160,
"type": "string"
},
"match_duration_minutes": {
"maximum": 240,
"minimum": 5,
"type": "integer"
},
"name": {
"description": "Defaults to '<Sport> tournament 14 Aug 2026 (<location>)' — start date (or today) plus the location when known",
"maxLength": 120,
"type": "string"
},
"page_results_entry": {
"description": "Allow anyone with the page link to enter scores courtside. Default TRUE — recreational tournaments run on whoever finishes their match first, and an organiser who has to type every result is the bottleneck. Pass false if the organiser wants to be the only one recording scores; switchable either way at any time via update_settings or the toggle on the page.",
"type": "boolean"
},
"pairs": {
"description": "Doubles: fixed pairs as [name, name] arrays. Omit to auto-pair.",
"items": {
"items": {
"type": "string"
},
"maxItems": 2,
"minItems": 2,
"type": "array"
},
"type": "array"
},
"players": {
"items": {
"properties": {
"gender": {
"enum": [
"m",
"f",
"x"
],
"type": "string"
},
"level": {
"description": "Any consistent numeric level/rating — used only for seeding and balancing",
"maximum": 10000,
"minimum": -10000,
"type": "number"
},
"name": {
"maxLength": 120,
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"maxItems": 128,
"type": "array"
},
"points_per_match": {
"description": "Americano/mexicano; default 21",
"maximum": 64,
"minimum": 4,
"type": "integer"
},
"rounds": {
"description": "Americano/mexicano; default from player count",
"maximum": 30,
"minimum": 1,
"type": "integer"
},
"seeding": {
"description": "Default random",
"enum": [
"random",
"level"
],
"type": "string"
},
"signup_cap": {
"description": "Signup limit; beyond it players join a waitlist",
"maximum": 128,
"minimum": 4,
"type": "integer"
},
"signup_open": {
"description": "Open self-signup: players add themselves on the shared page (name-only or signed in). Offer this when the organiser has no player list yet.",
"type": "boolean"
},
"sport": {
"description": "Write sport names to the organiser in words — 'table tennis', never the enum spelling 'table_tennis'.",
"enum": [
"tennis",
"padel",
"pickleball",
"badminton",
"squash",
"table_tennis"
],
"type": "string"
},
"start_time": {
"description": "ISO datetime with offset, e.g. 2026-08-01T18:00:00+03:00. Must be within 365 days from today.",
"type": "string"
},
"third_place_match": {
"description": "Single elimination; default true",
"type": "boolean"
}
},
"required": [
"sport"
],
"type": "object"
},
"name": "create_tournament",
"outputSchema": {
"additionalProperties": false,
"properties": {
"draw_generated": {
"type": "boolean"
},
"name": {
"type": "string"
},
"page_url": {
"type": "string"
},
"players_added": {
"type": "number"
},
"rounds_text": {
"description": "Present when a draw was generated — show it to the organiser as-is.",
"type": "string"
},
"summary": {
"type": "string"
},
"tournament_key": {
"type": "string"
}
},
"required": [
"tournament_key",
"page_url",
"name",
"players_added",
"draw_generated",
"summary"
],
"type": "object"
}
},
{
"description": "Soft-delete the whole tournament (recoverable by support for 7 days, then gone). Preview first; confirm: true to apply.",
"inputSchema": {
"properties": {
"confirm": {
"type": "boolean"
},
"tournament_key": {
"type": "string"
}
},
"required": [
"tournament_key"
],
"type": "object"
},
"name": "delete_tournament",
"outputSchema": {
"additionalProperties": false,
"properties": {
"deleted": {
"type": "boolean"
},
"summary": {
"type": "string"
}
},
"required": [
"deleted",
"summary"
],
"type": "object"
}
},
{
"description": "Finish the tournament. If matches are still pending it ends early and current standings freeze as the final results. Preview first, confirm to apply.",
"inputSchema": {
"properties": {
"confirm": {
"description": "Omit or false: return a preview of what would change. True: apply it.",
"type": "boolean"
},
"request_id": {
"description": "Optional idempotency id — retrying a call with the same id never applies it twice",
"maxLength": 64,
"type": "string"
},
"tournament_key": {
"description": "The tournament's organiser key (starts with tk_)",
"type": "string"
}
},
"required": [
"tournament_key"
],
"type": "object"
},
"name": "end_tournament",
"outputSchema": {
"additionalProperties": false,
"properties": {
"placements": {
"items": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"type": "array"
},
"preview": {
"description": "True when this is a preview — nothing was changed",
"type": "boolean"
},
"status": {
"type": "string"
},
"summary": {
"description": "What happened, in one line",
"type": "string"
}
},
"required": [
"status",
"placements",
"summary"
],
"type": "object"
}
},
{
"description": "Generate (or regenerate) the draw and schedule. This IS the start action: the first draw moves the tournament from setup to active and closes self-signup — when the organiser says \"start the tournament\", call this. The result includes rounds_text — SHOW it to the organiser as-is, in whatever language they are writing to you in (it is English already, so relay it unchanged unless they are writing something else) so they can check who plays whom — and the seed that produced the draw: preview first, then confirm with that SAME seed to apply exactly the previewed draw. Free until the first result is recorded; after that this DISCARDS recorded results and requires BOTH confirm: true and discard_results: true. If the organiser asks for a format that is not supported, offer to note it with record_feedback. Optional overrides adjust the format first.",
"inputSchema": {
"properties": {
"advance_per_group": {
"maximum": 4,
"minimum": 1,
"type": "integer"
},
"confirm": {
"description": "Omit or false: return a preview of what would change. True: apply it.",
"type": "boolean"
},
"discard_results": {
"description": "Required (true) when results already exist — separate acknowledgement that this redraw destroys them",
"type": "boolean"
},
"group_count": {
"maximum": 8,
"minimum": 2,
"type": "integer"
},
"points_per_match": {
"maximum": 64,
"minimum": 4,
"type": "integer"
},
"request_id": {
"description": "Optional idempotency id — retrying a call with the same id never applies it twice",
"maxLength": 64,
"type": "string"
},
"rounds": {
"maximum": 30,
"minimum": 1,
"type": "integer"
},
"seed": {
"description": "Draw seed returned by the preview — pass it back with confirm: true to apply exactly the previewed draw. Omit for a fresh draw.",
"maximum": 2147483647,
"minimum": 0,
"type": "integer"
},
"seeding": {
"enum": [
"random",
"level"
],
"type": "string"
},
"third_place_match": {
"type": "boolean"
},
"tournament_key": {
"description": "The tournament's organiser key (starts with tk_)",
"type": "string"
}
},
"required": [
"tournament_key"
],
"type": "object"
},
"name": "generate_draw",
"outputSchema": {
"additionalProperties": false,
"properties": {
"discarded_results": {
"type": "number"
},
"matches": {
"type": "number"
},
"preview": {
"description": "True when this is a preview — nothing was changed",
"type": "boolean"
},
"rounds_text": {
"type": "string"
},
"seed": {
"type": "number"
},
"summary": {
"description": "What happened, in one line",
"type": "string"
}
},
"required": [
"matches",
"discarded_results",
"rounds_text",
"seed",
"summary"
],
"type": "object"
}
},
{
"description": "Chronological record of every change (newest first) — the answer to \"who changed that?\". Paginate with before_id. Ids are global across all tournaments, so gaps between ids are normal.",
"inputSchema": {
"properties": {
"before_id": {
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"limit": {
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"tournament_key": {
"description": "The tournament's organiser key (starts with tk_)",
"type": "string"
}
},
"required": [
"tournament_key"
],
"type": "object"
},
"name": "get_audit_log",
"outputSchema": {
"additionalProperties": false,
"properties": {
"entries": {
"items": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"type": "array"
},
"next_before_id": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"entries",
"next_before_id"
],
"type": "object"
}
},
{
"description": "Compact full state of the tournament — settings, roster, progress, next matches, standings, page link. Call this first when resuming work in a new conversation with just the key.",
"inputSchema": {
"properties": {
"tournament_key": {
"description": "The tournament's organiser key (starts with tk_)",
"type": "string"
}
},
"required": [
"tournament_key"
],
"type": "object"
},
"name": "get_briefing",
"outputSchema": {
"additionalProperties": false,
"properties": {
"aside": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"fact",
"joke"
],
"type": "string"
},
"lead": {
"type": "string"
},
"text": {
"type": "string"
}
},
"required": [
"kind",
"lead",
"text"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "Present ONLY when the tournament is set up, running, and asking nothing of the organiser — for answering 'what else can you do?', or any moment where they are plainly just chatting. NEVER volunteer it: not as a greeting, not after a result, not alongside a report. Say `lead` then `text`, nothing of your own in between. Both are English already: relay them unchanged unless the organiser is writing to you in another language. If they are, translate `lead` — but translate `text` ONLY when kind is 'fact'. A joke goes out in English word for word, whatever language you are speaking, because translating it destroys it."
},
"courts": {
"items": {
"type": "string"
},
"type": "array"
},
"discipline": {
"type": "string"
},
"format": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"matches_pending": {
"type": "number"
},
"matches_played": {
"type": "number"
},
"name": {
"type": "string"
},
"next_up": {
"items": {
"additionalProperties": false,
"properties": {
"court": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"estimated_start": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"match_id": {
"type": "string"
},
"retired": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"round": {
"type": "number"
},
"score": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"side_a": {
"type": "string"
},
"side_b": {
"type": "string"
},
"state": {
"type": "string"
},
"structure": {
"type": "string"
},
"winner": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"match_id",
"structure",
"round",
"state",
"side_a",
"side_b",
"score",
"winner",
"retired",
"court",
"estimated_start"
],
"type": "object"
},
"type": "array"
},
"page_results_entry": {
"description": "True when anyone with the page link can record scores courtside (the default for new tournaments). Turn it off with update_settings page_results_entry: false.",
"type": "boolean"
},
"page_url": {
"type": "string"
},
"players": {
"items": {
"type": "string"
},
"type": "array"
},
"players_total": {
"type": "number"
},
"signup": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"sport": {
"type": "string"
},
"standings_top": {
"items": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"type": "array"
},
"start_time": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"status": {
"type": "string"
}
},
"required": [
"name",
"sport",
"status",
"discipline",
"courts",
"start_time",
"players_total",
"players",
"matches_played",
"matches_pending",
"next_up",
"standings_top",
"page_url",
"page_results_entry",
"format",
"signup",
"aside"
],
"type": "object"
}
},
{
"description": "Full structured export of the tournament document (players, draws, results) — for the organiser's own records or data portability.",
"inputSchema": {
"properties": {
"tournament_key": {
"description": "The tournament's organiser key (starts with tk_)",
"type": "string"
}
},
"required": [
"tournament_key"
],
"type": "object"
},
"name": "get_export",
"outputSchema": {
"additionalProperties": false,
"properties": {
"tournament": {
"additionalProperties": {},
"properties": {},
"type": "object"
}
},
"required": [
"tournament"
],
"type": "object"
}
},
{
"description": "The printable PDF itself, returned as a base64 embedded resource — use this when the organiser wants the file handed to them and your client cannot fetch URLs. Default \"sheet\": the merged tournament document (match sheet with write-in score boxes, player sheet, standings/results when they exist). \"results\" and \"plan\" are deprecated pre-merge variants kept for comparison. For a lighter response, get_pdf_link returns download URLs instead.",
"inputSchema": {
"properties": {
"doc": {
"enum": [
"sheet",
"results",
"plan"
],
"type": "string"
},
"tournament_key": {
"description": "The tournament's organiser key (starts with tk_)",
"type": "string"
}
},
"required": [
"tournament_key"
],
"type": "object"
},
"name": "get_pdf",
"outputSchema": {
"additionalProperties": false,
"properties": {
"filename": {
"type": "string"
},
"mime_type": {
"type": "string"
},
"pdf_url": {
"type": "string"
},
"size_bytes": {
"type": "number"
}
},
"required": [
"filename",
"mime_type",
"size_bytes",
"pdf_url"
],
"type": "object"
}
},
{
"description": "Download links for the printable PDF. pdf_url is the merged tournament document (match sheet with write-in score boxes, player sheet, standings/results when they exist) — hand this to the organiser. results_pdf_url and plan_pdf_url are deprecated pre-merge variants kept for comparison.",
"inputSchema": {
"properties": {
"tournament_key": {
"description": "The tournament's organiser key (starts with tk_)",
"type": "string"
}
},
"required": [
"tournament_key"
],
"type": "object"
},
"name": "get_pdf_link",
"outputSchema": {
"additionalProperties": false,
"properties": {
"page_url": {
"type": "string"
},
"pdf_url": {
"type": "string"
},
"plan_pdf_url": {
"type": "string"
},
"results_pdf_url": {
"type": "string"
}
},
"required": [
"pdf_url",
"results_pdf_url",
"plan_pdf_url",
"page_url"
],
"type": "object"
}
},
{
"description": "A blank Excel workbook the organiser fills in and hands back: Name, Level, Gender, Comments, one player per row, with a sheet explaining each column. Offer it when the organiser has no list ready, asks how to send their players, or would rather work in a spreadsheet than paste names into chat. Needs no key. The file comes back both as a download link and as an attachable file. Reading a filled-in sheet needs no tool: parse it yourself and send the rows to add_players.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "get_player_template",
"outputSchema": {
"additionalProperties": false,
"properties": {
"columns": {
"items": {
"type": "string"
},
"type": "array"
},
"filename": {
"type": "string"
},
"mime_type": {
"type": "string"
},
"note": {
"type": "string"
},
"size_bytes": {
"type": "number"
},
"template_url": {
"type": "string"
}
},
"required": [
"template_url",
"filename",
"mime_type",
"size_bytes",
"columns",
"note"
],
"type": "object"
}
},
{
"description": "Final placements (or placements-so-far for a tournament that ended early).",
"inputSchema": {
"properties": {
"tournament_key": {
"description": "The tournament's organiser key (starts with tk_)",
"type": "string"
}
},
"required": [
"tournament_key"
],
"type": "object"
},
"name": "get_results",
"outputSchema": {
"additionalProperties": false,
"properties": {
"placements": {
"items": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"type": "array"
},
"status": {
"type": "string"
}
},
"required": [
"status",
"placements"
],
"type": "object"
}
},
{
"description": "Upcoming matches in playing order with courts and estimated times.",
"inputSchema": {
"properties": {
"limit": {
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"tournament_key": {
"description": "The tournament's organiser key (starts with tk_)",
"type": "string"
}
},
"required": [
"tournament_key"
],
"type": "object"
},
"name": "get_schedule",
"outputSchema": {
"additionalProperties": false,
"properties": {
"schedule": {
"items": {
"additionalProperties": false,
"properties": {
"court": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"estimated_start": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"match_id": {
"type": "string"
},
"retired": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"round": {
"type": "number"
},
"score": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"side_a": {
"type": "string"
},
"side_b": {
"type": "string"
},
"state": {
"type": "string"
},
"structure": {
"type": "string"
},
"winner": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"match_id",
"structure",
"round",
"state",
"side_a",
"side_b",
"score",
"winner",
"retired",
"court",
"estimated_start"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"schedule"
],
"type": "object"
}
},
{
"description": "Current standings per group/structure, tiebreak-ordered (wins → head-to-head → set diff → game diff; americano: total points).",
"inputSchema": {
"properties": {
"tournament_key": {
"description": "The tournament's organiser key (starts with tk_)",
"type": "string"
}
},
"required": [
"tournament_key"
],
"type": "object"
},
"name": "get_standings",
"outputSchema": {
"additionalProperties": false,
"properties": {
"standings": {
"items": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"type": "array"
}
},
"required": [
"standings"
],
"type": "object"
}
},
{
"description": "Matches with sides, scores, courts and times. Filter by state or round; paginate with after_match_number for large tournaments.",
"inputSchema": {
"properties": {
"after_match_number": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"limit": {
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"round": {
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"state": {
"enum": [
"scheduled",
"completed",
"walkover",
"retired",
"cancelled",
"bye"
],
"type": "string"
},
"tournament_key": {
"description": "The tournament's organiser key (starts with tk_)",
"type": "string"
}
},
"required": [
"tournament_key"
],
"type": "object"
},
"name": "list_matches",
"outputSchema": {
"additionalProperties": false,
"properties": {
"matches": {
"items": {
"additionalProperties": false,
"properties": {
"court": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"estimated_start": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"match_id": {
"type": "string"
},
"retired": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"round": {
"type": "number"
},
"score": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"side_a": {
"type": "string"
},
"side_b": {
"type": "string"
},
"state": {
"type": "string"
},
"structure": {
"type": "string"
},
"winner": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"match_id",
"structure",
"round",
"state",
"side_a",
"side_b",
"score",
"winner",
"retired",
"court",
"estimated_start"
],
"type": "object"
},
"type": "array"
},
"next_after_match_number": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"required": [
"matches",
"next_after_match_number"
],
"type": "object"
}
},
{
"description": "Full roster with status, level, and doubles partner.",
"inputSchema": {
"properties": {
"tournament_key": {
"description": "The tournament's organiser key (starts with tk_)",
"type": "string"
}
},
"required": [
"tournament_key"
],
"type": "object"
},
"name": "list_players",
"outputSchema": {
"additionalProperties": false,
"properties": {
"players": {
"items": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"type": "array"
},
"total": {
"type": "number"
}
},
"required": [
"players",
"total"
],
"type": "object"
}
},
{
"description": "Health check. Returns a static confirmation that the Turnale MCP server is reachable.",
"inputSchema": {
"properties": {},
"type": "object"
},
"name": "ping",
"outputSchema": {
"additionalProperties": false,
"properties": {
"message": {
"type": "string"
},
"ok": {
"type": "boolean"
}
},
"required": [
"ok",
"message"
],
"type": "object"
}
},
{
"description": "Move a waitlisted player onto the active roster when a spot opens (signed-in players are notified by email). The cap can be raised with update_settings.",
"inputSchema": {
"properties": {
"name": {
"type": "string"
},
"request_id": {
"description": "Optional idempotency id — retrying a call with the same id never applies it twice",
"maxLength": 64,
"type": "string"
},
"tournament_key": {
"description": "The tournament's organiser key (starts with tk_)",
"type": "string"
}
},
"required": [
"tournament_key",
"name"
],
"type": "object"
},
"name": "promote_player",
"outputSchema": {
"additionalProperties": false,
"properties": {
"name": {
"type": "string"
},
"preview": {
"description": "True when this is a preview — nothing was changed",
"type": "boolean"
},
"status": {
"type": "string"
},
"summary": {
"description": "What happened, in one line",
"type": "string"
}
},
"required": [
"name",
"status",
"summary"
],
"type": "object"
}
},
{
"description": "Record a request for something Turnale does not support yet (a format, scoring variant, or feature), so it can be considered for the roadmap. Call this only when the organiser asked for something unsupported AND agreed to have it noted. Describe the missing capability in general terms — NEVER include player names, contact details, or tournament keys.",
"inputSchema": {
"properties": {
"category": {
"enum": [
"unsupported_format",
"scoring_variant",
"feature",
"other"
],
"type": "string"
},
"feedback": {
"description": "What the organiser wanted, summarised without any personal data (max 1000 characters — room for the problem, the workaround tried, and the suggested scope)",
"maxLength": 1000,
"minLength": 10,
"type": "string"
},
"related_tool": {
"description": "The tool this relates to, if any",
"maxLength": 60,
"type": "string"
}
},
"required": [
"category",
"feedback"
],
"type": "object"
},
"name": "record_feedback",
"outputSchema": {
"additionalProperties": false,
"properties": {
"recorded": {
"type": "boolean"
},
"summary": {
"type": "string"
}
},
"required": [
"recorded",
"summary"
],
"type": "object"
}
},
{
"description": "Record one or many results. Score is conversational text: \"6-4 3-6 10-7\" (sets) or \"16-8\" (americano points). Outcomes: completed (default), walkover, retired (partial score allowed), cancelled, reinstate — reinstate CLEARS a recorded result and returns the match to scheduled (the fix for a mis-entered score). Corrections simply re-record. Winner (a|b = first|second listed side) only needed when the score alone does not decide.",
"inputSchema": {
"properties": {
"request_id": {
"description": "Optional idempotency id — retrying a call with the same id never applies it twice",
"maxLength": 64,
"type": "string"
},
"results": {
"items": {
"properties": {
"match_id": {
"type": "string"
},
"outcome": {
"enum": [
"completed",
"walkover",
"retired",
"cancelled",
"reinstate"
],
"type": "string"
},
"score": {
"maxLength": 120,
"type": "string"
},
"winner": {
"enum": [
"a",
"b"
],
"type": "string"
}
},
"required": [
"match_id"
],
"type": "object"
},
"maxItems": 100,
"minItems": 1,
"type": "array"
},
"tournament_key": {
"description": "The tournament's organiser key (starts with tk_)",
"type": "string"
}
},
"required": [
"tournament_key",
"results"
],
"type": "object"
},
"name": "record_results",
"outputSchema": {
"additionalProperties": false,
"properties": {
"preview": {
"description": "True when this is a preview — nothing was changed",
"type": "boolean"
},
"recorded": {
"items": {
"additionalProperties": false,
"properties": {
"court": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"estimated_start": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"match_id": {
"type": "string"
},
"retired": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"round": {
"type": "number"
},
"score": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"side_a": {
"type": "string"
},
"side_b": {
"type": "string"
},
"state": {
"type": "string"
},
"structure": {
"type": "string"
},
"winner": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"match_id",
"structure",
"round",
"state",
"side_a",
"side_b",
"score",
"winner",
"retired",
"court",
"estimated_start"
],
"type": "object"
},
"type": "array"
},
"summary": {
"description": "What happened, in one line",
"type": "string"
}
},
"required": [
"recorded",
"summary"
],
"type": "object"
}
},
{
"description": "Remove one or MANY players before any result is recorded (afterwards use withdraw_player or replace_player) — pass player_names to clear several in one call, never loop one-by-one. Regenerates an existing unlocked draw.",
"inputSchema": {
"properties": {
"player_name": {
"type": "string"
},
"player_names": {
"description": "Bulk removal — e.g. clearing mistaken placeholder names in one call",
"items": {
"type": "string"
},
"maxItems": 128,
"minItems": 1,
"type": "array"
},
"request_id": {
"description": "Optional idempotency id — retrying a call with the same id never applies it twice",
"maxLength": 64,
"type": "string"
},
"tournament_key": {
"description": "The tournament's organiser key (starts with tk_)",
"type": "string"
}
},
"required": [
"tournament_key"
],
"type": "object"
},
"name": "remove_player",
"outputSchema": {
"additionalProperties": false,
"properties": {
"players_total": {
"type": "number"
},
"preview": {
"description": "True when this is a preview — nothing was changed",
"type": "boolean"
},
"promoted": {
"description": "Waitlisted players who took the freed spots",
"items": {
"type": "string"
},
"type": "array"
},
"removed": {
"items": {
"type": "string"
},
"type": "array"
},
"summary": {
"description": "What happened, in one line",
"type": "string"
}
},
"required": [
"players_total",
"removed",
"promoted",
"summary"
],
"type": "object"
}
},
{
"description": "A substitute takes over a player's spot. During play: slot takeover — completed results stay, the change is shown (\"Anna, for Kristjan from R3\"). Before the first result: choose mode slot_swap (default) or regenerate (re-pair and redraw using levels). Unknown substitute names are added to the roster automatically.",
"inputSchema": {
"properties": {
"in_player": {
"properties": {
"gender": {
"enum": [
"m",
"f",
"x"
],
"type": "string"
},
"level": {
"description": "Any consistent numeric level/rating — used only for seeding and balancing",
"maximum": 10000,
"minimum": -10000,
"type": "number"
},
"name": {
"maxLength": 120,
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"mode": {
"enum": [
"slot_swap",
"regenerate"
],
"type": "string"
},
"out_player_name": {
"type": "string"
},
"request_id": {
"description": "Optional idempotency id — retrying a call with the same id never applies it twice",
"maxLength": 64,
"type": "string"
},
"tournament_key": {
"description": "The tournament's organiser key (starts with tk_)",
"type": "string"
}
},
"required": [
"tournament_key",
"out_player_name",
"in_player"
],
"type": "object"
},
"name": "replace_player",
"outputSchema": {
"additionalProperties": false,
"properties": {
"entry": {
"type": "string"
},
"preview": {
"description": "True when this is a preview — nothing was changed",
"type": "boolean"
},
"summary": {
"description": "What happened, in one line",
"type": "string"
}
},
"required": [
"entry",
"summary"
],
"type": "object"
}
},
{
"description": "Shift the start time, add a delay, or move one match to a specific court/slot. Played matches never move.",
"inputSchema": {
"properties": {
"delay_minutes": {
"maximum": 600,
"minimum": 1,
"type": "integer"
},
"move_match": {
"properties": {
"court_name": {
"type": "string"
},
"match_id": {
"type": "string"
},
"slot": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"match_id"
],
"type": "object"
},
"request_id": {
"description": "Optional idempotency id — retrying a call with the same id never applies it twice",
"maxLength": 64,
"type": "string"
},
"start_time": {
"description": "New ISO start time",
"type": "string"
},
"tournament_key": {
"description": "The tournament's organiser key (starts with tk_)",
"type": "string"
}
},
"required": [
"tournament_key"
],
"type": "object"
},
"name": "reschedule",
"outputSchema": {
"additionalProperties": false,
"properties": {
"preview": {
"description": "True when this is a preview — nothing was changed",
"type": "boolean"
},
"start_time": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"summary": {
"description": "What happened, in one line",
"type": "string"
}
},
"required": [
"start_time",
"summary"
],
"type": "object"
}
},
{
"description": "Fix the doubles pairs: pass explicit pairs by name, or auto-pair (random or level-balanced). Only before results exist. Regenerates an existing unlocked draw.",
"inputSchema": {
"properties": {
"auto": {
"enum": [
"random",
"level_balanced"
],
"type": "string"
},
"pairs": {
"description": "Fixed pairs as [name, name] arrays",
"items": {
"items": {
"type": "string"
},
"maxItems": 2,
"minItems": 2,
"type": "array"
},
"type": "array"
},
"request_id": {
"description": "Optional idempotency id — retrying a call with the same id never applies it twice",
"maxLength": 64,
"type": "string"
},
"tournament_key": {
"description": "The tournament's organiser key (starts with tk_)",
"type": "string"
}
},
"required": [
"tournament_key"
],
"type": "object"
},
"name": "set_pairs",
"outputSchema": {
"additionalProperties": false,
"properties": {
"pairs": {
"items": {
"type": "string"
},
"type": "array"
},
"preview": {
"description": "True when this is a preview — nothing was changed",
"type": "boolean"
},
"summary": {
"description": "What happened, in one line",
"type": "string"
}
},
"required": [
"pairs",
"summary"
],
"type": "object"
}
},
{
"description": "Recommend tournament formats in plain language, with the round/time math done by the engine. Call this FIRST when the organiser has not named a format, names one hesitantly, or comes from a background where americano/mexicano need explaining — then relay the `menu` text as-is instead of asking an open 'which format?' question. SINGLES OR DOUBLES IS A PREREQUISITE: omit `discipline` and this returns the question to put to the organiser rather than a menu, because it decides which formats exist at all (americano and mexicano are doubles). Never infer it from the sport. Needs no key.",
"inputSchema": {
"properties": {
"courts": {
"description": "Default 2",
"maximum": 16,
"minimum": 1,
"type": "integer"
},
"discipline": {
"description": "Ask the organiser before offering formats; never infer it from the sport. 'unknown' = you asked and they don't mind, which shows both kinds. OMIT to get the question itself back.",
"enum": [
"singles",
"doubles",
"unknown"
],
"type": "string"
},
"fixed_partners": {
"description": "Doubles only: do pairs stay together all evening?",
"type": "boolean"
},
"match_minutes": {
"maximum": 240,
"minimum": 5,
"type": "integer"
},
"players_estimate": {
"maximum": 128,
"minimum": 2,
"type": "integer"
},
"total_minutes": {
"description": "The time budget, e.g. 120 for a two-hour evening",
"maximum": 600,
"minimum": 30,
"type": "integer"
},
"vibe": {
"description": "Social: everyone mixes and plays a lot. Competitive: a bracket and a winner.",
"enum": [
"social",
"competitive"
],
"type": "string"
}
},
"required": [
"players_estimate"
],
"type": "object"
},
"name": "suggest_format",
"outputSchema": {
"additionalProperties": false,
"properties": {
"glossary": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"menu": {
"description": "Ready-to-show menu of the options — relay it to the organiser as-is. Do not compress it to bare format names.",
"type": "string"
},
"note": {
"type": "string"
},
"recommendations": {
"items": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"type": "array"
}
},
"required": [
"recommendations",
"glossary",
"menu",
"note"
],
"type": "object"
}
},
{
"description": "Exchange two players' places. Fixed-pair doubles: swaps partners between two pairs permanently (name one player from each pair). Americano/mexicano: pass `round` to swap two players' places in ONE unplayed round — the courtside patch for a late arrival, an injury, or two friends who want a game together. One of them may be sitting that round, which is how you put a late arrival on court. Preview first, confirm to apply: the preview names any partnership or meeting the swap would repeat. Results already played never move.",
"inputSchema": {
"properties": {
"confirm": {
"description": "Omit or false: return a preview of what would change. True: apply it.",
"type": "boolean"
},
"player_a": {
"type": "string"
},
"player_b": {
"type": "string"
},
"request_id": {
"description": "Optional idempotency id — retrying a call with the same id never applies it twice",
"maxLength": 64,
"type": "string"
},
"round": {
"description": "Americano/mexicano only: which round to patch. Omit to swap the next unplayed round.",
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"tournament_key": {
"description": "The tournament's organiser key (starts with tk_)",
"type": "string"
}
},
"required": [
"tournament_key",
"player_a",
"player_b"
],
"type": "object"
},
"name": "swap_partners",
"outputSchema": {
"additionalProperties": false,
"properties": {
"pairs": {
"items": {
"type": "string"
},
"type": "array"
},
"preview": {
"description": "True when this is a preview — nothing was changed",
"type": "boolean"
},
"repeats_meeting": {
"items": {
"type": "string"
},
"type": "array"
},
"repeats_partnership": {
"items": {
"type": "string"
},
"type": "array"
},
"round": {
"type": "number"
},
"summary": {
"description": "What happened, in one line",
"type": "string"
}
},
"required": [
"summary"
],
"type": "object"
}
},
{
"description": "Roll the tournament back. Without to_change_id: restore exactly how it was before the most recent change (tool call or courtside page entry). With to_change_id (an id from get_audit_log): restore to just before that change — it and every later change are discarded in one step, so a burst of unwanted calls unwinds with a single revert. Preview lists exactly what would be discarded; confirm: true applies. A follow-up plain undo restores what the previous undo discarded.",
"inputSchema": {
"properties": {
"confirm": {
"description": "Omit or false: return a preview of what would change. True: apply it.",
"type": "boolean"
},
"request_id": {
"description": "Optional idempotency id — retrying a call with the same id never applies it twice",
"maxLength": 64,
"type": "string"
},
"to_change_id": {
"description": "A change id from get_audit_log — restore to just before this change, discarding it and everything after it. Omit to undo only the latest change.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"tournament_key": {
"description": "The tournament's organiser key (starts with tk_)",
"type": "string"
}
},
"required": [
"tournament_key"
],
"type": "object"
},
"name": "undo_last_change",
"outputSchema": {
"additionalProperties": false,
"properties": {
"discarded": {
"description": "Every change this rollback discards, oldest first",
"items": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"type": "array"
},
"discarded_count": {
"type": "number"
},
"preview": {
"description": "True when this is a preview — nothing was changed",
"type": "boolean"
},
"summary": {
"description": "What happened, in one line",
"type": "string"
},
"undone_at": {
"type": "string"
},
"undone_summary": {
"type": "string"
},
"undone_tool": {
"description": "Tool behind the earliest discarded change",
"type": "string"
}
},
"required": [
"undone_tool",
"undone_summary",
"undone_at",
"discarded_count",
"discarded",
"summary"
],
"type": "object"
}
},
{
"description": "Rename a player or set their gender/level/note. Updates MANY in one call: pass `updates` with one object per player and never loop one-by-one — setting levels for a whole roster used to be one call per player, which on a phone meant approving each one and left the roster half-updated when some were mis-tapped. The whole batch applies or none of it does.",
"inputSchema": {
"properties": {
"gender": {
"enum": [
"m",
"f",
"x"
],
"type": "string"
},
"level": {
"description": "Any consistent numeric level/rating — used only for seeding and balancing",
"maximum": 10000,
"minimum": -10000,
"type": "number"
},
"new_name": {
"maxLength": 120,
"type": "string"
},
"note": {
"description": "Free note shown on the tournament page. Pass an empty string to clear it.",
"maxLength": 500,
"type": "string"
},
"player_name": {
"description": "Single update; or use `updates` for several",
"type": "string"
},
"request_id": {
"description": "Optional idempotency id — retrying a call with the same id never applies it twice",
"maxLength": 64,
"type": "string"
},
"tournament_key": {
"description": "The tournament's organiser key (starts with tk_)",
"type": "string"
},
"updates": {
"description": "Bulk edit — e.g. levels for a whole roster in one call",
"items": {
"properties": {
"gender": {
"enum": [
"m",
"f",
"x"
],
"type": "string"
},
"level": {
"description": "Any consistent numeric level/rating — used only for seeding and balancing",
"maximum": 10000,
"minimum": -10000,
"type": "number"
},
"new_name": {
"maxLength": 120,
"type": "string"
},
"note": {
"description": "Free note shown on the tournament page. Pass an empty string to clear it.",
"maxLength": 500,
"type": "string"
},
"player_name": {
"type": "string"
}
},
"required": [
"player_name"
],
"type": "object"
},
"maxItems": 128,
"minItems": 1,
"type": "array"
}
},
"required": [
"tournament_key"
],
"type": "object"
},
"name": "update_player",
"outputSchema": {
"additionalProperties": false,
"properties": {
"player": {
"type": "string"
},
"players": {
"items": {
"type": "string"
},
"type": "array"
},
"preview": {
"description": "True when this is a preview — nothing was changed",
"type": "boolean"
},
"summary": {
"description": "What happened, in one line",
"type": "string"
}
},
"required": [
"players",
"summary"
],
"type": "object"
}
},
{
"description": "Change the tournament name, start time, match duration, break/changeover minutes, courts (count or names), house rules, or courtside score entry from the page. Court changes recompute the remaining schedule; played matches never move.",
"inputSchema": {
"properties": {
"break_minutes": {
"description": "Changeover between matches/rounds, shown separately from play time",
"maximum": 60,
"minimum": 0,
"type": "integer"
},
"court_names": {
"items": {
"maxLength": 60,
"type": "string"
},
"maxItems": 16,
"type": "array"
},
"courts": {
"maximum": 16,
"minimum": 1,
"type": "integer"
},
"gender_balance": {
"description": "Americano/mexicano: prefer matches where both teams have the same make-up (MM v MM, MW v MW, WW v WW). Default prefer_symmetric. A preference, not a rule — an uneven field cannot supply it, and the draw says so rather than distorting the rotation.",
"enum": [
"prefer_symmetric",
"off"
],
"type": "string"
},
"house_rules": {
"items": {
"maxLength": 200,
"type": "string"
},
"maxItems": 12,
"type": "array"
},
"language": {
"description": "Page/PDF/email language, ISO 639-1 (default en)",
"enum": [
"en",
"bg",
"hr",
"cs",
"da",
"nl",
"et",
"fi",
"fr",
"de",
"el",
"hu",
"it",
"lv",
"lt",
"nb",
"pl",
"ro",
"sk",
"sl",
"sv",
"uk",
"es",
"pt",
"ar",
"bn",
"zh",
"hi",
"id",
"ja",
"ko",
"ru",
"tr",
"ur",
"vi"
],
"type": "string"
},
"level_gap_cap": {
"description": "Opt-in: the largest level gap the organiser wants between opponents, in their own level units. Soft — the draw prefers to respect it and reports when it cannot. Pass 0 to clear.",
"maximum": 1000,
"minimum": 0,
"type": "number"
},
"level_offset": {
"description": "by_group only: how much stronger an m is than an f carrying the SAME number, in the organiser's own level units. Default 1 — a starting point to adjust, not a fact. Used for balancing only; never shown on the page or in standings.",
"maximum": 1000,
"minimum": 0,
"type": "number"
},
"level_scale": {
"description": "How to read the numbers in `level`. absolute (default): one shared scale, a 3 is a 3 whoever holds it. by_group: men and women were each rated within their own group, so the numbers are not directly comparable — ask the organiser which they did rather than guessing. ignore: the numbers are notes, never used for the draw.",
"enum": [
"absolute",
"by_group",
"ignore"
],
"type": "string"
},
"location": {
"description": "Venue/location shown to players; pass an empty string to clear it",
"maxLength": 160,
"type": "string"
},
"match_duration_minutes": {
"maximum": 240,
"minimum": 5,
"type": "integer"
},
"name": {
"maxLength": 120,
"type": "string"
},
"page_results_entry": {
"description": "Allow anyone with the page link to enter scores courtside. ON for new tournaments — pass false when the organiser wants to be the only one recording results, true to hand it back to the players.",
"type": "boolean"
},
"request_id": {
"description": "Optional idempotency id — retrying a call with the same id never applies it twice",
"maxLength": 64,
"type": "string"
},
"signup_cap": {
"maximum": 128,
"minimum": 4,
"type": "integer"
},
"signup_open": {
"description": "Open or close self-signup on the page",
"type": "boolean"
},
"start_time": {
"description": "ISO datetime with offset. Must be within 365 days from today.",
"type": "string"
},
"tournament_key": {
"description": "The tournament's organiser key (starts with tk_)",
"type": "string"
}
},
"required": [
"tournament_key"
],
"type": "object"
},
"name": "update_settings",
"outputSchema": {
"additionalProperties": false,
"properties": {
"courts": {
"items": {
"type": "string"
},
"type": "array"
},
"preview": {
"description": "True when this is a preview — nothing was changed",
"type": "boolean"
},
"promoted": {
"description": "Waitlisted players a raised cap let in",
"items": {
"type": "string"
},
"type": "array"
},
"summary": {
"description": "What happened, in one line",
"type": "string"
}
},
"required": [
"courts",
"promoted",
"summary"
],
"type": "object"
}
},
{
"description": "Withdraw a player (or their pair) mid-tournament. Remaining matches become walkovers for the opponents; americano regenerates its future rounds instead. Preview first, confirm to apply.",
"inputSchema": {
"properties": {
"confirm": {
"description": "Omit or false: return a preview of what would change. True: apply it.",
"type": "boolean"
},
"player_name": {
"type": "string"
},
"request_id": {
"description": "Optional idempotency id — retrying a call with the same id never applies it twice",
"maxLength": 64,
"type": "string"
},
"tournament_key": {
"description": "The tournament's organiser key (starts with tk_)",
"type": "string"
}
},
"required": [
"tournament_key",
"player_name"
],
"type": "object"
},
"name": "withdraw_player",
"outputSchema": {
"additionalProperties": false,
"properties": {
"affected_matches": {
"type": "number"
},
"preview": {
"description": "True when this is a preview — nothing was changed",
"type": "boolean"
},
"summary": {
"description": "What happened, in one line",
"type": "string"
}
},
"required": [
"affected_matches",
"summary"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:aa30047788db743d60cafc0b3f6932a2add792a77f647019f81a3490bec4c521 | sha256sum