Brasil Planos de Saúde (ANS)

brasil-planos-saude-mcp

MCP 服务，帮助解答巴西的**“这款医疗保险计划怎么样？”**Claude（或任何 MCP 客户端）可以查询医疗保险运营商（operadora de plano de saúde），了解监管机构 ANS 发布的信息：投诉、质量评分、医疗服务可及性监测、罚款和费率调整。还可以并排比较运营商并对其排名。

**只读，无需密钥或账户。**所有数据均来自 ANS 开放数据门户。本项目与 ANS 或任何运营商均无关联。

**数据针对运营商，而非计划或价格。**ANS 按运营商发布这些指标。一家运营商销售的多款计划可能有不同的服务网络；请向运营商或经纪人确认服务网络和价格。

**不构成法律建议。**如遇程序遭拒或延迟，请使用 where_to_complain（Disque ANS 0800 701 9656）。如遇紧急情况，请先就医。

工具

operator_profile

查看一家运营商的所有信息：注册信息和状态（有效，或已取消并附日期和原因）、受益人数和规模类别、投诉指数及其在同规模运营商中的排名、过去五年的 IDSS、医疗服务可及性等级、罚款，以及小团体费率调整。

参数：operator（名称或部分名称、CNPJ 或 ANS 注册编号）、coverage（medica 或 odonto）。像 “Unimed” 这样的共享品牌（由数百家独立合作社组成）会返回规模最大的匹配项，并要求提供更具体的名称。

compare_operators

并排比较 2 至 8 家运营商：12 个月投诉指数与其规模类别的中位数、最新 IDSS、最新医疗服务可及性等级、过去五年的罚款、最新小团体费率调整。

参数：operators（列表）、coverage。

rank_operators

按投诉情况（by="reclamacoes"，数值越低越好）或质量（by="qualidade"，采用最新 IDSS，数值越高越好）为有效运营商排名。

参数：by、coverage、porte（pequeno、medio、grande）、uf、modality、min_beneficiaries（默认值为 5000）、worst_first、limit。

find_operators

按名称、CNPJ 或注册编号搜索，或按总部所在州、市或运营类型列出运营商（cooperativa médica、medicina de grupo、seguradora、autogestão、odontologia de grupo、filantropia）。规模最大的排在最前。

where_to_complain

ANS 官方渠道，信息已在 ANS 消费者服务页面核实，并介绍投诉（NIP）的处理方式。

数值含义

指标	含义	越好	更新频率
IGR（Índice Geral de Reclamações）	每月每 100,000 名受益人向 ANS 提出的投诉数（采用 2023 年方法）。ANS 会比较规模相同的运营商：小型 < 20k，中型 20k-100k，大型 > 100k 名受益人。服务还会提供 12 个月平均值，数据更稳定。	越低越好	每月
IDSS（Índice de Desempenho da Saúde Suplementar）	ANS 每年发布的 0-1 评分，包含四个维度：医疗质量（IDQS）、可及性（IDGA）、市场可持续性（IDSM）、流程与监管（IDGR）。	越高越好	每年
Garantia de atendimento	针对保障遭拒或延迟情况的季度等级：0 表示没有经确认的投诉，1 表示低于中位数，3 表示高于中位数 50% 以上。反复达到 3 级会导致 ANS 暂停计划销售。	越低越好	每季度，ANS 发布时更新
Penalidades	ANS 处以的罚款，按年份和状态列出，包括处于申诉中、已暂停或已归档的罚款。不代表实际缴纳的金额。	相对规模而言越少越好	ANS 发布时更新
Reajuste do agrupamento	运营商对其承保人数少于 30 人的集体合同组合所实施的费率调整。个人和家庭计划则遵循 ANS 设定的上限。		每年

每项结果都会标明各项数据对应的月份、季度或年份，并链接到数据来源文件。

数据和缓存

首次调用会下载 7 个 ANS 文件（约 65 MB），并在你的用户缓存文件夹中保留一份精简副本（约 1 MB）。24 小时后，服务会向 ANS 查询文件是否有变更，仅在文件有变更时重新下载。如果 ANS 不可用，则使用缓存副本并说明这一点。要提前填充缓存：

brasil-planos-saude-mcp --refresh

设置 BRASIL_PLANOS_SAUDE_CACHE_DIR 以使用其他文件夹。

运营商注册文件还包含运营商的联系电子邮箱和其法定代表人的姓名。此服务不会提供这两项信息。

安装

最快方式（需要 uv）：无需克隆，可直接从 PyPI 运行。

claude mcp add brasil-planos-saude -- uvx brasil-planos-saude-mcp

对于 Claude Desktop，请使用 "command": "uvx", "args": ["brasil-planos-saude-mcp"]。

从源代码安装：

需要 Python 3.10 或更高版本。

git clone https://github.com/ThiagoJacobLannes/brasil-planos-saude-mcp
cd brasil-planos-saude-mcp
python -m pip install -e .

在 Windows 上，如果你将代码保存在云同步文件夹（Google Drive、OneDrive）中，请在该文件夹之外创建虚拟环境。同步客户端会将 desktop.ini 文件放入文件夹中，这可能导致软件包在启动时崩溃。

添加到 Claude Code

claude mcp add brasil-planos-saude -- python -m brasil_planos_saude_mcp.server

添加到 Claude Desktop

将 claude_desktop_config.snippet.json 合并到你的 Claude Desktop claude_desktop_config.json，然后重启 Claude Desktop：

{
  "mcpServers": {
    "brasil-planos-saude": {
      "command": "python",
      "args": ["-m", "brasil_planos_saude_mcp.server"]
    }
  }
}

示例问题

• “Hapvida 靠谱吗？它的投诉情况如何？”
• “比较 Amil、Bradesco Saúde、SulAmérica 和 Porto Seguro。”
• “哪些大型健康保险计划的投诉最少？”
• “评级最高的牙科保险计划有哪些？”
• “Unimed Campinas 被 ANS 罚过款吗？”
• “我的保险计划拒绝了某项治疗。我该向哪里投诉？”

许可证

MIT