Wellness Pulse

---

🧠 ¿Qué es Wellness Pulse MCP?

Wellness Pulse MCP es un servidor de Model Context Protocol (MCP) que cierra la brecha entre los datos brutos de bienestar y la comprensión impulsada por IA.

Con una integración única, tu IA obtiene acceso a:

• 📊 Puntos de referencia públicos de CDC PLACES — datos confiables de salud mental para cualquier código postal o condado en EE. UU.
• 🏢 Señales institucionales de bienestar — tendencias en vivo, instantáneas y verificaciones de alertas de los datos de Wellness Pulse de tu organización.
• 🗣️ Explicaciones en lenguaje sencillo — resúmenes listos para IA devueltos junto con JSON estructurado.

Diseñado para flujos de trabajo rápidos de "pregunta → respuesta" en copilotos, automatizaciones y paneles de IA, sin necesidad de análisis humano en el proceso.

---

✨ Por qué los equipos añaden Wellness Pulse MCP

Capacidad	Qué desbloquea
📖 Narrativa instantánea	Tu IA explica "qué cambió y por qué importa" sin un analista humano.
📍 Puntos de referencia CDC	Contexto de malestar mental a nivel de condado para presentaciones de marketing, informes y solicitudes de subvenciones.
📡 Señales institucionales en vivo	Tendencias diarias y verificaciones de alertas que detectan caídas de bienestar antes de que se conviertan en crisis.
🔌 Una integración	Añade el MCP una vez y reutilízalo en cada copiloto, agente y panel que ejecute tu equipo.
🔒 Privacidad primero	Sin seguimiento de usuarios. Sin identificadores. Confiable para instituciones que toman la privacidad en serio.

---

🏗️ Descripción general de la arquitectura

---

🛠️ Herramientas disponibles

🌍 Herramientas de puntos de referencia públicos

get_mental_health_benchmark

Obtiene datos de Malestar Mental Frecuente (FMD) de CDC PLACES para un código postal o FIPS de condado determinado.

Argumentos:

Parámetro	Tipo	Obligatorio	Descripción
zip	string	opcional*	Código postal de EE. UU. de 5 dígitos
county_fips	string	opcional*	Código FIPS del condado

Se requiere al menos uno de zip o county_fips.

Devuelve: scope, values, national_percentile_rank (opcional), marketing_copy

Caso de uso de ejemplo: "¿Cuál es el punto de referencia de malestar mental de CDC para el código postal 94597?"

---

get_basic_alert_guidance

Devuelve umbrales de alerta predeterminados según el tamaño de la organización y el tipo de ubicación, sin necesidad de ID de institución.

Argumentos:

Parámetro	Tipo	Obligatorio	Descripción
org_size	string	✅	p. ej., "small", "medium", "large"
location_type	string	✅	p. ej., "urban", "rural", "suburban"

Caso de uso de ejemplo: "¿Qué umbrales de alerta deberíamos usar para una institución suburbana de tamaño mediano?"

---

🏢 Herramientas de datos institucionales

Estas herramientas requieren un identificador de institución válido (institution_id) de tu cuenta de Wellness Pulse.

get_institution_snapshot

Una instantánea puntual de los datos de bienestar de tu institución durante un período determinado.

Argumentos:

Parámetro	Tipo	Obligatorio	Descripción
institution_id	string	✅	Tu ID de institución de Wellness Pulse
window_days	integer	✅	Ventana de retroceso en días (p. ej., 30, 90)

Devuelve: response_count, avg_wellness_score, last_response_at

---

get_institution_trend_daily

Obtiene una serie temporal diaria de puntuaciones de bienestar y recuentos de respuestas.

Argumentos:

Parámetro	Tipo	Obligatorio	Descripción
institution_id	string	✅	Tu ID de institución de Wellness Pulse
window_days	integer	✅	Número de días a incluir

Devuelve: Matriz de objetos { day, avg_wellness, responses }

Caso de uso de ejemplo: "¿Cuál es nuestra tendencia de bienestar en los últimos 90 días?"

---

get_institution_alert_check

Compara los últimos 7 días con los 7 días anteriores y señala caídas significativas.

Argumentos:

Parámetro	Tipo	Obligatorio	Descripción
institution_id	string	✅	Tu ID de institución de Wellness Pulse

Devuelve: drop_pct, alert (indicador booleano)

Caso de uso de ejemplo: "¿Caímos semana tras semana? ¿Deberíamos preocuparnos?"

---

get_sector_snapshot

Datos agregados de bienestar a nivel de sector entre instituciones.

Argumentos:

Parámetro	Tipo	Obligatorio	Descripción
sector	string	✅	Identificador del sector
window_days	integer	✅	Ventana de retroceso en días

Devuelve: institutions_with_responses, total_responses, avg_wellness_score

---

🚀 Primeros pasos

Paso 1 — Añádelo a tu cliente de IA

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "Wellness Pulse": {
      "url": "https://wpulse.org/mcp/",
      "transport": "http-stream"
    }
  }
}

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "Wellness Pulse": {
      "url": "https://wpulse.org/mcp/",
      "transport": "http-stream"
    }
  }
}

---

Paso 2 — Inicializa una sesión (mediante cURL)

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": "my-app", "version": "1.0.0" }
    }
  }'

📌 Captura el mcp-session-id de los encabezados de la respuesta; lo necesitarás para todas las llamadas posteriores.

---

Paso 3 — Lista las herramientas disponibles

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

---

Paso 4 — Llama a una herramienta

Ejemplo: Obtener el punto de referencia de CDC para un código postal

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

Ejemplo: Verificar el estado de alerta de la institución

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

---

💬 Ejemplos de indicaciones para tu IA

Una vez conectado Wellness Pulse MCP, prueba a preguntarle a tu IA:

"What's our wellness trend for the last 90 days?"
"Did we drop week-over-week? Why might that matter?"
"What's the CDC mental distress benchmark for ZIP 94597?"
"Write a short exec update with our wellness numbers and CDC context."
"Are we above or below the national average for mental distress?"
"Flag any alert conditions in our institution data this week."
"Summarize the sector snapshot and highlight any outliers."

---

🔌 Referencia de endpoints

Tipo	URL
HTTP Stream (canónico)	https://wpulse.org/mcp/
HTTP Stream (redirección)	https://wpulse.org/mcp
SSE	https://wpulse.org/sse

Encabezados obligatorios para HTTP Streaming:

Content-Type: application/json
Accept: application/json, text/event-stream

Todas las llamadas usan JSON-RPC 2.0.

---

🔐 Privacidad y seguridad

Wellness Pulse MCP está construido con una arquitectura de privacidad primero:

• ✅ Sin seguimiento de usuarios ni registro de comportamiento
• ✅ Sin información de identificación personal (PII) almacenada o transmitida
• ✅ Los datos institucionales están delimitados y controlados por acceso según la cuenta
• ✅ Todo el transporte a través de HTTPS
• ✅ Diseñado para entornos conscientes del cumplimiento (salud, educación, RR. HH.)

---

🗺️ Casos de uso

🏥 Equipos de salud y bienestar de empleados

Usa el monitoreo de tendencias diarias y las verificaciones de alertas semana tras semana para detectar señales emergentes de agotamiento o malestar antes de que escalen, y brinda a los líderes clínicos o de RR. HH. un resumen ejecutivo generado por IA bajo demanda.

🎓 Universidades e instituciones educativas

Combina los puntos de referencia de condado de CDC con los datos de tus encuestas de bienestar estudiantil para contextualizar las puntuaciones en relación con las normas regionales, ideal para informes de acreditación y presentaciones de asuntos estudiantiles.

📈 Plataformas de tecnología de RR. HH. y bienestar

Integra Wellness Pulse MCP en tu copiloto o producto de panel existente para añadir al instante contexto de salud mental con puntos de referencia y narración de tendencias, sin construir tu propia canalización de datos.

📢 Comunicaciones de salud pública

Extrae datos de FMD de CDC PLACES por código postal o condado para generar textos de marketing, narrativas de subvenciones e informes de salud comunitaria basados en datos públicos autorizados.

🤖 Agentes de IA y automatizaciones

Conecta Wellness Pulse MCP a agentes de múltiples pasos que verifican periódicamente condiciones de alerta, redactan actualizaciones para las partes interesadas y enrutan escalamientos, todo sin análisis humano en el proceso.

---

📚 Recursos

• 🌐 Sitio web: wpulse.org
• 📖 Documentación del protocolo MCP: modelcontextprotocol.io
• 📊 Datos de CDC PLACES: cdc.gov/places
• 🐛 Problemas / Soporte: wpulse.org

---

📄 Licencia

Este servidor está disponible bajo una Licencia Institucional. Visita wpulse.org para obtener detalles de licencia y acceso institucional.

---