Hospital Prices

@pipeworx/hospital-prices

米国の病院が公表するサービス料金です。CMS の病院価格透明化規則に基づいて病院が公開する標準料金ファイルから、ZIP コード周辺の病院における CPT/HCPCS または MS-DRG コードの総請求額、自己負担の現金価格、保険者との交渉料金を取得します。

Pipeworx の一部です。AI エージェントを1858以上の稼働中データソースに接続する MCP ゲートウェイです。これは独立した非公式のインテグレーションであり、上流のプロバイダーとは提携関係になく、承認や公開も受けていません。

ツール

• hospital_price_search(code, near, radius_mi?, payer?, plan?, setting?, limit?) — ZIP コード（または lat,lon）から指定半径内にある病院を、近い順に取得します。各病院の総請求額、割引後の現金価格、匿名化された交渉額の最小値／最大値、保険者料金の概要が含まれます。payer／plan を指定すると、その保険者の交渉料金の行を返します。主要な保険者グループは、病院で使われているあらゆる表記で照合されます（blue cross では BCBS／Blue Shield／Anthem も検索され、uhc では UnitedHealthcare も検索されます。Aetna、Cigna、Humana、Kaiser も同様です）。料金が登録された各病院には payer_match（照合された表記と、その病院が掲載している保険者名）が含まれ、searched には payer_filter_normalised と検索した別名が含まれます。
• hospital_price_compare(code, ccns[]) — CMS Certification Number で指定した最大10病院について、同じ項目を並べて比較します。
• hospital_price_coverage(ccn? | name? | state?) — データストアに病院の料金があるかどうかを返します。ない場合は、その理由（ブロック、ファイルが見つからない、未対応バージョンなど）も返します。

交渉料金にはすべて dollar_available が含まれます。病院が金額ではなく割合や計算式を公表している場合は false となり、病院独自の方法論／計算式のテキストが返されます。金額を推測して返すことはありません。レスポンスには data_as_of（ファイル自体の最終更新日）、total／truncated／絞り込みのヒントが含まれます。また、空のリストではなく、具体的で明確な理由を返します。範囲内に病院がない、範囲内に病院はあるが料金データがない（その理由も表示）、ファイルは読み込まれているがコードが公表されていない、コードは公表されているが保険者が掲載されていない、などです。

認証

キーは不要です。データは Pipeworx 独自のデータストア（ゲートウェイにバインドされた D1 データベース）から読み取られます。このパックは Pipeworx ゲートウェイ経由でのみ応答します。スタンドアロンでインストールした場合、データストアがないことを明示して応答します。

データソース

• 各病院が公開する CMS 病院価格透明化標準料金ファイル（45 CFR 180）。レスポンスには病院名とファイルの種類を記載し、ダウンロード先は記載しません。

対応範囲は限定的で、その旨を明示します

• リクエストを拒否する病院のサイト（HTTP 403／ボットチャレンジ）は blocked として報告されます。ブロックを回避することはありません。それ以外の病院では、ファイルが見つからないか、解析できません。各病院にはステータスがあり、hospital_price_coverage で確認できます。
• 保存対象は CMS の70件の選択可能なサービス（69件の CPT/HCPCS コード）と MS-DRG のみです。それ以外のコードは「料金なし」ではなく code_not_in_scope を返します。
• データストアには、対象範囲を絞ったサイクルごとにデータが読み込まれます。料金データが登録されている病院数は、どのレスポンスでも coverage を確認してください。
• ZIP コード間の距離は、ZIP コードの中心点（町レベル）間の距離であり、道路上の距離ではありません。

ライセンス

ファイルは連邦政府の透明化義務に基づいて一般利用向けに公開されていますが、再利用ライセンスは付与されていません。このパックは、2026-09-23 の「ライブアクセスで提供されない場合はコピーを構築する」という判断に基づいて作成・フラグ付けされた、ファイルのフィルタリング済みコピーを提供します。すべてのレスポンスに licence_note が含まれます。取り込み、スキーマ、更新処理は scripts/hospital-prices/ にあります（フリート #3035）。設計記録：docs/hospital-price-transparency-plan.md。

個人データは含まれません。ファイル内の交渉額の最小値／最大値は、規則に基づいて匿名化されています。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurf など）に追加します。

{
  "mcpServers": {
    "hospital-prices": {
      "url": "https://gateway.pipeworx.io/hospital-prices/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/hospital-prices/mcp の tools/list は、上の表にあるツールに加えて、共通の Pipeworx メタツール（ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール群）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、パック固有のツールに加えて、共通ツールがおよそ 30 個表示されます。接続の initialize レスポンスには正確なスコープが示されており、その時点での正式な回答となります。

これは意図的なものであり、偶然の多重化ではありません。メタツールがあることで、このパックでは対応できない質問にも、カタログ全体を対象に振り分ける ask_pipeworx を通じて回答できます。そのため、MCP サーバーをもう 1 つ追加する必要はありません。現在、メタツールを含めずにパックのエンドポイントを接続する方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度接続してください。

または、フル Pipeworx ゲートウェイに接続して、このパックだけでなく、すべてのパックのツールを直接一覧表示できます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も、同じゲートウェイと同じ 1858 以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも ask_pipeworx を使えば、すべてのツールにアクセスできます。

MCP クライアントをお持ちでない場合：HTTP で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/hospital_price_search \
  -H 'Content-Type: application/json' \
  -d '{"code":"470","near":"60453","radius_mi":10,"limit":4}'

最初の呼び出しにアカウントは必要ありません。任意のツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/hospital_price_search を実行します。ツールを見つけるには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

npm から実行する

@pipeworx/mcp-hospital-prices は、Pipeworx ゲートウェイへのローカル stdio ブリッジです。MCP クライアントが npx で起動し、すべての呼び出しを上記と同じ https://gateway.pipeworx.io/hospital-prices/mcp エンドポイントに転送します。ネットワークアクセスが必要で、オフラインモードはありません。

{
  "mcpServers": {
    "hospital-prices": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-hospital-prices"]
    }
  }
}

キーがない場合は匿名で呼び出され、1 日あたり 50 回までに制限されます。無料アカウントでは 1 日あたり 200 回まで利用できます。https://pipeworx.io/signup でキーを取得し、サーバーエントリに "env": { "PIPEWORX_API_KEY": "<your key>" } を追加してください。キーはホスト型接続と同じ方法で Bearer トークンとして送信されるため、呼び出しはそこでの利用とまったく同じように計測・課金されます。

デフォルトでは、このパックのツールのみが一覧表示されます。PIPEWORX_META_TOOLS=1 を設定すると、ask_pipeworx やその他のゲートウェイ共通ツールも一覧表示されます。

HTTPS プロキシ経由で接続する場合：Node の組み込み fetch は、デフォルトでは HTTPS_PROXY を読み取りません。新しい Node リリースでは NODE_USE_ENV_PROXY=1 を設定すると利用できます。お使いの Node バージョンのドキュメントを確認してください。

ask_pipeworx を使う

ツールを直接呼び出す代わりに、平易な英語で質問できます。これは上記のパックエンドポイントでも、フルゲートウェイでも利用できます。

ask_pipeworx({ question: "your question about Hospital Prices data" })

ゲートウェイが適切なツールを選択し、引数を自動的に設定します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT