Skip to main content
Glama
Pergunte à Reforma

Pergunte à Reforma

Pergunte à Reforma

Pergunte em português, receba o valor do imposto, a explicação e o artigo da LC 214/2025. A conta é sempre feita pelo motor oficial da Receita Federal, nunca pela IA.

Status: 🟢 Semana 1 quase concluída: motor oficial buildando e testado no CI, ETL e busca de NCM/NBS prontos (Bloco 2 · Projeto 1). Plano completo em docs/PLANO.md e tarefas nas Issues e Milestones.


A ideia em 30 segundos

Você:  "Quanto de imposto tem num pacote de arroz de R$ 25 e numa cerveja de R$ 8?"

Agente: busca "arroz" → NCM 1006.30.21 → cesta básica (redução de 100%)
        busca "cerveja" → NCM 2203.00.00 → alíquota cheia + Imposto Seletivo
        chama o MOTOR OFICIAL → recebe os valores
        responde com os números do motor, o artigo da lei e um gráfico

O resultado não vem só em texto: aparece um painel visual com a memória de cálculo (base → redução → CBS → IBS → IS), a comparação entre os itens e o caminho da classificação ("por que deu isso").

Related MCP server: mcp-calculadora-rtc

Use com a IA que você já tem

Em vez de cobrar uma API de IA do projeto, você usa o seu próprio Claude, ChatGPT ou Gemini:

Modo

Como funciona

Quem paga o modelo

1. Conector (principal)

Cole a URL do servidor MCP em Conectores do Claude, Apps do ChatGPT ou Connected Apps do Gemini. As ferramentas e os painéis visuais aparecem dentro do chat que você já usa.

A sua assinatura

2. Site com sua chave

No site, escolha Claude, GPT ou Gemini e cole sua chave de API. Ela fica só no seu navegador.

A sua chave

3. Demonstração grátis

Algumas perguntas por dia com um modelo leve, para quem só quer testar.

O projeto (com limite)

Por que não "entrar com a conta do Claude/ChatGPT/Gemini" dentro do site? Os termos de uso da Anthropic e do Google proíbem que apps de terceiros usem o login da assinatura do usuário (e contas já foram bloqueadas por isso). O conector MCP inverte a lógica: o projeto entra na sua conta, não o contrário. Detalhes em ADR-001.

Arquitetura

flowchart LR
    subgraph Usuario["Onde a pessoa pergunta"]
        C[Claude] & G[ChatGPT] & Ge[Gemini]
        W[Site Next.js<br/>BYOK ou demo]
    end
    subgraph Projeto["Pergunte à Reforma"]
        MCP[Servidor MCP<br/>ferramentas + painéis]
        CORE[core<br/>guardrails e cenários]
        S[(Busca híbrida<br/>NCM · NBS · anexos)]
    end
    E[[Motor oficial RTC<br/>Java · Cloud Run]]

    C & G & Ge -- MCP --> MCP
    W --> CORE
    MCP --> CORE
    CORE --> S
    CORE -- cálculo e dados abertos --> E

Mais detalhes em docs/ARQUITETURA.md.

Princípios inegociáveis

  1. A IA não faz conta. Todo número exibido vem da resposta do motor oficial (ADR-002).

  2. Toda resposta cita a lei: artigo da LC 214/2025 e a classificação usada (CST/cClassTrib).

  3. Na dúvida, pergunta. Se o produto cabe em duas classificações, o agente pergunta em vez de chutar.

  4. Simulação, não consultoria. O aviso aparece em toda resposta. A partir de 2027 as alíquotas são cenários configuráveis e isso fica explícito.

  5. Medido, não prometido. A taxa de acerto é medida contra os casos de teste oficiais do repositório da Receita (docs/AVALIACAO.md).

Rodando localmente

pnpm install --ignore-scripts
pnpm --filter @reforma/search etl        # clona a calculadora oficial (1.6.1), gera o banco e exporta data/*.json
pnpm --filter @reforma/search avaliar     # mede a busca no gabarito (top-1/3/5)
docker run -p 8080:8080 ghcr.io/nicolasdev-web/rtc-engine:1.6.1   # motor oficial
engine/smoke.sh                           # confere o exemplo oficial da Receita

Estrutura do repositório

engine/          Dockerfile do motor oficial (Java 21 + SQLite gerado no build)
packages/core/   cliente do motor, ferramentas, cenários, guardrails (TypeScript)
packages/search/ ETL dos dados abertos + índice de busca NCM/NBS/anexos
apps/mcp/        servidor MCP remoto + painéis visuais (MCP Apps)
apps/web/        site Next.js: chat BYOK/demo + painéis
eval/            gabarito a partir dos testes oficiais + runner de avaliação
docs/            plano, arquitetura, ideias, ADRs, posts

Créditos e aviso

  • Motor de cálculo: ReceitaFederal/calculadora-rtc-regime-regular (licença MIT), usado sem modificações.

  • Projeto independente, sem vínculo com a Receita Federal ou o SERPRO. É uma simulação e não substitui orientação de um contador.

Feito por Nicolas Santos · Licença MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      MCP server that exposes Brazilian tax infrastructure as tools, resources, and prompts, enabling AI agents to emit and manage fiscal documents (NF-e, NFC-e, NFS-e, CT-e, MDF-e, DC-e) through natural language.
      -
    • A
      license
      A
      quality
      C
      maintenance
      Enables interaction with the Brazilian Federal Revenue's official consumption tax calculator, performing CBS/IBS/Imposto Seletivo calculations, rate lookups, NCM/NBS validation, and fiscal document XML operations, while attaching provenance metadata to every result.
      17
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables calculation of Simples Nacional taxes in Brazil, including DAS, effective rate, Fator R, sector exemptions, and tax amounts not covered by the DAS, helping assistants avoid incomplete or misleading tax conclusions.
      7
      37 PyPI
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables AI assistants and automation tools to query and analyze Brazilian fiscal data, including CNPJ, Simples Nacional, NF-e, NFS-e, SPED, eSocial, tax regime comparison, and supplier risk assessment without requiring API keys.
      44
      MIT