Ca Medical Exclusions

@pipeworx/ca-medical-exclusions

加利福尼亚州 DHCS Medi-Cal 暂停资格和无资格（S&I）提供方名单筛查——按提供方姓名、NPI 或执照/提供方编号查询，核对其是否出现在这份约有 23,400 行的名单中。名单列出了被禁止参加加利福尼亚州 Medicaid 项目的提供方，是联邦 HHS OIG LEIE（leie pack）的州级对应名单，也是纽约 ny-omig-exclusions 的姊妹项目。

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

工具

• ca_medical_check_exclusion(name?, npi?, license?, limit?)——根据 DHCS S&I 名单筛查提供方。NPI 或执照匹配属于身份确认（两者都是提供方专属的精确标识符）；姓名匹配——即使完全相同——也仅是候选线索，因为名单不包含出生日期，而且许多实体记录没有名字或中间名，无法区分同名提供方。
• ca_medical_exclusion_coverage()——已收录的排除记录总数、其中包含 NPI 或执照编号的记录数、提供方类型多样性、最早和最新的暂停日期、适用于整份名单的法定依据，以及本 pack 提供的预置副本在 CHHS Open Data Portal 上的“最后修改”日期。

身份验证

无需密钥。

数据源

• https://data.chhs.ca.gov/api/3/action/datastore_search?resource_id=48630a37-b5ba-4d3d-af54-e82b30e658a0&limit=25000 ——CHHS Open Data Portal CKAN 数据存储中的完整 DHCS S&I 名单，提供规范的 JSON 数据（last_name、first_name、middle_name、AKA/DBA、address、provider type、license number、provider number(s)、date of suspension、active period）。单次请求即可返回全部约 23,400 条记录。
• https://data.chhs.ca.gov/api/3/action/resource_show?id=48630a37-b5ba-4d3d-af54-e82b30e658a0 ——资源元数据；last_modified 用作 data_as_of。
• https://data.chhs.ca.gov/dataset/provider-suspended-and-ineligible-list-s-i-list ——数据集面向用户的主页。

为什么使用 CHHS 数据存储，而不直接使用 dhcs.ca.gov/files.medi-cal.ca.gov

DHCS 自己的页面（dhcs.ca.gov、files.medi-cal.ca.gov）仅将 S&I 名单链接为以月份命名的 CSV，例如 suspended-ineligible-list-august-2026.csv。每月更新时文件名都会变化，因此无法通过固定 URL 获取，除非先从 HTML 页面抓取当前文件名。加利福尼亚州卫生与公众服务局（CHHS）的 Open Data Portal、data.ca.gov 和 catalog.data.gov 也发布了同一份数据集（相同的 CKAN resource_id：48630a37-b5ba-4d3d-af54-e82b30e658a0），三个门户都镜像了同一资源。CHHS CKAN API 的 datastore_search/resource_show 端点使用稳定的资源 ID，而非文件名作为索引，并直接返回规范的 JSON（无需解析 CSV）。本 pack 使用该 API。

为什么使用预置数据，而不是实时代理

根据根目录 CLAUDE.md 对这类大型表格的既定规则，完整名单（抓取时有 23,433 条记录，生成的 TypeScript 文件约 7.2MB）由 scripts/bake-index.mjs 预置到 src/ca-dhcs-index-data.ts，在 workers/gateway/src/pack-baked-indexes.json 中注册，部署时上传到 KV，并作为 args._bakedIndex 注入每次调用——绝不通过静态的模块作用域导入（fleet #2754：有六个 pack 这样做，导致每个网关 isolate 都保留约 48MB 堆内存，并因 Cloudflare 1102 错误使大约每四次调用中有一次失败）。如果注入缺失或格式错误，系统会明确抛出错误，而不会回答“未找到”——详见 src/index.test.ts。

定期重新运行 node mcps/ca-medical-exclusions/scripts/bake-index.mjs（DHCS/CHHS 每月更新名单）并重新提交；每个响应中的 data_as_of 都会说明预置副本相较于 CHHS 自身 last_modified 元数据有多陈旧。

这份数据不包含什么，以及它包含了哪些纽约名单没有的内容

提交此数据包的任务假定 DHCS 发布了“纽约没有的”逐条排除原因／法律依据字段。我们直接核对了 CHHS 实时数据存储（并非凭空假定）：**事实并非如此。**DHCS 发布的字段包括 Last/First/Middle Name、AKA/DBA、Address、Provider Type、License Number、Provider Number(s)（NPI 和／或非 NPI 代码，例如 PHA410230）、Date of Suspension 和 Active Period；没有逐行的法规、原因代码或案件引文。23,433 行中有 23,431 行的“Active Period”是“Indefinitely effective”，也不包含任何原因。

加州名单确实包含、但纽约 OMIG 名单缺少的内容：

• Provider Type — 数百种不同值（Registered Nurse、Physician、Pharmacy、Entity/Corporation 等），每次匹配都会返回。
• 公开发布的全名单法定依据 — 加州《福利与机构法典》第 14043.6 和 14123 条（重罪定罪、与 Medi-Cal 相关的轻罪、被联邦 Medicare/Medicaid 排除、丧失执照或违反合同）。这适用于整份名单，而非单条记录；每个响应都会以 statutory_basis 显示该依据，并明确标注其适用于全名单，而不是虚构逐条原因。

匹配

源数据中的 provider_numbers 是一个逗号分隔字段，可能混合 10 位 NPI 和非 NPI 代码（例如 PHA410230 这样的药房／注册编号）。此数据包会在构建时提取 10 位数字的标记作为 npis；npi 查询只与这些值匹配。license 查询会匹配单独的 License Number 字段，仅保留数字并去除前导零——与 ny-omig-exclusions 使用相同的比较方式。名称查询会匹配服务提供者组合后的名称（姓氏，或姓氏＋名字＋中间名）以及任何 AKA/DBA，不区分大小写和标点。

可访问性

已于 2026-10-07 使用笔记本电脑上的 curl 和生产账户中临时启动的 wrangler dev --remote Worker 进行实时验证：Cloudflare 边缘节点对 datastore_search（完整约 8.68MB 的负载，约 1.1 秒内返回）和 resource_show 均返回相同的 200 响应。与 oklahoma-code / utah-code / new-hampshire-code 不同，此主机无需 Supabase 出口中继。

快速开始

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

{
  "mcpServers": {
    "ca-medical-exclusions": {
      "url": "https://gateway.pipeworx.io/ca-medical-exclusions/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/ca-medical-exclusions/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 都连接到同一网关和相同的 1878+ 个数据源。唯一的区别是哪个数据包的工具会被直接列出；无论连接哪个端点，ask_pipeworx 都能访问所有数据包。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/ca_medical_check_exclusion \
  -H 'Content-Type: application/json' \
  -d '{"name":"111 Pharmacy"}'

首次调用无需账户。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/ca_medical_check_exclusion。查找工具：向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求，正文为 {"query":"..."}。

独立运行（无需网关账户）

此软件包也可作为本地 stdio MCP 服务运行，无需 Pipeworx 账户，也无需经过网关往返：

{
  "mcpServers": {
    "ca-medical-exclusions": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-ca-medical-exclusions"]
    }
  }
}

也可以直接运行，确认它能正常启动：

npx -y @pipeworx/mcp-ca-medical-exclusions

它通过 stdin/stdout 使用 MCP 通信，并针对仅限此软件包的工具响应 initialize/tools/list/tools/call——不包含上方网关连接所添加的任何共享元工具。相同的源代码，相同的工具，无需 ask_pipeworx 路由。

使用 ask_pipeworx

你也可以用通俗的英语提问，而不是直接调用工具——这既适用于上方的软件包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Ca Medical Exclusions data" })

网关会选择合适的工具并自动填写参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT