Cms Open Payments

mcp-cms-open-payments

公式 DKAN API を通じて、年次データセットを検出できる CMS Open Payments です。

Pipeworx の一部です。AI エージェントを 1875 以上のライブデータソースに接続する MCP ゲートウェイです。これは独立した非公式のインテグレーションであり、上流プロバイダーとの提携、同社による承認、または同社からの公開を受けたものではありません。

ツール

ツール	説明
open_payments_top_companies	プログラム年度に、米国の医師および教育病院への支払額が最も多かった医薬品・医療機器メーカーを順位付けします。「医師に最も多く支出しているのは誰か」という疑問に答えます。各社について、米ドルでの総額、支払件数、支払先となった個別の受領者数を、支出額の多い順に返します。CMS は集計値を公開しておらず、稼働中の API では1,400万行の支払テーブルをグループ化できないため、このツールはオフラインで計算されたサマリーを読み込みます。応答にはプログラム年度とサマリーの更新日時が記載されます。支払は価値移転の開示情報であり、不正行為の証拠ではありません。
open_payments_search	製薬・医療機器業界から医師への資金提供を調べる際の主要な情報源です。「メーカーから医師への支払」「この医師に支払った製薬会社」「サンシャイン法のデータ」「業界から病院への支払」などを検索できます。構造化された受領者、会社、製品、地域、支払の性質、金額の各フィルターを使い、CMS Open Payments のプログラム年度データセットを1つ検索します。機能の制限を守り、推測せずに明示してください。この情報源では検索と絞り込みはできますが、すべてのメーカーを支出総額で順位付けすることはできません（「最も多く支払ったメーカーはどこか」は、1,400万行の集計が上流でタイムアウトするため、稼働中には算出できません）。そのような質問には、その旨を伝え、代わりに会社名を指定した検索（open_payments_company）を提案してください。CMS は企業が報告した関係を公開しています。支払があったからといって、不正行為や利益相反があるとは限りません。
open_payments_physician	プログラム年度を1つ指定し、正確な NPI で医師・非医師の医療従事者に関する CMS Open Payments の記録を検索します。正確な一致件数と、件数に上限を設けた支払サンプルを返します。報告された関係は不正行為を意味しません。NPI ではなく氏名がある場合は、まず NPPES レジストリ（clinicaltables pack の npi_individual）で確認するか、受領者の姓と名を指定して open_payments_search を使用してください。
open_payments_company	CMS Open Payments のプログラム年度を1つ指定し、メーカーまたは GPO が報告した支払を検索します。会社名の照合では、大文字と小文字を区別しない部分一致を使うため、似た名称の法人がまとめて検索されることがあります。
open_payments_product	CMS の5つすべての製品欄を対象に、指定した医薬品、生物製剤、医療機器、医療用品に関連付けられた一般支払の記録を検索します。製品との関連付けは報告主体が行うものであり、その支払がその製品だけに対するものだったことを証明するものではありません。
open_payments_research	プログラム年度を1つ指定し、会社、受領者の NPI、研究名、または州で CMS の研究支払記録を検索します。金額は機関を経由した資金を表す場合があるため、自動的に個人への報酬とみなさないでください。
open_payments_recipient_history	正確な受領者 NPI を指定し、複数年にわたる CMS Open Payments の履歴を作成します。信頼できる年間一致件数と、件数に上限を設けたサンプルを返します。サンプルの金額合計がデータセット全体の合計ではないことを明示します。
open_payments_company_history	会社名の部分文字列を指定し、複数年にわたる CMS Open Payments の履歴を作成します。この検索における年間件数は正確です。金額は返された件数に上限のあるサンプルのみを対象とし、会社名の別名によって法人が分割または統合されることがあります。
open_payments_product_history	CMS の製品欄全体で、報告された製品名の部分文字列を指定し、複数年にわたる一般支払の履歴を作成します。製品との関連付けは報告者が行います。サンプルの金額は年間の完全な合計ではありません。
open_payments_compare_companies	CMS Open Payments のプログラム年度を対象に、会社名の検索クエリを2～5件比較します。正確な一致件数と、サンプルの範囲が明確に示されたデータを使用します。一致する全行がサンプルに含まれる場合を除き、支出総額全体を比較するものではありません。
open_payments_nature_breakdown	受領者、会社、または製品を1つ指定し、複数年にわたる件数に上限のある支払サンプルを、報告された支払の性質別に分類します。内訳に示される件数と金額はサンプルの統計値です。年間の total_matches は、引き続き検索の正確な件数を示します。

クイックスタート

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

{
  "mcpServers": {
    "cms-open-payments": {
      "url": "https://gateway.pipeworx.io/cms-open-payments/mcp"
    }
  }
}

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

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

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

または、フル Pipeworx ゲートウェイに接続すると、このパックのツールだけでなく、すべてのパックのツールが直接一覧表示されます：

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

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

MCP クライアントがない場合は、HTTP 経由で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/open_payments_top_companies \
  -H 'Content-Type: application/json' \
  -d '{"limit":3}'

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

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイとの往復通信も不要です：

{
  "mcpServers": {
    "cms-open-payments": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-cms-open-payments"]
    }
  }
}

または、直接実行して起動を確認します：

npx -y @pipeworx/mcp-cms-open-payments

stdin/stdout 経由で MCP を使用し、このパックのツールのみについて initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使用する

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

ask_pipeworx({ question: "your question about Cms Open Payments data" })

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

詳細

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

ライセンス

MIT