Lodi Kids Activities

Search youth programs in Lodi, CA. Filter by free-text query (program name or description), category (Sports, Music, Arts, Academics, Swimming, etc.), child age (integer in years — programs that accept that age), free-only flag, or season. Returns up to 15 matching programs with full details for decision-making (cost, schedule, location, registration status).

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free-text search across program name + description (case-insensitive substring match)."
    },
    "category": {
      "type": "string",
      "description": "Program category. Common values: Sports, Music, Arts, Academics, Swimming, Gymnastics, Dance, Enrichment, Free Programs."
    },
    "age": {
      "type": "integer",
      "description": "Child age in years. Returns programs whose age range includes this age.",
      "minimum": 0,
      "maximum": 18
    },
    "free_only": {
      "type": "boolean",
      "description": "If true, only return programs with $0 cost."
    },
    "season": {
      "type": "string",
      "description": "Filter by season — e.g. 'Summer', 'Fall', 'Spring', 'Winter', 'Year-Round'."
    },
    "limit": {
      "type": "integer",
      "description": "Max programs to return (1-30). Default 15.",
      "minimum": 1,
      "maximum": 30
    }
  }
}

Get full details for a single program by slug. Use this after `search_programs` returned a result and the user wants to know more — full description, schedule, registration timing, contact info.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Program slug from search_programs results (e.g. 'lodi-fc-competitive-soccer')."
    }
  },
  "required": [
    "slug"
  ]
}

Search licensed daycares in Lodi, CA. Filter by child age (in MONTHS — daycares think in months for under-5s), program kind (daycare / preschool / after_school), facility setting (in_home / center), or claimed-only (more reliable data). Returns up to 10 daycares with hours + tuition where available. For subsidy / bilingual / curriculum filters, follow up with `get_daycare` on a slug.

{
  "type": "object",
  "properties": {
    "age_months": {
      "type": "integer",
      "description": "Child age in months. Returns daycares whose licensed age range includes this age. Daycares without ages_min/max populated are kept (we don't know they DON'T serve this age).",
      "minimum": 0,
      "maximum": 144
    },
    "program_kind": {
      "type": "string",
      "enum": [
        "daycare",
        "preschool",
        "after_school"
      ],
      "description": "Filter by program kind."
    },
    "setting": {
      "type": "string",
      "enum": [
        "in_home",
        "center"
      ],
      "description": "Filter by facility setting. 'in_home' is a family child care home (smaller, residential). 'center' is a commercial facility."
    },
    "claimed_only": {
      "type": "boolean",
      "description": "If true, only return daycares whose owner has claimed the listing (more accurate data + reliable contact channel)."
    },
    "limit": {
      "type": "integer",
      "description": "Max daycares to return (1-25). Default 10.",
      "minimum": 1,
      "maximum": 25
    }
  }
}

Get full details for a single daycare by slug, including capacity by age band (infant / toddler / 2s / 3s / 4s / pre-K / kindergarten) when the daycare has filled it in. Use after `search_daycares` to surface specifics.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Daycare slug from search_daycares results."
    }
  },
  "required": [
    "slug"
  ]
}

List upcoming family events in Lodi, CA — open houses, workshops, community days, storytimes, sports clinics. Different from `search_programs` (ongoing classes) — these are single-day or short-window events.

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "description": "Filter by event category: workshop, open_house, community, showcase, fundraiser, camp_session, storytime, sports_clinic."
    },
    "limit": {
      "type": "integer",
      "description": "Max events to return (1-30). Default 10.",
      "minimum": 1,
      "maximum": 30
    }
  }
}

Get full details for a single event by slug. Use after `list_upcoming_events`.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Event slug."
    }
  },
  "required": [
    "slug"
  ]
}

Returns the distinct program categories currently active in the LKA directory (e.g. Sports, Music, Arts, Academics, Swimming, Dance). Use this before search_programs to suggest exact category strings.

{
  "type": "object",
  "properties": {}
}

Returns the cities Lodi Kids Activities currently serves. Today: Lodi, CA only. Other cities are seeded but inactive; do not surface as active to users.

{
  "type": "object",
  "properties": {}
}

Aggregate stats for a city: # programs, # daycares, % claimed by owners, % with Spanish description, % free, category breakdown. Useful for AIs answering 'how many youth programs are there in Lodi' or comparing Lodi to other cities.

{
  "type": "object",
  "properties": {
    "city_slug": {
      "type": "string",
      "description": "City slug (e.g. 'lodi'). Defaults to 'lodi' if omitted."
    }
  }
}

Lists editorial guides published on LKA — parent-facing articles like 'How to pick a summer camp,' 'Lodi after-school programs by neighborhood,' etc. Useful when a parent is researching a topic rather than searching a specific program.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  }
}

Fetch the full markdown body of a published editorial guide by slug.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string"
    }
  },
  "required": [
    "slug"
  ]
}

Returns the currently-promoted programs on the LKA homepage. Reads from featured_listings table within the active date window.

{
  "type": "object",
  "properties": {}
}

Programs whose registration window is opening soon (within the next 60 days). Useful for parents planning ahead.

{
  "type": "object",
  "properties": {
    "window_days": {
      "type": "integer",
      "minimum": 7,
      "maximum": 180
    }
  }
}

Programs within a radius (miles) of a lat/lng point. Useful for AIs answering 'what's near 95240' style questions. Uses naive Haversine — accurate enough for a single city.

{
  "type": "object",
  "properties": {
    "lat": {
      "type": "number"
    },
    "lng": {
      "type": "number"
    },
    "radius_miles": {
      "type": "number",
      "minimum": 0.5,
      "maximum": 50
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 30
    }
  },
  "required": [
    "lat",
    "lng"
  ]
}

Public reviews for a program or daycare. Returns rating, text, reviewer first name only, season. Used by AIs to surface parent sentiment when recommending a program.

{
  "type": "object",
  "properties": {
    "program_slug": {
      "type": "string"
    },
    "daycare_slug": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    }
  }
}

Upcoming events (practices, games, scrimmages, cancellations) for a specific program. Returns next 30 days. Use this to answer 'is there a game this Saturday?' style questions, and to power Add-to-Calendar flows.

{
  "type": "object",
  "properties": {
    "program_slug": {
      "type": "string"
    },
    "days_ahead": {
      "type": "integer",
      "minimum": 1,
      "maximum": 90
    }
  },
  "required": [
    "program_slug"
  ]
}

Structured map of LKA's public URLs and content sections. Equivalent to llms.txt — gives an AI grounding agent the full topology of the site so it knows what's worth crawling/calling.

{
  "type": "object",
  "properties": {}
}

Returns the signed-in parent's saved (hearted) programs AND daycares. Each row has a `kind` field of 'program' or 'daycare' so callers can route to the right detail page. Previously this tool returned `{program_id: null}` for daycare rows with no other data — a hangover from when only programs could be saved.

{
  "type": "object",
  "properties": {}
}

Save a program to the parent's hub. Accepts either the program UUID or its slug (e.g. 'youth-soccer-league'). Optionally associate the save with one or more specific kids (by UUID or name) so the kid filter in /account → Saved Programs picks it up. Requires consent.

{
  "type": "object",
  "properties": {
    "program_id": {
      "type": "string",
      "description": "Program UUID or slug"
    },
    "kid_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional: one or more kid UUIDs OR first names (case-insensitive) to tag the save with. Use parent_list_kids to look them up."
    }
  },
  "required": [
    "program_id"
  ]
}

Remove a saved program from the parent's hub. Accepts either the program UUID or its slug. Requires consent.

{
  "type": "object",
  "properties": {
    "program_id": {
      "type": "string",
      "description": "Program UUID or slug"
    }
  },
  "required": [
    "program_id"
  ]
}

Returns the parent's kids on file (names + ages, no PII beyond what they shared).

{
  "type": "object",
  "properties": {}
}

Add a kid to the parent's account. Requires consent.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "birthdate": {
      "type": "string",
      "description": "YYYY-MM-DD"
    },
    "interests": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "name"
  ]
}

Returns the parent's daycare tour requests with status.

{
  "type": "object",
  "properties": {}
}

Returns recent daycare leads + program saves for the org.

{
  "type": "object",
  "properties": {}
}

Returns the org's programs.

{
  "type": "object",
  "properties": {}
}

Set the listing status on a program (accepting / full / waitlist_only / closed_for_season). Requires consent.

{
  "type": "object",
  "properties": {
    "program_id": {
      "type": "string"
    },
    "listing_status": {
      "type": "string",
      "enum": [
        "accepting",
        "full",
        "waitlist_only",
        "closed_for_season"
      ]
    }
  },
  "required": [
    "program_id",
    "listing_status"
  ]
}

Post an org response to a review. Requires consent. Replies are one-shot per review.

{
  "type": "object",
  "properties": {
    "review_id": {
      "type": "string"
    },
    "response_text": {
      "type": "string"
    }
  },
  "required": [
    "review_id",
    "response_text"
  ]
}

Returns the signed-in parent's profile + preferences.

{
  "type": "object",
  "properties": {}
}

Update parent notification + language preferences.

{
  "type": "object",
  "properties": {
    "language_preference": {
      "type": "string",
      "enum": [
        "en",
        "es"
      ]
    },
    "sms_opt_in": {
      "type": "boolean"
    },
    "phone": {
      "type": "string"
    },
    "first_name": {
      "type": "string"
    }
  }
}

Update a kid record (birthdate, interests, school, special_needs).

{
  "type": "object",
  "properties": {
    "kid_id": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "birthdate": {
      "type": "string",
      "description": "YYYY-MM-DD"
    },
    "interests": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "school": {
      "type": "string"
    },
    "special_needs": {
      "type": "string"
    }
  },
  "required": [
    "kid_id"
  ]
}

Remove a kid from the parent's account. Irreversible — deletes the kid record and any kid-linked enrollments/reviews remain but become orphaned (kid_id set null).

{
  "type": "object",
  "properties": {
    "kid_id": {
      "type": "string"
    }
  },
  "required": [
    "kid_id"
  ]
}

Returns the parent's enrollments (programs their kid is signed up for).

{
  "type": "object",
  "properties": {}
}

Self-report that the parent enrolled their kid in a program outside the LKA RegFlow ('I'm In'). Accepts program UUID or slug.

{
  "type": "object",
  "properties": {
    "program_id": {
      "type": "string",
      "description": "Program UUID or slug"
    },
    "kid_id": {
      "type": "string"
    }
  },
  "required": [
    "program_id"
  ]
}

Save a daycare to the parent's hub.

{
  "type": "object",
  "properties": {
    "daycare_id": {
      "type": "string"
    }
  },
  "required": [
    "daycare_id"
  ]
}

Submit a review for a program or daycare. One review per (parent, program). Use parent_update_review to edit afterward.

{
  "type": "object",
  "properties": {
    "program_id": {
      "type": "string"
    },
    "daycare_id": {
      "type": "string"
    },
    "kid_id": {
      "type": "string"
    },
    "rating": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5
    },
    "text": {
      "type": "string"
    },
    "season": {
      "type": "string"
    }
  },
  "required": [
    "rating",
    "text"
  ]
}

Reviews the parent has submitted.

{
  "type": "object",
  "properties": {}
}

Returns the parent's household members + shared kids. If no household exists yet, returns null.

{
  "type": "object",
  "properties": {}
}

Invite a co-parent / partner / grandparent to share this household. They receive a one-time invite link by email; on accept, they join the household and can see all kids + saves.

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string"
    }
  },
  "required": [
    "email"
  ]
}

Accept a household invite using the token from the invite link.

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    }
  },
  "required": [
    "token"
  ]
}

Leave the current household. If you're the owner and there are other members, ownership transfers to the longest-tenured member.

{
  "type": "object",
  "properties": {}
}

Upcoming program events (practices, games, scrimmages) for the parent's enrolled programs. Covers next 30 days by default. Cancellations included as 'canceled' status.

{
  "type": "object",
  "properties": {
    "days_ahead": {
      "type": "integer",
      "minimum": 1,
      "maximum": 90
    }
  }
}

Returns the parent's personal iCal feed URL — subscribe in Google/Apple/Outlook Calendar to see practices + games in your normal calendar app. Refreshes hourly.

{
  "type": "object",
  "properties": {}
}

Submit a daycare tour request. Returns the tour id + status='requested'.

{
  "type": "object",
  "properties": {
    "daycare_id": {
      "type": "string"
    },
    "kid_id": {
      "type": "string"
    },
    "preferred_date_1": {
      "type": "string",
      "description": "YYYY-MM-DD"
    },
    "preferred_date_2": {
      "type": "string"
    },
    "start_date_needed": {
      "type": "string"
    },
    "notes": {
      "type": "string"
    }
  },
  "required": [
    "daycare_id",
    "preferred_date_1"
  ]
}

Cancel a tour request you previously submitted.

{
  "type": "object",
  "properties": {
    "tour_id": {
      "type": "string"
    }
  },
  "required": [
    "tour_id"
  ]
}

Daycare waitlists the parent is on, with current position.

{
  "type": "object",
  "properties": {}
}

Daycare applications the parent has submitted.

{
  "type": "object",
  "properties": {}
}

Programs matched to the parent's primary kid's age + interests. Simple matcher today — surfaces top 10 active programs that include the kid's age in their range, weighted by interest overlap.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 25
    }
  }
}

Export everything LKA has on you in a single JSON payload (kids, saves, enrollments, tours, reviews, household membership).

{
  "type": "object",
  "properties": {}
}

Revoke ALL MCP tokens issued under your parent account. Use this if you suspect an AI agent has misused your access.

{
  "type": "object",
  "properties": {}
}

Org dashboard summary — program count, leads in last 7d, new saves in last 7d, listing-status breakdown.

{
  "type": "object",
  "properties": {}
}

Update the org's profile (website, phone, email, logo_url, instagram).

{
  "type": "object",
  "properties": {
    "website": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "email": {
      "type": "string"
    },
    "logo_url": {
      "type": "string"
    },
    "instagram": {
      "type": "string"
    }
  }
}

Update an existing program's editable fields.

{
  "type": "object",
  "properties": {
    "program_id": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "age_min": {
      "type": "integer"
    },
    "age_max": {
      "type": "integer"
    },
    "cost": {
      "type": "string"
    },
    "cost_num": {
      "type": "integer"
    },
    "day": {
      "type": "string"
    },
    "time": {
      "type": "string"
    },
    "location": {
      "type": "string"
    },
    "address": {
      "type": "string"
    },
    "season": {
      "type": "string"
    },
    "listing_status": {
      "type": "string",
      "enum": [
        "accepting",
        "full",
        "waitlist_only",
        "closed_for_season"
      ]
    },
    "openings_remaining": {
      "type": "integer"
    }
  },
  "required": [
    "program_id"
  ]
}

Soft-archive a program (active=false). Hides from public directory but preserves history.

{
  "type": "object",
  "properties": {
    "program_id": {
      "type": "string"
    }
  },
  "required": [
    "program_id"
  ]
}

Confirm a program listing is still accurate (resets the stale-nudge timer).

{
  "type": "object",
  "properties": {
    "program_id": {
      "type": "string"
    }
  },
  "required": [
    "program_id"
  ]
}

List upcoming events for a program owned by this org.

{
  "type": "object",
  "properties": {
    "program_id": {
      "type": "string"
    },
    "days_ahead": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365
    }
  },
  "required": [
    "program_id"
  ]
}

Add a single event (practice, game, scrimmage, picture day, cancellation, etc.) to a program's calendar.

{
  "type": "object",
  "properties": {
    "program_id": {
      "type": "string"
    },
    "kind": {
      "type": "string",
      "enum": [
        "practice",
        "game",
        "scrimmage",
        "tournament",
        "recital",
        "picture_day",
        "meeting",
        "field_trip",
        "cancellation",
        "other"
      ]
    },
    "starts_at": {
      "type": "string",
      "description": "ISO 8601 timestamp"
    },
    "ends_at": {
      "type": "string"
    },
    "location": {
      "type": "string"
    },
    "address": {
      "type": "string"
    },
    "opponent": {
      "type": "string"
    },
    "notes": {
      "type": "string"
    }
  },
  "required": [
    "program_id",
    "kind",
    "starts_at"
  ]
}

Mark a program event as canceled. Enrolled parents see this in their hub + iCal.

{
  "type": "object",
  "properties": {
    "event_id": {
      "type": "string"
    },
    "reason": {
      "type": "string"
    }
  },
  "required": [
    "event_id"
  ]
}

Org-level analytics — page views, saves, contacts in a date window.

{
  "type": "object",
  "properties": {
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365
    }
  }
}

Returns a URL to the org's downloadable promo kit (QR poster + share card) for a given program.

{
  "type": "object",
  "properties": {
    "program_id": {
      "type": "string"
    }
  },
  "required": [
    "program_id"
  ]
}

Get current capacity by age band for the daycare(s) this org owns.

{
  "type": "object",
  "properties": {
    "daycare_id": {
      "type": "string"
    }
  }
}

Upsert capacity for one age band on a daycare. Age bands: infant, toddler, twos, threes, fours, prek, kindergarten.

{
  "type": "object",
  "properties": {
    "daycare_id": {
      "type": "string"
    },
    "age_band": {
      "type": "string",
      "enum": [
        "infant",
        "toddler",
        "twos",
        "threes",
        "fours",
        "prek",
        "kindergarten"
      ]
    },
    "total_slots": {
      "type": "integer",
      "minimum": 0
    },
    "current_enrollment": {
      "type": "integer",
      "minimum": 0
    },
    "waitlist_count": {
      "type": "integer",
      "minimum": 0
    },
    "notes": {
      "type": "string"
    }
  },
  "required": [
    "daycare_id",
    "age_band",
    "total_slots"
  ]
}

Tour requests for the org's daycare(s).

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "requested",
        "confirmed",
        "completed",
        "no_show",
        "declined",
        "cancelled"
      ]
    }
  }
}

Respond to a tour request — confirm with a date/time, propose alternates via notes, or decline.

{
  "type": "object",
  "properties": {
    "tour_id": {
      "type": "string"
    },
    "response": {
      "type": "string",
      "enum": [
        "confirm",
        "decline"
      ]
    },
    "confirmed_date": {
      "type": "string",
      "description": "YYYY-MM-DD; required if response='confirm'"
    },
    "confirmed_time": {
      "type": "string",
      "description": "e.g. '10:30am'"
    },
    "note": {
      "type": "string"
    }
  },
  "required": [
    "tour_id",
    "response"
  ]
}

Current waitlist queue for the org's daycare.

{
  "type": "object",
  "properties": {
    "daycare_id": {
      "type": "string"
    }
  }
}

Submitted applications for the org's daycare.

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string"
    }
  }
}

Pending org + daycare claim REQUESTS (someone applied to claim but admin hasn't approved). Excludes the long tail of seed orgs that have no contact info yet.

{
  "type": "object",
  "properties": {}
}

Pending discoveries in admin queue.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  }
}

Pending editorial guide drafts.

{
  "type": "object",
  "properties": {}
}

Month-to-date spend across Anthropic / Firecrawl / Serper / Apify / Resend / Twilio (when each logger is in place).

{
  "type": "object",
  "properties": {}
}

MCP call volume + top tools + top agents in the last 7 days.

{
  "type": "object",
  "properties": {}
}

Last 24h of activity across the platform — signups, saves, contacts, claims, discoveries.

{
  "type": "object",
  "properties": {}
}

Top parent search queries in the last 30d. Reads parent_search_queries.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  }
}