get_event_simple
Read-onlyIdempotent
Retrieve a compact FRC event profile (key, name, code, type, location, dates, year) without district, webcast, division, or playoff metadata.
Instructions
Retrieve a reduced FRC event profile (key, name, event_code, type, location, dates, year). Lighter than get_event; use when district, webcast, division, and playoff metadata are not needed.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| event_key | Yes | TBA event key combining the season year and event code (e.g., '2023casj' for the 2023 Silicon Valley Regional, '2024txhou' for the 2024 Houston Championship, '2024micmp4' for a Michigan State Championship division). Use get_events or get_events_keys to discover valid event keys for a year. |
Implementation Reference
- src/handlers.ts:556-568 (handler)Handler for 'get_event_simple' tool. Parses event_key from args, calls TBA API /event/{event_key}/simple, validates response with EventSimpleSchema, returns JSON stringified result.
case 'get_event_simple': { const { event_key } = z.object({ event_key: EventKeySchema }).parse(args); const data = await makeApiRequest(`/event/${event_key}/simple`); const event = EventSimpleSchema.parse(data); return { content: [ { type: 'text', text: JSON.stringify(event, null, 2), }, ], }; } - src/schemas.ts:649-651 (schema)Input schema for get_event_simple. Accepts an event_key string validated by EventKeySchema (regex pattern for TBA event keys like '2023casj').
export const GetEventSimpleInputSchema = z.object({ event_key: EventKeySchema, }); - src/tools.ts:312-318 (registration)Tool registration entry for 'get_event_simple' in the tools array. Defines name, description, input schema reference, and read-only annotations.
{ name: 'get_event_simple', description: 'Retrieve a reduced FRC event profile (key, name, event_code, type, location, dates, year). Lighter than get_event; use when district, webcast, division, and playoff metadata are not needed.', inputSchema: toMCPSchema(GetEventSimpleInputSchema), annotations: { ...READ_ONLY_API, title: 'Get FRC Event Details (Simple)' }, },