Wellness Pulse

---

🧠 O que é o Wellness Pulse MCP?

O Wellness Pulse MCP é um servidor Model Context Protocol (MCP) que preenche a lacuna entre dados brutos de bem-estar e compreensão alimentada por IA.

Com uma única integração, sua IA tem acesso a:

• 📊 Benchmarks públicos CDC PLACES — dados confiáveis de saúde mental para qualquer CEP ou condado nos EUA
• 🏢 Sinais institucionais de bem-estar — tendências ao vivo, instantâneos e verificações de alerta dos dados do Wellness Pulse da sua organização
• 🗣️ Explicações em linguagem simples — resumos prontos para IA retornados junto com JSON estruturado

Construído para fluxos de trabalho rápidos de "perguntar → responder" em copilotos, automações e painéis de IA — sem necessidade de análise humana no processo.

---

✨ Por que as equipes adicionam o Wellness Pulse MCP

Capacidade	O que ela desbloqueia
📖 Narrativa instantânea	Sua IA explica "o que mudou e por que isso importa" sem um analista humano.
📍 Benchmarks CDC	Contexto de sofrimento mental em nível de condado para apresentações de marketing, relatórios e pedidos de subsídio.
📡 Sinais institucionais ao vivo	Tendências diárias + verificações de alerta que detectam quedas de bem-estar antes que se tornem crises.
🔌 Uma integração	Adicione o MCP uma vez — reutilize-o em todos os copilotos, agentes e painéis da sua equipe.
🔒 Privacidade em primeiro lugar	Sem rastreamento de usuários. Sem identificadores. Confiável por instituições que levam a privacidade a sério.

---

🏗️ Visão geral da arquitetura

---

🛠️ Ferramentas disponíveis

🌍 Ferramentas de benchmark público

get_mental_health_benchmark

Busca dados de Sofrimento Mental Frequente (FMD) do CDC PLACES para um CEP ou código FIPS de condado.

Argumentos:

Parâmetro	Tipo	Obrigatório	Descrição
zip	string	opcional*	CEP dos EUA com 5 dígitos
county_fips	string	opcional*	Código FIPS do condado

Pelo menos um de zip ou county_fips é obrigatório.

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

Exemplo de uso: "Qual é o benchmark de sofrimento mental do CDC para o CEP 94597?"

---

get_basic_alert_guidance

Retorna limites de alerta padrão com base no tamanho da organização e no tipo de localização — sem necessidade de ID de instituição.

Argumentos:

Parâmetro	Tipo	Obrigatório	Descrição
org_size	string	✅	ex.: "small", "medium", "large"
location_type	string	✅	ex.: "urban", "rural", "suburban"

Exemplo de uso: "Quais limites de alerta devemos usar para uma instituição suburbana de médio porte?"

---

🏢 Ferramentas de dados institucionais

Essas ferramentas exigem um identificador de instituição válido (institution_id) da sua conta Wellness Pulse.

get_institution_snapshot

Um instantâneo pontual dos dados de bem-estar da sua instituição em um determinado período.

Argumentos:

Parâmetro	Tipo	Obrigatório	Descrição
institution_id	string	✅	Seu ID de instituição Wellness Pulse
window_days	integer	✅	Janela de retrospectiva em dias (ex.: 30, 90)

Retorna: response_count, avg_wellness_score, last_response_at

---

get_institution_trend_daily

Busca uma série temporal diária de pontuações de bem-estar e contagens de respostas.

Argumentos:

Parâmetro	Tipo	Obrigatório	Descrição
institution_id	string	✅	Seu ID de instituição Wellness Pulse
window_days	integer	✅	Número de dias a incluir

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

Exemplo de uso: "Qual é a nossa tendência de bem-estar nos últimos 90 dias?"

---

get_institution_alert_check

Compara os últimos 7 dias com os 7 dias anteriores e sinaliza quedas significativas.

Argumentos:

Parâmetro	Tipo	Obrigatório	Descrição
institution_id	string	✅	Seu ID de instituição Wellness Pulse

Retorna: drop_pct, alert (sinalizador booleano)

Exemplo de uso: "Caímos semana após semana? Devemos nos preocupar?"

---

get_sector_snapshot

Dados agregados de bem-estar em nível de setor entre instituições.

Argumentos:

Parâmetro	Tipo	Obrigatório	Descrição
sector	string	✅	Identificador do setor
window_days	integer	✅	Janela de retrospectiva em dias

Retorna: institutions_with_responses, total_responses, avg_wellness_score

---

🚀 Primeiros passos

Etapa 1 — Adicione ao seu 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"
    }
  }
}

---

Etapa 2 — Inicialize uma sessão (via 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" }
    }
  }'

📌 Capture o mcp-session-id dos cabeçalhos da resposta — você precisará dele para todas as chamadas subsequentes.

---

Etapa 3 — Liste as ferramentas disponíveis

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": {} }'

---

Etapa 4 — Chame uma ferramenta

Exemplo: Buscar benchmark do CDC para um CEP

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" }
    }
  }'

Exemplo: Verificar status de alerta da instituição

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" }
    }
  }'

---

💬 Exemplos de prompts para perguntar à sua IA

Depois de conectar o Wellness Pulse MCP, tente perguntar à sua 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."

---

🔌 Referência de endpoints

Tipo	URL
HTTP Stream (canônico)	https://wpulse.org/mcp/
HTTP Stream (redirecionamento)	https://wpulse.org/mcp
SSE	https://wpulse.org/sse

Cabeçalhos obrigatórios para HTTP Streaming:

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

Todas as chamadas usam JSON-RPC 2.0.

---

🔐 Privacidade e segurança

O Wellness Pulse MCP é construído com uma arquitetura de privacidade em primeiro lugar:

• ✅ Sem rastreamento de usuários ou registro de comportamento
• ✅ Nenhuma informação pessoalmente identificável (PII) armazenada ou transmitida
• ✅ Dados institucionais são limitados e controlados por acesso por conta
• ✅ Todo o transporte via HTTPS
• ✅ Projetado para ambientes conscientes de conformidade (saúde, educação, RH)

---

🗺️ Casos de uso

🏥 Equipes de saúde e bem-estar do funcionário

Use monitoramento de tendências diárias e verificações de alerta semana após semana para detectar sinais emergentes de burnout ou sofrimento antes que eles aumentem — e forneça à liderança clínica ou de RH um resumo executivo gerado por IA sob demanda.

🎓 Universidades e instituições educacionais

Combine benchmarks de condados do CDC com seus dados de pesquisa de bem-estar estudantil para contextualizar pontuações em relação às normas regionais — ideal para relatórios de acreditação e apresentações de assuntos estudantis.

📈 Plataformas de tecnologia de RH e bem-estar

Integre o Wellness Pulse MCP ao seu copiloto ou produto de painel existente para adicionar instantaneamente contexto de saúde mental com benchmarks e narração de tendências — sem construir seu próprio pipeline de dados.

📢 Comunicações de saúde pública

Extraia dados FMD do CDC PLACES por CEP ou condado para gerar textos de marketing, narrativas de subsídios e relatórios de saúde comunitária fundamentados em dados públicos confiáveis.

🤖 Agentes de IA e automações

Conecte o Wellness Pulse MCP a agentes de várias etapas que verificam periodicamente condições de alerta, redigem atualizações para partes interessadas e encaminham escalonamentos — tudo sem análise humana no processo.

---

📚 Recursos

• 🌐 Site: wpulse.org
• 📖 Documentação do protocolo MCP: modelcontextprotocol.io
• 📊 Dados CDC PLACES: cdc.gov/places
• 🐛 Problemas / Suporte: wpulse.org

---

📄 Licença

Este servidor está disponível sob uma Licença Institucional. Visite wpulse.org para detalhes de licenciamento e acesso institucional.

---