Hospital Prices

@pipeworx/hospital-prices

美国医院公布的服务价格：通过 CMS 医院价格透明度规则要求医院发布的标准收费文件，查询 ZIP 附近医院针对 CPT/HCPCS 或 MS-DRG 代码公布的总收费、自费现金价格和付款方协商价格。

属于 Pipeworx 的一部分——一个将 AI Agent 连接到 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[]) — 并排比较最多 10 家指定医院的相同字段（按 CMS Certification Number 查询）。
• 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/（fleet #3035）。设计依据：docs/hospital-price-transparency-plan.md。

不包含个人数据：根据规定，文件中的协商价格最低值/最高值已去标识化。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

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

此端点实际提供的内容

tools/list 在 https://gateway.pipeworx.io/hospital-prices/mcp 上返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、 discover_tools、search_within、remember/recall，还有网关级工具集中的其他工具。因此，你看到的工具数量会多于此表：目前，单个工具包端点除了列出该工具包自己的工具，还会列出大约 30 个共享工具。连接的 initialize 响应会说明确切范围，是当天情况的权威依据。

这是有意为之，并非意外地进行了多路复用。元工具可以让限定范围的连接回答此工具包未涵盖的问题——通过 ask_pipeworx 在整个目录中路由——无需再添加第二个 MCP 服务。目前无法挂载不含这些元工具的工具包端点；如果额外的架构定义占用的上下文超过路由带来的价值，请连接一次完整网关，而不是连接多个工具包端点。

也可以连接完整的 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。查找工具：向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求，并使用 {"query":"..."}。

通过 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"]
    }
  }
}

没有密钥时，它会匿名调用，每天最多 50 次。免费账户可将上限提高至每天 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