Morningform MCP server

Morning Form

Morning Form is a premium mobile-first state-optimization web app covering assessment, profile generation, protocol recommendation, daily guidance, check-ins, insights, and wearable integrations.

Local development

cd /Users/reubenselby/Desktop/morning-form
npm install
npx prisma db push
npm run db:seed
npm run dev

App URL:

http://localhost:3000

Demo user seeded locally:

demo@morningform.com

Current branch workflow

• main: built MVP
• feat/real-health-oauth: review branch for real provider connection wiring

Open PR:

https://github.com/contactxyz-admin/morning-form/pull/1

Health integrations

Morning Form currently supports:

• Terra-backed Apple Health and Garmin connection flow
• Direct OAuth scaffolding for Whoop, Oura, Fitbit, and Google Fit
• persisted provider connections via Prisma
• callback routes and token exchange when credentials are configured
• graceful mock fallback when credentials are absent

Detailed provider setup lives in:

docs/HEALTHPROVIDERSETUP.md

Metrics

• Activation funnel (signup → first grounded answer → retained): npx tsx scripts/metrics/activation-funnel.ts --signup-since 2026-03-22 --signup-until 2026-04-21. Prints CSV + human-readable summary. See docs/plans/2026-04-21-002-feat-activation-funnel-instrumentation-plan.md.

Retest loop

The retest loop (off by default, behind RETESTLOOPENABLED) runs the "return leg": a lab panel completes a Draw, the next retest is scheduled, a daily Vercel cron (/api/cron/retest-nudge, gated by CRON_SECRET) sends a capped nudge sequence, and retention-to-retest is measured (nudge-attributed = loop-caused). The metrics CLI above appends a retest-retention section when the flag is on. Backfill existing users (run dark, before the flip): npx tsx scripts/retest/backfill-baseline-draws.ts (dry run) then --apply. Tunables live in src/lib/retest/constants.ts. See docs/runbooks/retest-loop-go-live.md and docs/plans/2026-06-17-001-feat-return-leg-retest-loop-plan.md.

Retrieval

Hybrid retrieval is enabled when an embedding provider is configured. It embeds only SourceChunk.text, stores one VectorEmbedding per chunk, and keeps searchgraphnodes on the same public contract while ranking with vector + lexical + graph RRF. Set HYBRIDRETRIEVALENABLED=false to roll back to legacy lexical/graph behavior.

Production rollout:

npx prisma generate
npx prisma db push
npx tsx scripts/backfill-embeddings.ts --dry-run --estimate
npx tsx scripts/backfill-embeddings.ts --batch 80

See docs/runbooks/hybrid-retrieval-production.md and docs/runbooks/backfill-embeddings.md.