Wellness Pulse MCP: plug your AI into real wellbeing intelligence

One connection gives your AI institution-specific wellness signals from your Wellness Pulse data—trends, snapshots, sector context, and alert checks—returned in plain JSON for copilots and automations.

Why teams add this

Instant narrative: your AI can explain “what changed” without a human analyst.
Clear numbers: response counts, averages, and trend lines your AI can summarize for leaders.
Early signals: daily trends and alert checks to spot dips before they spread.
One integration: add the MCP once; reuse across copilots, agents, dashboards.

Endpoints

HTTP Stream: https://wpulse.org/mcp/ (canonical; /mcp redirects)
SSE: https://wpulse.org/sse

Use JSON-RPC. For HTTP streaming, include: Accept: application/json, text/event-stream.

How it works (visual)

AI app / agent
   │  (MCP tools)
   ▼
Wellness Pulse MCP (this server)
   └─ Your institution data (responses, trends, alerts)
   ▼
Plain-English insights + structured JSON

Designed for fast “ask → answer” loops in copilots and automations.

What you can ask

“What’s our wellness trend for the last 90 days?”
“Did we drop week-over-week? Why might that matter?”
“How does our sector compare over the last quarter?”
“Write a short exec update with our latest wellness numbers.”

Available Tools

get_sector_snapshot — Sector-level snapshot over a window; returns institutions_with_responses, total_responses, avg_wellness_score.
get_basic_alert_guidance — Default alert thresholds by org_size and location_type.
get_institution_snapshot — Counts, avg_wellness_score, last_response_at for an institution over a window.
get_institution_trend_daily — Daily series of { day, avg_wellness, responses }.
get_institution_alert_check — Compares last 7d vs prior 7d; returns drop_pct and alert flag.

Initialize session

curl -s https://wpulse.org/mcp/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc":"2.0",
    "id":1,
    "method":"initialize",
    "params":{
      "protocolVersion":"2025-03-26",
      "capabilities":{},
      "clientInfo":{"name":"example","version":"1.0.0"}
    }
  }'

Capture mcp-session-id response header for subsequent calls.

List tools

curl -s https://wpulse.org/mcp/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "mcp-session-id: <SESSION_ID>" \
  -d '{ "jsonrpc":"2.0", "id":2, "method":"tools/list", "params":{} }'

Call a tool (example)

curl -s https://wpulse.org/mcp/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "mcp-session-id: <SESSION_ID>" \
  -d '{
    "jsonrpc":"2.0",
    "id":3,
    "method":"tools/call",
    "params":{
      "name":"get_institution_snapshot",
      "arguments":{"institution_id":"","window_days":30}
    }
  }'

Notes

Institution tools require a valid institution_id for your organization in Wellness Pulse.
Use tools/list after connecting to see the current tool catalog.
Endpoint health validated on 2026-03-19: /mcp/ initialize + tools/list and /sse stream handshake.