MCP Imposto de Renda
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
O MCP Imposto de Renda é um servidor MCP (Model Context
Protocol) que roda na sua máquina e conversa com o seu cliente MCP via stdio. Ele lê e grava o
arquivo de cópia de segurança da declaração (.DBK) do programa oficial, calcula o imposto nos
modelos completo e simplificado, explica cada conta, aponta pendências e consulta as tabelas de
códigos do exercício. No fim, você restaura o arquivo no programa oficial, confere e transmite por
lá.
Leia antes de usar.
O MCP Imposto de Renda não é serviço oficial da Receita Federal e não tem vínculo com ela nem com qualquer órgão público.
Ele não transmite declarações e não acessa sistemas do governo. A entrega é sempre feita pelo programa oficial (PGD).
Ele não envia nada pela rede. Porém, tudo o que as ferramentas devolvem ao seu cliente MCP (nomes, CPFs, rendimentos, bens) chega ao provedor de LLM que você escolheu nesse cliente. Leia a política de privacidade desse provedor e decida o que compartilhar.
Não há garantia de exatidão. A responsabilidade pela declaração é sempre do contribuinte.
Sumário
Related MCP server: simples-nacional-mcp
Por que usar
Você conversa, o assistente preenche. Cole o informe de rendimentos, descreva as despesas e peça para lançar. O servidor acha os códigos certos, grava cada ficha e devolve as pendências na mesma resposta.
Cada conta explicada.
explicar_calculomostra a memória de cálculo linha a linha, com a lei aplicada em cada passo: tetos, limites por dependente, truncamento de centavos, comparação entre os modelos.Arquivo do programa oficial, não um formato paralelo. O resultado é um
.DBKque o programa da Receita restaura com Ferramentas > Cópia de Segurança > Restaurar. Dá para começar do zero ou partir de uma declaração já iniciada no programa.Conferido contra o programa oficial. O motor reproduz ao centavo 65 casos de referência gerados pelo próprio programa, e o codec regrava byte a byte os arquivos que ele grava.
Seus arquivos ficam com você. Sem servidor, conta, telemetria ou conexão de rede. O processo só enxerga a pasta que você autorizar e guarda cópia de cada versão antes de gravar.
Software livre e auditável. AGPL-3.0, em TypeScript, sem nenhum código da Receita Federal.
Como é na prática
Trecho real do exemplo 1, com as respostas exatas do
servidor. Todos os dados são fictícios; a conversa inteira está em
conversa.md.
Você: Este é o meu informe de rendimentos da empresa: rendimentos tributáveis R$ 96.000,00, previdência oficial R$ 9.840,00, imposto retido R$ 11.400,00, 13º salário R$ 8.000,00 com IRRF de R$ 652,30.
O assistente chama adicionar_rendimento_pj com o CNPJ da fonte e os valores, e o servidor
responde:
Rendimentos Tributáveis Recebidos de Pessoa Jurídica: item 1 incluído. Gravado 10121874206-IRPF-A-2026-2025-ORIGI.DBK (6 registros).
Cópia do conteúdo anterior: .mcp-imposto-de-renda-backups/10121874206-IRPF-A-2026-2025-ORIGI.DBK.20260410T120000Z.bak.
Controles: conferem.
Sem erros impeditivos; 0 aviso(s).Você: Qual modelo é melhor para mim? Me mostre a conta.
definir_opcao_tributacao grava o modelo mais vantajoso e explicar_calculo devolve a memória de
cálculo (trecho):
Modelo simplificado:
1. Rendimentos tributáveis: R$ 96.000,00 [Mesma soma do modelo completo.]
2. Desconto simplificado: 20% de R$ 96.000,00 = R$ 19.200,00, limitado a R$ 16.754,34; desconto R$ 16.754,34 [Lei 9.250/1995, art. 10, ...]
3. Base de cálculo: R$ 96.000,00 - R$ 16.754,34 = R$ 79.245,66
4. Imposto pela tabela anual (alíquota de 27,50% menos parcela a deduzir de R$ 10.853,78): R$ 10.938,77
...
13. Imposto a restituir: R$ 11.400,00 - R$ 10.938,77, se positivo = R$ 461,23 [Lei 9.250/1995, art. 13.]Você: Quero receber a restituição por Pix na chave do meu CPF. Confira o arquivo e me diga como entregar.
O servidor grava a opção, confere os controles de integridade (verificar_integridade_arquivo) e
devolve o passo a passo para restaurar e transmitir no programa oficial
(instruir_transmissao).
Início rápido
Requisito: Node.js 22 ou superior. A versão 0.1.0 ainda não foi publicada no npm; até lá,
instale a partir do código (o pnpm vem com corepack enable).
1. Instale e compile.
git clone https://github.com/ALASTecnology/mcp-imposto-de-renda.git
cd mcp-imposto-de-renda
corepack enable && pnpm install && pnpm build
node apps/cli/dist/index.js --versao2. Crie uma pasta só para a declaração e registre o servidor no seu cliente. No Claude
Desktop, por exemplo, em claude_desktop_config.json:
{
"mcpServers": {
"mcp-imposto-de-renda": {
"command": "node",
"args": [
"/caminho/para/mcp-imposto-de-renda/apps/cli/dist/index.js",
"--dir",
"/Users/voce/Documentos/IR-2026"
]
}
}
}Depois da publicação no npm, o comando vira npx -y mcp-imposto-de-renda --dir <pasta>. Opções
úteis:
Opção | Efeito |
| 90 ferramentas: a declaração inteira, sem os atalhos repetidos por ficha. Use em clientes com limite de ferramentas (VS Code: 128; Windsurf: 100). |
| 44 ferramentas: só leitura e cálculo, nada grava. |
| Expõem ou tiram grupos inteiros, por nome. |
| Desliga todas as ferramentas que gravam arquivos. |
3. Converse. Peça "Vamos preparar a minha declaração do IRPF 2026" ou acione o prompt
preparar_declaracao. Para partir do que você já tem, grave a cópia de segurança no programa
oficial dentro da pasta e peça para abrir o .DBK.
Mais detalhes em instalação, no tutorial da primeira declaração e em solução de problemas.
Clientes compatíveis
O servidor funciona em qualquer cliente que inicie servidores MCP locais por stdio. O índice de clientes traz o nível de suporte e um guia de configuração para cada um, inclusive os que exigem ponte local ou não são suportados.
Cliente | Suporte | Guia |
Claude Desktop | Completo | |
Claude Code | Completo | |
ChatGPT (aplicativo de desktop) e OpenAI Codex | Completo | |
Gemini CLI e Antigravity | Completo | |
GitHub Copilot no VS Code | Completo, com limite de ferramentas do cliente | |
Cursor | Completo | |
Windsurf | Completo, com limite de ferramentas do cliente | |
Zed, JetBrains, Cline, Continue, goose, Kiro | Completo | |
LM Studio e Ollama (modelo local) | Completo | |
Open WebUI | Com ponte local |
Com um modelo rodando na sua máquina (LM Studio, Ollama), nada da declaração sai do computador.
Destaques
Números conferidos no código desta versão (pnpm docs:catalogo e pnpm test).
Indicador | Valor | Onde conferir |
Ferramentas MCP | 166 em 11 grupos; 100 gravam, 66 com | |
Casos de referência (golden) reproduzidos ao centavo | 65 de 65 | |
Arquivos do programa oficial relidos e regravados byte a byte | 96 (48 | |
Tipos de registro do | 57, em 26 fichas | |
Regras de validação | 108 (81 erros e 27 avisos) | |
Tabelas de códigos do exercício | 31 | |
Funções do programa oficial mapeadas | 416: 408 atendidas, 7 parciais, 1 sem equivalente | |
Testes automatizados | mais de 1.100 testes, em Vitest (o total exato sai de | |
Declarações de exemplo regeneradas a cada teste | 4 | |
Chamadas de rede | nenhuma (verificado por teste) |
Ferramentas
Grupo | Ferramentas | O que cobre |
20 | Criar, retificar, copiar, restaurar, fechar e excluir; importar a declaração de 2025, a pré-preenchida, o demonstrativo do GCAP e o Livro Caixa da Atividade Rural; opção de tributação, conta e quotas; importação de informes colados | |
4 | Abrir o | |
5 | Listar a pasta e as declarações (em preenchimento e transmitidas), gravar relatório em PDF ou HTML, conferir os controles de integridade e pré-validar o arquivo de entrega como o validador da Receita | |
1 | Ler uma ficha isolada | |
105 | Incluir, alterar, remover e listar em 22 fichas em lista, mais as fichas únicas | |
2 | Consultar as 32 tabelas de códigos | |
2 | Pendências da declaração e conferência de CPF, CNPJ, NIT, recibo, CEP, contatos, Renavam e conta bancária | |
6 | Simular, comparar modelos, explicar o cálculo, quotas, multa e parâmetros | |
10 | Carnê-leão, RRA, preço médio, renda variável, ganho de capital, acréscimos, residência, obrigatoriedade, câmbio | |
4 | Dados do Darf, relatório, comunicação de saída e passo a passo da transmissão | |
7 | Ajuda do programa, atalhos com a ferramenta equivalente, calculadora exata, serviços que só existem fora do servidor, diagnóstico do servidor e modelo de sugestão para o projeto |
A referência das ferramentas traz, para cada uma, os parâmetros com
tipo e obrigatoriedade, as anotações MCP, um exemplo real de chamada e resposta e as funções
correspondentes do programa oficial. Todas são locais (openWorldHint: false); as que gravam são
anunciadas com destructiveHint: true, para o cliente pedir confirmação.
Valores monetários na entrada: texto é sempre em reais no formato brasileiro
("1.234,56"); número inteiro é sempre em centavos (123456 = R$ 1.234,56). No modelo JSON da
declaração, os valores são inteiros em centavos, as datas em AAAA-MM-DD e CPF/CNPJ só com dígitos.
Tipo | Nome | Para que serve |
Prompt |
| Roteiro guiado de coleta dos informes e preenchimento das fichas, com simulação a cada etapa. Argumento opcional |
Prompt |
| Revisão em busca de pendências e inconsistências que costumam levar à malha fina. Argumento opcional |
Recurso |
| Limites do servidor: não é serviço oficial, dados vão ao provedor de LLM, revisar e transmitir pelo programa oficial. |
Gerado a partir de tools/list do servidor: 166 ferramentas em 11 grupos, 100 delas gravam na pasta autorizada (e somem com --somente-leitura, que deixa 66).
calculo
Simulação do imposto, comparação de modelos, quotas, multa e parâmetros.
Ferramenta | O que faz | Grava? |
| Calcula o imposto da declaração (exercício 2026, ano-calendário 2025) nos modelos completo e simplificado e indica o mais vantajoso, com saldo a pagar ou a restituir. | não |
| Compara as deduções legais (modelo completo) com o desconto simplificado de 20% (limitado a R$ 16.754,34) e mostra a diferença de resultado. | não |
| Devolve a memória de cálculo linha a linha, em pt-BR, com a conta feita e a regra legal aplicada em cada passo (rendimentos, deduções, base, tabela progressiva, incentivos, imposto pago, saldo). | não |
| Divide o saldo de imposto a pagar em até 8 quotas (mínimo R$ 50,00 cada; abaixo de R$ 100,00 só quota única), com vencimentos e juros Selic a partir da 2ª quota. | não |
| Multa por atraso (MAED): 1% ao mês-calendário ou fração sobre o imposto devido, mínimo R$ 165,74 e máximo 20%. | não |
| Tabela progressiva anual, limites de dedução, desconto simplificado, prazos e quotas do exercício, com as fontes oficiais. | não |
declaracao
Abrir, converter e gravar o arquivo da declaração (DBK/DEC). Exige --dir.
Ferramenta | O que faz | Grava? |
| Lê um DBK ou DEC da pasta autorizada e devolve um resumo: contribuinte, tipo de declaração, quantidade de itens e totais por ficha, registros por tipo e integridade dos controles. | não |
| Converte um DBK/DEC da pasta autorizada no modelo JSON do MCP Imposto de Renda (identificação, dependentes, rendimentos de PJ, pagamentos, bens e dívidas). | não |
| Grava a declaração (modelo JSON) em um arquivo .DBK da pasta autorizada. | sim |
| Gera o arquivo de entrega (.DEC) a partir de um .DBK da pasta autorizada, montando os registros do recibo (HR, DR e R9) e recalculando os controles, como o programa oficial grava. | sim |
fichas
Consulta de fichas da declaração. Exige --dir.
Ferramenta | O que faz | Grava? |
| Devolve só uma ficha (identificação, dependentes, rendimentos de PJ, pagamentos, bens ou dívidas) de um DBK/DEC/JSON da pasta autorizada, no formato do modelo (centavos). | não |
edicao
Inclusão, edição, remoção e listagem de lançamentos de cada ficha da declaração. Exige --dir.
Fichas em lista: cada uma tem quatro ferramentas. As de inclusão, alteração e remoção validam a declaração e gravam o .DBK com cópia de segurança, devolvendo as pendências.
Ficha | Incluir | Alterar | Remover | Listar |
Dependentes |
|
|
|
|
Alimentandos |
|
|
|
|
Rendimentos Tributáveis Recebidos de Pessoa Jurídica |
|
|
|
|
Rendimentos Isentos e Não Tributáveis |
|
|
|
|
Rendimentos Sujeitos à Tributação Exclusiva/Definitiva |
|
|
|
|
Rendimentos Tributáveis de PJ (Exigibilidade Suspensa) |
|
|
|
|
Rendimentos Recebidos Acumuladamente |
|
|
|
|
Pagamentos Efetuados |
|
|
|
|
Doações Efetuadas |
|
|
|
|
Doações Diretamente na Declaração |
|
|
|
|
Bens e Direitos |
|
|
|
|
Dívidas e Ônus Reais |
|
|
|
|
Herdeiros/Meeiro |
|
|
|
|
Doações a Partidos Políticos e Candidatos |
|
|
|
|
Demonstrativo de Ganhos de Capital |
|
|
|
|
Renda Variável: Operações Comuns/Day-Trade |
|
|
|
|
Renda Variável: Operações em FII ou Fiagro |
|
|
|
|
Demonstrativo da Atividade Rural: Imóveis explorados |
|
|
|
|
Demonstrativo da Atividade Rural: Receitas e despesas |
|
|
|
|
Demonstrativo da Atividade Rural: Movimentação do rebanho |
|
|
|
|
Demonstrativo da Atividade Rural: Bens da atividade rural |
|
|
|
|
Demonstrativo da Atividade Rural: Dívidas vinculadas à atividade rural |
|
|
|
|
Demais ferramentas do grupo:
Ferramenta | O que faz | Grava? |
| Mostra todas as fichas do modelo com a quantidade de itens preenchidos em um DBK/DEC, e quais estão em lista, consultáveis por listar_lancamentos e editáveis pelas ferramentas genéricas de lançamento. | não |
| Lista os itens de qualquer ficha em lista, com a posição de cada um. | não |
| Altera um item de qualquer ficha em lista (campos mesclados; null remove), valida e grava com cópia de segurança. | sim |
| Remove um item de qualquer ficha em lista, valida e grava com cópia de segurança (dependente ou alimentando com vínculos exige cascata: true). | sim |
| Mescla os campos informados na ficha Identificação do Contribuinte (nome, nascimento, endereço, ocupação, cônjuge, tipo de declaração, retorno ao país, NIT). | sim |
| Lança os valores mensais (carnê-leão) de uma pessoa: informe 'mes' e 'valores' (coluna: valor) para um mês, ou 'colunas' (coluna: 12 valores) para o ano. | sim |
| Grava o mês (comuns e day-trade por mercado, IRRF de day-trade, IRRF da Lei 11.033 e imposto pago) do titular ou de um dependente; também aceita os valores de janeiro vindos de anos anteriores. | sim |
| Grava o mês das operações com cotas de FII ou Fiagro (resultado líquido, imposto retido e imposto pago) do titular ou de um dependente; 'prejuizo_anterior' informa o prejuízo vindo de anos anteriores. | sim |
| Grava a ficha Espólio: 'tipo' ajuste (declaração de ajuste com natureza 81: sobrepartilha e inventariante) ou final (Declaração Final de Espólio: ano do óbito, modalidade, bens a inventariar, decisão judicial ou escritura, inventariante e cônjuge). | sim |
| Grava a ficha Saída Definitiva do País (campos mesclados aos atuais; 'remover': true apaga a ficha). | sim |
| Grava a ficha Informações do Cônjuge (campos mesclados aos atuais; 'remover': true apaga a ficha). | sim |
| Grava as receitas e despesas da atividade rural: na aba brasil, itens { mes, receitaBruta, despesa }; na aba exterior, itens { pais, receitaBrutaMoedaOriginal, despesaMoedaOriginal, resultadoDolar }. | sim |
| Grava os campos digitados da apuração da atividade rural (prejuízo anterior, opção resultado ou limite20, compensação, adiantamentos, limite de 20% no exterior). | sim |
| Grava a movimentação de uma espécie do rebanho (1 a 4 conforme o programa, 5 = outros): estoque inicial, aquisições, nascimentos, consumo e perdas, vendas. | sim |
| Na Declaração Final de Espólio, define para um bem (posição em listar_lancamentos com ficha 'bens') se ainda está a inventariar, a situação na data da partilha, o valor de transferência e os percentuais por herdeiro (centésimos: 100,00% = 10000; herdeiros cadastrados em adicionar_herdeiro). | sim |
| Aplica a um bem (posição em listar_lancamentos com ficha 'bens') um caso especial: usufruto (com os CPF/CNPJ dos proprietários ou usufrutuários), bem a inventariar, atualização pela Lei 14.973/2024 ou criptoativo em custodiante; 'desfazer': true desmarca. | sim |
| Procura, nos DBK/DEC da pasta autorizada, o nome já informado para um CPF ou CNPJ (fontes pagadoras, dependentes, beneficiários de pagamentos e doações). | não |
ciclo
Ciclo de vida da declaração (criar, retificar, excluir), opções do Resumo e importações. Exige --dir.
Ferramenta | O que faz | Grava? |
| Começa a declaração de 2026 com os dados do arquivo de 2025 (DEC gravado para entrega, transmitido ou DBK de cópia de segurança, lido com o leiaute de 2025), como "Importar dados da Declaração de 2025" do programa: Identificação; dependentes e alimentandos; fontes pagadoras de PJ e beneficiários de pagamentos (sem valores); bens e dívidas com situação em 31/12/2024 diferente de zero (o valor passa para a coluna de 31/12/2024); imóveis, bens, rebanho (estoque final como inicial) e dívidas da atividade rural; e o recibo de 2025. | sim |
| Cria a declaração de 2026 a partir do arquivo da pré-preenchida trazido pelo usuário (o DBK ou DEC que o programa oficial grava depois de "Iniciar a partir da Pré-Preenchida" com a conta gov.br Ouro ou Prata). | sim |
| Importa na declaração o arquivo que o GCAP 2025 grava em "Exportar para o IRPF2026" (-DDMM-DDMM-GCAP-2025.DEC, um zip com o XML do demonstrativo), como "Importar dados de Ganhos de Capital" do programa: substitui o demonstrativo do mesmo CPF e período e refaz os valores transportados para Rendimentos Isentos (05 pequeno valor, 06 único imóvel, 07 demais reduções, no campo transportado) e Tributação Exclusiva (02 ganho de capital, 03 bens adquiridos em moeda estrangeira, 04 moeda estrangeira em espécie), mantendo o que foi digitado nesses isentos. | sim |
| Importa na declaração o arquivo que o programa Livro Caixa da Atividade Rural 2025 grava em "Exportar para o IRPF" (-ARURAL-2025-2025-EXPORTA-IRPF2026.DEC), como "Importar dados da Atividade Rural" do programa: confere o exercício e o controle do arquivo, substitui as receitas e despesas mensais da aba Brasil (as despesas não dedutíveis não entram), grava na Apuração os adiantamentos recebidos e a receita de produtos entregues por adiantamentos anteriores, substitui a linha de cada país da aba Exterior (moeda original) e refaz o isento 15 (resultado não tributável). | sim |
| Equivalente ao Fechar do programa oficial: espera terminar qualquer gravação em andamento no arquivo (a fila de gravação do servidor), confere os controles do que ficou no disco e informa a última cópia de segurança automática. | não |
| Cria um DBK novo na pasta autorizada a partir da identificação do contribuinte (formato do modelo) e da opção de tributação. | sim |
| Marca a declaração como retificadora com o número do recibo (12 dígitos) da declaração a retificar e grava em um novo DBK (padrão: CPF-IRPF-A-2026-2025-RETIF.DBK), preservando o restante. | sim |
| Guarda o número do recibo (12 dígitos) que o programa oficial mostrou ao transmitir a declaração, num arquivo <declaração>.recibo.json ao lado do DBK/DEC, para preencher uma futura retificadora (criar_retificadora sem 'recibo'). | sim |
| Remove um DBK ou DEC da pasta autorizada, guardando antes uma cópia em .mcp-imposto-de-renda-backups. | sim |
| Copia um DBK ou DEC da pasta para outro .DBK (um DEC vira DBK sem o recibo, com os controles refeitos). | sim |
| Lista as cópias automáticas guardadas em .mcp-imposto-de-renda-backups (feitas antes de sobrescrever ou excluir), da mais recente para a mais antiga. | não |
| Restaura uma cópia de .mcp-imposto-de-renda-backups (nome de listar_copias_seguranca) sobre um .DBK da pasta (padrão: o arquivo de origem; cópia de um .DEC exige arquivo_destino .DBK). | sim |
| Escolhe deduções legais (completa) ou desconto simplificado, preservando as deduções informadas, e devolve a comparação dos dois modelos com a recomendação. | sim |
| Grava a conta para restituição ou débito (banco, agência sem DV, conta, DV, tipo e operação da Caixa), Pix pela chave CPF, número de quotas (1 a 8) e débito automático, validando banco, agência, conta e DV pela regra de cada banco. | sim |
| Grava as linhas digitadas da ficha Imposto Pago/Retido: imposto complementar (Darf 0246), imposto pago no exterior e imposto retido na fonte da Lei 11.033/2004. | sim |
| Copia a situação em 31/12/2024 para 31/12/2025 nos bens escolhidos (posições de listar_lancamentos com ficha 'bens') ou, sem 'indices', em todos os bens com situação atual zerada; forcar: true copia mesmo quando já há valor. | sim |
| Lança na declaração o comprovante de rendimentos de PJ colado pelo usuário, em texto ou JSON (sem OCR e sem rede): fonte e CNPJ, quadro 3 (rendimentos, previdência oficial, IRRF), quadro 4 (isentos como parcela de 65 anos, indenizações, lucros), quadro 5 (13º e IRRF do 13º, PLR, aplicações) e plano de saúde do quadro 7. | sim |
| Lança em Pagamentos Efetuados (código 26) o informe de plano de saúde colado em texto ou JSON: operadora (CNPJ e nome), valor pago por beneficiário e reembolsos. | sim |
| Lê o comprovante de rendimentos de PJ colado em 'texto' ou num arquivo .txt da pasta autorizada e devolve os campos extraídos por regras fixas (fonte e CNPJ, rendimentos, previdência oficial, IRRF, 13º e IRRF do 13º, isentos e exclusivos), sem gravar nada, sem OCR e sem rede. | não |
| Soma, por beneficiário com 65 anos ou mais em 2025 (contando a partir do mês em que completa 65), a parcela isenta de aposentadoria (isento código 10) de todas as fontes, aplica o limite de R$ 1.903,98 por mês mais o 13º e transfere o excedente para os Rendimentos Tributáveis de PJ da mesma fonte, como a pergunta do programa. | sim |
validacao
Validação de CPF, CNPJ, recibo, CEP, contatos, Renavam, conta bancária e pendências da declaração.
Ferramenta | O que faz | Grava? |
| Confere o formato e o dígito verificador de um campo como o programa oficial faz na digitação. | não |
| Aplica as regras de consistência equivalentes às críticas do programa oficial e lista as pendências: 'erro' impede a entrega, 'aviso' indica risco de malha fina. | não |
tabelas
Tabelas de códigos do programa (dependentes, pagamentos, bens, municípios...).
Ferramenta | O que faz | Grava? |
| Lista as entradas de uma tabela de códigos do exercício 2026, com filtro opcional por texto (sem diferenciar acentos) e paginação. | não |
| Busca um código exato numa tabela do exercício 2026. | não |
arquivos
Arquivos da pasta autorizada. Exige --dir.
Ferramenta | O que faz | Grava? |
| Lista os arquivos .DBK, .DEC, .json e .txt da pasta autorizada (sem subpastas, ocultos ou links). | não |
| Relação das declarações DBK/DEC da pasta autorizada, como as abas "Em Preenchimento" e "Transmitidas" da tela inicial e a Relação de Declarações do programa: nome, CPF, exercício, tipo (ajuste, final de espólio, saída definitiva), original ou retificadora, modelo (completa ou simplificada) e situação (em preenchimento para DBK, gravada para entrega para DEC, transmitida quando há recibo registrado). | não |
| Grava na pasta autorizada, em PDF (A4) ou HTML, com layout próprio: o relatório da declaração ( | sim |
| Confere os controles do arquivo: número de controle (CRC-32) de cada registro, contagens do registro T9 e hash do header. | não |
| Reúne num relatório único o que o validador da Receita confere na recepção e que dá para conferir localmente: tipo e exercício do arquivo, número de controle (CRC-32) de cada linha, NR_CONTROLE do header, contagens do T9, NR_HASH do header, NR_HASH do R9 (no .DEC), pendências de erro da validação e totais do Resumo refeitos pelo motor de cálculo. | não |
saidas
Etapa final: dados do Darf e passo a passo para transmitir pelo programa oficial.
Ferramenta | O que faz | Grava? |
| Calcula os dados do Darf (código de receita, período de apuração, vencimentos e valores de cada quota, juros Selic das quotas e, se informada a data de pagamento após o vencimento, multa de 0,33% ao dia até 20% e juros de mora). | não |
| Gera o passo a passo e o checklist para concluir no programa oficial da declaração 2026: restaurar o DBK gravado pelo MCP Imposto de Renda, verificar pendências, conferir o Resumo, transmitir com ou sem certificado digital, guardar o recibo e pagar o Darf. | não |
| Monta o relatório da declaração para conferência ou impressão, com layout próprio. | não |
| Gera o texto da comunicação de saída definitiva do país, uma por fonte pagadora de rendimentos de PJ, a partir da ficha Saída Definitiva. | não |
calculadoras
Calculadoras auxiliares offline: renda variável, preço médio, carnê-leão, RRA, ganho de capital e acréscimos.
Ferramenta | O que faz | Grava? |
| Calcula o carnê-leão (Darf 0190) de um mês de 2025 pela tabela progressiva mensal vigente no mês (janeiro a abril pela Lei 14.848/2024; maio a dezembro pela Lei 15.191/2025), com as deduções de previdência oficial, dependentes (R$ 189,59 cada), pensão e livro-caixa, ou o desconto simplificado mensal quando mais vantajoso. | não |
| Calcula o imposto do RRA pela tabela progressiva acumulada (tabela mensal do mês do recebimento vezes o número de meses, art. | não |
| Calcula o custo médio ponderado por ativo e o resultado de cada venda a partir das notas de corretagem (compras e vendas com custos), separando day-trade (compra e venda do mesmo ativo no mesmo dia), para preencher a Renda Variável. | não |
| Apura o imposto mensal sobre ganhos líquidos: operações comuns 15%, day-trade 20%, FII e Fiagro 20%, com compensação de prejuízos separada por tipo, compensação de IR na fonte (day-trade e Lei 11.033/2004), isenção de ganhos com ações à vista quando as vendas do mês não passam de R$ 20.000,00 e Darf 6015 com vencimento no último dia útil do mês seguinte. | não |
| Simulador de orientação para alienação de imóvel, móvel, participação ou moeda estrangeira em espécie, conferido ao centavo com o GCAP 2025: ganho = valor de alienação menos corretagem e custo; para imóveis, reduções em cascata da Lei 7.713/1988 (aquisição até 1988) e dos fatores FR1/FR2 da Lei 11.196/2005 (meses contados inclusive, percentual com 6 casas, cada redução truncada no centavo); isenções do único imóvel até R$ 440.000,00, da reaplicação em outro imóvel residencial e de pequeno valor (alienações do mês até R$ 35.000,00, inclusive quotas fora de bolsa); alíquotas de 15%, 17,5%, 20% e 22,5% por faixa. | não |
| Orientação e cálculo da atualização do custo de bem ou direito com os valores informados pelo usuário: 'ufir' (bens adquiridos até 31/12/1995, quantidade de UFIR vezes R$ 0,8287, Lei 9.249/1995, art. | não |
| Calcula a multa de mora (0,33% por dia de atraso, limitada a 20%) e os juros (Selic acumulada informada mais 1% no mês do pagamento) de qualquer débito federal vencido. | não |
| Determina a data em que a pessoa passa a residente ou não residente no Brasil (IN SRF 208/2002): saída definitiva (não residente na data da saída), ausência temporária (não residente no dia seguinte ao que completar 12 meses fora), retorno de brasileiro ou visto permanente (residente na chegada) e visto temporário (residente ao completar 184 dias no país em 12 meses). | não |
| Avalia os critérios de obrigatoriedade da declaração de 2026 (rendimentos tributáveis acima de R$ 35.584,00; isentos e exclusivos acima de R$ 200.000,00; ganho de capital; bolsa acima de R$ 40.000,00; atividade rural; bens acima de R$ 800.000,00; residência; reaplicação de imóvel; exterior e trust) a partir das respostas do usuário. | não |
| Converte para reais um valor em moeda estrangeira e explica qual cotação a regra exige para cada finalidade: rendimento ou imposto pago no exterior, dedução, atividade rural, bem ou aplicação financeira (Lei 14.754/2023). | não |
orientacao
Orientação sobre serviços que só existem fora do MCP Imposto de Renda (sem acesso à rede).
Ferramenta | O que faz | Grava? |
| Explica como usar um serviço que só existe fora do MCP Imposto de Renda (gov.br, pré-preenchida, Carnê-Leão Web, consulta de CPF, e-CAC, extrato e malha, débito automático, Darf e Sicalc, GCAP, Livro Caixa rural, restituição) e o que trazer de volta para a pasta autorizada. | não |
| Devolve a ajuda de uma ficha, demonstrativo, menu ou regra do programa oficial, tirada das notas de mapeamento do MCP Imposto de Renda (onde fica, a quem se aplica, campos, validações, códigos e regras de cálculo, com a página da Ajuda do programa). | não |
| Informa de qual versão do programa oficial vieram as tabelas de códigos e parâmetros embarcadas no MCP Imposto de Renda e quantos registros cada uma tem. | não |
| Calculadora do MCP Imposto de Renda, equivalente a Ferramentas > Calculadora do programa oficial: avalia expressões com +, -, *, /, parênteses e porcentagem ("27,5% * 10.000,00") em aritmética decimal exata, sem erro de arredondamento binário, e arredonda o resultado (metade para cima) nas casas pedidas. | não |
| Explica os atalhos de teclado e os botões do programa oficial (barra de ferramentas, menus por Alt, F1, F5, F11 de acessibilidade, Ctrl+P, Ctrl+Shift+G e outros) e diz qual ferramenta do MCP Imposto de Renda faz a mesma coisa, com o status de cobertura. | não |
| Mostra o estado do próprio servidor do MCP Imposto de Renda: versão, versão das tabelas, perfil, grupos e quantidade de ferramentas registradas, se há pasta autorizada (só o nome da pasta, nunca o caminho), modo somente leitura, uso de memória do processo e versões do Node e da plataforma. | não |
| Monta o texto de uma issue para o repositório público do MCP Imposto de Renda (sugestão, problema ou dúvida), com modelo, versão, perfil e plataforma, e devolve o link para o usuário abrir e enviar ele mesmo. | não |
Declarações de exemplo
Quatro declarações fictícias completas, feitas com o próprio servidor. Cada uma traz o roteiro de
pedidos, a conversa com as respostas reais, a saída do cálculo e o .DBK pronto para restaurar no
programa oficial. A suíte de testes regenera os quatro exemplos e falha se algum byte mudar.
Exemplo | Perfil | Resultado |
Um empregador, poupança e CDB | Simplificado, restituir R$ 461,23 | |
Companheira e dois filhos, plano de saúde, escola, faculdade, imóvel financiado | Completo, restituir R$ 9.572,98 | |
Duas fontes que informaram a parcela isenta inteira | Simplificado, pagar R$ 5.693,16 em 3 quotas | |
Livro-caixa, PGBL e uma clínica que retém imposto | Completo, pagar R$ 4.653,06 em 4 quotas |
Arquitetura
apps/cli mcp-imposto-de-renda executável stdio: argumentos, pasta, logs em stderr
packages/mcp @mcp-imposto-de-renda/mcp createServer(): 166 ferramentas, prompts, recursos, PastaAutorizada
packages/core @mcp-imposto-de-renda/core codec DBK, modelo, conversão, motor de cálculo, validação, tabelas (sem I/O)
exemplos/ declarações fictícias geradas pelo servidor
tools/ leiaute, harness de referência, mapeamento e geradores de documentação
docs/ arquitetura, referência, guias, regras, mapeamento, ADRsA dependência só vai de fora para dentro e o core não faz I/O. Uma chamada percorre sempre o mesmo
caminho: bytes do .DBK, registros de posição fixa, modelo tipado, alteração, validação, registros
com o Resumo e os controles recalculados, gravação atômica com backup.
O detalhamento de cada camada, com diagramas de fluxo e do ciclo de vida da declaração, está em docs/arquitetura.md.
Segurança
Sem rede. O código do servidor e do CLI não importa
http,https,net,tls,dnsnemchild_processe não usafetch; um teste automatizado confere isso. Só o transporte stdio é oferecido (ADR 0001).Pasta autorizada. Só nomes relativos dentro de
--dir. Caminhos absolutos,..,~, links simbólicos, arquivos ocultos e nomes reservados do Windows são recusados antes de tocar no disco.Gravação segura. Escrita atômica com
fsync, cópia automática em.mcp-imposto-de-renda-backups(10 por arquivo, permissão 0600) e--somente-leiturapara consultar sem risco.Limites. 20 MB por arquivo e 50.000 elementos por chamada.
Logs sem dados pessoais. Só eventos do processo, nome da ferramenta e classe do erro, em stderr. Mensagens de erro nunca levam caminho absoluto nem conteúdo da declaração.
Conteúdo marcado como dado. O que vem de arquivo ou de texto colado volta delimitado e identificado como dado da declaração, não instrução, o que reduz o risco de injeção de prompt por um documento.
Modelo de ameaças completo em docs/seguranca.md. Para relatar uma vulnerabilidade, siga o SECURITY.md e nunca abra issue pública com o problema.
Privacidade e LGPD
A declaração reúne dados pessoais, financeiros e, em despesas médicas, dados de saúde, que a Lei Geral de Proteção de Dados (Lei 13.709/2018) trata como sensíveis. O que acontece com eles depende de onde cada parte roda:
Onde | O que acontece com os dados |
MCP Imposto de Renda | Roda só na sua máquina. Não coleta, não guarda fora da pasta autorizada, não envia nada e não tem telemetria. O projeto não recebe nenhum dado. |
Pasta autorizada | Guarda o |
Cliente MCP e provedor de LLM | Recebem tudo o que você digita e tudo o que as ferramentas devolvem. O tratamento segue os termos e a política de privacidade do provedor escolhido. |
Programa oficial e Receita Federal | Recebem a declaração quando você a transmite, como em qualquer entrega. |
Recomendações práticas:
Prefira um provedor que não use as conversas para treinar modelos, ou um modelo local (LM Studio, Ollama), quando a declaração tiver dados de terceiros.
Compartilhe só o necessário. Dependentes, alimentandos e prestadores de serviço também são titulares de dados pessoais.
Use uma pasta exclusiva para a declaração e
--somente-leituraquando só quiser consultar.Apague a conversa no cliente e as cópias em
.mcp-imposto-de-renda-backupsquando não precisar mais delas.
Esta seção é informativa e não substitui orientação jurídica.
Precisão
O motor de cálculo e o codec do arquivo são próprios, em TypeScript (ADR 0002). Para saber se estão certos, o projeto compara o resultado com o do programa oficial:
Casos sintéticos em
tools/referencia/casosdescrevem declarações com CPFs gerados, nomes fictícios e valores escolhidos para isolar uma regra (cada faixa da tabela, tetos, limites, arredondamento, empate entre modelos).Um harness local (
tools/referencia) usa o programa oficial, baixado pelo próprio desenvolvedor e nunca versionado, como biblioteca: preenche as fichas, executa o cálculo oficial e grava o resultado esperado (golden) e os arquivos.DBK/.DECgravados pelo próprio programa (fixtures).A suíte de testes exige que o motor reproduza todos os campos de cada golden ao centavo e que o codec releia e regrave cada fixture byte a byte, com os controles de integridade recalculados.
Quando um caso diverge, a regra é investigada e documentada em
docs/regras/irpf-2026.md. Foi assim que se confirmou, por exemplo, que o programa trunca a fração de centavo das alíquotas, do desconto de 20% e do limite de 12%.
Nenhum código, classe, binário ou recurso do programa oficial entra no repositório, e nada dele é descompilado. O software publicado nunca executa, embute ou baixa o programa oficial.
O formato do arquivo, com os quatro controles de integridade (CRC-32 por registro, contagens do T9, hash e controle do header), está em docs/formato-dbk.md.
Limitações conhecidas
Só o exercício 2026 (ano-calendário 2025). Leiaute, tabelas e motor são versionados por exercício.
Arquivo de entrega conferido nos casos de referência.
gerar_arquivo_entregagrava o.DECigual ao do programa nos 65 casos de referência, inclusive o imposto pago de ganho de capital e o imposto da moeda estrangeira em espécie do recibo. A transmissão continua sendo feita pelo programa oficial.Serviços on-line da Receita Federal estão fora de escopo: transmissão, certificado digital, login gov.br, declaração pré-preenchida, Carnê-Leão Web, Darf com código de barras e recibo.
Sem leitura de PDF. Informes de rendimentos e de plano de saúde entram como texto ou JSON colado pelo usuário; não há OCR.
Cálculo do ajuste com demonstrativos parciais. A atividade rural no Brasil entra no cálculo; RRA pela opção do ajuste, prejuízo rural a compensar, atividade rural no exterior e a Lei 14.754 ficam com os valores do arquivo. Ganho de capital e renda variável são de tributação definitiva e não mudam o ajuste.
Limite de ferramentas de alguns clientes. Clientes que aceitam menos de 166 ferramentas precisam de
--perfil essencial(90) ou de--grupos; o guia de cada cliente explica como.Pendências documentadas em
docs/regras/irpf-2026.md, como a contribuição do ente patrocinador no código 37 e os limites de 6%, 7% e 1% das doações, ainda não confirmados por caso de referência.
Perguntas frequentes
Preciso do programa oficial? Sim, para conferir e transmitir. O servidor prepara o .DBK; a
entrega é sempre feita pelo programa da Receita Federal.
Funciona sem internet? O servidor, sim. O cliente MCP precisa de rede se o modelo de linguagem for remoto; com um modelo local, nada sai da máquina.
Posso partir da declaração que já comecei no programa? Sim. Grave a cópia de segurança
(Ferramentas > Cópia de Segurança > Gravar) na pasta autorizada e peça para abrir o .DBK. O
que o servidor não descreve no modelo é preservado byte a byte na regravação.
E se o assistente lançar algo errado? Toda gravação guarda a versão anterior.
listar_copias_seguranca e restaurar_copia_seguranca desfazem a alteração, e editar_* ou
remover_* corrigem o lançamento.
O cálculo é igual ao do programa? Nos 65 casos de referência, sim, ao centavo. Fora deles pode haver divergência; o programa oficial é sempre a palavra final.
Mais respostas em docs/guias/perguntas-frequentes.md.
Roadmap
IRPF 2027 (ano-calendário 2026), com as mudanças da Lei 15.270/2025: nova tabela anual, redução do imposto do art. 11-A e tributação mínima de altas rendas. Notas em
docs/regras/irpf-2027.md.Exercícios anteriores, para retificadoras e declarações em atraso.
Importação de PDF local de informes de rendimentos, lida na máquina, sem serviço externo.
Publicação no npm, para instalar com
npx mcp-imposto-de-renda.As funções do programa oficial ainda parciais na matriz de cobertura, cada uma com a justificativa e a alternativa em uso: a importação do Carnê-Leão Web e da pré-preenchida (serviços autenticados da Receita).
Documentação
O índice da documentação organiza tudo pelo que você quer fazer. Os pontos de partida mais comuns:
Para | Leia |
Instalar e configurar o cliente | |
Fazer a primeira declaração | |
Saber o que cada ferramenta faz | |
Entender o código | |
Conferir regras e cálculos |
Contribuição
Contribuições são bem-vindas. Leia o CONTRIBUTING.md e o Código de Conduta. Duas regras não têm exceção: nenhum código da Receita Federal entra no repositório e nenhum dado real (declaração, CPF, informe) entra em issue, PR ou teste. Divergência de cálculo se reporta com caso sintético, pelo modelo de issue próprio.
pnpm install
pnpm lint && pnpm typecheck && pnpm test && pnpm build
pnpm docs:catalogo && pnpm docs:links # documentação gerada e linksLicença
AGPL-3.0-only. O motivo da escolha está no ADR 0003. Versões modificadas, inclusive oferecidas pela rede, precisam disponibilizar o código-fonte sob a mesma licença.
Aviso legal
O MCP Imposto de Renda é software livre fornecido "no estado em que se encontra", sem garantia de qualquer tipo, nos termos da AGPL-3.0. Não é serviço oficial da Receita Federal do Brasil, não tem vínculo com ela nem com qualquer órgão público e não usa marca, brasão ou identidade visual do governo. Cálculos, conversões e validações podem divergir do programa oficial. Abra o arquivo no programa da Receita Federal, confira cada ficha e transmita por ele. A responsabilidade pelas informações declaradas é sempre do contribuinte. Os dados que você compartilha com o assistente são tratados pelo provedor de LLM escolhido por você, segundo os termos desse provedor.
Related MCP Connectors
Brazilian AI-powered accounting & tax automation: NFS-e invoicing, CBS/IBS tax reform, compliance.
Current source-cited 2026 US tax constants and calculators for AI agents; every answer cites IRS.
Open-source AI accounting skills verified by licensed accountants (tax, VAT, payroll).
Let your AI assistant read and fill your finances: budget, statements, payslips, taxes (French).
Related MCP Servers
- FlicenseAqualityCmaintenanceEnables AI assistants to help compile the Italian Modello 730 income tax return by providing IRPEF calculations, deduction tools, and tax rule guidance.1225-
- AlicenseAqualityBmaintenanceEnables 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.719 PyPIMIT
- AlicenseBqualityCmaintenanceEnables 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.44MIT
- AlicenseAqualityCmaintenanceEnables an AI assistant to read Portuguese invoices and receipts, file them by tax year, and book them into an Excel or Google Sheets workbook. It works out the boxes of the quarterly IVA return, tracks IRS and Segurança Social totals, and reports what documents are still missing.16MIT