Simples Nacional MCP server

simples-nacional-mcp

<!-- mcp-name: io.github.vitorantoniazzi/simples-nacional-mcp -->

Servidor MCP para cálculo do Simples Nacional. Sete ferramentas, tabelas vindas da lei, e duas que existem para impedir a conclusão errada mais comum.

pip install simples-nacional-mcp

Por que existe

Pergunte a um assistente quanto uma empresa paga de imposto no Simples e ele vai calcular a alíquota efetiva — que é a carga do DAS, não a carga tributária. A diferença não é sutil:

• O DAS do Anexo IV não abrange a contribuição patronal. São 20% sobre a folha, mais RAT, recolhidos à parte. Pela alíquota, o Anexo IV parece mais barato que o Anexo III. Não é.
• Cruzar o sublimite de R$ 3,6 mi reduz a alíquota do DAS, porque ICMS e ISS saem dele. A carga não cai; ela se reparte.
• Receita monofásica ou com ICMS-ST muda a conta em direções opostas conforme a posição na cadeia: quem produz recolhe o concentrado por fora, quem revende segrega e reduz o DAS.

A ferramenta cargaforado_das existe para que o assistente diga isso em vez de entregar um número redondo e errado.

Ferramentas

O número que ninguém calcula

Um bar no Anexo I, RBT12 de R$ 900 mil, receita mensal de R$ 80 mil sendo R$ 60 mil em cerveja:

São 37% do DAS, quase R$ 29 mil por ano, e é indébito recuperável. Cerveja é monofásica de PIS/COFINS e tem ICMS-ST, então 49% da alíquota daquela faixa corresponde a tributos já recolhidos na cadeia.

quantificar_segregacao calcula isso. Acima do sublimite ela avisa que segregar ICMS-ST não muda nada, porque ali o ICMS já não integra o DAS.

A armadilha do Anexo IV, quantificada

RBT12 de R$ 1 milhão, receita mensal de R$ 80 mil, folha de R$ 30 mil:

comparar_anexos soma o que fica fora do DAS e alerta quando a ordem por carga inverte a ordem por alíquota — que é o caso acima. Sem folha informada, ela avisa que a comparação subestima o Anexo IV.

E quanto dá para recuperar

indebito_acumulado recebe as competências e devolve o total, separando o que ainda cabe no prazo de cinco anos:

Prazo do art. 168 do CTN. A contagem usa o vencimento do DAS como referência do pagamento; pedido administrativo não interrompe o prazo.

Instalação no Claude Code

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

Instalação no Claude Desktop

Em claudedesktopconfig.json:

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

Exemplo

Uma empresa de serviços com RBT12 de R$ 1 milhão e folha de R$ 250 mil: qual anexo, e quanto paga?

Shortened. The full README is on GitHub.