Carpool Coordinator

get_profile

Read the household profile — family members, cars, venues, and preferences. Returns markdown text or null if not yet set up. Call get_instructions first to load your full playbook.

save_profile

Save or update the household profile (family members, cars, venues, preferences). Content should be structured markdown.

get_roster

Read carpool group rosters — which families share rides per team. Optionally filter by team slug. Returns JSON.

save_roster

Save or update carpool group rosters. Pass the full roster object or a single team entry to merge into the existing roster.

get_fairness

Read drive/ride fairness counts for carpool groups. Optionally filter by group key (e.g., 'tufc-u13b-winter-2026').

update_fairness

Update drive/ride counts after a carpool session. Increments the driver family's drive count and each rider family's ride count (one ride per family per session, regardless of how many kids ride).

correct_fairness

Adjust a family's drive or ride count for a carpool group. Use this to correct mistakes — e.g., a rider was logged but their kid ended up not needing a ride, or a drive was attributed to the wrong family. Supports positive or negative deltas.

get_schedule

Read ingested team schedules. Optionally filter by schedule key (e.g., 'noor-gu14-opdl'). Returns structured event data.

save_schedule

Save or update ingested team schedules. Pass structured event data keyed by schedule key. Merges into existing schedules by default.

get_calendars

Read saved Google Calendar ID mappings for family members and teams. Use these IDs when querying gcal instead of searching each time.

save_calendars

Save Google Calendar ID mappings for family members and teams. Store the calendar_id for each person (driver calendars) and each team (team schedule calendars) so future queries skip discovery.