io.github.MarcioKorpHub/contazz-autopilot

Official61 tools

by MarcioKorpHub

Contazz AutoPilot

Brazilian AI-powered accounting & tax automation: NFS-e invoicing, CBS/IBS tax reform, compliance.

Brazilian accounting and tax automation with NFS-e invoicing and compliance support.

Captured live from the server via tools/list.

listar_transacoes

Lista transações financeiras da empresa (entradas e saídas). Suporta filtros por período e limite.

Parameters (3)

empresaIdnumber
ID da empresa
limitnumber
Quantidade máxima de registros (padrão: 50)
offsetnumber
Offset para paginação

importar_transacoes

Importa transações financeiras em lote para a empresa. Cada transação deve ter: descricao, valor, data, tipo (entrada/saida), categoriaId.

Parameters (2)

empresaIdnumber
ID da empresa
transacoesarrayrequired
Array de transações a importar

listar_cobrancas

Lista cobranças (contas a receber) da empresa com status de pagamento.

Parameters (3)

empresaIdnumber
ID da empresa
limitnumber
Quantidade máxima
offsetnumber
Offset para paginação

criar_cobranca

Cria uma nova cobrança (conta a receber) para um cliente. Pode gerar boleto ou Pix automaticamente.

Parameters (6)

empresaIdnumber
ID da empresa
clienteIdnumberrequired
ID do cliente
valornumberrequired
Valor da cobrança em reais
vencimentostringrequired
Data de vencimento YYYY-MM-DD
descricaostringrequired
Descrição da cobrança
formaPagamentostring
Forma de pagamento

listar_contas_bancarias

Lista contas bancárias cadastradas da empresa com saldos atuais.

Parameters (1)

empresaIdnumber
ID da empresa

listar_clientes

Lista clientes cadastrados da empresa.

Parameters (1)

empresaIdnumber
ID da empresa

consultar_dre

Gera o Demonstrativo de Resultado do Exercício (DRE) da empresa para um período.

Parameters (3)

empresaIdnumber
ID da empresa
dataIniciostringrequired
Data início YYYY-MM-DD
dataFimstringrequired
Data fim YYYY-MM-DD

listar_contratos

Lista contratos ativos da empresa com valores e vencimentos.

Parameters (1)

empresaIdnumber
ID da empresa

listar_orcamentos

Módulo desativado no Core v3.0. Contate suporte para reativação.

No parameters.

criar_orcamento

Módulo desativado no Core v3.0. Contate suporte para reativação.

No parameters.

listar_contas_pagar

Lista contas a pagar da empresa com vencimentos e status.

Parameters (1)

empresaIdnumber
ID da empresa

saude_financeira

Calcula o score de saúde financeira da empresa (0-100) com indicadores detalhados: liquidez, inadimplência, margem, compliance.

Parameters (1)

empresaIdnumber
ID da empresa

compliance_fiscal

Verifica o status de compliance fiscal da empresa: obrigações acessórias, certidões, pendências.

Parameters (1)

empresaIdnumber
ID da empresa

economia_tributaria

Calcula a economia tributária gerada pela empresa com otimizações aplicadas.

Parameters (1)

empresaIdnumber
ID da empresa

dashboard_executivo

Retorna métricas executivas consolidadas: receita, despesas, lucro, fluxo de caixa, inadimplência.

Parameters (1)

empresaIdnumber
ID da empresa

metricas_escritorio

Retorna métricas SaaS do escritório contábil: MRR, ARR, churn, LTV, ticket médio, clientes ativos.

Parameters (1)

empresaIdnumber
ID da empresa

autopilot_regua

Retorna o score geral do AutoPilot e status de cada módulo de automação (cobranças, conciliação, compliance, etc).

Parameters (1)

empresaIdnumber
ID da empresa

emitir_nfse

Emite uma Nota Fiscal de Serviço Eletrônica (NFS-e) com cálculo automático de CBS/IBS (Reforma Tributária LC 214/2025). Requer dados do tomador e serviço.

Parameters (3)

empresaIdnumber
ID da empresa prestadora
tomadorobjectrequired
Dados do tomador do serviço
servicoobjectrequired
Dados do serviço

consultar_status_fiscal

Consulta o status de processamento de um documento fiscal (NFS-e, NF-e, NFC-e) pela referência Focus NFe.

Parameters (2)

empresaIdnumber
ID da empresa
referenciastringrequired
Referência Focus NFe do documento (ex: nfse-2-abc123)

listar_documentos_fiscais

Lista documentos fiscais emitidos pela empresa (NFS-e, NF-e, NFC-e) com filtros.

Parameters (3)

empresaIdnumber
ID da empresa
tipostring
Tipo de documento
limitnumber
Quantidade máxima

calcular_cbs_ibs

Calcula alíquotas CBS (federal) e IBS (estadual/municipal) da Reforma Tributária (LC 214/2025) para um produto (NCM) ou serviço. Usa a API oficial da Receita Federal.

Parameters (6)

ncmstring
Código NCM do produto (8 dígitos) ou código de serviço
codigoServicostring
Código do serviço municipal
tipoOperacaostring
Tipo de operação
valorOperacaonumber
Valor da operação em reais
ufOrigemstring
UF de origem (2 letras)
ufDestinostring
UF de destino (2 letras)

simular_regime_tributario

Simula e compara regimes tributários (Simples Nacional, Lucro Presumido, Lucro Real) para a empresa, indicando o mais vantajoso.

Parameters (4)

empresaIdnumber
ID da empresa
faturamentoAnualnumberrequired
Faturamento anual estimado em reais
folhaPagamentonumber
Folha de pagamento mensal em reais
atividadePrincipalstring
CNAE ou descrição da atividade principal

caixa_postal_ecac

Consulta mensagens da Caixa Postal do e-CAC classificadas por prioridade e tipo.

Parameters (1)

empresaIdnumber
ID da empresa

dashboard_multi_pj

Retorna visão consolidada de múltiplas empresas do grupo: receita, despesas, saldo por empresa.

Parameters (1)

empresaIdnumber
ID da empresa principal (grupo)

badges_contadores

Retorna contadores rápidos: a receber hoje, a pagar hoje, tarefas pendentes.

Parameters (1)

empresaIdnumber
ID da empresa

procuracoes_ecac

Lista procurações eletrônicas do e-CAC (outorgadas e recebidas) com status de validade.

Parameters (1)

empresaIdnumber
ID da empresa

listar_empresas

Lista todas as empresas vinculadas à conta do usuário.

No parameters.

gerar_agent_report

Gera um relatório estruturado de análise (agent report) que fica salvo no histórico da empresa.

Parameters (4)

empresaIdnumber
ID da empresa
titulostringrequired
Título do relatório
conteudostringrequired
Conteúdo do relatório em markdown
tipostringrequired
Tipo do relatório

status_api

Retorna o status operacional da API Contazz AutoPilot e versão atual.

No parameters.

cancelar_nfse

Cancela uma NFS-e emitida anteriormente. Requer a referência Focus NFe e justificativa obrigatória (mínimo 15 caracteres). Ação irreversível.

Parameters (3)

empresaIdnumber
ID da empresa
referenciastringrequired
Referência Focus NFe da NFS-e (ex: nfse-2-abc123)
justificativastringrequired
Justificativa do cancelamento (mínimo 15 caracteres)

agendar_cobranca

Agenda uma cobrança para ser gerada automaticamente em data futura ou de forma recorrente (cron). Usa o sistema de Heartbeat para execução confiável.

Parameters (7)

empresaIdnumber
ID da empresa
clienteIdnumberrequired
ID do cliente
valornumberrequired
Valor da cobrança em reais
descricaostringrequired
Descrição da cobrança
formaPagamentostring
Forma de pagamento
dataIniciostringrequired
Data da primeira cobrança YYYY-MM-DD
recorrenciastring
Frequência

subscribe_webhook

Registra uma URL de webhook para receber notificações em tempo real de eventos da empresa (cobrança paga, NFS-e emitida, etc). Eventos são assinados com HMAC-SHA256.

Parameters (3)

empresaIdnumber
ID da empresa
urlstringrequired
URL do webhook (HTTPS obrigatório em produção)
eventsarrayrequired
Lista de eventos para receber notificações

enviar_relatorio_email

Gera e envia um relatório financeiro/fiscal por email para o proprietário da conta. Tipos: resumo_diario, fluxo_caixa, inadimplencia, compliance, dre.

Parameters (3)

empresaIdnumber
ID da empresa
tipostringrequired
Tipo do relatório
periodoobject
Período do relatório

listar_audit_log

Lista o histórico de chamadas de tools MCP da empresa com latência, status e timestamps.

Parameters (3)

empresaIdnumber
ID da empresa
limitnumber
Quantidade máxima
toolstring
Filtrar por nome da tool

listar_webhooks

Lista webhooks registrados para a empresa com status e eventos configurados.

Parameters (1)

empresaIdnumber
ID da empresa

cancelar_webhook

Desativa um webhook registrado pelo ID.

Parameters (1)

webhookIdnumberrequired
ID do webhook a desativar

criar_cobranca_pix

Cria uma cobrança Pix (QR Code) para recebimento imediato via Asaas.

Parameters (6)

empresaIdnumber
ID da empresa
clienteNomestringrequired
Nome do cliente/pagador
clienteCpfCnpjstringrequired
CPF ou CNPJ do pagador
valornumberrequired
Valor em reais (ex: 150.00)
descricaostring
Descrição da cobrança
vencimentostring
Data de vencimento ISO (YYYY-MM-DD)

consultar_saldo

Retorna o saldo atual de todas as contas bancárias da empresa.

Parameters (1)

empresaIdnumber
ID da empresa

fluxo_caixa_projetado

Projeta o fluxo de caixa futuro (recebimentos vs pagamentos) para os próximos N meses.

Parameters (2)

empresaIdnumber
ID da empresa
mesesnumber
Quantidade de meses a projetar (1-12)

listar_inadimplentes

Lista clientes com cobranças vencidas (inadimplentes), ordenados por valor em aberto.

Parameters (2)

empresaIdnumber
ID da empresa
diasAtrasonumber
Mínimo de dias de atraso para considerar inadimplente

enviar_lembrete_cobranca

Envia um lembrete de cobrança para o cliente via WhatsApp, Telegram ou Email.

Parameters (3)

cobrancaIdnumberrequired
ID da cobrança
canalstring
Canal de envio
mensagemCustomstring
Mensagem personalizada (opcional)

classificar_transacao

Classifica uma transação financeira automaticamente usando IA (categoria contábil).

Parameters (2)

descricaostringrequired
Descrição da transação (ex: 'Pagamento Google Ads')
valornumberrequired
Valor da transação em reais

conciliar_extrato

Executa conciliação automática entre extrato bancário e lançamentos internos usando IA.

Parameters (3)

empresaIdnumber
ID da empresa
usarLLMboolean
Usar LLM para matches complexos (mais preciso, mais lento)
limiteTransacoesnumber
Limite de transações a processar

simular_imposto_reforma

Simula o impacto da Reforma Tributária (CBS + IBS) sobre uma operação, comparando com o regime atual (PIS/COFINS/ISS/ICMS).

Parameters (7)

valorOperacaonumberrequired
Valor da operação em reais
tipoOperacaostringrequired
Tipo da operação
ufOrigemstring
UF de origem (ex: SP)
ufDestinostring
UF de destino (ex: MG)
codigoServicostring
Código do serviço LC 116 (para serviços)
ncmstring
NCM do produto (para mercadorias)
regimeAtualstring
Regime tributário atual

consultar_aliquota_cbs_ibs

Consulta as alíquotas CBS e IBS vigentes para um serviço ou produto específico (Reforma Tributária LC 214/2025).

Parameters (4)

codigoServicostring
Código do serviço LC 116 (ex: 01.01)
ncmstring
NCM do produto (ex: 84713012)
ufDestinostring
UF de destino (ex: SP)
codigoMunicipionumber
Código IBGE do município

calcular_imposto_seletivo

Calcula o Imposto Seletivo (IS) sobre um produto com base no NCM, conforme EC 132/2023 + LC 214/2025.

Parameters (4)

ncmstringrequired
NCM do produto (8 dígitos)
valorOperacaonumberrequired
Valor da operação em reais
quantidadenumber
Quantidade (para base específica)
dataDoFatostring
Data do fato gerador ISO (YYYY-MM-DD)

gerar_guia_pagamento

Gera guias DARF para recolhimento de tributos retidos (IR, PIS, COFINS, CSLL) sobre serviços tomados.

Parameters (2)

empresaIdnumber
ID da empresa
competenciastringrequired
Competência no formato YYYY-MM (ex: 2026-05)

listar_obrigacoes_acessorias

Lista obrigações acessórias (DCTF, EFD, SPED, DIRF, etc.) da empresa com prazos e status de cumprimento.

Parameters (3)

empresaIdnumber
ID da empresa
competenciastring
Competência no formato YYYY-MM (ex: 2026-05)
statusstring
Filtrar por status

gerar_insight_cliente

Gera narrativa personalizada com insights financeiros/fiscais para um cliente usando IA (Claude). Retorna texto em linguagem acessível com destaques e próxima ação recomendada.

Parameters (3)

empresaIdnumberrequired
ID da empresa para gerar insight
periodostring
Período de referência no formato YYYY-MM (default: mês atual)
forceRefreshboolean
Forçar regeneração ignorando cache (default: false)

enviar_magic_link

Gera e retorna um Magic Link (URL assinada JWT) para acesso direto do cliente ao portal da empresa. Escopos: dashboard, outcome, apuracao, alerta.

Parameters (4)

empresaIdnumberrequired
ID da empresa para gerar o link
escopostring
Escopo de acesso do link (default: dashboard)
ttlDiasnumber
Validade do link em dias (default: 7, max: 30)
motivostring
Motivo do envio para auditoria (ex: 'Solicitação via agente IA')

processar_mensagem_cliente

Processa uma mensagem de texto de um cliente (WhatsApp/chat) usando IA para classificar intenção e gerar resposta automática. Intenções: boleto_2via, status_envio, saudacao, humano, duvida_fiscal, reclamacao.

Parameters (3)

telefonestringrequired
Telefone do cliente (formato: 5511999999999)
textostringrequired
Texto da mensagem recebida do cliente
whatsappMessageIdstring
ID da mensagem WhatsApp (para rastreamento)

reconciliation_list_accounts

Lista todas as contas configuradas para conciliação contábil (bancária, clientes, fornecedores, impostos). Retorna nome, tipo, banco, e configurações de tolerância.

Parameters (1)

empresaIdnumber
ID da empresa

reconciliation_create_session

Cria uma nova sessão de conciliação para um período específico. A sessão é o container onde transações e lançamentos são comparados.

Parameters (4)

empresaIdnumber
ID da empresa
accountIdnumberrequired
ID da conta de conciliação
periodoIniciostringrequired
Data início do período (YYYY-MM-DD)
periodoFimstringrequired
Data fim do período (YYYY-MM-DD)

reconciliation_import_transactions

Importa transações do extrato bancário para uma sessão de conciliação. Aceita array de transações com data, descrição, valor e tipo (credito/debito).

Parameters (4)

sessionIdnumberrequired
ID da sessão de conciliação
accountIdnumberrequired
ID da conta
empresaIdnumber
ID da empresa
transacoesarrayrequired
Array de transações bancárias

reconciliation_import_entries

Importa lançamentos do razão contábil para uma sessão de conciliação. Aceita array de lançamentos com data, descrição, valor, tipo, e contas débito/crédito.

Parameters (4)

sessionIdnumberrequired
ID da sessão de conciliação
accountIdnumberrequired
ID da conta
empresaIdnumber
ID da empresa
lancamentosarrayrequired
Array de lançamentos contábeis

reconciliation_execute

Executa o motor de conciliação em 3 camadas (regras determinísticas + fuzzy matching + LLM) para uma sessão. Retorna resumo com matches encontrados, taxa de automação e exceções.

Parameters (1)

sessionIdnumberrequired
ID da sessão de conciliação a executar

reconciliation_list_matches

Lista os matches (correspondências) encontrados em uma sessão de conciliação. Mostra confiança, tipo de match (exato/fuzzy/llm), e status (sugerido/aprovado/rejeitado).

Parameters (2)

sessionIdnumberrequired
ID da sessão
statusstring
Filtrar por status

reconciliation_approve_match

Aprova um match sugerido pelo motor de conciliação. Marca as transações e lançamentos envolvidos como conciliados.

Parameters (1)

matchIdnumberrequired
ID do match a aprovar

reconciliation_list_exceptions

Lista exceções (itens sem correspondência) de uma sessão. Exceções podem ser transações sem lançamento ou lançamentos sem transação. Inclui prioridade e sugestão IA.

Parameters (2)

sessionIdnumberrequired
ID da sessão
statusstring
Filtrar por status

reconciliation_kpis

Retorna indicadores-chave de conciliação: contas ativas, sessões concluídas, taxa de automação, exceções pendentes, e sessões recentes.

Parameters (1)

empresaIdnumber
ID da empresa

reconciliation_seed_demo

Cria dados fictícios de demonstração para conciliação contábil: conta bancária, sessão, 20 transações, 19 lançamentos, e regras de matching. Útil para testes e onboarding.

Parameters (1)

empresaIdnumber
ID da empresa

Install

claude_desktop_config.json

{
  "mcpServers": {
    "contazz-autopilot": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://appcontazz.com/api/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.