Contazz AutoPilot
Brazilian AI-powered accounting & tax automation: NFS-e invoicing, CBS/IBS tax reform, compliance.
Should I use this
Quality & Safety
Findings (31)
- LOWin criar_cobranca
- LOWin consultar_dre
- LOWin listar_orcamentos
- LOWin criar_orcamento
- LOWin saude_financeira
- LOWin compliance_fiscal
- LOWin economia_tributaria
- LOWin metricas_escritorio
- LOWin autopilot_regua
- LOWin calcular_cbs_ibs
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"contazz-autopilot": {
"url": "https://appcontazz.com/api/mcp"
}
}
}Remote endpoints
https://appcontazz.com/api/mcpstreamable-httpWhat it can do
Tool inventory
Tools (61)
🟢listar_transacoes(empresaId, limit, offset)
Lista transações financeiras da empresa (entradas e saídas). Suporta filtros por período e limite.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
},
"limit": {
"default": 50,
"description": "Quantidade máxima de registros (padrão: 50)",
"type": "number"
},
"offset": {
"default": 0,
"description": "Offset para paginação",
"type": "number"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴importar_transacoes(empresaId, transacoes)
Importa transações financeiras em lote para a empresa. Cada transação deve ter: descricao, valor, data, tipo (entrada/saida), categoriaId.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
},
"transacoes": {
"description": "Array de transações a importar",
"type": "array",
"items": {
"type": "object",
"properties": {
"descricao": {
"description": "Descrição da transação",
"type": "string"
},
"valor": {
"description": "Valor em reais (positivo)",
"type": "number"
},
"data": {
"description": "Data no formato YYYY-MM-DD",
"type": "string"
},
"tipo": {
"description": "Tipo: entrada ou saida",
"type": "string",
"enum": [
"entrada",
"saida"
]
},
"categoriaId": {
"description": "ID da categoria",
"type": "number"
}
},
"required": [
"descricao",
"valor",
"data",
"tipo"
]
}
}
},
"required": [
"transacoes"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢listar_cobrancas(empresaId, limit, offset)
Lista cobranças (contas a receber) da empresa com status de pagamento.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
},
"limit": {
"default": 50,
"description": "Quantidade máxima",
"type": "number"
},
"offset": {
"default": 0,
"description": "Offset para paginação",
"type": "number"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴criar_cobranca(empresaId, clienteId, valor, vencimento, descricao, ...)
Cria uma nova cobrança (conta a receber) para um cliente. Pode gerar boleto ou Pix automaticamente.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
},
"clienteId": {
"description": "ID do cliente",
"type": "number"
},
"valor": {
"description": "Valor da cobrança em reais",
"type": "number"
},
"vencimento": {
"description": "Data de vencimento YYYY-MM-DD",
"type": "string"
},
"descricao": {
"description": "Descrição da cobrança",
"type": "string"
},
"formaPagamento": {
"description": "Forma de pagamento",
"type": "string",
"enum": [
"boleto",
"pix",
"cartao"
]
}
},
"required": [
"clienteId",
"valor",
"vencimento",
"descricao"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢listar_contas_bancarias(empresaId)
Lista contas bancárias cadastradas da empresa com saldos atuais.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢listar_clientes(empresaId)
Lista clientes cadastrados da empresa.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢consultar_dre(empresaId, dataInicio, dataFim)
Gera o Demonstrativo de Resultado do Exercício (DRE) da empresa para um período.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
},
"dataInicio": {
"description": "Data início YYYY-MM-DD",
"type": "string"
},
"dataFim": {
"description": "Data fim YYYY-MM-DD",
"type": "string"
}
},
"required": [
"dataInicio",
"dataFim"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢listar_contratos(empresaId)
Lista contratos ativos da empresa com valores e vencimentos.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢listar_orcamentos
Módulo desativado no Core v3.0. Contate suporte para reativação.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴criar_orcamento
Módulo desativado no Core v3.0. Contate suporte para reativação.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢listar_contas_pagar(empresaId)
Lista contas a pagar da empresa com vencimentos e status.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢saude_financeira(empresaId)
Calcula o score de saúde financeira da empresa (0-100) com indicadores detalhados: liquidez, inadimplência, margem, compliance.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢compliance_fiscal(empresaId)
Verifica o status de compliance fiscal da empresa: obrigações acessórias, certidões, pendências.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢economia_tributaria(empresaId)
Calcula a economia tributária gerada pela empresa com otimizações aplicadas.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢dashboard_executivo(empresaId)
Retorna métricas executivas consolidadas: receita, despesas, lucro, fluxo de caixa, inadimplência.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢metricas_escritorio(empresaId)
Retorna métricas SaaS do escritório contábil: MRR, ARR, churn, LTV, ticket médio, clientes ativos.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢autopilot_regua(empresaId)
Retorna o score geral do AutoPilot e status de cada módulo de automação (cobranças, conciliação, compliance, etc).
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴emitir_nfse(empresaId, tomador, servico)
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.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa prestadora",
"type": "number"
},
"tomador": {
"description": "Dados do tomador do serviço",
"type": "object",
"properties": {
"cpfCnpj": {
"description": "CPF ou CNPJ do tomador",
"type": "string"
},
"razaoSocial": {
"description": "Nome/Razão Social do tomador",
"type": "string"
},
"email": {
"description": "Email do tomador",
"type": "string"
},
"endereco": {
"description": "Endereço do tomador",
"type": "object",
"properties": {
"logradouro": {
"type": "string"
},
"numero": {
"type": "string"
},
"bairro": {
"type": "string"
},
"codigoMunicipio": {
"description": "Código IBGE do município",
"type": "string"
},
"uf": {
"description": "UF (2 letras)",
"type": "string"
},
"cep": {
"type": "string"
}
}
}
},
"required": [
"cpfCnpj",
"razaoSocial"
]
},
"servico": {
"description": "Dados do serviço",
"type": "object",
"properties": {
"descricao": {
"description": "Descrição do serviço prestado",
"type": "string"
},
"valorServicos": {
"description": "Valor total dos serviços em reais",
"type": "number"
},
"codigoServico": {
"description": "Código do serviço municipal (ex: 03476 para contabilidade em SP)",
"type": "string"
},
"itemListaServico": {
"description": "Item da LC 116 (ex: 17.19)",
"type": "string"
},
"aliquotaIss": {
"description": "Alíquota ISS (ex: 0.05 para 5%)",
"type": "number"
}
},
"required": [
"descricao",
"valorServicos",
"codigoServico"
]
}
},
"required": [
"tomador",
"servico"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢consultar_status_fiscal(empresaId, referencia)
Consulta o status de processamento de um documento fiscal (NFS-e, NF-e, NFC-e) pela referência Focus NFe.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
},
"referencia": {
"description": "Referência Focus NFe do documento (ex: nfse-2-abc123)",
"type": "string"
}
},
"required": [
"referencia"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢listar_documentos_fiscais(empresaId, tipo, limit)
Lista documentos fiscais emitidos pela empresa (NFS-e, NF-e, NFC-e) com filtros.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
},
"tipo": {
"default": "todos",
"description": "Tipo de documento",
"type": "string",
"enum": [
"nfse",
"nfe",
"nfce",
"todos"
]
},
"limit": {
"default": 20,
"description": "Quantidade máxima",
"type": "number"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢calcular_cbs_ibs(ncm, codigoServico, tipoOperacao, valorOperacao, ufOrigem, ...)
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.
Input Schema
{
"type": "object",
"properties": {
"ncm": {
"description": "Código NCM do produto (8 dígitos) ou código de serviço",
"type": "string"
},
"codigoServico": {
"description": "Código do serviço municipal",
"type": "string"
},
"tipoOperacao": {
"default": "prestacao_servico",
"description": "Tipo de operação",
"type": "string",
"enum": [
"venda_mercadoria",
"prestacao_servico",
"importacao"
]
},
"valorOperacao": {
"description": "Valor da operação em reais",
"type": "number"
},
"ufOrigem": {
"default": "SP",
"description": "UF de origem (2 letras)",
"type": "string"
},
"ufDestino": {
"default": "SP",
"description": "UF de destino (2 letras)",
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢simular_regime_tributario(empresaId, faturamentoAnual, folhaPagamento, atividadePrincipal)
Simula e compara regimes tributários (Simples Nacional, Lucro Presumido, Lucro Real) para a empresa, indicando o mais vantajoso.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
},
"faturamentoAnual": {
"description": "Faturamento anual estimado em reais",
"type": "number"
},
"folhaPagamento": {
"description": "Folha de pagamento mensal em reais",
"type": "number"
},
"atividadePrincipal": {
"description": "CNAE ou descrição da atividade principal",
"type": "string"
}
},
"required": [
"faturamentoAnual"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢caixa_postal_ecac(empresaId)
Consulta mensagens da Caixa Postal do e-CAC classificadas por prioridade e tipo.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢dashboard_multi_pj(empresaId)
Retorna visão consolidada de múltiplas empresas do grupo: receita, despesas, saldo por empresa.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa principal (grupo)",
"type": "number"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢badges_contadores(empresaId)
Retorna contadores rápidos: a receber hoje, a pagar hoje, tarefas pendentes.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢procuracoes_ecac(empresaId)
Lista procurações eletrônicas do e-CAC (outorgadas e recebidas) com status de validade.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢listar_empresas
Lista todas as empresas vinculadas à conta do usuário.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴gerar_agent_report(empresaId, titulo, conteudo, tipo)
Gera um relatório estruturado de análise (agent report) que fica salvo no histórico da empresa.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
},
"titulo": {
"description": "Título do relatório",
"type": "string"
},
"conteudo": {
"description": "Conteúdo do relatório em markdown",
"type": "string"
},
"tipo": {
"description": "Tipo do relatório",
"type": "string",
"enum": [
"financeiro",
"fiscal",
"tributario",
"operacional",
"estrategico"
]
}
},
"required": [
"titulo",
"conteudo",
"tipo"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢status_api
Retorna o status operacional da API Contazz AutoPilot e versão atual.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴cancelar_nfse(empresaId, referencia, justificativa)
Cancela uma NFS-e emitida anteriormente. Requer a referência Focus NFe e justificativa obrigatória (mínimo 15 caracteres). Ação irreversível.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
},
"referencia": {
"description": "Referência Focus NFe da NFS-e (ex: nfse-2-abc123)",
"type": "string"
},
"justificativa": {
"description": "Justificativa do cancelamento (mínimo 15 caracteres)",
"type": "string",
"minLength": 15
}
},
"required": [
"referencia",
"justificativa"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴agendar_cobranca(empresaId, clienteId, valor, descricao, formaPagamento, ...)
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.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
},
"clienteId": {
"description": "ID do cliente",
"type": "number"
},
"valor": {
"description": "Valor da cobrança em reais",
"type": "number"
},
"descricao": {
"description": "Descrição da cobrança",
"type": "string"
},
"formaPagamento": {
"default": "boleto",
"description": "Forma de pagamento",
"type": "string",
"enum": [
"boleto",
"pix",
"cartao"
]
},
"dataInicio": {
"description": "Data da primeira cobrança YYYY-MM-DD",
"type": "string"
},
"recorrencia": {
"default": "mensal",
"description": "Frequência",
"type": "string",
"enum": [
"unica",
"semanal",
"mensal",
"trimestral"
]
}
},
"required": [
"clienteId",
"valor",
"descricao",
"dataInicio"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴subscribe_webhook(empresaId, url, events)
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.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
},
"url": {
"description": "URL do webhook (HTTPS obrigatório em produção)",
"type": "string",
"format": "uri"
},
"events": {
"description": "Lista de eventos para receber notificações",
"type": "array",
"items": {
"type": "string",
"enum": [
"cobranca.criada",
"cobranca.paga",
"cobranca.vencida",
"cobranca.cancelada",
"nfse.emitida",
"nfse.cancelada",
"nfse.rejeitada",
"transacao.criada",
"transacao.categorizada",
"contrato.vencendo",
"contrato.renovado",
"compliance.alerta",
"compliance.resolvido"
]
}
}
},
"required": [
"url",
"events"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴enviar_relatorio_email(empresaId, tipo, periodo)
Gera e envia um relatório financeiro/fiscal por email para o proprietário da conta. Tipos: resumo_diario, fluxo_caixa, inadimplencia, compliance, dre.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
},
"tipo": {
"description": "Tipo do relatório",
"type": "string",
"enum": [
"resumo_diario",
"fluxo_caixa",
"inadimplencia",
"compliance",
"dre"
]
},
"periodo": {
"description": "Período do relatório",
"type": "object",
"properties": {
"inicio": {
"description": "Data início YYYY-MM-DD",
"type": "string"
},
"fim": {
"description": "Data fim YYYY-MM-DD",
"type": "string"
}
},
"required": [
"inicio",
"fim"
]
}
},
"required": [
"tipo"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢listar_audit_log(empresaId, limit, tool)
Lista o histórico de chamadas de tools MCP da empresa com latência, status e timestamps.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
},
"limit": {
"default": 50,
"description": "Quantidade máxima",
"type": "number"
},
"tool": {
"description": "Filtrar por nome da tool",
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢listar_webhooks(empresaId)
Lista webhooks registrados para a empresa com status e eventos configurados.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴cancelar_webhook(webhookId)
Desativa um webhook registrado pelo ID.
Input Schema
{
"type": "object",
"properties": {
"webhookId": {
"description": "ID do webhook a desativar",
"type": "number"
}
},
"required": [
"webhookId"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴criar_cobranca_pix(empresaId, clienteNome, clienteCpfCnpj, valor, descricao, ...)
Cria uma cobrança Pix (QR Code) para recebimento imediato via Asaas.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
},
"clienteNome": {
"description": "Nome do cliente/pagador",
"type": "string"
},
"clienteCpfCnpj": {
"description": "CPF ou CNPJ do pagador",
"type": "string"
},
"valor": {
"description": "Valor em reais (ex: 150.00)",
"type": "number"
},
"descricao": {
"description": "Descrição da cobrança",
"type": "string"
},
"vencimento": {
"description": "Data de vencimento ISO (YYYY-MM-DD)",
"type": "string"
}
},
"required": [
"clienteNome",
"clienteCpfCnpj",
"valor"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢consultar_saldo(empresaId)
Retorna o saldo atual de todas as contas bancárias da empresa.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢fluxo_caixa_projetado(empresaId, meses)
Projeta o fluxo de caixa futuro (recebimentos vs pagamentos) para os próximos N meses.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
},
"meses": {
"default": 6,
"description": "Quantidade de meses a projetar (1-12)",
"type": "number"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢listar_inadimplentes(empresaId, diasAtraso)
Lista clientes com cobranças vencidas (inadimplentes), ordenados por valor em aberto.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
},
"diasAtraso": {
"default": 1,
"description": "Mínimo de dias de atraso para considerar inadimplente",
"type": "number"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴enviar_lembrete_cobranca(cobrancaId, canal, mensagemCustom)
Envia um lembrete de cobrança para o cliente via WhatsApp, Telegram ou Email.
Input Schema
{
"type": "object",
"properties": {
"cobrancaId": {
"description": "ID da cobrança",
"type": "number"
},
"canal": {
"default": "whatsapp",
"description": "Canal de envio",
"type": "string",
"enum": [
"whatsapp",
"telegram",
"email"
]
},
"mensagemCustom": {
"description": "Mensagem personalizada (opcional)",
"type": "string"
}
},
"required": [
"cobrancaId"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢classificar_transacao(descricao, valor)
Classifica uma transação financeira automaticamente usando IA (categoria contábil).
Input Schema
{
"type": "object",
"properties": {
"descricao": {
"description": "Descrição da transação (ex: 'Pagamento Google Ads')",
"type": "string"
},
"valor": {
"description": "Valor da transação em reais",
"type": "number"
}
},
"required": [
"descricao",
"valor"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢conciliar_extrato(empresaId, usarLLM, limiteTransacoes)
Executa conciliação automática entre extrato bancário e lançamentos internos usando IA.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
},
"usarLLM": {
"default": false,
"description": "Usar LLM para matches complexos (mais preciso, mais lento)",
"type": "boolean"
},
"limiteTransacoes": {
"default": 50,
"description": "Limite de transações a processar",
"type": "number"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢simular_imposto_reforma(valorOperacao, tipoOperacao, ufOrigem, ufDestino, codigoServico, ...)
Simula o impacto da Reforma Tributária (CBS + IBS) sobre uma operação, comparando com o regime atual (PIS/COFINS/ISS/ICMS).
Input Schema
{
"type": "object",
"properties": {
"valorOperacao": {
"description": "Valor da operação em reais",
"type": "number"
},
"tipoOperacao": {
"description": "Tipo da operação",
"type": "string",
"enum": [
"servico",
"mercadoria",
"importacao"
]
},
"ufOrigem": {
"description": "UF de origem (ex: SP)",
"type": "string"
},
"ufDestino": {
"description": "UF de destino (ex: MG)",
"type": "string"
},
"codigoServico": {
"description": "Código do serviço LC 116 (para serviços)",
"type": "string"
},
"ncm": {
"description": "NCM do produto (para mercadorias)",
"type": "string"
},
"regimeAtual": {
"default": "lucro_presumido",
"description": "Regime tributário atual",
"type": "string",
"enum": [
"simples_nacional",
"lucro_presumido",
"lucro_real"
]
}
},
"required": [
"valorOperacao",
"tipoOperacao"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢consultar_aliquota_cbs_ibs(codigoServico, ncm, ufDestino, codigoMunicipio)
Consulta as alíquotas CBS e IBS vigentes para um serviço ou produto específico (Reforma Tributária LC 214/2025).
Input Schema
{
"type": "object",
"properties": {
"codigoServico": {
"description": "Código do serviço LC 116 (ex: 01.01)",
"type": "string"
},
"ncm": {
"description": "NCM do produto (ex: 84713012)",
"type": "string"
},
"ufDestino": {
"description": "UF de destino (ex: SP)",
"type": "string"
},
"codigoMunicipio": {
"description": "Código IBGE do município",
"type": "number"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢calcular_imposto_seletivo(ncm, valorOperacao, quantidade, dataDoFato)
Calcula o Imposto Seletivo (IS) sobre um produto com base no NCM, conforme EC 132/2023 + LC 214/2025.
Input Schema
{
"type": "object",
"properties": {
"ncm": {
"description": "NCM do produto (8 dígitos)",
"type": "string"
},
"valorOperacao": {
"description": "Valor da operação em reais",
"type": "number"
},
"quantidade": {
"description": "Quantidade (para base específica)",
"type": "number"
},
"dataDoFato": {
"description": "Data do fato gerador ISO (YYYY-MM-DD)",
"type": "string"
}
},
"required": [
"ncm",
"valorOperacao"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢gerar_guia_pagamento(empresaId, competencia)
Gera guias DARF para recolhimento de tributos retidos (IR, PIS, COFINS, CSLL) sobre serviços tomados.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
},
"competencia": {
"description": "Competência no formato YYYY-MM (ex: 2026-05)",
"type": "string"
}
},
"required": [
"competencia"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢listar_obrigacoes_acessorias(empresaId, competencia, status)
Lista obrigações acessórias (DCTF, EFD, SPED, DIRF, etc.) da empresa com prazos e status de cumprimento.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
},
"competencia": {
"description": "Competência no formato YYYY-MM (ex: 2026-05)",
"type": "string"
},
"status": {
"description": "Filtrar por status",
"type": "string",
"enum": [
"pendente",
"cumprida",
"vencida",
"em_atraso"
]
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪gerar_insight_cliente(empresaId, periodo, forceRefresh)
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.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"description": "ID da empresa para gerar insight",
"type": "number"
},
"periodo": {
"description": "Período de referência no formato YYYY-MM (default: mês atual)",
"type": "string"
},
"forceRefresh": {
"description": "Forçar regeneração ignorando cache (default: false)",
"type": "boolean"
}
},
"required": [
"empresaId"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪enviar_magic_link(empresaId, escopo, ttlDias, motivo)
Gera e retorna um Magic Link (URL assinada JWT) para acesso direto do cliente ao portal da empresa. Escopos: dashboard, outcome, apuracao, alerta.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"description": "ID da empresa para gerar o link",
"type": "number"
},
"escopo": {
"description": "Escopo de acesso do link (default: dashboard)",
"type": "string",
"enum": [
"dashboard",
"outcome",
"apuracao",
"alerta"
]
},
"ttlDias": {
"description": "Validade do link em dias (default: 7, max: 30)",
"type": "number",
"minimum": 1,
"maximum": 30
},
"motivo": {
"description": "Motivo do envio para auditoria (ex: 'Solicitação via agente IA')",
"type": "string"
}
},
"required": [
"empresaId"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}⚪processar_mensagem_cliente(telefone, texto, whatsappMessageId)
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.
Input Schema
{
"type": "object",
"properties": {
"telefone": {
"description": "Telefone do cliente (formato: 5511999999999)",
"type": "string"
},
"texto": {
"description": "Texto da mensagem recebida do cliente",
"type": "string"
},
"whatsappMessageId": {
"description": "ID da mensagem WhatsApp (para rastreamento)",
"type": "string"
}
},
"required": [
"telefone",
"texto"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢reconciliation_list_accounts(empresaId)
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.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡reconciliation_create_session(empresaId, accountId, periodoInicio, periodoFim)
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.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
},
"accountId": {
"description": "ID da conta de conciliação",
"type": "number"
},
"periodoInicio": {
"description": "Data início do período (YYYY-MM-DD)",
"type": "string"
},
"periodoFim": {
"description": "Data fim do período (YYYY-MM-DD)",
"type": "string"
}
},
"required": [
"accountId",
"periodoInicio",
"periodoFim"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴reconciliation_import_transactions(sessionId, accountId, empresaId, transacoes)
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).
Input Schema
{
"type": "object",
"properties": {
"sessionId": {
"description": "ID da sessão de conciliação",
"type": "number"
},
"accountId": {
"description": "ID da conta",
"type": "number"
},
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
},
"transacoes": {
"description": "Array de transações bancárias",
"type": "array",
"items": {
"type": "object",
"properties": {
"data": {
"description": "Data da transação (YYYY-MM-DD)",
"type": "string"
},
"descricao": {
"description": "Descrição/histórico da transação",
"type": "string"
},
"valor": {
"description": "Valor da transação (ex: '1500.00')",
"type": "string"
},
"tipo": {
"description": "Tipo: credito (entrada) ou debito (saída)",
"type": "string",
"enum": [
"credito",
"debito"
]
},
"documento": {
"description": "Número do documento/comprovante",
"type": "string"
},
"favorecido": {
"description": "Nome do favorecido/pagador",
"type": "string"
}
},
"required": [
"data",
"descricao",
"valor",
"tipo"
]
}
}
},
"required": [
"sessionId",
"accountId",
"transacoes"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴reconciliation_import_entries(sessionId, accountId, empresaId, lancamentos)
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.
Input Schema
{
"type": "object",
"properties": {
"sessionId": {
"description": "ID da sessão de conciliação",
"type": "number"
},
"accountId": {
"description": "ID da conta",
"type": "number"
},
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
},
"lancamentos": {
"description": "Array de lançamentos contábeis",
"type": "array",
"items": {
"type": "object",
"properties": {
"data": {
"description": "Data do lançamento (YYYY-MM-DD)",
"type": "string"
},
"descricao": {
"description": "Descrição/histórico do lançamento",
"type": "string"
},
"valor": {
"description": "Valor do lançamento (ex: '1500.00')",
"type": "string"
},
"tipo": {
"description": "Tipo: credito ou debito",
"type": "string",
"enum": [
"credito",
"debito"
]
},
"contaDebito": {
"description": "Conta contábil de débito",
"type": "string"
},
"contaCredito": {
"description": "Conta contábil de crédito",
"type": "string"
},
"historico": {
"description": "Histórico complementar",
"type": "string"
},
"documento": {
"description": "Número do documento",
"type": "string"
},
"favorecido": {
"description": "Nome do favorecido",
"type": "string"
}
},
"required": [
"data",
"descricao",
"valor",
"tipo"
]
}
}
},
"required": [
"sessionId",
"accountId",
"lancamentos"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴reconciliation_execute(sessionId)
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.
Input Schema
{
"type": "object",
"properties": {
"sessionId": {
"description": "ID da sessão de conciliação a executar",
"type": "number"
}
},
"required": [
"sessionId"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢reconciliation_list_matches(sessionId, status)
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).
Input Schema
{
"type": "object",
"properties": {
"sessionId": {
"description": "ID da sessão",
"type": "number"
},
"status": {
"description": "Filtrar por status",
"type": "string",
"enum": [
"sugerido",
"aprovado",
"rejeitado",
"auto_aprovado"
]
}
},
"required": [
"sessionId"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴reconciliation_approve_match(matchId)
Aprova um match sugerido pelo motor de conciliação. Marca as transações e lançamentos envolvidos como conciliados.
Input Schema
{
"type": "object",
"properties": {
"matchId": {
"description": "ID do match a aprovar",
"type": "number"
}
},
"required": [
"matchId"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢reconciliation_list_exceptions(sessionId, status)
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.
Input Schema
{
"type": "object",
"properties": {
"sessionId": {
"description": "ID da sessão",
"type": "number"
},
"status": {
"description": "Filtrar por status",
"type": "string",
"enum": [
"pendente",
"resolvida",
"ignorada"
]
}
},
"required": [
"sessionId"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢reconciliation_kpis(empresaId)
Retorna indicadores-chave de conciliação: contas ativas, sessões concluídas, taxa de automação, exceções pendentes, e sessões recentes.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴reconciliation_seed_demo(empresaId)
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.
Input Schema
{
"type": "object",
"properties": {
"empresaId": {
"default": 0,
"description": "ID da empresa",
"type": "number"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Community
Evidence