Simples Nacional

simples-nacional-mcp

用于计算 Simples Nacional 的 MCP 服务。七个工具，税表来自法律规定，还有两个工具专门用来避免最常见的错误结论。

pip install simples-nacional-mcp

为什么要做这个项目

询问助手一家企业在 Simples Nacional 下要缴多少税，它会计算有效税率——也就是 DAS 的税负，而不是总税负。两者的差别并非微不足道：

• 附表 IV（Anexo IV） 的 DAS 不包含雇主缴费。工资总额的 20%，另加 RAT，需单独缴纳。从税率来看，附表 IV 似乎比附表 III 更便宜。事实并非如此。
• 超过 360 万雷亚尔的子限额会降低 DAS 税率，因为 ICMS 和 ISS 不再计入 DAS。总税负并未下降，只是分摊方式变了。
• 单阶段征税或适用ICMS-ST的收入，会因处于供应链中的不同位置而产生相反影响：生产商在链外缴纳集中征收的税款；转售商则将收入单独划分，从而降低 DAS。

carga_fora_do_das 工具的作用，就是让助手解释这一点，而不是给出一个看似整齐却错误的数字。

工具

工具	可回答的问题
calcular_das	当月 DAS、有效税率、税率档、DAS 中包含的税种、子限额和退出该制度的标记。接受 rbt12，或接受 receita_acumulada + meses_de_atividade，用于经营未满十三个月的企业
resolver_anexo_fator_r	根据 Fator R 判断适用附表 III 还是 V，并提供比率和法规依据
ressalvas_setoriais	适用特殊制度的行业：酒精饮料和冷饮、药品、化妆品、汽车零部件、轮胎、燃料
carga_fora_do_das	说明税率未涵盖的内容，以及每项是增加还是减少税负
quantificar_segregacao	计算未将单阶段征税或适用 ICMS-ST 的收入单独划分所导致的额外缴税金额
comparar_anexos	按总税负比较五个附表，并加上附表 IV 未计入 DAS 的 CPP
indebito_acumulado	计算多个纳税期的多缴税款，并区分已超过时效的部分

人人都会漏算的数字

某家适用附表 I 的酒吧，RBT12 为 90 万雷亚尔，月收入为 8 万雷亚尔，其中 6 万雷亚尔来自啤酒：

未单独划分收入时的 DAS	6,560.00 雷亚尔
单独划分收入后的 DAS	4,149.20 雷亚尔
多缴金额	每月 2,410.80 雷亚尔

这相当于 DAS 的 37%，每年将近 29,000 雷亚尔，而且属于可追回的多缴税款。啤酒适用 PIS/COFINS 单阶段征税，并适用 ICMS-ST，因此该税率档的 49% 对应的税款已在供应链中缴纳。

quantificar_segregacao 会计算这一金额。超过子限额后，它会提示，单独划分 ICMS-ST 收入不会产生影响，因为此时 ICMS 已不再计入 DAS。

附表 IV 的陷阱：量化结果

RBT12 为 100 万雷亚尔，月收入为 8 万雷亚尔，工资总额为 30,000 雷亚尔：

附表	DAS 税率	单独缴纳的 CPP	总税负
III	12.44%	—	12.44%
IV	10.02%	6,300 雷亚尔	17.90%

comparar_anexos 会加上 DAS 之外的缴款，并在总税负的排序与税率的排序相反时发出提醒——上面的例子就是这种情况。未提供工资总额时，它会提示比较结果低估了附表 IV 的税负。

可追回多少

indebito_acumulado 接收各纳税期，并返回总额，同时区分仍在五年期限内的部分：

最近的 20 个纳税期	48,216.00 雷亚尔，可追回
2019 年的 2 个纳税期	4,821.60 雷亚尔，已超过时效

期限依据 CTN 第 168 条。计算时以 DAS 到期日作为缴款日期；行政申请不会中止期限。

在 Claude Code 中安装

claude mcp add simples-nacional -- simples-nacional-mcp

在 Claude Desktop 中安装

在 claude_desktop_config.json 中：

{
  "mcpServers": {
    "simples-nacional": {
      "command": "simples-nacional-mcp"
    }
  }
}

示例

一家服务类企业的 RBT12 为 100 万雷亚尔，工资总额为 250,000 雷亚尔：适用哪个附表，应缴多少？

助手会计算 Fator R（25%，低于 28%，因此适用附表 V），计算 DAS；被问到总税负时，会调用 carga_fora_do_das——该工具在附表 V 下返回空列表，确认这里的税率确实代表总税负。若改为附表 IV 下的业务，同样的问题就会返回单独缴纳的 CPP。

不负责什么

• carga_fora_do_das 不进行量化。 它说明哪些内容不在其中以及方向；如需数字，请使用 quantificar_segregacao，它根据 DAS 按税种的分配情况进行计算。
• 不判定活动类别。 确定某个 CNAE 对应的附件属于会计决策。
• 不提供税务咨询。 每个工具说明都会重复这一点，因为如果不提醒，助手就会把结果转述为建议。

计算在哪里

在 simples-nacional (PyPI) 中，那里收录了根据 LC 123/2006 转录的表格，并通过另一份独立转录进行了验证。这里只提供接口：法律内容不会在两个地方重复。

许可证

MIT