# Copa do Mundo 2026 — how to use (mcp.ai)

Schedules and results for the 2026 FIFA World Cup in natural language: today's matches, kickoff times, scores, groups, standings, the knockout bracket, teams and stadiums. Data updates automatically during the tournament. Free.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_worldcup?ms=1781698980000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `worldcup_bracket`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/worldcup`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/worldcup/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/worldcup/bracket` — Chaveamento do mata-mata (16 avos até a final) com os confrontos e os classificados conhecidos. Use para 'como está o chaveamento'.
  - body: { stage?: string }
- `POST https://api.mcp.ai/api/worldcup/groups` — Composição dos grupos (12 grupos de 4 seleções) com as equipes e os jogos de cada grupo. Use para 'quem está no grupo do Brasil'.
  - body: { group?: string }
- `POST https://api.mcp.ai/api/worldcup/matches` — Jogos da Copa do Mundo 2026 com placar e horário. Filtre por data (YYYY-MM-DD), seleção, grupo, fase ou status. Sem filtro, retorna os jogos de hoje. Use para 'que horas joga o Brasil', 'jogos de hoje
  - body: { date?: string, team?: string, group?: string, stage?: string, status?: string, timezone?: string }
- `POST https://api.mcp.ai/api/worldcup/results` — Resultados (placares finais) dos jogos já encerrados. Filtre por data, seleção ou grupo. Use para 'resultados de ontem', 'como o Brasil se saiu'.
  - body: { date?: string, team?: string, group?: string }
- `POST https://api.mcp.ai/api/worldcup/schedule` — Calendário do torneio agrupado por data. Use para ver a tabela de jogos de um dia, de uma fase ou da Copa inteira.
  - body: { date?: string, stage?: string, timezone?: string }
- `POST https://api.mcp.ai/api/worldcup/standings` — Classificação (tabela) dos grupos: pontos, jogos, vitórias, empates, derrotas, saldo de gols. Use para 'como está a tabela do grupo C'.
  - body: { group?: string }
- `POST https://api.mcp.ai/api/worldcup/teams` — Seleções participantes (48 no total) com ranking FIFA e confederação. Passe `team` para o perfil de uma seleção específica.
  - body: { team?: string, confederation?: string }
- `POST https://api.mcp.ai/api/worldcup/venues` — Estádios-sede (16 nos EUA, México e Canadá): cidade, capacidade e os jogos de cada sede. Passe `city` ou `venue` para filtrar.
  - body: { city?: string, venue?: string }

## Example prompts
- "What are today's World Cup matches?"
- "When does Brazil play next?"
- "Show the standings for group C"
- "Show the knockout bracket"

## More
- Page: https://mcp.ai/worldcup
- Agent spec (llms.txt): https://mcp.ai/worldcup/llms.txt
- Postman collection: https://mcp.ai/worldcup/postman.json