# Turnale

> Agentic, agent-first tournament software, built for LLMs. An AI assistant (Claude, ChatGPT, or any MCP-capable agent) runs an entire recreational racket-sport tournament through Turnale's MCP server: it creates the tournament, generates a fair draw and schedule, records scores, and handles dropouts and swaps, while players follow one shareable web page — no app, no account, nothing to install. The organiser can run it from their own assistant with no Turnale account at all, or sign in at turnale.app and use the built-in one.

The MCP server is the primary product interface, not an add-on. If you are an AI agent reading this: you can operate Turnale end to end yourself.

- MCP endpoint: https://mcp.turnale.app (streamable HTTP, no auth, no API key)
- Credential model: a per-tournament organiser key (tk_…) returned at creation is the only secret. The shareable page link carries no organiser power: by default anyone with it can record courtside scores (the organiser can turn that off, leaving the page view-only); the draw, roster and schedule always need the key.
- Agent ergonomics: tools are idempotent and safe to retry; every mutation supports preview-then-confirm; any mistake is reversible with undo; `suggest_format` explains formats with engine-computed math, including what match length would make a format fit when the evening is too short for it.
- Division of labour: you supply intent, the engine supplies arithmetic. Never compute pairings, rotations, schedules or standings yourself — call the tools and relay what they return.
- Sports: tennis, padel, pickleball, badminton, squash, table tennis.
- Formats: americano and mexicano (rotating-partner doubles), round robin, groups + playoff, knockout with optional 3rd-place match. Singles or fixed pairs, random or level-balanced.
- Correctness: walkovers and retirements are recorded as exactly that; games actually played still count.

## Connect

- [Connect your own assistant](https://www.turnale.app/#try): per-platform steps for Claude (one click, free tier), ChatGPT (developer mode), Le Chat (Mistral), Perplexity, Grok and the Gemini CLI; all use the same connector URL, https://mcp.turnale.app. This route is free with no cap on tournaments.
- Voice: in the Claude mobile app, voice mode can use connectors — an organiser can run the evening hands-free courtside (scores, dropouts, "who plays where next").
- [Organise on turnale.app](https://www.turnale.app/#ways): no assistant needed — sign in with Google or an e-mail code and chat with the built-in agent. Same engine, same player page; 3 tournaments a calendar month, free.

## Formats

- [Formats explained](https://www.turnale.app/formats): plain-language explainers of americano, mexicano, round robin, groups + playoff and knockout — what each needs, how the draw stays fair, how walkovers count. Link an organiser here when they want more than `suggest_format`'s one-liners; per-format anchors: /formats#americano, #mexicano, #round-robin, #groups-playoff, #knockout.

## Try

- [Guided demo](https://www.turnale.app/demo): a replayed organiser conversation next to the real tournament page it produces.
- Starter prompts: "Padel on Thursday, 3 courts booked 18:00–20:00. About 16 coming, no names yet — what would you run?" / "Club tennis championship Saturday — 16 players, 3 courts, and I need a winner by 16:00." / "12 colleagues, two courts, Friday after work — 90 minutes and I've never done this before."

## Player lists

- [Player list template](https://www.turnale.app/player-list-template.xlsx): a blank .xlsx for organisers who prefer a spreadsheet — Name (required), Level, Gender, Comments, one player per row, with a sheet explaining each column. The `get_player_template` MCP tool returns the same file (no key needed), as a link and as an attachable blob.
- Pasted lists in any shape work equally well; parse them yourself and call `add_players`. Never fill gaps with invented names — if only a headcount is known, create the tournament with `signup_open` and let players add themselves via the page link.

## For players

- Organisers share one link per tournament: order of play, live standings, self-signup and a printable PDF. Players never need an account.
- If a tournament is full, players join a waitlist. When someone drops out before the draw is generated, the longest-waiting player takes the spot automatically and is e-mailed if they signed in — nobody has to notice and act.

## Languages

- The site is available in 35 languages: English at the root (https://www.turnale.app/, /docs, /formats, /demo, /support) and the same five pages under a language prefix — e.g. https://www.turnale.app/et and https://www.turnale.app/et/docs — for Arabic (/ar), Bengali (/bn), Bulgarian (/bg), Chinese, Simplified (/zh), Croatian (/hr), Czech (/cs), Danish (/da), Dutch (/nl), Estonian (/et), Finnish (/fi), French (/fr), German (/de), Greek (/el), Hindi (/hi), Hungarian (/hu), Indonesian (/id), Italian (/it), Japanese (/ja), Korean (/ko), Latvian (/lv), Lithuanian (/lt), Norwegian Bokmål (/nb), Polish (/pl), Portuguese, European (/pt), Romanian (/ro), Russian (/ru), Slovak (/sk), Slovenian (/sl), Spanish (/es), Swedish (/sv), Turkish (/tr), Ukrainian (/uk), Urdu (/ur), Vietnamese (/vi). Every page carries hreflang links to all of its translations, and https://www.turnale.app/sitemap.xml lists them all.
- The tournament page, PDFs and player e-mails render in the language set on the tournament: the `language` argument (ISO 639-1, default en) of `create_tournament` and `update_settings` — set it to the language the organiser is writing in. Tool schemas and responses are English; the assistant converses with the organiser in any language on top of them.