← Back to home

MCP server

Connect Claude, ChatGPT, Cursor, or any MCP-compatible AI assistant to the Lodi Kids Activities directory. Read-only access to programs, daycares, and family events — your assistant can search, filter, and recommend without you opening a browser.

Available on:Smithery badge
Endpoint
https://lodikidsactivities.com/api/mcp
Transport: Streamable HTTP (JSON-RPC 2.0 over POST). No auth required. Rate limit: 60 requests/min/IP.

Claude Desktop

Edit your ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) and add Lodi to your mcpServers map:

{
  "mcpServers": {
    "lodi-kids-activities": {
      "type": "http",
      "url": "https://lodikidsactivities.com/api/mcp"
    }
  }
}

Quit and reopen Claude Desktop. Once Lodi is connected, ask something like “Find me free summer programs for a 6-year-old in Lodi”.

Cursor

In Cursor: Settings → MCP → Add server, or paste into your ~/.cursor/mcp.json:

{
  "mcpServers": {
    "lodi-kids-activities": {
      "url": "https://lodikidsactivities.com/api/mcp"
    }
  }
}

ChatGPT (Custom Connector)

  1. ChatGPT → Settings → Connectors → Add custom connector
  2. Server URL: https://lodikidsactivities.com/api/mcp
  3. Auth: None (this is a public read-only server)
  4. Save, then enable the connector in any chat where you want it

Available tools

search_programs
Search youth programs in the cities Kyds Activities serves, city by city (call list_cities for the live list; pass `city`, defaults to 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).
get_program
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.
search_daycares
Search licensed daycares in the cities Kyds Activities serves, city by city (call list_cities for the live list; pass `city`, defaults to 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.
get_daycare
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.
list_upcoming_events
List upcoming family events in a city Kyds Activities serves (pass `city`; defaults to Lodi, CA) — open houses, workshops, community days, storytimes, sports clinics. Different from `search_programs` (ongoing classes) — these are single-day or short-window events.
get_event
Get full details for a single event by slug. Use after `list_upcoming_events`.
list_categories
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.
list_cities
Returns the cities Kyds Activities (the Lodi Kids Activities platform) currently serves, live from the database. Call this first when the user's city matters, then pass the city slug to the search tools.
city_stats
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.
list_guides
Lists published editorial guides — parent-facing articles like 'How to pick a summer camp.' Pass `city` for another city's guides (each city has its own blog); defaults to Lodi.
get_guide
Fetch the full markdown body of a published editorial guide by slug.
featured_listings
Returns the currently-promoted programs on the LKA homepage. Reads from featured_listings table within the active date window.
upcoming_registrations
Programs whose registration window is opening soon (within the next 60 days). Useful for parents planning ahead.
nearby_programs
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.
list_reviews
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.
program_events_feed
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.
site_directory
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.

Account-scoped tools (requires a token)

Generate a token in your Parent Hub → Settings → Connect AI tools. Paste it as Authorization: Bearer <token> in your MCP client config. Write tools also need per-tool consent on the same page.

parent_list_saves
parent
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.
parent_save_program
parentWrite · consent
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.
parent_unsave_program
parentWrite · consent
Remove a saved program from the parent's hub. Accepts either the program UUID or its slug. Requires consent.
parent_list_kids
parent
Returns the parent's kids on file (names + ages, no PII beyond what they shared).
parent_add_kid
parentWrite · consent
Add a kid to the parent's account. Requires consent.
parent_list_tours
parent
Returns the parent's daycare tour requests with status.
org_list_leads
org
Returns recent daycare leads + program saves for the org.
org_list_programs
org
Returns the org's programs.
org_update_program_capacity
orgWrite · consent
Set the listing status on a program (accepting / full / waitlist_only / closed_for_season). Requires consent.
org_reply_to_review
orgWrite · consent
Post an org response to a review. Requires consent. Replies are one-shot per review.
parent_me
parent
Returns the signed-in parent's profile + preferences.
parent_update_prefs
parentWrite · consent
Update parent notification + language preferences.
parent_update_kid
parentWrite · consent
Update a kid record (birthdate, interests, school, special_needs).
parent_remove_kid
parentWrite · consent
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).
parent_list_enrollments
parent
Returns the parent's enrollments (programs their kid is signed up for).
parent_report_enrollment
parentWrite · consent
Self-report that the parent enrolled their kid in a program outside the LKA RegFlow ('I'm In'). Accepts program UUID or slug.
parent_save_daycare
parentWrite · consent
Save a daycare to the parent's hub.
parent_submit_review
parentWrite · consent
Submit a review for a program or daycare. One review per (parent, program). Use parent_update_review to edit afterward.
parent_my_reviews
parent
Reviews the parent has submitted.
parent_my_household
parent
Returns the parent's household members + shared kids. If no household exists yet, returns null.
parent_invite_household_member
parentWrite · consent
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.
parent_accept_household_invite
parentWrite · consent
Accept a household invite using the token from the invite link.
parent_leave_household
parentWrite · consent
Leave the current household. If you're the owner and there are other members, ownership transfers to the longest-tenured member.
parent_my_upcoming_events
parent
Upcoming program events (practices, games, scrimmages) for the parent's enrolled programs. Covers next 30 days by default. Cancellations included as 'canceled' status.
parent_calendar_subscribe_url
parent
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.
parent_request_tour
parentWrite · consent
Submit a daycare tour request. Returns the tour id + status='requested'.
parent_cancel_tour
parentWrite · consent
Cancel a tour request you previously submitted.
parent_my_waitlist_positions
parent
Daycare waitlists the parent is on, with current position.
parent_my_applications
parent
Daycare applications the parent has submitted.
parent_recommended_for_me
parent
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.
parent_export_my_data
parent
Export everything LKA has on you in a single JSON payload (kids, saves, enrollments, tours, reviews, household membership).
parent_revoke_my_tokens
parentWrite · consent
Revoke ALL MCP tokens issued under your parent account. Use this if you suspect an AI agent has misused your access.
org_dashboard
org
Org dashboard summary — program count, leads in last 7d, new saves in last 7d, listing-status breakdown.
org_update_profile
orgWrite · consent
Update the org's profile (website, phone, email, logo_url, instagram).
org_update_program
orgWrite · consent
Update an existing program's editable fields.
org_archive_program
orgWrite · consent
Soft-archive a program (active=false). Hides from public directory but preserves history.
org_confirm_listing_fresh
orgWrite · consent
Confirm a program listing is still accurate (resets the stale-nudge timer).
org_list_program_events
org
List upcoming events for a program owned by this org.
org_add_program_event
orgWrite · consent
Add a single event (practice, game, scrimmage, picture day, cancellation, etc.) to a program's calendar.
org_cancel_program_event
orgWrite · consent
Mark a program event as canceled. Enrolled parents see this in their hub + iCal.
org_analytics
org
Org-level analytics — page views, saves, contacts in a date window.
org_generate_promo_kit_url
org
Returns a URL to the org's downloadable promo kit (QR poster + share card) for a given program.
daycare_capacity
org
Get current capacity by age band for the daycare(s) this org owns.
daycare_set_capacity
orgWrite · consent
Upsert capacity for one age band on a daycare. Age bands: infant, toddler, twos, threes, fours, prek, kindergarten.
daycare_list_tours
org
Tour requests for the org's daycare(s).
daycare_respond_to_tour
orgWrite · consent
Respond to a tour request — confirm with a date/time, propose alternates via notes, or decline.
daycare_list_waitlist
org
Current waitlist queue for the org's daycare.
daycare_list_applications
org
Submitted applications for the org's daycare.
admin_pending_claims
admin
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.
admin_pending_discoveries
admin
Pending discoveries in admin queue.
admin_pending_guides
admin
Pending editorial guide drafts.
admin_cost_summary
admin
Month-to-date spend across Anthropic / Firecrawl / Serper / Apify / Resend / Twilio (when each logger is in place).
admin_mcp_stats
admin
MCP call volume + top tools + top agents in the last 7 days.
admin_live_activity
admin
Last 24h of activity across the platform — signups, saves, contacts, claims, discoveries.
admin_search_trends
admin
Top parent search queries in the last 30d. Reads parent_search_queries.

What this server does NOT do (yet)

  • Submit tour requests or daycare applications (still in build)
  • Access another user’s data with your token — every scoped tool reads/writes only the user the token is bound to
  • Run write tools without explicit per-tool consent (granted in your settings)

All those require write access + OAuth, coming in v2. For now this server is a powerful read-only browsing layer — your assistant can recommend, but the parent still clicks through to LKA to act.

Curl smoke test

curl -s https://lodikidsactivities.com/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}' | jq

Questions or feedback? hello@lodikidsactivities.com