Wellness Pulse

---

🧠 Wellness Pulse MCP とは？

Wellness Pulse MCP は、生のウェルビーイングデータと AI による理解をつなぐ Model Context Protocol (MCP) サーバーです。

1 回の統合で、AI は次の情報にアクセスできます。

• 📊 CDC PLACES の公的ベンチマーク — 米国の ZIP コードまたは郡ごとの、信頼できるメンタルヘルスデータ
• 🏢 組織のウェルネスシグナル — 組織の Wellness Pulse データから得られるリアルタイムの傾向、スナップショット、アラートチェック
• 🗣️ 平易な英語での説明 — 構造化 JSON とともに返される、AI 対応の要約

コパイロット、自動化、AI ダッシュボードでのすばやい 「質問 → 回答」 ワークフロー向けに構築されており、人による分析は不要です。

---

✨ チームが Wellness Pulse MCP を導入する理由

機能	実現できること
📖 すぐに得られる説明	人間の分析担当者がいなくても、AI が 「何が変わり、なぜ重要なのか」 を説明します。
📍 CDC ベンチマーク	マーケティング資料、レポート、助成金申請に活用できる、郡レベルの精神的苦痛に関する背景情報。
📡 リアルタイムの組織シグナル	ウェルビーイングの低下が危機に発展する前に捉える、日々の傾向とアラートチェック。
🔌 1 回の統合	MCP を一度追加すれば、チームが利用するすべてのコパイロット、エージェント、ダッシュボードで再利用できます。
🔒 プライバシーを最優先	ユーザー追跡なし。識別情報なし。プライバシーを重視する組織から信頼されています。

---

🏗️ アーキテクチャの概要

---

🛠️ 利用可能なツール

🌍 公開ベンチマークツール

get_mental_health_benchmark

指定した ZIP コードまたは郡の FIPS コードについて、CDC PLACES の**頻繁な精神的苦痛（FMD）**データを取得します。

引数：

パラメーター	型	必須	説明
zip	string	任意*	米国の 5 桁の ZIP コード
county_fips	string	任意*	郡の FIPS コード

zip または county_fips のいずれかが必須です。

戻り値： scope、values、national_percentile_rank（任意）、marketing_copy

使用例： 「ZIP コード 94597 の CDC 精神的苦痛ベンチマークは何ですか？」

---

get_basic_alert_guidance

組織の規模と所在地の種類に基づいて、デフォルトのアラートしきい値を返します。機関 ID は不要です。

引数：

パラメーター	型	必須	説明
org_size	string	✅	例："small"、"medium"、"large"
location_type	string	✅	例："urban"、"rural"、"suburban"

使用例： 「中規模の郊外の機関では、どのアラートしきい値を使うべきですか？」

---

🏢 機関データツール

これらのツールを使用するには、Wellness Pulse アカウントの有効な機関識別子（institution_id）が必要です。

get_institution_snapshot

指定した期間における、機関のウェルネスデータの特定時点のスナップショットを取得します。

引数：

パラメーター	型	必須	説明
institution_id	string	✅	Wellness Pulse の機関 ID
window_days	integer	✅	遡る期間の日数（例：30、90）

戻り値： response_count、avg_wellness_score、last_response_at

---

get_institution_trend_daily

ウェルネススコアと回答数の日次時系列データを取得します。

引数：

パラメーター	型	必須	説明
institution_id	string	✅	Wellness Pulse の機関 ID
window_days	integer	✅	含める日数

戻り値： { day, avg_wellness, responses } オブジェクトの配列

使用例： 「過去 90 日間のウェルネスの推移はどうなっていますか？」

---

get_institution_alert_check

直近 7 日間とその前の 7 日間を比較し、大幅な低下があれば通知します。

引数：

パラメーター	型	必須	説明
institution_id	string	✅	Wellness Pulse の機関 ID

戻り値： drop_pct、alert（真偽値のフラグ）

使用例： 「前週比で低下しましたか？懸念すべきでしょうか？」

---

get_sector_snapshot

機関横断のセクターレベルで集計したウェルネスデータを取得します。

引数：

パラメーター	型	必須	説明
sector	string	✅	セクター識別子
window_days	integer	✅	遡る期間の日数

戻り値： institutions_with_responses、total_responses、avg_wellness_score

---

🚀 はじめに

ステップ 1 — AI クライアントに追加する

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

---

ステップ 2 — セッションを初期化する（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" }
    }
  }'

📌 応答ヘッダーから mcp-session-id を取得してください。以降のすべての呼び出しで必要になります。

---

ステップ 3 — 使用可能なツールを一覧表示する

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

---

ステップ 4 — ツールを呼び出す

例：ZIP コードの CDC ベンチマークを取得する

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

例：機関のアラート状況を確認する

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

---

💬 AI に尋ねるプロンプトの例

Wellness Pulse MCP に接続したら、AI に次のように尋ねてみてください。

"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."

---

🔌 エンドポイントの一覧

種類	URL
HTTP Stream（標準）	https://wpulse.org/mcp/
HTTP Stream（リダイレクト）	https://wpulse.org/mcp
SSE	https://wpulse.org/sse

HTTP ストリーミングに必要なヘッダー：

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

すべての呼び出しで JSON-RPC 2.0 を使用します。

---

🔐 プライバシーとセキュリティ

Wellness Pulse MCP は、プライバシーを最優先するアーキテクチャで構築されています。

• ✅ ユーザーの追跡や行動ログの記録はありません
• ✅ 個人を特定できる情報（PII）の保存や送信はありません
• ✅ 組織のデータはアカウントごとに範囲が限定され、アクセス制御されています
• ✅ すべての通信は HTTPS 経由です
• ✅ コンプライアンスを重視する環境（医療、教育、人事）向けに設計されています

---

🗺️ ユースケース

🏥 医療・従業員のウェルネスチーム

日々の傾向のモニタリングと週ごとのアラート確認を活用し、深刻化する前に、燃え尽きや苦痛の兆候を検知できます。また、必要に応じて、臨床部門や人事部門のリーダー向けに AI が生成するエグゼクティブサマリーを提供できます。

🎓 大学・教育機関

CDC の郡別ベンチマークと学生のウェルネス調査データを組み合わせ、地域の標準と照らし合わせてスコアを把握できます。認定評価レポートや学生支援部門のプレゼンテーションに最適です。

📈 HR テック・ウェルネスプラットフォーム

Wellness Pulse MCP を既存のコパイロットやダッシュボード製品に組み込むことで、独自のデータパイプラインを構築せずに、ベンチマークに基づくメンタルヘルスの文脈や傾向の説明をすぐに追加できます。

📢 公衆衛生に関する情報発信

ZIP コードまたは郡ごとに CDC PLACES FMD データを取得し、信頼性の高い公的データに基づくマーケティング文案、助成金申請の説明文、地域の健康レポートを作成できます。

🤖 AI エージェントと自動化

Wellness Pulse MCP を複数のステップからなるエージェントに接続し、アラート条件を定期的に確認したり、関係者向けの更新情報を作成したり、エスカレーションを振り分けたりできます。人間が分析に介在することなく実行できます。

---

📚 リソース

• 🌐 ウェブサイト： wpulse.org
• 📖 MCP プロトコルのドキュメント： modelcontextprotocol.io
• 📊 CDC PLACES データ： cdc.gov/places
• 🐛 問題報告／サポート： wpulse.org

---

📄 ライセンス

このサーバーは機関向けライセンスで利用できます。ライセンスの詳細と機関向けアクセスについては、wpulse.org をご覧ください。

---