Nursing Home Database

Nursing Home Database — MCP

Nursing Home Database の Model Context Protocol サーバーに関する公開ドキュメントです。米国の熟練看護施設の検索、詳細情報、所有権、所有者のポートフォリオのデータを AI アシスタントやその他の MCP クライアントに提供します。CMS の看護師勤務時間、離職率、検査スコアも含まれます。

ウェブサイト： nursinghomedatabase.com
お問い合わせ： お問い合わせページ

MCP エンドポイント

トランスポート	Streamable HTTP（HTTPS 経由の JSON-RPC 2.0）
URL	https://mcp.nursinghomedatabase.com/mcp
認証	不要（公開アクセス）
サーバー名	nhd-mcp
バージョン	1.4.0

標準的な MCP セッションを送信します：initialize → notifications/initialized（任意。HTTP 204 が返される場合があります）→ tools/list → 必要に応じて tools/call。

ツール

ツール	用途
search_facilities	住所の近く、または名前／市／州／所有形態で認定 SNF を検索し、勤務時間、離職率、検査スコアを使って3施設を超える候補を絞り込みます
search_facilities_by_ownership	同じ検索を行いますが、CMS の ownership タイプが必須です（営利／非営利／政府、または list_distinct_values の完全一致値）
summarize_facilities	看護師勤務時間、離職率、評価、病床数、罰金の全国またはグループ別統計（件数、平均、最小、最大。中央値は任意）を返します。search_facilities のページングよりこちらを優先してください
get_facility	CMS プロバイダー番号またはサイトスラッグを指定して施設を1つ開き、検索と同じ勤務時間、離職率、検査、病床数、罰則の項目を取得します
compare_facilities	最大25件の CCN／スラッグについて同じスキーマで比較します。get_facility の繰り返し呼び出しよりこちらを優先してください（MCP は毎分60リクエストまで）
get_facility_changes	CMS の月次ファイル2件における施設1件のフィールド単位の差分を返します。デフォルトでは最新ファイルと直前のスナップショットを比較します。所有者名は対象外です
get_facility_ownership	施設の所有者とその役割を一覧表示します
search_owners	老人ホームの所有者を名前で検索します
get_owner	所有者が保有する認定 SNF のポートフォリオを開きます
list_file_dates	データベース内の CMS 月次スナップショットの日付を一覧表示します。過去の月を確認できます
list_distinct_values	ProviderInfo フィールド（ownership、state、sffstatus、chainname など）の CMS 値と件数を一覧表示します
get_data_freshness	最新の CMS ファイルの公開日時と行数を返します

正確な inputSchema オブジェクトは tools/list で返されます。

過去の月（filedate）

デフォルトでは、すべての検索に 最新 の CMS 月次ファイルが使用されます。過去の月のデータを取得するには：

1. list_file_dates を呼び出します（current、新しい順の filedates、未公開月を示す known_gaps が返されます）。
2. filedate にその日付のいずれかを指定して（YYYY-MM-DD または YYYY-MM）、search_facilities、search_facilities_by_ownership、summarize_facilities、compare_facilities、get_facility、get_facility_ownership、search_owners、get_owner、または list_distinct_values を呼び出します。get_facility_changes では filedate を指定できません。from と to を渡してください。

CMS スナップショットは月の初日（YYYY-MM-01）として保存されます。2026-07 や 2026-07-15 のような値は 2026-07-01 に正規化されます。不明な日付を指定すると検証エラーが返されるため、推測せずに list_file_dates を呼び出してください。

search_facilities

住所の近くにある認定済みSNFを検索します。時間数、離職率、検査スコアを使って、3施設を超える候補を絞り込めます。施設名、市区町村、州、ZIPコードで検索することもできます。

Parameter	Type	Description
q	string	施設名のフリーテキスト検索
address	string	距離検索の起点となる住所（例：150 Corporate Woods Drive, Magnolia, TX 77354）
city	string	市区町村の絞り込み条件
state	string	州の絞り込み条件
zip	string	ZIPコードの絞り込み条件
radius_miles	number	直線距離の半径（マイル）。addressを指定した場合のデフォルト値は25です
min_overall_rating	integer	CMS総合星評価の最低値（RESTではすでに利用可能で、このMCPツールでも利用できます）
max_overall_rating	integer	CMS総合星評価の最高値（RESTではすでに利用可能で、このMCPツールでも利用できます）
abuse_icon	string	CMS虐待アイコンによる絞り込み（Y／N、true／false）（RESTではすでに利用可能で、このMCPツールでも利用できます）
sffstatus	string	設定すると、CMS特別重点施設（または候補施設）のステータスを持つ施設に絞り込みます（RESTではすでに利用可能で、このMCPツールでも利用できます）
ownership	string	CMSの所有形態（ProviderInfo.ownership）。大文字と小文字は区別されません。For profit、Non profit、Governmentの各接頭辞は該当する種類に一致します。field=ownershipを指定してlist_distinct_valuesを呼び出すと、13個の正確な値を確認できます
sort	string	並べ替えキー（以下の並べ替えキーを参照）
limit	integer	結果の最大件数
offset	integer	ページネーションのオフセット
filedate	string	list_file_datesから指定する任意のCMS月次スナップショット（デフォルトは最新月）

指定した住所を解決できない場合、APIは住所に関する検証エラーを返します。

施設のペイロード（検索および詳細）

search_facilities（各items[]行）とget_facility（facility）は、同じ詳細なオブジェクトを返すため、候補施設ごとに詳細取得を呼び出す必要はありません。

識別情報、所在地、CMS星評価（provnum、web、provname、lbn、address、city、state、zip、latitude、longitude、phone、overall_rating、survey_rating、quality_rating、staffing_rating、公開URL）が含まれます。判断に使用するフィールドにはCMSキーが使われます。

Key	Meaning
tothrd	入居者1人・1日あたりの看護師総勤務時間（HPRD）
rnhrd	入居者1人・1日あたりのRN勤務時間
totalnumberofnursestaffhoursperresidentperdayontheweekend	週末の入居者1人・1日あたりの看護師総勤務時間（HPRD）
registerednursehoursperresidentperdayontheweekend	週末の入居者1人・1日あたりのRN勤務時間（HPRD）
totalnursingstaffturnover	看護スタッフの離職率
registerednurseturnover	RNの離職率
numberofadministratorswhohaveleftthenursinghome	退職した介護施設管理者の人数
weighted_all_cycles_score	加重健康検査スコア（全サイクル）
bedcert	認定ベッド数
restot	認定ベッドを利用する入居者数
occupancy	入居率（入居者数／認定ベッド数）
fine_tot	罰金の合計額（ドル）
fine_cnt	罰金の件数
abuse_icon	CMS虐待アイコン
sffstatus	特別重点施設のステータス
chain_id	チェーン識別子
chain_name	チェーン名
ownership	CMSの所有形態（例：For profit - Corporation）
oldsurvey	フラグ（Y／N）：直近の標準健康検査が2年以上前であることを示します
cycle_1_survey_date	直近の標準健康検査の日付

距離（直線距離のマイル。車での所要時間ではありません）

search_facilitiesをaddressを指定して呼び出すと、次のようになります。

• distance_milesは、起点から施設までの**ハーバーサイン式による直線距離（マイル）**です。
• distanceは同じ値の別名として維持されています。

これらの値は、車での所要時間や道路上の距離ではありません。車での所要時間を確認するには、各行でmaps.google_dir／maps.apple_dirを使うか、座標を地図ツールに渡してください。

ソートキー

search_facilities（および GET /api/v1/nh/facilities）で sort を指定します。sort を省略した場合、デフォルトは overall_rating（星の評価、降順）です。住所を起点に検索する場合、近い順にするには sort=distance を指定します。

sort の値	エイリアス	順序
overall_rating		星の評価の降順（高いほど良い）
survey_rating		星の評価の降順
quality_rating		星の評価の降順
staffing_rating		星の評価の降順
distance		マイルの昇順（近い順）
tothrd	total_nurse_hours	時間の降順（多いほど良い）
totalnursingstaffturnover	nurse_turnover	離職率の昇順（低いほど良い）
weighted_all_cycles_score	survey_score	検査スコアの昇順（低いほど良い）

search_facilities_by_ownership

search_facilities と同じ結果スキーマで、ownership が必須です。「…の政府系／非営利／営利の施設を探す」という質問には、このツールを使用します。state、city、zip、または address と組み合わせてください。正確な CMS の文字列を確認するには、先に field=ownership を指定して list_distinct_values を呼び出します。

パラメーター	型	必須	説明
ownership	string	はい	CMS の所有形態（前方一致または完全一致）
state	string	いいえ	2 文字の州コード
city	string	いいえ	市区町村による絞り込み
zip	string	いいえ	ZIP による絞り込み
address	string	いいえ	距離検索の起点となる住所
filedate	string	いいえ	list_file_dates の CMS 月次スナップショット

summarize_facilities

認定 SNF 全体の数値 CMS ProviderInfo フィールドを集計します。全国またはグループ別の統計（政府系と民間の勤務時間、州ごとの平均など）には、search_facilities をページングするよりこちらを優先してください。平均値は施設単位で均等に算出されます（ベッド数による重み付けはありません）。指標が欠損している施設は、その指標の n／平均／最小／最大の集計のみから除外され、値は補完されません。因果関係を示すものではありません。名前が指定された施設については、get_facility の代わりにはなりません。

パラメーター	型	必須	説明
metrics	array of strings	はい	1～20 個のキー：tothrd、rnhrd、weekend_tothrd、weekend_rnhrd、totalnursingstaffturnover、registerednurseturnover、weighted_all_cycles_score、overall_rating、survey_rating、staffing_rating、quality_rating、bedcert、restot、fine_tot、fine_cnt、occupancy。同義語：total_nurse_hours、nurse_turnover、rn_turnover、survey_score
group_by	string	いいえ	ownership、ownership_kind（Government / For profit / Non profit）、state、overall_rating、staffing_rating、survey_rating、quality_rating、sffstatus、abuse_icon。省略すると、全国（またはフィルター適用範囲）を 1 行で返します
ownership	string	いいえ	search_facilities と同じ前方一致／完全一致のフィルター
state	string	いいえ	2 文字の州コード
city	string	いいえ	state が必要です
zip	string	いいえ	ZIP による絞り込み
abuse_icon	string	いいえ	search_facilities と同じ
sffstatus	string	いいえ	search_facilities と同じ
min_overall_rating	integer	いいえ	1～5
max_overall_rating	integer	いいえ	1～5
include_median	boolean	いいえ	デフォルトは false です。true の場合、各統計オブジェクトに median が含まれます
filedate	string	いいえ	list_file_dates の CMS 月次スナップショット

REST：GET /api/v1/nh/facilities/summary?metrics=tothrd,rnhrd&group_by=ownership_kind&include_median=true

レスポンスの groups[] の各要素には、group_key、group_label、facilities_in_group と、正規メトリック（n、mean、min、max、任意の median、unit）をキーとする stats が含まれます。facilities_in_scope はフィルターに一致する施設数です。各グループのメトリックごとの n は、値が null ではない件数です。不明なメトリックキーを指定すると、許可されているキーの一覧とともに invalid_metric が返されます。

離職率が 0%／100% であることや、HPRD がほぼゼロであることは、報告上のアーティファクトである可能性があります。

list_distinct_values

アクティブな月次スナップショット内のフィールドについて、CMS の ProviderInfo の個別の値と行数を一覧表示します。使用可能なフィールド一覧を確認するには、field を省略してください。field=city には state が必要です。

パラメーター	型	必須	説明
field	string	いいえ	ownership、state、sffstatus、abuse_icon、certification、chainname、overall_rating、…
state	string	いいえ	2 文字の州コード（city には必須）
filedate	string	いいえ	list_file_dates で取得した CMS の月次スナップショット

compare_facilities

1 つのスナップショット上で、最大 25 件の CMS プロバイダー番号またはウェブスラッグについて、search_facilities と同じ判断項目を比較します。25 件を超える ID は除外されます。これは月ごとの差分ではありません。月ごとの差分には get_facility_changes を使用してください。

パラメーター	型	必須	説明
ids	array of strings	はい	CMS プロバイダー番号またはウェブスラッグ。最大 25 件
filedate	string	いいえ	list_file_dates で取得した CMS の月次スナップショット

get_facility

CMS プロバイダー番号（provnum）またはサイトのスラッグで、1 つの施設を開きます。facility オブジェクトは、search_facilities の行（営業時間、スタッフの離職率、検査、ベッド数、罰金、地図リンク）と一致します。

パラメーター	型	必須	説明
id	string	はい	プロバイダー番号またはウェブスラッグ
filedate	string	いいえ	list_file_dates で取得した CMS の月次スナップショット

get_facility_changes

2 つの CMS 月次スナップショット間で、1 つの施設の差分を取得します。from と to を省略すると、最新ファイルとその前のスナップショットを比較します。changes はフィールド単位の差分です。星評価、看護師の勤務時間、スタッフの離職率、加重検査スコア、CMS の虐待アイコン、Special Focus のステータス、所有形態（営利／非営利／政府。所有者名ではありません）、罰金、ベッド数、入居者数、稼働率が対象です。2 つのファイルのいずれかに施設がない場合、found.from または found.to は false になります。これは施設の閉鎖を意味するものではありません。

パラメーター	型	必須	説明
id	string	はい	CMS プロバイダー番号またはウェブスラッグ
from	string	いいえ	古い方の filedate（YYYY-MM-DD または YYYY-MM）。省略すると、to の1つ前のスナップショットが使用されます
to	string	いいえ	新しい方の filedate。省略すると、最新の CMS ファイルが使用されます

get_facility_ownership

施設の所有者とその役割を一覧表示します。

パラメーター	型	必須	説明
id	string	はい	プロバイダー番号またはウェブスラッグ
filedate	string	いいえ	list_file_dates で取得した CMS の月次スナップショット

search_owners

介護施設の所有者を名前で検索します。

パラメーター	型	必須	説明
q	string	はい	所有者名の検索語
limit	integer	いいえ	結果の最大件数
offset	integer	いいえ	ページネーションのオフセット
filedate	string	いいえ	list_file_dates で取得した CMS の月次スナップショット

get_owner

web_owner スラッグで、認定 SNF の所有者のポートフォリオを開きます。

パラメーター	型	必須	説明
web_owner	string	はい	所有者のスラッグ識別子
filedate	string	いいえ	list_file_dates で取得した CMS の月次スナップショット

list_file_dates

データベースで利用可能な CMS の月次スナップショットの日付を一覧表示します。パラメーターはありません。current、新しい順の filedates、未公開の月を示す known_gaps を返します。

get_data_freshness

最新の CMS ソースデータセットの日付と行数を報告します。パラメーターはありません。過去の月のデータを取得するには、list_file_dates を呼び出し、他のツールに filedate を渡してください。

MCP レジストリ

公式 MCP レジストリに com.nursinghomedatabase/mcp として登録されています。

• レジストリマニフェスト：server.json
• 検索：https://registry.modelcontextprotocol.io/v0.1/servers?search=com.nursinghomedatabase

REST API（同じバックエンド）

メインサイトでは、JSON 検索 API も利用できます。

• GET https://www.nursinghomedatabase.com/api/v1/nh/capabilities
• GET https://www.nursinghomedatabase.com/api/v1/nh/file-dates
• GET https://www.nursinghomedatabase.com/api/v1/nh/facilities?address=150+Corporate+Woods+Drive,+Magnolia,+TX+77354
• GET https://www.nursinghomedatabase.com/api/v1/nh/facilities?address=150+Corporate+Woods+Drive,+Magnolia,+TX+77354&radius_miles=10&sort=distance
• GET https://www.nursinghomedatabase.com/api/v1/nh/facilities?state=TX&min_overall_rating=4&sort=tothrd
• GET https://www.nursinghomedatabase.com/api/v1/nh/facilities?state=TX&filedate=2026-07-01
• GET https://www.nursinghomedatabase.com/api/v1/nh/field-values?field=ownership
• GET https://www.nursinghomedatabase.com/api/v1/nh/facilities?state=TX&ownership=Non+profit
• GET https://www.nursinghomedatabase.com/api/v1/nh/facilities/summary?metrics=tothrd,rnhrd,totalnursingstaffturnover&group_by=ownership_kind

REST の呼び出し元は、MCP ツールと同様に、施設および所有者のエンドポイントで filedate=YYYY-MM-DD（または YYYY-MM）を指定できます。min_overall_rating、max_overall_rating、abuse_icon、sffstatus、ownership は、GET /api/v1/nh/facilities のクエリパラメーターです。

MCP と REST は、同じ基盤データレイヤーを共有しています。

例：Cursor / IDE の設定

{
  "mcpServers": {
    "nursing-home-database": {
      "type": "streamableHttp",
      "url": "https://mcp.nursinghomedatabase.com/mcp"
    }
  }
}

ライセンスとデータ

データは、公開されている CMS および関連ソースに基づいています。利用は、nursinghomedatabase.com に掲載されている規約に従います。