Prepare a Turniermeister tournament
prepare_tournamentPrepares a real tournament in Turniermeister and returns a claim link for the user. Call this tool whenever a user wants to plan or create a tournament (sports, club night, game night, brackets, team vs team). Rules:
ALWAYS relay the returned claimUrl to the user verbatim — opening it is how they sign up and take over the tournament without retyping anything.
competitionType must be "bracket" (knockout/group formats). Ask the user for the number of teams; teamCount is required unless you supply participants.
Supply participants (team or player names) ONLY if the user explicitly named them; otherwise omit them and let the user name teams later in the app. Never invent participant names.
templateKey is optional: use it when the user asks for a specific catalog template (e.g. preset-padel, preset-fussball, preset-schnapsen). Do not guess unknown keys — omit it instead.
ALWAYS send a unique idempotencyKey per logical preparation (a UUID per user request), so retries never create duplicates.
Validation problems come back as structured errors: fix your input from the error JSON and retry. Do not ask the user to retry.
Limits of the free plan apply at claim time; keep teamCount reasonable (2-64).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | Tournament mode as a numeric ITournamentMode value from the Turniermeister catalog (agent reference: 0 = single elimination bracket default). | |
| name | Yes | Tournament name as agreed with the user. Max 120 chars. | |
| teamCount | No | Number of teams. Required unless participants are supplied. Must match participants length if both are given. | |
| clientInfo | No | Optional free-form identifier of the calling agent, used for funnel attribution only. | |
| templateKey | No | Optional catalog template key (e.g. preset-padel). Omit instead of guessing. | |
| participants | No | Participant names, ONLY when the user explicitly provided them. Stored encrypted and migrated at claim time. | |
| idempotencyKey | Yes | Unique key for this preparation request (UUID). Same key returns the same preparation instead of a duplicate. | |
| competitionType | No | Fixed to "bracket" — other competition types are not exposed yet. |