list_tournaments
Retrieve a complete list of all FIFA World Cup tournaments from 1930 to 2026, including host countries and champions.
Instructions
List every FIFA World Cup tournament (1930 → 2026) with year, host country list, champion (or null for the upcoming 2026 cup). Useful as a starting point when the user is exploring history or needs to disambiguate a year.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/index.ts:113-122 (registration)The 'list_tournaments' tool is defined as part of the 'tools' array. It has a name, description, empty zod schema (no arguments), and a handler that calls the api('/tournaments') endpoint. This is both the registration and the handler definition since everything is in one file.
const tools = [ { name: 'list_tournaments', description: 'List every FIFA World Cup tournament (1930 → 2026) with year, host country list, ' + 'champion (or null for the upcoming 2026 cup). Useful as a starting point when the ' + 'user is exploring history or needs to disambiguate a year.', schema: z.object({}).strict(), handler: async () => api('/tournaments'), }, - src/index.ts:121-121 (handler)The handler for 'list_tournaments' is an async arrow function that calls api('/tournaments'), which makes a GET request to the base API path /fifa/worldcup/v1/tournaments.
handler: async () => api('/tournaments'), - src/index.ts:120-120 (schema)The input schema for 'list_tournaments' is an empty strict zod object (z.object({}).strict()), meaning no arguments are accepted.
schema: z.object({}).strict(),