关于 Cms Open Payments
Cms Open Payments 是面向研究人员和分析人员的 MCP 服务,用于调查 CMS 披露的药械企业向医生和医院支付款项。支持结构化搜索、收款方和企业历史记录,以及标明样本范围的跨年度比较。
主要功能
- 01按结构化条件搜索支付记录
- 02按 NPI 查询医生记录
- 03搜索企业、产品和研究支付
- 04构建收款方、企业及产品历史
- 05跨项目年度比较企业查询
- 06按申报支付性质拆分样本
适用场景
- 01查找某医生或企业的披露支付记录
- 02追踪产品相关支付的历史
- 03比较企业跨年度支付记录
- 04按收款方或州查看研究支付记录
MCP 相关
通过 Pipeworx 网关端点或本地 stdio 服务,向 MCP 客户端提供 CMS Open Payments 搜索和历史查询工具。网关端点还包含 Pipeworx 共享元工具。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://gateway.pipeworx.io/cms-open-payments/mcpclaude mcp add --transport http pipeworx-io-cms-open-payments https://gateway.pipeworx.io/cms-open-payments/mcp{"mcpServers":{"pipeworx-io-cms-open-payments":{"type":"http","url":"https://gateway.pipeworx.io/cms-open-payments/mcp"}}}在 Cursor 中打开{"servers":{"pipeworx-io-cms-open-payments":{"type":"http","url":"https://gateway.pipeworx.io/cms-open-payments/mcp"}}}在 VS Code 中打开{"mcpServers":{"pipeworx-io-cms-open-payments":{"type":"http","url":"https://gateway.pipeworx.io/cms-open-payments/mcp"}}}{"mcpServers":{"pipeworx-io-cms-open-payments":{"serverUrl":"https://gateway.pipeworx.io/cms-open-payments/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
详细介绍
mcp-cms-open-payments
CMS Open Payments,通过官方 DKAN API 发现年度数据集。
这是 Pipeworx 的一部分——一个将 AI Agent 连接到 1875+ 个实时数据源的 MCP 网关。这是一个独立的非官方集成,与上游提供商无关联、未获其认可,也并非由其发布。
工具
| 工具 | 描述 |
|---|---|
open_payments_top_companies | 按项目年度列出向美国医师和教学医院支付金额最多的药品和器械制造商排名——回答“哪些公司在医生身上花钱最多”的问题。返回每家公司支付的美元总额、付款笔数以及收到付款的不同对象数量,并按支出排序。CMS 不发布汇总数据,其实时 API 也无法对 1,400 万行付款表进行分组,因此此工具读取离线计算的摘要;响应会注明项目年度和摘要刷新时间。付款是价值转移披露,并非不当行为的证据。 |
open_payments_search | 查找制药/器械行业向医生支付款项的权威来源——例如“制造商向医师支付的款项”“哪些制药公司向这位医生付款”“阳光法案数据”“行业向医院支付的款项”。使用一个 CMS Open Payments 项目年度数据集,按结构化的收款人、公司、产品、地理位置、付款性质和金额筛选。能力限制,请明确说明,不要猜测:此来源可查询和筛选,但无法按总支出对所有制造商排名(无法实时计算“哪个制造商支付最多”——上游对 1,400 万行数据的聚合会超时);遇到此类问题,请说明这一限制,并建议改为查询指定公司(使用 open_payments_company)。CMS 发布的是公司申报的关系;付款并不代表存在不当行为或利益冲突。 |
open_payments_physician | 按精确 NPI,在一个项目年度内查找 CMS Open Payments 中某位医师/非医师执业者的记录。返回权威匹配总数以及数量有限的付款样本;申报的关系并不代表存在不当行为。如果你有姓名而非 NPI,请先通过 NPPES 注册表(clinicaltables pack 中的 npi_individual)解析姓名,或使用 open_payments_search 并提供 recipient_last_name + recipient_first_name。 |
open_payments_company | 搜索一个 CMS Open Payments 项目年度内由制造商或 GPO 申报的付款。公司匹配不区分大小写,并可能合并名称相似的法律实体。 |
open_payments_product | 搜索与指定药品、生物制品、器械或医疗用品相关的一般付款记录,涵盖 CMS 的全部五个产品槽位。产品关联由申报实体提供,并不能证明付款完全是针对该产品。 |
open_payments_research | 按公司、收款人 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 | 按申报的付款性质,分年度细分某个收款人、公司或产品的有限付款样本。细分中的计数和金额是样本统计数据;年度 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 在整个目录中进行路由——无需添加第二个 MCP 服务。目前无法挂载不包含这些元工具的工具包端点;如果额外的 schema 占用的上下文超过了路由带来的价值,请连接完整网关一次,而不是连接多个工具包端点。
或者,连接完整的 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" })
网关会自动选择合适的工具并填写参数。
更多信息
许可证
MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。