get_event
Retrieve a single FRC event's metadata, team statistics, and predictions using its event key. Get details like location, dates, and winner probabilities.
Instructions
Look up a single FIRST Robotics Competition (FRC) event by its event key. Returns metadata (event name, year, week, type, location, dates, district), aggregate EPA stats for participating teams, qualification and playoff status, and Statbotics predictions for the event (e.g. winner probabilities). Event keys follow the format <year><event-code>, e.g. "2024flor" (FLOR = Orlando regional 2024), "2024necmp" (New England district championship 2024), "2024cmptx" (Houston champs 2024). Use this to answer "what happened at 2024flor?", "show predictions for 2024cmptx", or to get context (week, type, location) for an event you have the key for. For browsing events by season, district, or week, use get_events.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| event | Yes | Event key, e.g. 2024flor |
Implementation Reference
- src/handlers.ts:128-134 (handler)The get_event handler: parses input via GetEventInputSchema, calls the Statbotics API at /v3/event/{event}, and returns the event data as JSON.
case 'get_event': { const { event } = GetEventInputSchema.parse(args); const data = await makeApiRequest(`/v3/event/${event}`); return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }], }; } - src/schemas.ts:137-139 (schema)The GetEventInputSchema Zod schema: validates input with a single required 'event' field of type string (EventKeySchema).
export const GetEventInputSchema = z.object({ event: EventKeySchema, }); - src/tools.ts:134-151 (registration)The tool registration/definition for 'get_event' in the tools array, including name, description, annotations, and inputSchema.
{ name: 'get_event', description: 'Look up a single FIRST Robotics Competition (FRC) event by its event key. ' + 'Returns metadata (event name, year, week, type, location, dates, district), aggregate EPA stats for ' + 'participating teams, qualification and playoff status, and Statbotics predictions for the event ' + '(e.g. winner probabilities). ' + 'Event keys follow the format `<year><event-code>`, e.g. "2024flor" (FLOR = Orlando regional 2024), ' + '"2024necmp" (New England district championship 2024), "2024cmptx" (Houston champs 2024). ' + 'Use this to answer "what happened at 2024flor?", "show predictions for 2024cmptx", or to get ' + 'context (week, type, location) for an event you have the key for. ' + 'For browsing events by season, district, or week, use get_events.', annotations: { title: 'Get FRC Event Details (Single Event)', ...readOnlyAnnotations, }, inputSchema: toMCPSchema(GetEventInputSchema), }, - src/utils.ts:23-28 (helper)The makeApiRequest helper function used by the handler to make HTTP GET requests to the Statbotics API.
export async function makeApiRequest(endpoint: string): Promise<unknown> { try { const url = `https://api.statbotics.io${endpoint}`; const response = await fetch(url, { headers: {