# TeamUp

> TeamUp is an AI assistant that organizes amateur sports games directly inside a team's Telegram or VK group chat — sign-ups, team splitting, dues, and the live match score — with an optional iPhone & Apple Watch companion app (TeamUp Live) for scoring on the pitch. It also runs a public Model Context Protocol (MCP) server, so external AI agents can drive the very same tools.

TeamUp lives where teams already chat. An organizer adds the bot to a group; players sign up by writing an ordinary message (a simple "+"), and the assistant keeps the roster, balances the teams, tracks who has paid, and posts the live score and commentary during the match. No buttons, no forms, nothing for players to install.

## For AI agents and MCP clients

TeamUp is agent-friendly: the same actions the in-chat assistant performs are available to any MCP-compatible client over an authenticated endpoint.

- [MCP endpoint](https://team-up.tgmbot.com/mcp): a Streamable-HTTP Model Context Protocol server. Tools cover events (create, list, snapshot), rollcall (register participants by stable badge number), team splitting, dues, spreadsheet export, and live event logging / scoring. OAuth 2.1 authorization with dynamic client registration.
- [MCP setup guide](https://team-up.tgmbot.com/en/mcp): how to connect an MCP client (Claude, Cursor, and others) and obtain a token in the browser.

## Getting started

- [Get started (English)](https://team-up.tgmbot.com/en/docs/get-started): five minutes from adding the bot to a full game — sign-ups, teams, score and dues, shown as one real chat conversation.
- [С чего начать (Russian)](https://team-up.tgmbot.com/ru/docs/get-started): the same guide in Russian.

## Developer documentation

English-only developer docs, generated from the server source on every build:

- [Docs overview](https://team-up.tgmbot.com/en/docs): which API surface fits which job.
- [MCP API reference](https://team-up.tgmbot.com/en/docs/mcp): every tool with input schemas, annotations and authorization requirements.
- [GraphQL API](https://team-up.tgmbot.com/en/docs/graphql): the contract behind the web and iOS apps; downloadable SDL schema at https://team-up.tgmbot.com/docs/graphql-schema.gql (introspection is disabled in production).
- [Spreadsheet CSV export](https://team-up.tgmbot.com/en/docs/sheets-export): live CSV feeds for Google Sheets / Excel — events, attendance, player stats, dues, cash ledger.

## Product

- [Home](https://team-up.tgmbot.com/en/): what TeamUp does, for organizers and for players.
- [TeamUp Live on the App Store](https://apps.apple.com/us/app/teamup-live/id6762489462): the standalone iPhone & Apple Watch app for live scoring (Android coming).

## Where it runs

- Telegram and VK group chats — the assistant, for everyone, with nothing to install.
- iPhone & Apple Watch — the optional TeamUp Live app, for the organizer to score live on the pitch.

## Languages

Available in 12 languages: English, Русский, Español, Deutsch, Français, Português (BR), Italiano, 简体中文, 日本語, 한국어, Türkçe, Polski.

## Optional

- [Privacy policy](https://team-up.tgmbot.com/en/privacy)