Nc Medical Exclusions

@pipeworx/nc-medical-exclusions

根据北卡罗来纳州 Medicaid 服务提供者排除名单，筛查服务提供者或企业名称、NPI，或非 NPI 的“特殊” Medicaid 服务提供者 ID。该名单是联邦 HHS OIG LEIE 在北卡罗来纳州层面的对应名单，也是 ny-omig-exclusions、 ca-medical-exclusions、tx-medical-exclusions、fl-medical-exclusions、 pa-medical-exclusions、ga-medical-exclusions、oh-medical-exclusions 和 nj-medical-exclusions 的同类工具。

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

工具

• nc_medical_check_exclusion(name?, npi?, atypical_id?, limit?) — 根据名单筛查服务提供者或企业。匹配到 NPI 或特殊 ID 即为身份确认；名称匹配 EXCLUDED ENTITY 字段仅为潜在线索。若名称仅匹配某条记录的 OWNERSHIP 字段（根据 NC Medicaid 自行发布的说明，该字段列出所有者／负责人以供参考），则返回 match_type: "ownership_only_match" 和 excluded:false — 不会将其误判为被排除。
• nc_medical_exclusion_coverage(year?, start_date?, end_date?) — 不带参数时，返回记录总数、包含 NPI 与特殊 ID 的记录数、不同的排除原因，以及最早和最晚的生效日期。提供 year 或日期范围时，统计该时间段内生效的排除记录数（按 effective_date 统计，涵盖整个名单，而非单页数据）。

身份验证

无需密钥。

数据源

• NC Medicaid，健康福利司，合规与项目诚信办公室 — 州级被排除服务提供者名单。因故被终止参与北卡罗来纳州 Medicaid 及其他健康计划的服务提供者。无需登录，无 CAPTCHA。

注意事项

• 这是当前快照，并非历来被排除者的历史记录 — 与 TX/PA/NJ 先例工具包不同。NC Medicaid 未发布终止／恢复资格日期列；恢复资格的服务提供者会直接从下一个月度文件中消失（与 ga-medical-exclusions 的处理方式相同）。因此，此工具包提供的每条记录均为 currently_excluded:true。
• 不提供家庭住址。 此来源的任何记录都不含街道地址 — CITY/STATE/ZIP 是服务提供者的注册地点，提供的粒度与 ga-medical-exclusions 的 STATE 字段相同，绝非街道级地址。
• OWNERSHIP 不代表被排除。 NC Medicaid 自行发布的注意事项指出：除非同时列在 EXCLUDED ENTITY 下，否则 OWNERSHIP 列中的名称不会被排除。此工具包通过不同的匹配类型明确保留这一区别，不会将所有权字段的匹配视为确认结果。
• 标识符不总是 NPI。 NC Medicaid 使用的列标题为“NPI/ATYPICAL ID (EXCLUDED)” — 大多数记录包含格式正确的 10 位 NPI，但少数记录使用 8 位、非 NPI 的“特殊” Medicaid 服务提供者 ID。npi 和 atypical_id 分别存储在不同字段中。
• 源文件中的生效日期类型并不统一 — 大多数记录将日期存储为 Excel 日期序列号，少数记录则使用字面上的“MM/DD/YYYY”字符串。两种格式都会解码为相同的 ISO 日期。
• 通过 scripts/bake-index.mjs 刷新；该脚本会重新获取已发布的文件（NC Medicaid 的下载链接稳定，无需重新解析列表页），并重建 src/nc-dhb-index-data.ts；请定期重新运行并提交更新。每条响应中的 data_as_of 会说明烘焙副本的数据陈旧程度。

快速开始

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

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

此端点实际提供的内容

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

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

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

首次调用无需账户。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/nc_medical_check_exclusion。查找工具：使用 {"query":"..."} 调用 POST https://gateway.pipeworx.io/v1/tools/search_packs。

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

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

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

或者直接运行，确认它能够启动：

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

它通过 stdin/stdout 使用 MCP 通信，并响应 initialize/tools/list/tools/call，仅提供此工具包的工具——不包含上述网关连接添加的任何共享元工具。数据源相同，工具相同，但不提供 ask_pipeworx 路由。

使用 ask_pipeworx

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

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

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT