Medicaid Intelligence

@pipeworx/medicaid-intelligence

CMS Medicaid Open Data API による、Medicaid の医薬品利用、マネージドケアの加入状況、州の加入業務データです。認証情報は不要です。

Pipeworx の一部です。AI エージェントを 1882 以上のライブデータソースにつなぐ MCP ゲートウェイです。これは独立した非公式の統合であり、上流プロバイダーとは提携関係になく、承認も受けておらず、公開もされていません。

ツール

ツール	返されるデータ
medicaid_drug_utilization	1 つの NDC に関する州別・四半期ごとの利用状況。出来高払いとマネージドケアは別々に保持されます
medicaid_drug_state_market	1 年分の、州別に集計された 1 つの NDC のデータ
medicaid_drug_trend	2020 年以降の、1 つの NDC に関する年間処方数、単位数、総償還額
medicaid_managed_care_summary	州別の年間加入者数、およびマネージドケア全体または包括的マネージドケアへの加入者数
medicaid_managed_care_program_mix	包括的 MCO、PCCM、MLTSS、行動医療、歯科、交通、PACE など、プログラム種別ごとの州別加入者数
medicaid_plan_market	州別のマネージドケアのプラン／プログラム行の上限付きサンプルと、該当行の正式な件数
medicaid_monthly_managed_care	1 つの州と参加区分に関する、Medicaid／CHIP の月次加入者数
medicaid_enrollment_operations	1 つの州に関する、月次加入者数と申請処理指標

認証

不要です。すべてのエンドポイントは、data.medicaid.gov 上の CMS の公開インフラです。

数値を正しく読み取る

このデータソースは誤解されやすく、このパックの設計の大部分はその防止を目的としています。各レスポンスには、該当する注意点を示す interpretation フィールドが含まれます。

• 償還額はリベート控除前の総額です。 total_amount_reimbursed は、州の Medicaid プログラムが薬局に支払った金額です。メーカーの売上でも正味価格でもありません。Medicaid のリベートは相当な額ですが、このデータには含まれていません。これらの数値をメーカーの Medicaid 売上として扱うと、実際よりも、しばしば大幅に過大評価することになります。
• 抑制された値はゼロではありません。 CMS は小さなセルを抑制します（DS、*、--、または suppression_used フラグ）。これらは 0 ではなく null になり、ある区分のデータがすべて抑制されている場合は、利用実績がないのではなく、利用可能なデータがないと報告されます。テストでも、この点を特に確認しています。
• 出来高払いとマネージドケアは別々の指標であり、別々に保持されます。州ごとの構成比が時間とともに変化するため、ほとんどの質問では両者を合算しても意味がありません。
• マネージドケアのプログラム区分は重複するため、合算してはいけません。 受給者が包括的 MCO、MLTSS、行動医療のそれぞれに計上される場合があります。medicaid_managed_care_program_mix の interpretation にもその旨が記載されています。
• 加入者数は州が報告したプログラム加入者数であり、特定の保険会社に帰属する加入者数ではありません。保険者の事業規模と単純に対応させることはできません。
• プランファイルのゼロは、空のプランではなく、機密保持のための抑制を示す場合があります。 medicaid_plan_market は上限付きのサンプルと正式な総行数を返すため、リストが短くても市場が小さいとは限りません。

引数の規則

基盤となるデータセットでは、州の表記方法が統一されていません。医薬品ファイルでは 2 文字のコードが使われ、加入者数とマネージドケアのファイルでは州名がフルで使われます。どちらの形式もすべてのツールで受け付けられ、内部で変換されます。これは重要です。以前は、マネージドケアの概要に "CA" を指定すると何も一致せず、確信度の高い total: 0 が返されていました。これは、引数が間違っているのに「カリフォルニアにはマネージドケアがない」と読み取れてしまう結果です。

ndc には、ハイフンの有無を問わず、正確な 11 桁の National Drug Code を指定します。ブランド名や成分名を指定すると、{found:false, reason:'ndc_expected_got_name'} が返され、まず名前を解決するための openfda_drug_label または rxnorm を示すヒントが付いています。

失敗の形

回復可能な呼び出し元のミスは、代わりに何をすべきかを示す {found:false, reason, hint} に解決されます。 上流の障害または実際の不具合は、{error, hint} に解決されます。この2つは意図的に区別されているため、監視処理で「CMS に拒否された」のか「不正なデータを返した」のかを判別できます。

データソース

すべてのデータセットは、CMS Medicaid Open Data データストア API https://data.medicaid.gov/api/1/datastore/query を通じて照会されます。

• State Drug Utilization Data — 2020年から2026年まで、各年に1つのデータセットがあります
• Managed Care Enrollment Summary とプログラム別登録者数
• Managed Care Plan and Program data
• Monthly Medicaid and CHIP managed-care enrollment
• Medicaid and CHIP enrollment and operations reports

クイックスタート

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

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

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

https://gateway.pipeworx.io/medicaid-intelligence/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 も、同じゲートウェイと同じ1882以上のデータソースに接続します。違いは、どのパックのツールを直接一覧表示するかだけです。どちらからでも、ask_pipeworx を使ってすべてのツールにアクセスできます。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/medicaid_drug_utilization \
  -H 'Content-Type: application/json' \
  -d '{"drug":"Ozempic","year":2026,"state":"CA"}'

最初の呼び出しにアカウントは必要ありません。ツールの詳細を確認するには、GET https://gateway.pipeworx.io/v1/tools/medicaid_drug_utilization を使います。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を使います。

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

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

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

または、起動を確認するために直接実行します。

npx -y @pipeworx/mcp-medicaid-intelligence

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

ask_pipeworx を使う

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

ask_pipeworx({ question: "your question about Medicaid Intelligence data" })

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

詳細情報

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

ライセンス

MIT