{
  "markdown": "<!-- delx-wellness header v2 -->\n<h1 align=\"center\">Wellness Cycle Coach</h1>\n\n<h3 align=\"center\">\n  Menstrual cycle coach MCP for AI agents — now with PCOS-aware mode.<br>\n  Built so AI finally serves the <strong>50% of users</strong> agents have ignored — without ever storing cycle data.\n</h3>\n\n<p align=\"center\">\n  <a href=\"https://www.npmjs.com/package/wellness-cycle-coach\"><img src=\"https://img.shields.io/npm/v/wellness-cycle-coach?style=for-the-badge&labelColor=0F172A&color=10B981&logo=npm&logoColor=white\" alt=\"npm version\" /></a>\n  <a href=\"https://www.npmjs.com/package/wellness-cycle-coach\"><img src=\"https://img.shields.io/npm/dm/wellness-cycle-coach?style=for-the-badge&labelColor=0F172A&color=0EA5A3&logo=npm&logoColor=white\" alt=\"npm downloads\" /></a>\n  <a href=\"LICENSE\"><img src=\"https://img.shields.io/badge/LICENSE-MIT-22C55E?style=for-the-badge&labelColor=0F172A\" alt=\"License MIT\" /></a>\n  <a href=\"https://wellness.delx.ai/connectors/cycle\"><img src=\"https://img.shields.io/badge/SITE-wellness.delx.ai-0EA5A3?style=for-the-badge&labelColor=0F172A\" alt=\"Site\" /></a>\n</p>\n\n<p align=\"center\">\n  <a href=\"https://github.com/davidmosiah/wellness-cycle-coach/stargazers\"><img src=\"https://img.shields.io/github/stars/davidmosiah/wellness-cycle-coach?style=for-the-badge&labelColor=0F172A&color=FBBF24&logo=github\" alt=\"GitHub stars\" /></a>\n  <a href=\"https://modelcontextprotocol.io\"><img src=\"https://img.shields.io/badge/BUILT_FOR-MCP-7C3AED?style=for-the-badge&labelColor=0F172A\" alt=\"Built for MCP\" /></a>\n  <a href=\"https://github.com/davidmosiah/delx-wellness-hermes\"><img src=\"https://img.shields.io/badge/HERMES-one--command_setup-10B981?style=for-the-badge&labelColor=0F172A\" alt=\"Hermes\" /></a>\n  <a href=\"https://github.com/davidmosiah/delx-wellness-openclaw\"><img src=\"https://img.shields.io/badge/OPENCLAW-one--command_setup-FB923C?style=for-the-badge&labelColor=0F172A\" alt=\"OpenClaw\" /></a>\n</p>\n\n<p align=\"center\">\n  <strong>🌙 Why this exists:</strong> Most AI agents treat the body as a single context-free unit. But energy, recovery, training tolerance, nutrient needs and even cognitive bandwidth shift across the menstrual cycle. <code>wellness-cycle-coach</code> gives any agent <strong>phase-aware</strong> guidance — and never stores cycle data to do it.\n</p>\n\n> ⚡ **One-command install** — pick your runtime:\n> - [Delx Wellness for Hermes](https://github.com/davidmosiah/delx-wellness-hermes): `npx -y delx-wellness-hermes setup`\n> - [Delx Wellness for OpenClaw](https://github.com/davidmosiah/delx-wellness-openclaw): `npx -y delx-wellness-openclaw setup`\n\n---\n\n## HTTP (v2 stateless)\n\nDefault is **stdio**. Optional Streamable HTTP — no session id, JSON responses, loopback only:\n\n```bash\nnpx -y wellness-cycle-coach --http\n# GET  http://127.0.0.1:3000/health\n# POST http://127.0.0.1:3000/mcp   (sessionless)\n```\n\nEnv: `WELLNESS_CYCLE_COACH_HOST`, `WELLNESS_CYCLE_COACH_PORT`, `WELLNESS_CYCLE_COACH_TRANSPORT=http`.\n\n<!-- /delx-wellness header v2 -->\n\n## Overview\n\nPass in period start dates (from any source — Apple Health Cycle, Garmin women's health, Fitbit female health, or direct user input) and get back the user's current phase plus phase-aware recommendations for nutrition, training, and hydration. **Stateless** — the MCP itself never persists cycle data. **Supports PCOS-aware mode via the `cycle_irregular` flag (v0.3.3)** — accepts cycles 21-90 days, caps confidence at 'low', and returns a `luteal_extended` placeholder when standard 14-day-luteal math no longer applies.\n\n## Try It In 60 Seconds\n\n```bash\nnpx -y wellness-cycle-coach doctor\n\n# Or use the MCP directly via your client:\n# {\n#   \"mcpServers\": {\n#     \"wellness-cycle-coach\": {\n#       \"command\": \"npx\",\n#       \"args\": [\"-y\", \"wellness-cycle-coach\"]\n#     }\n#   }\n# }\n```\n\nThen in your agent:\n\n```json\n{\n  \"name\": \"cycle_full_report\",\n  \"arguments\": {\n    \"history\": [\n      { \"start_date\": \"2026-04-01\" },\n      { \"start_date\": \"2026-04-29\" }\n    ]\n  }\n}\n```\n\nReturns current phase + nutrition emphasize/moderate/avoid + training style/intensity + hydration target + next-period estimate.\n\n## Tools (17)\n\n| Tool | Purpose |\n|---|---|\n| `cycle_agent_manifest` | Runtime contract |\n| `cycle_capabilities` | Phases, upstream connectors, metrics |\n| `cycle_connection_status` | Health + stateless reminder |\n| `cycle_privacy_audit` | What's logged (nothing) vs sent out (nothing) |\n| `cycle_data_inventory` | Phase taxonomy + metric catalog |\n| **`cycle_estimate_phase`** | **Current phase + cycle day + confidence** |\n| `cycle_predict_next_period` | Average cycle length + next-period date |\n| `cycle_phase_guidance` | Recommendations for any specific phase |\n| **`cycle_recommend_nutrition`** | **Phase-aware nutrition for current phase** |\n| **`cycle_recommend_training`** | **Phase-aware training for current phase** |\n| **`cycle_full_report`** | **Single-call combined report** |\n| `cycle_irregular_check` | PCOS / irregular-cycle screening from history |\n| `cycle_quickstart` | Minimal getting-started walkthrough |\n| `cycle_profile_get` | Read the shared Delx Wellness profile (read-only) |\n| `cycle_profile_update` | Persist opt-in profile prefs (requires explicit user intent) |\n| `cycle_onboarding` | 11-question onboarding flow for the shared profile |\n| `cycle_demo` | Sample request/response for quick exploration |\n\n## The 4-phase model\n\n| Phase | When | Energy | Nutrition emphasis | Training |\n|---|---|---|---|---|\n| **menstrual** | days 1 → period end (~5) | Lower | Iron + magnesium + omega-3 | Restorative (yoga, walking, mobility) |\n| **follicular** | post-period → ovulation - 2 | Rising / peak | Complex carbs + lean protein + fermented foods | **Build** (strength, sprints, new skills) |\n| **ovulatory** | ovulation ± 1 day | Peak | Antioxidants + zinc | **Peak** (PRs, plyometrics) |\n| **luteal** | ovulation + 2 → next period | Falling | B vitamins + magnesium + complex carbs | Endurance + technique |\n\n## Why stateless?\n\nMenstrual cycle data is **medical-record sensitive**. The strongest privacy guarantee is to never store it. Other apps (Flo, Clue) live by hoarding cycle data on their servers; this MCP refuses to participate. The agent passes data in, the coach returns guidance, the data evaporates.\n\n## Cross-connector wedge\n\n```\nApple Health Cycle → period dates       ┐\nGarmin women's health → cycle context   ├─→ wellness-cycle-coach → phase + guidance\nFitbit female health → period dates     ┘                                  │\n                                                                            │\n                                                                            ↓\n                                                            wellness-nourish coach\n                                                            (phase-aware meal planning)\n                                                                            │\n                                                            whoop-mcp / garminmcp / ouramcp\n                                                            (recovery-aware late-luteal load adjustments)\n```\n\n## Privacy\n\n- ✅ **Stateless for cycle data** — period dates are never persisted; they stay in process memory for the duration of the call and evaporate.\n- ✅ **Opt-in local preferences** — the `cycle_profile_*` tools can persist non-secret wellness preferences (name, goals, devices, training/nutrition context) to `~/.delx-wellness/profile.json`, but only when the user explicitly asks (`cycle_profile_update` requires `explicit_user_intent: true`). Secrets (tokens, API keys, biomarkers) are rejected at write time.\n- ✅ **Offline-capable** — pure-function computation. No outbound calls.\n- ✅ **Tool-arg-only cycle data** — the agent passes period history in via the MCP request and it stays in process memory.\n\nRun `wellness-cycle-coach doctor` to inspect.\n\n## What this is NOT\n\n- Not medical advice or diagnosis.\n- Not a fertility tracker or contraception aid (consult a clinician).\n- Not a replacement for talking to a healthcare provider about painful, abnormal, or absent periods.\n- PCOS / irregular cycles supported via `cycle_irregular: true` (v0.3.3), but this is NOT a substitute for clinical care — see clinician for fertility, contraception, or symptom-management decisions.\n- Not specialized for perimenopause or post-pill (yet — see CONTRIBUTING.md).\n\n## Roadmap\n\n- **v0.2** — adapters for apple-health-mcp / garminmcp / fitbitmcp so agents can pull period history with one MCP call.\n- **v0.3** — symptom logging surface + symptom-aware guidance adjustments (cramps → magnesium emphasis, mood drop → B-vitamin emphasis).\n- **v0.4** — non-English locale support starting with pt-BR.\n\n## 📧 Contact & Support\n\n- 📨 **support@delx.ai** — general questions, integration help, partnerships\n- 🐛 **Bug reports / feature requests** — [GitHub Issues](https://github.com/davidmosiah/wellness-cycle-coach/issues)\n- 🐦 **Updates** — [@delx369](https://x.com/delx369) on X\n- 🌐 **Site** — [wellness.delx.ai](https://wellness.delx.ai)\n\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n\n<sub>wellness-cycle-coach is independent research-software. Not affiliated with Clue, Flo, Stardust, or any other cycle-tracking app. Not medical advice.</sub>\n\n## Skill or MCP\n\nSame package, two doors. MCP registers tools on stdio/HTTP. The [skill](skill/SKILL.md) can drive the **same** tools through the CLI when the client has no MCP:\n\n```bash\nnpx -y wellness-cycle-coach call cycle_connection_status --json '{}'\n```\n\nCopy `skill/SKILL.md` into your agent skills dir.\n",
  "bytes": 9551,
  "sha": "5405549e9eb860a8a78a8ef6d7acb5c52bef1eb32d313f5f620f9c5a54e936a2",
  "repo_slug": "davidmosiah/wellness-cycle-coach",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_davidmosiah_wellness_cycle_coa_a3153851/readme"
}