Medicaid Intelligence

@pipeworx/medicaid-intelligence

来自 CMS Medicaid Open Data API 的 Medicaid 药品使用情况、管理式医疗参保情况和州级参保运营数据。无需密钥。

这是 Pipeworx 的一部分——一个将 AI Agent 接入 1882+ 个实时数据源的 MCP 网关。这是一个独立的非官方集成，与上游提供方无关联，未获其认可，也非其发布。

工具

工具	返回内容
medicaid_drug_utilization	某个 NDC 的州级季度使用情况数据，按按服务收费和管理式医疗分别列出
medicaid_drug_state_market	某个 NDC 在某一年的各州汇总数据
medicaid_drug_trend	自 2020 年起，某个 NDC 的年度处方量、用量和总报销金额
medicaid_managed_care_summary	各州年度参保人数，以及参加任何管理式医疗或综合管理式医疗的人数
medicaid_managed_care_program_mix	各州按项目类型划分的参保人数——综合 MCO、PCCM、MLTSS、行为健康、牙科、交通、PACE
medicaid_plan_market	按州筛选的管理式医疗计划/项目行数上限样本，以及权威的匹配行总数
medicaid_monthly_managed_care	某个州按参与类别划分的 Medicaid/CHIP 月度参保人数
medicaid_enrollment_operations	某个州的月度参保人数和申请处理指标

身份验证

无。所有端点均为 data.medicaid.gov 上的公开 CMS 基础设施。

正确解读这些数据

这个数据源很容易被误读，因此该工具包的大部分设计都旨在避免这一问题。每个响应都包含一个 interpretation 字段，说明适用的注意事项。

• 报销金额为折扣前的总额。 total_amount_reimbursed 是州 Medicaid 项目支付给药房的金额。它既不是制造商收入，也不是净价——Medicaid 的折扣金额很可观，但本数据不包含这些信息。若将这些数字视为制造商的 Medicaid 收入，就会高估收入，往往高估很多。
• 被抑制不等于零。 CMS 会抑制较小的数据单元（DS、*、-- 或 suppression_used 标记）。这些值会变为 null，而非 0；如果某个渠道的数据全部被抑制，则会报告为不可用，而不是没有使用情况。测试会专门对此进行验证。
• 按服务收费和管理式医疗是两种独立指标，始终分开列出。对于大多数问题，将它们相加没有意义，因为各州的构成会随时间变化。
• 管理式医疗项目类别存在重叠，不可相加。 同一位受益人可能同时计入综合 MCO、MLTSS 和行为健康类别。medicaid_managed_care_program_mix 会在其 interpretation 字段中说明这一点。
• 参保人数是各州报告的项目参保人数，并非可归属于特定保险公司的承保人数。它们无法与付款方的业务规模直接对应。
• 计划文件中的零值可能表示保密抑制，而非空计划。medicaid_plan_market 会返回有限数量的样本和权威的行总数，因此列表较短并不意味着市场规模较小。

参数约定

底层数据集对州名的写法并不一致——药品文件使用两字母代码，参保和管理式医疗文件使用全名。所有工具都接受这两种形式，并会在内部转换。这一点很重要：在支持这项功能之前，用 "CA" 查询管理式医疗摘要会匹配不到数据，并返回一个看似确定的 total: 0，让人误以为“加利福尼亚州没有管理式医疗”，而不是参数有误。

ndc 接受精确的 11 位国家药品代码，可带连字符，也可不带。若传入品牌名或成分名，则会返回 {found:false, reason:'ndc_expected_got_name'}，并提示先使用 openfda_drug_label 或 rxnorm 进行解析。

失败形式

可恢复的调用方错误会返回 {found:false, reason, hint}，指出应采取的操作。 上游故障或真实缺陷会返回 {error, hint}。两者经过有意区分，因此监控扫描可以分辨“CMS 拒绝了我们的请求”和“我们返回了垃圾数据”。

数据来源

所有数据集均通过 CMS Medicaid Open Data 数据存储 API 查询： https://data.medicaid.gov/api/1/datastore/query：

• 州药品使用数据 — 每年一个数据集，涵盖 2020 至 2026 年
• Managed Care Enrollment Summary 和 按项目划分的参保情况
• Managed Care Plan and Program data
• Medicaid 和 CHIP 管理式医疗月度参保数据
• Medicaid 和 CHIP 参保及运营报告

快速开始

添加到你的 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 跨整个目录进行路由 — 无需添加第二个 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