Connect Luna to Meta Muse, Claude, or any MCP assistant.
Luna is a baby tracker for feeds, sleep, nappies, solids and routines. This page describes the MCP connector that lets an AI assistant log events, check status and answer questions from a family's own log, on their behalf and with their consent.
What it does
Once connected, an assistant can log feeds, naps and nappy changes; check whether a child is asleep, hungry or due for a nap; review the week's nutrition and allergen records once solids have started; pull proactive nudges; and (with Luna Plus, £4.99/month) answer free-text questions grounded in that family's actual log, never generic advice and never percentile jargon. Everything except ask_luna works on the free plan.
Server details
| MCP server URL | https://getmyluna.app/mcp |
|---|---|
| Transport | Streamable HTTP, JSON responses, stateless |
| Manifest | https://getmyluna.app/.well-known/luna-connector.json |
| Auth | Bearer token in the Authorization header; 401 with WWW-Authenticate: Bearer otherwise |
| Rate limit | 120 calls per minute per token (429 beyond that) |
| Support | [email protected] |
Set up in Muse
Create a Luna account (or sign in), open Settings in the app and choose Connect an assistant to create a token. In Muse, choose "build a custom integration" and paste:
Build a custom integration to Luna. Its MCP server URL is https://getmyluna.app/mcp. Authenticate with the header Authorization: Bearer <token> (create a token in Luna → Settings → Connect an assistant). I want you to be able to log feeds, naps and nappies, check status and nudges, and ask Luna questions from any future conversation. Connect to it, test every capability end to end, show me the results, and save the integration as a reusable skill.Create a Luna account →
Set up in Claude Code
claude mcp add luna --transport http https://getmyluna.app/mcp --header "Authorization: Bearer <token>"
Tools
Every tool response includes child (name and age) and as_of (local time with timezone), so the assistant never has to guess whose data, or which clock, it is reading. Write tools accept an optional idempotency_key and return a plain-language confirmation_summary for the assistant's approval dialog.
| Tool | Scope | What it does |
|---|---|---|
get_status | read | Live state: asleep/awake and duration, awake vs typical window in plain language (never percentiles), next nap window, predicted bedtime and bath time, hunger state and next feed, last nappy, today's milk/meals/naps, and active alerts. |
get_today | read | Today's events enriched with meals and foods, milk total, allergens given, and supplements logged. |
get_week_review | read | 7-day nutrient scores vs targets, allergen grid, sleep totals per day (partial days marked), longitudinal flags, and the top 3 recommendations. |
get_events | read | Raw event log for a given date (default today), optionally filtered by event type. |
get_child_profile | read | Child's name, date of birth, age, region, units, milk type, and caregiver usernames. |
get_nudges | read | Pending proactive nudges (nap windows, feeds due, allergen lapses, restock, etc.) with suggested actions. |
ask_luna | read | Free-text question answered by Luna's AI advisor, grounded in the child's actual logged data, in Luna's safe, non-clinical lane. Requires Luna Plus (returns {error: "payment_required"} otherwise) and returns {error: "advisor_unavailable"} when no AI provider is configured. |
suggest_meal | read | Top 3 meal suggestions (optionally filtered by meal type) and which nutrient or allergen gaps each one closes. |
get_restock_forecast | read | Days-remaining forecast for nappies, wipes, formula, vitamin D and milk, based on logged usage and current inventory. |
log_feed | write | Log a milk, breastfeed or solid-food feed (amount, foods, meal type, time, note). Flags if logged during a known sleep span. |
log_sleep | write | Log the child falling asleep or waking up at a given time. |
log_nappy | write | Log a nappy change (wet, dirty or mixed) with optional consistency and note. |
log_measurement | write | Log a weight or length measurement in either metric or imperial units. |
log_supplement | write | Log a vitamin D, iron or multivitamin dose, in micrograms or IU. |
log_note | write | Log a free-text note against the timeline at a given time. |
undo_last | write | Remove the most recently logged app-sourced event. |
edit_event | write | Edit a previously logged app-sourced event by id. |
delete_event | write | Delete a previously logged app-sourced event by id. |
remember | write | Save a durable note for Luna to recall in future conversations (preferences, illness, travel, milestones). |
set_inventory | write | Record the current quantity on hand for a consumable item (nappies, wipes, formula, vitamin D, milk) to feed the restock forecast. |
create_caregiver_invite | write | Create a 72-hour invite link so a partner, grandparent or nanny can join the family and log events themselves. |
subscribe_nudges | write | Register a webhook URL (and optional shared secret) to receive proactive nudges as they become due. |
unsubscribe_nudges | write | Remove a previously registered nudge webhook. |
Resources
luna://playbook— Playbook: Region-specific, non-diagnostic infant care reference playbook (UK or US).luna://week-plan— Week plan: The family's current week plan (activities by weekday, daily milk target).luna://profile— Child profile: Same content as the get_child_profile tool, exposed as a readable resource.
Prompts
daily_briefing— Summarise today so far and what to do next.bedtime_plan— Given naps and sleep debt, plan tonight.close_the_gaps— Plan meals for the next 2 days that close this week's nutrient and allergen gaps.
Proactive nudges
Luna does not only answer when asked. Pending nudges (a nap window opening, a feed overdue, an allergen record about to lapse, supplies running low) are available by polling get_nudges or by registering a webhook with subscribe_nudges. Webhook posts carry X-Luna-Timestamp and, when a secret is set, X-Luna-Signature: sha256=<HMAC of "timestamp.body">. Webhook delivery is paused between 21:00 and 06:30 local time; nudges stay visible via get_nudges.
The connector organises and summarises what a family has logged. It does not diagnose, assess symptoms, or advise on medication or allergy decisions, and the assistant is told to direct those questions to a qualified clinician or emergency services. See Safety.
Data handling
Luna stores only what a family logs about their own child: first name, date of birth, event logs, caregiver usernames, and optional consumable inventory. Data is isolated per family, bearer tokens are stored hashed, tokens carry read/write scopes, and every write through the connector is audited. See Privacy and Terms for the full detail, including retention, deletion and sub-processors.
Changelog
- 1.0.0: initial public connector: 23 tools, UK and US regions, proactive nudges, signed webhooks.