next-finance-mcp
Installed, started with no arguments, no environment and no input, and listed its tools. Run 2026-11-16.
Needs to start: nothing
Contacts while installing and starting: nothing
What it contacted
Nothing besides the npm registry it was installed from. Watched from outside its sandbox while it was installed and started with no input. Its tools may still contact things when called.
Starting it
npx -y -p next-finance-mcp@0.9.235 next-finance-mcp
Installing a package runs its code. Use a sandbox for anything you have not read.
What its tools tell an agent
In the tool descriptions, nothing that talks about the user, other tools or private files, or uses hidden characters.
Found by simple pattern rules in each tool's description (up to 3,000 characters), quoted as written. Parameter descriptions are not scanned. A clean result is not a safety review.
Tools
versao
Retorna a versão da SofIA (NEXT Finance MCP) e informações do servidor. Use quando o usuário perguntar qual a versão da SofIA/MCP — funciona em qualquer cliente (Claude, ChatGPT, Codex).
login
Abre uma janela no browser para login seguro no NEXT Finance. As credenciais não passam pelo chat. Se já houver sessão salva, restaura automaticamente sem abrir o browser.
logout
Encerra a sessão e remove os dados de sessão salvos.
listar_carteiras
Lista todas as carteiras disponíveis para o usuário logado.
criar_carteira nome, email, telefone, tipo_pessoa, cpf, cnpj, estrangeiro, produto, onde_conheceu, aceitar_termos
ONBOARDING (não exige login): cria o cadastro do usuário + uma CARTEIRA DE TESTE GRÁTIS (30 dias) para um prospect que ainda não usa o NEXT. Use quando alguém pede para 'criar minha conta/carteira', 'quero testar o NEXT', etc. REGRAS: (1) a SofIA NÃO pede senha pelo chat — ela gera uma senha temporária e o prospect define a dele depois via 'Esqueci minha senha'; (2) o prospect precisa ACEITAR os termos de uso (https://finance.net.br/termos-de-uso) explicitamente → só então passe aceitar_termos=true; (3) CONFIRME todos os dados (e o produto inferido) antes de gravar. Produtos: Finance Standard (padrão, gestão pessoal), Finance Professional, Finance Fortune, e as versões '+ Business' para PJ.
113 more tools
selecionar_carteira nome_carteira
Seleciona uma carteira pelo nome (necessário antes de listar contas e lançamentos). Os nomes disponíveis vêm de listar_carteiras.
listar_contas busca, moeda, portfolio, tipo_conta, pagina, limite
Lista as contas ativas da carteira selecionada. As contas seguem hierarquia de 4 níveis: Moeda → Portfolio → Tipo de Conta → Conta. Portfolios: Liquidez, Previdência, Renda Fixa, Renda Variável, Tesouraria. Use os filtros para navegar nessa hierarquia.
listar_contas_correntes busca, incluir_saldo
RÁPIDO e DIRETO: lista SÓ as contas correntes da carteira, com campos mínimos (nome, banco, agência, conta, permissão e saldo de hoje). Use esta tool quando o usuário pedir 'minhas contas correntes' / 'saldo das contas' — diferente de listar_contas (que traz a árvore inteira de centenas de contas) e das tools de Open Finance/extrato/conciliação. Uma única consulta ao cadastro interno + uma consulta de saldo em lote. Passe incluir_saldo=false para a resposta mais rápida possível (sem o saldo do dia).
criar_conta tipo_conta, nome, portfolio, moeda, pais, data_inicial, saldo_inicial, observacoes, banco, agencia, digito_agencia, numero_conta, digito_conta, nib, iban, swift, limite_cheque_especial, juros_cheque_especial, dia_vencimento_fatura, dia_fechamento_fatura, limite, numero_cartao, internacional, cnpj, codigo_ativo, bolsa, setor_segmento, emissor, grau_de_risco, rating, data_vencimento, numero_dias, taxa, rentabilidade_cdi, rentabilidade_ipca, rentabilidade_igpm, rentabilidade_fixa, aplicacao_inicial, valor_aplicado, data_de_aplicacao, aplicacao_cotizacao, resgate_cotizacao, aplicacao_liquidacao, resgate_liquidacao
Cria uma CONTA de QUALQUER TIPO na carteira (Conta Corrente, Poupança, Conta Caixa, Cartão de Crédito, CDB, Tesouro Direto, Ações, Fundo, Empréstimo, Conta a Pagar/Receber, etc.). Obrigatórios: tipo_conta e nome. Os tipos válidos vêm de listar_tipos_conta. Nomes (tipo_conta, portfolio, banco, moeda, país) são resolvidos para IDs. Campos bancários (banco, agência, conta) valem para contas com banco. Padrões: moeda BRL, país Brasil, data inicial hoje, saldo inicial 0. Portfólio: se omitido, o sistema atribui um padrão.
editar_conta nome, moeda, novo_nome, observacoes, portfolio, cnpj, codigo_ativo, bolsa, setor_segmento, emissor, grau_de_risco, rating, data_vencimento, numero_dias, taxa, rentabilidade_cdi, rentabilidade_ipca, rentabilidade_igpm, rentabilidade_fixa, aplicacao_inicial, valor_aplicado, data_de_aplicacao, aplicacao_cotizacao, resgate_cotizacao, aplicacao_liquidacao, resgate_liquidacao
EDITA o cadastro de uma conta existente: nome, observações, portfolio e os campos de INVESTIMENTO (CNPJ, código do ativo, bolsa, emissor, vencimento, taxa, rentabilidade % do CDI / spread IPCA-IGPM / pré, aplicação inicial, valor aplicado, data de aplicação…). Localiza a conta pelo nome (use 'moeda' para desambiguar homônimas). Só altera o que você informar; preserva o resto. Útil para completar contas de CDB/RDB/Tesouro/Fundos que ficaram sem esses dados. Informe ao menos um campo além do nome de busca.
renomear_conta nome, novo_nome, moeda
RENOMEIA uma conta existente (muda só o NOME; não altera tipo, saldo, banco nem mais nada). Localiza a conta pelo nome atual — se houver contas homônimas em moedas diferentes, informe 'moeda' para desambiguar. Os nomes exatos vêm de listar_contas.
reparar_planos_transferencia codigo_confirmacao, remapear_de, remapear_para_conta, reclassificar_de
DIAGNOSTICA e REPARA planos de transferência ÓRFÃOS que TRAVAM a tela Transações do NEXT (erro 'Cannot read properties of null (reading 0)' em listarPlanoDeContasComTransferenciaFiltrado). Cada conta tem um plano de transferência chamado '[NomeDaConta]'; se a conta foi renomeada/excluída, o plano '[nome antigo]' fica órfão e a tela quebra em TODAS as contas. Esta ferramenta acha os órfãos e, em 2 passos (sem código = diagnóstico; com código = executa), RENOMEIA cada órfão para uma conta sem plano (preserva o histórico) ou EXCLUI quando não há par. Rode sem argumentos para ver o diagnóstico primeiro.
listar_tipos_conta
Lista os tipos de conta disponíveis (corrente, poupança, cartão, investimento etc.).
consultar_rentabilidade data_inicial, data_final, tipo_conta, indicador, incluir_contribuicao
Rentabilidade OFICIAL dos investimentos (mesmo serviço da tela Rentabilidade do NEXT) — NÃO recalcula fórmula. Retorna, por ativo: % mensal, % acumulado composto, setor; os benchmarks do período (CDI/IPCA/IGP-M); o % do benchmark; e a CONTRIBUIÇÃO de cada ativo para o resultado (peso pelo saldo atual × acumulado) — para saber o IMPACTO real (um fundo pode cair muito mas pesar pouco). Marca 'ND' os meses sem cálculo (posição inexistente/sem cotação — não é 0%) e sinaliza meses atípicos para conferir possível evento societário (incorporação/amortização/mudança de ticker). ALERTA (período ≥3 meses): em 'alertas_rendimento_concentrado' marca títulos cujo rendimento foi lançado NO EVENTO (ex.: RDB/CDB no vencimento/reaplicação) e não por competência — o % aparece num mês só e ~0% nos demais, distorcendo a rentabilidade mensal. SEMPRE repasse esse aviso ao usuário quando aparecer (sugira lançar o rendimento mensalmente). Informe o período (YYYY-MM ou YYYY-MM-DD).
simular_parcelamento valor, numero_prestacoes, prestacao, taxa_juros_mensal, primeira_prestacao_avista, comparar_indicadores
Calculadora "Parcelado ou à vista?" (mesma da tela do NEXT). Dado o VALOR À VISTA, o NÚMERO DE PRESTAÇÕES e o VALOR DA PRESTAÇÃO, acha a TAXA DE JUROS embutida no parcelamento (a IRR do fluxo — igual ao 1,14% a.m. da tela) e compara com os indicadores financeiros (CDI, IPCA, IGP-M, TJLP, Poupança) no último período disponível. Resolve o campo que faltar: informe o nº de prestações e DOIS entre {valor, prestação, taxa} — valor+prestação→taxa (padrão); valor+taxa→prestação; prestação+taxa→valor. Use primeira_prestacao_avista=true quando a 1ª parcela é paga no ato (antecipado). Regra de decisão: se a taxa do parcelamento for MENOR que o rendimento do seu dinheiro (ex.: CDI), vale parcelar e manter o valor aplicado; se for MAIOR, à vista sai mais barato (o indicador de referência é escolha do usuário).analisar_ativos_bolsa tipo_conta, codigo, data_inicial, data_final, ordenar_por, indicador, incluir_zerados, rapido
Análise de bolsa por ativo para DECISÃO de compra/venda — vai ALÉM da tela Análise de Bolsa do NEXT, que não mostra DY. Junta 3 fontes internas do NEXT: (1) posição (Qtd, PMC, cotação atual, Investido, Valor Atual) via LancamentosBolsa; (2) PROVENTOS de CAIXA recebidos (Rendimentos Mensais FII / Dividendos / JCP) somados dos lançamentos de cada conta-ativo — exclui marcação a mercado e taxas; é a mesma base da planilha do usuário; (3) rentabilidade % oficial e CDI (tela Rentabilidade). Calcula, por ativo: valorização (R$/%), retorno total (R$/%), DY sobre o PREÇO MÉDIO (yield on cost) e DY sobre a COTAÇÃO (yield on market), ambos no PERÍODO e ANUALIZADO 12m. COMPARAÇÃO: retorna os INDICADORES DE REFERÊNCIA da tela Rentabilidade (CDI, IPCA, IGP-M — e um índice extra cadastrado, se você passar 'indicador') em 'indicadores_referencia', e por ativo 'vs_indicadores_pp' = rentab − CADA indicador (p.p.). NÃO fixa o CDI: ofereça os indicadores e deixe o usuário escolher. OBS: proventos = fluxo de caixa (não replica a coluna 'Resultado' da tela, que é métrica interna do NEXT e não é exposta pela API). Se a leitura de proventos de um ativo falhar (servidor lento), o campo vem em null (não zero) — rode de novo. Pode demorar (~1-3 min) pois varre lançamentos de cada conta-ativo. Prefira filtrar por tipo_conta ou codigo.
analisar_renda_fixa tipo, agrupar_por, data_inicial, data_final, indicador, incluir_encerrados
Análise de RENDA FIXA por título — o NEXT NÃO tem tela equivalente à Análise de Bolsa para renda fixa, então é montada a partir dos DADOS DA CONTA. Cobre Tesouro Direto, CDB, LCA, LCI, CRI, CRA, Debêntures, RDB, FDIC, Poupança, Fundo Renda Fixa e Conta Remunerada. Por título extrai (do NOME + campos da conta): indexador (CDI/IPCA/Pré/Selic), taxa/spread, vencimento, prazo em anos, emissor, rating, saldo atual e % da carteira RF; e a rentabilidade realizada comparada aos INDICADORES DE REFERÊNCIA da tela Rentabilidade (CDI, IPCA, IGP-M + um índice extra via 'indicador') em 'vs_indicadores_pp' — NÃO fixa o CDI; ofereça os indicadores e deixe o usuário escolher. Agrega por tipo, por indexador e por faixa de vencimento. Sinaliza títulos VENCIDOS com saldo e produtos de liquidez SEM taxa no nome (ex.: 'LCA ... Liquidez'). Indexador/taxa/vencimento vêm do nome (convenção do usuário) — sempre apresentar como dado a conferir, não fiscal.
consultar_cota_fundo cnpj, conta, moeda, data, quantidade
Valor OFICIAL da cota de um fundo de investimento, direto da CVM (Informe Diário de Fundos, dados.cvm.gov.br). Informe o CNPJ do fundo (ou a conta, de onde leio o CNPJ do cadastro) e a data — devolvo a cota na data (ou no último dia útil anterior), o PL, e, se passar a quantidade de cotas, o valor da posição (qtd × cota). Trata os dois formatos (pré e pós-reforma de 2024). ATENÇÃO: a cota/rentabilidade do fundo é confiável; para valorizar a posição em R$ use a quantidade ATUAL de cotas (já descontado o come-cotas) — ver registrar_come_cotas.
registrar_come_cotas conta, cnpj, moeda, data_aplicacao, valor_aplicado, quantidade_inicial, aliquota, ate_data, plano, incluir_rendimento, plano_rendimento, centro_de_custo, rendimento_mensal, lancar_a_partir_de, codigo_confirmacao
Calcula e REGISTRA no NEXT o come-cotas (IR semestral de fundo, nos últimos dias úteis de MAIO e NOVEMBRO) usando as cotas oficiais da CVM. A partir da aplicação (data + valor), simula semestre a semestre: rendimento × alíquota = IR, que RESGATA cotas (reduz a quantidade). Alíquota: 20% (curto prazo, ex.: DI) ou 15% (longo prazo). Fluxo em 2 passos: 1ª chamada mostra a PRÉVIA (datas, IR, cotas, quantidade final) para conferir com os extratos; com codigo_confirmacao, LANÇA cada come-cotas como resgate de cotas (plano 'Imposto de Renda') na conta do fundo — deixando a quantidade de cotas correta.
analisar_centros_de_custo filtro, centros_de_custo, data_inicial, data_final, portfolio, incluir_planos
Reproduz a tela 'Análise de Centros de Custo' do NEXT — gasto por CENTRO DE CUSTO (ex.: viagens, projetos, obras), com o DETALHE por plano de contas de cada um (onde o dinheiro foi gasto). Fonte oficial e hospedado-compatível: REST /api/AnalisePlanoDeContas/AcumuladoPorCentroDeCustos com ConsiderarDataDeEmissao=false (SEMPRE pela data da transação — para cartão, a data da fatura; a data de emissão vem vazia em muitos lançamentos). O total de cada CC = soma dos planos-FOLHA (o retorno traz folha+categoria+total; somar tudo triplica). Usa as contas ATIVAS do portfolio (padrão 'Tesouraria'). Período padrão vai 4 meses à frente para capturar fatura de cartão lançada depois do mês da despesa. OBS: o endpoint pode ser LENTO (o de /api/AnaliseCentrosDeCusto NÃO serve — ignora o flag e devolve valores errados; ver BUG-analise-centros-de-custo-rest.md).
fluxo_de_caixa dias, data_inicial, data_final, tipo, contas, incluir_cartoes, usar_padrao
Reproduz a tela 'Fluxo de Caixa' do NEXT — projeta o SALDO CONSOLIDADO dia a dia (ou mês a mês) a partir do saldo atual das contas + os títulos a receber (sobe) e a pagar (desce) ao longo do período. É mais completo do que só olhar 'Conta a Pagar': carrega o PADRÃO salvo pelo usuário (quais contas e centros de custo entram) e, quando o cartão de crédito está na análise, as FATURAS futuras entram; lançamentos já AGENDADOS na conta corrente também. Fonte oficial e hospedado-compatível: REST /api/FluxoDeCaixa/CarregarPadrao + /Diario (ou /Mensal). Retorna a série consolidada (para o gráfico), a série por conta, e um resumo com saldo inicial/final, variação e o MENOR saldo projetado (indicador de risco de caixa — se o saldo fica negativo e quando). Usa as contas do PADRÃO salvo pelo usuário. ALERTA automaticamente (campo alerta_cartao) quando há cartão de crédito com fatura no período SEM transferência de pagamento para alguma conta da análise — nesse caso a saída do cartão não está projetada. incluir_cartoes=true adiciona os cartões ativos à análise.
listar_centros_de_custo busca
Lista os centros de custo da carteira. Use para descobrir nomes exatos antes de filtrar lançamentos por centro de custo.
listar_plano_de_contas busca, tipo, pagina, limite
Lista o plano de contas da carteira — categorias de DESPESA E RECEITA (cada item traz o 'tipo'). Retorna por_tipo com a contagem de despesa/receita. Use tipo='despesa' ou 'receita' para focar num lado. Use para descobrir os nomes exatos das categorias antes de classificar/buscar lançamentos por plano de contas.
criar_centro_de_custo nome, pai, descricao
Cria um novo centro de custo na carteira. Informe o 'nome'; opcionalmente um 'pai' (centro de custo existente, para criar como sub-centro) e uma 'descricao'.
criar_plano_de_contas nome, pai, descricao
Cria uma nova categoria no plano de contas. O 'pai' é OBRIGATÓRIO e define se o novo plano é de DESPESA ou RECEITA (o tipo é herdado do ramo do pai — ex.: pai 'Despesas Operacionais' cria uma despesa). Use 'listar_plano_de_contas' para achar o nome do pai.
buscar_lancamentos nome_conta, data_inicio, data_fim, plano_de_contas, centro_de_custo, busca, apenas_despesas, apenas_receitas, apenas_liquidados, excluir_transferencias, excluir_previsoes, pagina, limite
Busca lançamentos/transações da carteira. nome_conta é OPCIONAL — sem ele a tool agrega automaticamente todas as contas de movimento (corrente, cartão de crédito, caixa, poupança) numa única chamada, retornando o resultado consolidado. Prefira chamar UMA vez sem nome_conta a iterar por conta para um dashboard. Use plano_de_contas para filtrar por categoria (ex: 'Restaurante'). Transferências entre contas são excluídas por padrão. O retorno inclui totais (despesas/receitas/saldo) + agregações por plano_de_contas e centro_de_custo. Cada lançamento traz os campos de TÍTULO: 'vencimento' (DataVencimento), 'data_transacao' (data da baixa/liquidação), 'data_emissao', 'cliente', 'numero_documento', 'liquidado' e 'dias_atraso' (data_transacao − vencimento, para fator de atraso). Para uma consulta de TÍTULOS LIQUIDADOS, use apenas_liquidados=true.
buscar_contas_a_pagar data_inicio, data_fim, busca, moeda, apenas_vencidos, pagina, limite
Lista os TÍTULOS A PAGAR (contas a pagar) da carteira — agrega TODAS as contas do tipo 'Conta a Pagar'. Cada título traz: vencimento, valor, moeda, fornecedor (campo 'contraparte'), conta, se está vencido e os dias de atraso/para vencer. Retorna totais_por_moeda (nunca soma moedas diferentes) e agregação por fornecedor. Use moeda='BRL' para focar no real; apenas_vencidos=true para só o que está em atraso. Janela padrão: 1 ano atrás a 1 ano à frente.
buscar_contas_a_receber data_inicio, data_fim, busca, moeda, apenas_vencidos, apenas_cobranca, incluir_cobranca, pagina, limite
Lista os TÍTULOS A RECEBER da carteira — agrega TODAS as contas do tipo 'Conta a Receber' e, por padrão, também as do tipo 'Contas em Cobrança' (cada título tem o flag em_cobranca). Cada título traz: vencimento, valor, moeda, cliente (campo 'contraparte'), conta, se está vencido e os dias de atraso/para vencer. Retorna totais_por_moeda (nunca soma moedas diferentes) e agregação por cliente. Use moeda='BRL' para focar no real; apenas_cobranca=true para SÓ os recebíveis em cobrança; apenas_vencidos=true para só os vencidos. Janela padrão: 1 ano atrás a 1 ano à frente.
baixar_a_receber cliente, vencimento, valor, moeda, conta_destino, data, documento, valor_parcial, previsao_restante, retirar_previsao, codigo_confirmacao
BAIXA (liquida) um título A RECEBER — marca o recebimento e joga o valor numa conta corrente/caixa (conta_destino). Localiza o título pelo cliente (contraparte) + vencimento (+ valor para desambiguar). Suporta baixa PARCIAL (valor_parcial + previsao_restante). O título pode ser localizado com buscar_contas_a_receber. Confirme com o usuário antes de baixar.
baixar_a_pagar fornecedor, vencimento, valor, moeda, conta_destino, data, documento, valor_parcial, previsao_restante, retirar_previsao, codigo_confirmacao
BAIXA (liquida) um título A PAGAR — marca o pagamento e debita o valor de uma conta corrente/caixa (conta_destino). Localiza o título pelo fornecedor (contraparte) + vencimento (+ valor para desambiguar). Suporta baixa PARCIAL. O título pode ser localizado com buscar_contas_a_pagar. Confirme com o usuário antes de baixar.
enviar_para_cobranca cliente, vencimento, valor, moeda, conta_cobranca, retirar_previsao, codigo_confirmacao
Move um título A RECEBER não recebido para 'Contas em Cobrança' (reclassificação, sem emitir boleto). Localiza o título pelo cliente (contraparte) + vencimento (+ valor). Se houver mais de uma conta de cobrança, informe conta_cobranca.
enviar_email_cobranca cliente, vencimento, valor, moeda, conta_cobranca, codigo_confirmacao
Envia o E-MAIL DE COBRANÇA de um título que está em 'Contas em Cobrança' (reproduz o botão 'Enviar Email de Cobrança' da tela). Usa o padrão 'Email de Cobrança' + AWS SES configurados na carteira e envia para o e-mail do cliente cadastrado. O título precisa ESTAR em cobrança — mova antes com enviar_para_cobranca. Localiza o título pelo cliente (contraparte) + vencimento (+ valor). Confirme com o usuário antes de disparar.
listar_inadimplentes moeda, min_dias, incluir_contato, limite
Lista os CLIENTES INADIMPLENTES — contas a receber VENCIDAS agregadas por cliente (inclui as já em 'Contas em Cobrança'). Cada cliente traz: total_vencido, nº de títulos, vencimento_mais_antigo, dias_atraso_max, faixa de aging (1-30/31-60/61-90/90+), quanto já está em cobrança e o CONTATO para cobrar (celular/e-mail; em PJ, os contatos internos). Ordenado pelo maior valor em atraso. Retorna totais_por_moeda (nunca soma moedas diferentes). Use para saber quem cobrar e como falar — e depois enviar_para_cobranca / enviar_email_cobranca.
substituir_previsao_por_boleto linha_digitavel, fornecedor, conta, moeda, competencia, valor, vencimento, confirmar
Use SOMENTE para BOLETO SEM NOTA de uma despesa recorrente. ATUALIZA a PREVISÃO existente em Contas a Pagar (vira título real com a linha digitável, valor e vencimento do boleto) em vez de criar um lançamento novo — evita DUPLICAR o valor. SEMPRE avisa a diferença de valor (previsão estimada vs boleto real). Localiza a previsão pelo fornecedor + competência (mês do vencimento do boleto). Fluxo: confirmar=false para a PRÉVIA (com o alerta de valor) → após o 'ok', confirmar=true para gravar. IMPORTANTE: se a conta VEIO COM NOTA FISCAL (energia, água, telefonia, NF-e), não se aplica: o registro é por cadastrar_documento_recebido (o documento no Business gera a transação vinculada), com a diferença de valor sinalizada. Se não achar a previsão, avisa.
buscar_despesas_periodicas busca, moeda
Lista as DESPESAS PERIÓDICAS (estimativas recorrentes) da carteira — a camada de PREVISÃO que o usuário cadastra na tela 'Despesas Periódicas' e que depois é programada em Contas a Pagar. Cada item traz: descrição, valor_estimado, moeda, dia do mês, periodicidade (Mensal/Anual…), plano de contas, centro de custo, variacao_tolerada_pct e previsoes_associadas. Retorna a estimativa_mensal_por_moeda (orçamento mensal). Use moeda='BRL' para focar no real. Distinta de buscar_contas_a_pagar (que traz os títulos já programados/reais).
buscar_receitas_periodicas busca, moeda
Lista as RECEITAS PERIÓDICAS (estimativas recorrentes) da carteira — a camada de PREVISÃO da tela 'Receitas Periódicas', depois programada em Contas a Receber. Cada item traz: descrição, valor_estimado, moeda, dia do mês, periodicidade, plano de contas, centro de custo, variacao_tolerada_pct e previsoes_associadas. Retorna a estimativa_mensal_por_moeda. Use moeda='BRL' para focar no real. Distinta de buscar_contas_a_receber (títulos já programados/reais).
conferir_previsto_realizado tipo, mes, moeda
CONFERÊNCIA previsto × realizado de um mês: cruza as 3 camadas — previsto (Despesa/Receita Periódica = estimativa), programado (título em Contas a Pagar/Receber no mês, após acerto) e realizado (efetivado nas contas de movimento). Retorna por_item (descrição: previsto/programado/realizado/diferença/status, respeitando a variação tolerada) e por_categoria (orçado × realizado por plano de contas), além de resumo_por_moeda. Status: ok / acima / abaixo / pendente (sem realizado) / sem_previsao. Use para validar se as estimativas batem com a realidade. Passe moeda='BRL' para não misturar moedas. Observação: por_item casa por descrição+plano (exato); a visão por_categoria é a mais robusta.
listar_clientes busca, moeda, pagina, limite
Lista os CLIENTES da carteira (quem tem títulos a receber), ordenados pelo valor a receber. Cada cliente traz: nome, tipo (PF/PJ), quantidade de títulos, valor a receber e valor vencido. Retorna também o total_a_receber da carteira. Use busca para filtrar por nome. A ficha cadastral completa de um cliente (CPF/CNPJ, endereço, etc.) vem de buscar_contato; uma tratativa/cobrança é registrada por criar_registro_relacionamento.
criar_lancamento nome_conta, moeda, data, valor, descricao, cliente, plano_de_contas, centro_de_custo, data_vencimento, data_emissao, quantidade, valor_unitario, observacoes, numero_documento, previsao, manter_data_compra, forma_pagamento, linha_digitavel, codigo_de_barras, nosso_numero, cpf_cnpj_beneficiario, local_de_pagamento, tipo_servico, parcelas, periodicidade, dia_util, dia_util_direcao
Cria um novo lançamento (despesa ou receita) numa conta. Valor negativo = despesa, positivo = receita. Nomes (conta, plano de contas, centro de custo) são resolvidos para IDs internos automaticamente; se a busca for ambígua a tool lista as opções.
criar_transferencia conta_origem, conta_destino, valor, data, descricao, observacoes, codigo_confirmacao
Cria uma transferência entre duas contas — débito na conta de origem e crédito na conta de destino (o NEXT cria automaticamente os dois lados, vinculados). Use isto, NÃO criar_lancamento, quando o dinheiro sai de uma conta sua e entra em outra conta sua (ex: PIX entre contas próprias, aplicação/resgate, pagamento de fatura de cartão a partir da conta corrente). Requer permissão de edição na conta de origem. Valor sempre positivo.
editar_lancamento nome_conta, data, valor, descricao, numero_documento, moeda, autorizar_protegido, nova_descricao, novo_cliente, novo_valor, nova_quantidade, novo_valor_unitario, nova_data, novo_plano_de_contas, novo_centro_de_custo, novas_observacoes, novo_numero_documento, nova_data_vencimento, nova_data_emissao, nova_previsao, nova_forma_pagamento, nova_linha_digitavel, novo_codigo_de_barras, novo_nosso_numero, novo_cpf_cnpj_beneficiario, novo_local_de_pagamento, novo_tipo_servico, novas_divisoes
Edita um lançamento existente. Localiza pelo nome_conta + data + valor/descrição (varre TODAS as contas homônimas, inclusive em moedas diferentes — ex: as várias 'Conta a Pagar') e aplica as alterações. Se mais de um lançamento bater, a tool lista as opções para você refinar (use 'moeda' para desambiguar).
editar_lancamentos_em_lote nome_conta, data, data_inicial, data_final, valor, descricao, cliente, moeda, nova_descricao, novo_cliente, novo_plano_de_contas, novo_centro_de_custo, novas_observacoes, novo_numero_documento, autorizar_protegido, confirmar, limite
Edita VÁRIOS lançamentos DE UMA VEZ — resolve o caso de N lançamentos IDÊNTICOS (mesma data/valor/descrição) que a edição individual recusa por não conseguir distinguir. Localiza TODOS os que batem os critérios (conta + data ou período + valor/descrição/cliente) e aplica a MESMA mudança a cada um (descrição, contato, plano, centro, observações, nº doc). Caso típico: transferir todos os lançamentos de uma descrição errada para a correta, vinculando ao cadastro certo (ex.: 'Lara Assis' → 'Lara Ribeiro'). Fluxo em 2 passos: confirmar=false devolve a CONTAGEM e uma amostra; após o 'ok', confirmar=true aplica a todos. Ignora transferências. Só age em contas com permissão de edição.
excluir_lancamento nome_conta, data, data_final, valor, descricao, numero_documento, moeda, excluir_parcelas, codigo_confirmacao
Exclui um lançamento existente. Fluxo SEGURO em 2 passos: a 1ª chamada (sem codigo_confirmacao) LOCALIZA o(s) lançamento(s) e devolve os itens exatos (data, valor, descrição) + o código; a 2ª (com o código) exclui SÓ esses IDs. Localiza por nome_conta + data + valor/descrição/numero_documento. CARTÃO: a compra é lançada na DATA DE VENCIMENTO da fatura — informe a data da COMPRA que a busca varre a fatura automaticamente (janela de +75 dias; use data_final para ampliar). PARCELAS: se vários lançamentos baterem (parcelas/itens), por padrão (excluir_parcelas='todas') exclui o grupo todo — a confirmação mostra quantos, as datas e o total; use excluir_parcelas='uma' para forçar o refino a um único. AÇÃO IRREVERSÍVEL.
anexar_arquivo_lancamento nome_conta, data, valor, descricao, numero_documento, moeda, caminho_arquivo, conteudo_base64, url_arquivo, nome_arquivo
Anexa um arquivo (boleto PDF, comprovante, nota, imagem, etc.) a um lançamento. Localiza o lançamento pelo (nome_conta + data + valor/descrição) e envia o arquivo. Informe 'caminho_arquivo' (arquivo local no computador) OU 'conteudo_base64' + 'nome_arquivo' OU 'url_arquivo' (uma URL http/https que o SERVIDOR baixa — use no conector hospedado/ChatGPT, que não consegue enviar o arquivo local). O nome precisa ter extensão (ex: boleto.pdf). DESAMBIGUAÇÃO: se houver vários lançamentos com a MESMA data/valor/descrição (ex.: pedágios do mesmo fornecedor), passe 'numero_documento' (o nº do documento/recibo do lançamento) — casa EXATO e anexa sem ambiguidade, sem precisar mexer na descrição. Dica: registre o recibo no numero_documento ao criar o lançamento (criar_lancamento devolve numero_documento) e use-o aqui.
listar_anexos_lancamento nome_conta, data, valor, descricao, numero_documento, moeda
Lista os arquivos anexados a um lançamento (nome, extensão, tamanho, URL). Localiza pelo trio (nome_conta + data + valor/descrição).
remover_anexo_lancamento nome_conta, data, valor, descricao, numero_documento, moeda, nomes_arquivo
Remove um ou mais anexos de um lançamento. Localiza pelo trio (nome_conta + data + valor/descrição) e remove os arquivos por nome COM extensão (ex: 'boleto.pdf'). Use 'listar_anexos_lancamento' para ver os nomes exatos.
listar_documentos_recebidos apenas_nao_importadas, apenas_recorrentes
Lista os DOCUMENTOS RECEBIDOS (NF-e da SEFAZ, bandeja a importar) e SINALIZA os RECORRENTES — casa o emitente com uma despesa periódica cadastrada. Cada documento traz: fornecedor, data, valor, nsu, importada e o flag 'recorrente' (com a referência da despesa periódica e o ALERTA de diferença de valor: 'a previsão era R$X e o documento chegou R$Y'). Use para priorizar/avisar as contas recorrentes que chegaram. apenas_nao_importadas=true mostra só as pendentes; apenas_recorrentes=true só as recorrentes.
importar_documento_recebido caminho_arquivo, diretorio, conteudo_base64, nome_arquivo, conta_pagamento, parcelas, primeiro_vencimento, plano_de_contas, centro_de_custo, periodicidade, forma_pagamento
Importa documento(s) fiscal(is) recebido(s) por XML no NEXT Business (Compras & Despesas → Documentos Recebidos): NF-e, NFC-e ou NFS-e. O NEXT parseia o XML e cria o documento. NFS-e NACIONAL (padrão nacional SPED, <NFSe xmlns='.../nfse'>): o importador do NEXT ainda não reconhece esse layout; nesse caso o MCP parseia o XML e cadastra pelos CAMPOS automaticamente — vira REGISTRO GERENCIAL (sem o vínculo do XML fiscal autorizado); avise o usuário disso. Informe 'caminho_arquivo' (um XML local), 'diretorio' (importa TODOS os .xml da pasta, em lote), ou 'conteudo_base64' + 'nome_arquivo'. CLASSIFICAÇÃO (só para UM arquivo): para o documento já sair lançado no Finance, informe 'conta_pagamento' (conta/cartão), e se for o caso 'parcelas' + 'primeiro_vencimento', além de 'plano_de_contas' e 'centro_de_custo'. Esses dados (conta/cartão, à vista ou parcelado + 1º vencimento, plano de contas, centro de custo) são necessários para a classificação e devem ser informados, não inferidos.
cadastrar_documento_recebido tipo, numero, fornecedor, data_emissao, data_vencimento, valor, itens, informacao_adicional, plano_de_contas, centro_de_custo, forma_pagamento, conta_pagamento, tipo_servico, fornecedor_cnpj, fornecedor_ie, endereco_logradouro, endereco_numero, endereco_bairro, endereco_cidade, endereco_uf, endereco_cep, atualizar_endereco, classe_fornecedor, permitir_resumo, linha_digitavel, codigo_barras, nosso_numero
Cadastra MANUALMENTE um documento fiscal recebido no NEXT Business (Compras & Despesas → Documentos Recebidos) a partir de dados lidos de um PDF/impressão/imagem — quando NÃO há XML nem link importável (ex.: NFC-e cuja consulta foi protegida por reCAPTCHA, ou NF3-e de energia). Os campos são extraídos do documento (PDF/impressão/imagem) e passados como parâmetros. Tipos: 'NFCe', 'NFe', 'NFSe', 'Energia Elétrica' (NF3-e), 'Recibo', 'Cupom Fiscal', etc. FORNECEDOR pela RAIZ do CNPJ (identidade única): se a filial (CNPJ completo) já existe, vincula a ela; se a empresa (raiz) existe mas a filial não, adiciona a filial (passe o endereço); se a raiz NÃO existe, CRIA o cadastro completo (passe o endereço + opcional classe_fornecedor). Se a filial existe mas o endereço mudou, passe atualizar_endereco=true com os campos endereco_* novos. ATENÇÃO a valores negativos (ex.: energia compensada na NF3-e reduz o total). Requer a data de emissão (quando não visível no documento, deve ser informada, não inferida) e a forma de pagamento (e conta/cartão). O parâmetro 'fornecedor_cnpj' é recomendado. Este passo apenas CRIA o documento; a classificação (conta/cartão, número de parcelas e vencimentos, plano de contas e centro de custo) é feita em seguida por 'classificar_documento_recebido' — sem ela o lançamento fica sem classificação.
classificar_documento_recebido numero, fornecedor, data_inicio, data_fim, conta_pagamento, parcelas, primeiro_vencimento, plano_de_contas, centro_de_custo, periodicidade, forma_pagamento
Classifica o pagamento de um documento recebido JÁ importado (Compras & Despesas): define a conta/cartão, parcelas e vencimentos, e o plano de contas + centro de custo — deixando-o lançado no Finance. Localiza o documento pelo 'numero' (+ 'fornecedor' se houver mais de um). Conta, parcelas e classificação são necessários; quando não informados, devem ser solicitados antes de gravar.
editar_documento_recebido numero, fornecedor, data_inicio, data_fim, itens
CORRIGE os ITENS de um documento recebido JÁ cadastrado — troca a lista de produtos (DespesaServProd) preservando total, fornecedor, classificação, pagamento e parcelas. Use para DETALHAR uma NFC-e que entrou como resumo (ex.: '65 itens conforme a nota') com os itens produto a produto. O total NÃO muda (a soma dos itens tem que bater com o total do documento — não afeta o saldo). Localiza pelo 'numero' (+ 'fornecedor').
importar_nfce_html html, conta_pagamento, plano_de_contas, centro_de_custo, confirmar
Importa uma NFC-e (cupom fiscal) a partir do HTML da tela 'Consulta Detalhada' do portal da SEFAZ, colado pelo usuário (o portal fica atrás de Cloudflare Turnstile, então o servidor NUNCA busca a URL — quem coleta o HTML é o navegador do usuário). Faz o parsing puro (chave, emitente, itens com código/EAN/desconto, totais, pagamento) e grava pelo MESMO pipeline de cadastrar_documento_recebido (data de fatura no cartão, fornecedor por CNPJ/endereço, itens individuais). ATENÇÃO: NÃO é documento fiscal (origem=consulta_publica_sefaz, sem XML autorizado) — serve como registro gerencial / histórico de preço, não para escrituração ou crédito de ICMS. Fluxo em 2 passos: sem confirmar mostra a PRÉVIA (fornecedor, nº de itens, total, avisos); com confirmar=true grava. Para pagamento no cartão, informe conta_pagamento (o cartão) para a transação cair no vencimento da fatura.
importar_nfce_por_url url
PORTA DE ENTRADA para NFC-e: recebe a URL do QR Code do cupom (portalsped.fazenda.mg.gov.br/.../qrcode.xhtml?p=...). SEM acessar a URL (o portal fica atrás do Cloudflare — só o navegador do usuário passa), decodifica a chave de 44 dígitos: identifica emitente (CNPJ), número, série, competência e se é contingência; valida o dígito verificador; recusa NF-e (modelo 55). Checa se a nota já está cadastrada (não duplica). Se for nova, devolve a 'url' e 'abrir_navegador_interno': a url deve ser aberta num navegador (interno, se houver); o usuário resolve o Cloudflare e clica 'Visualizar', e o HTML da página (resumo do QR, já com os itens) é enviado a importar_nfce_html. Sem navegador interno, o usuário abre no Chrome com o userscript. Os itens (o que/quanto/preço) só vêm pelo HTML — o servidor não acessa a URL.
adicionar_filial_fornecedor fornecedor, cnpj, ie, logradouro, numero, bairro, cidade, uf, cep
Adiciona uma FILIAL (endereço com CNPJ) a um fornecedor JÁ cadastrado (mesma raiz de CNPJ) — independente de documento. Use quando uma NFC-e/NF-e chega de uma filial ainda não cadastrada e a matriz já existe: a filial precisa entrar no cadastro de endereços. Localiza a matriz pela raiz, verifica se a filial já existe (evita duplicar) e confirma que ela apareceu. Depois, selecione a filial em Matriz/Filial no documento (ou recadastre o documento). Passe o CNPJ COMPLETO da filial (14 dígitos).
listar_contratos pessoa, pagina, limite
Lista os contratos (NEXT Business → Receitas & Operações → Contratos) da carteira. Use 'pessoa' para filtrar por cliente. Traz número, cliente, valor, situação, período de reajuste e o índice detectado no texto do contrato.
detalhar_contrato numero, pessoa
Detalha um contrato pelo 'numero' (+ 'pessoa' para desambiguar): valor atual, datas, periodicidade de reajuste, situação e o texto de 'Informações sobre o contrato' (onde fica o índice de reajuste IPCA/IGPM).
calcular_reajuste numero, pessoa, indice, meses
Calcula (SEM gravar) o reajuste de um contrato: usa o índice acumulado dos últimos 12 meses (padrão) do Banco Central — IPCA ou IGP-M — até o último mês fechado, e mostra valor atual → valor novo. O índice é lido do texto do contrato ('Informações sobre o contrato'); se não estiver lá, informe em 'indice'. Fonte: BCB SGS (público).reajustar_contrato numero, pessoa, indice, meses, parcelas, responsavel
APLICA o reajuste do contrato E cria o novo ciclo de parcelas (grava tudo via API). Faz o procedimento completo da tela: (1) atualiza o VALOR e os valores dos serviços pelo índice acumulado (IPCA/IGPM, BCB, 12 meses até o último mês fechado); (2) MANTÉM todas as parcelas existentes nos valores originais; (3) CRIA as 12 novas parcelas no valor reajustado, do mês seguinte à última; (4) avança a Validade (+12) e a Data Fim (+12 meses); (5) acrescenta a nota padrão. Ao final avisa quantas parcelas foram criadas e no valor novo. Confirme o valor novo com o usuário antes de chamar. O índice vem do texto do contrato (ou de 'indice').
gerar_faturamento_contrato numero, pessoa
Gera o FATURAMENTO do contrato (emite os documentos das parcelas) — NEXT `GerarFaturamento`. Ação SEPARADA do reajuste e do 'Criar Parcelas'. Use só quando o usuário pedir para faturar/emitir.
criar_contrato cliente, produto, valor_parcela, periodicidade, prazo_meses, data_inicio, data_primeira_parcela, indice_reajuste, tipo_contrato, conta_recebimento, responsavel, observacao, numero_pedido, confirmar
Cria um NOVO contrato no NEXT Business (faturamento recorrente). Funciona em qualquer carteira: INFERE o produto pelos Serviços cadastrados no Business daquela carteira (case o mais provável a partir do 'produto' informado; se ambíguo/inexistente, a tool devolve as opções para você escolher — NÃO invente). SEGURANÇA: por padrão (confirmar=false) só devolve a PRÉVIA do plano (cliente, produto, valor, nº de parcelas, vencimentos) SEM gravar; confira com o usuário e só então chame de novo com confirmar=true para gravar. REGRAS: nº de parcelas segue a periodicidade dentro do prazo (mensal→12, trimestral→4, semestral→2, anual→1 no ano); reajuste padrão anual pelo IPCA (gravado nas Informações para o reajustar_contrato detectar depois); assinatura sempre pelo usuário logado + '(via SofIA MCP)'. O cliente precisa já estar cadastrado (via buscar_contato/criar_contato). Ex.: compra 'Trimestral' de R$261,95 → contrato anual, 4 parcelas trimestrais. NÃO emite faturamento (isso é gerar_faturamento_contrato).
listar_modelos_proposta
Lista os MODELOS de proposta cadastrados (Business → Propostas). Fornece as opções de modelo para uso opcional em criar_proposta — o modelo preenche os textos de Introdução, Validade, Condição, etc.
buscar_propostas produto, cliente, situacao, data_inicio, data_fim, dias, limite
PESQUISA as PROPOSTAS já cadastradas (Business → Propostas / Atendimento). Use quando o usuário quer LOCALIZAR/CONSULTAR propostas existentes — por PRODUTO/SERVIÇO (ex.: 'Company Up'), por CLIENTE ou por SITUAÇÃO. Retorna número, data, cliente, valor, situação, tipo, modelo e os serviços de cada proposta. O intervalo padrão é os últimos 730 dias (~2 anos); ajuste com dias/data_inicio/data_fim. A resposta traz 'periodo_descricao' e 'mensagem' com o INTERVALO pesquisado — SEMPRE informe esse período ao usuário. Se vier VAZIO, a proposta pode ser mais antiga: amplie a janela (ex.: dias=1095) antes de dizer que não existe — NÃO caia no CRX (oportunidade/atendimento não é proposta emitida). Diferente de listar_modelos_proposta (que lista MODELOS de texto, não propostas emitidas).
criar_proposta cliente, tipo, servicos, modelo, email, data, responsavel, confirmar
Cria uma PROPOSTA comercial no NEXT Business (Atendimento). Requer: o CLIENTE, o TIPO da proposta, os SERVIÇOS a incluir e, opcionalmente, um MODELO (as opções vêm de listar_modelos_proposta) que preenche os blocos de texto (Introdução, Validade, Condição…). Os serviços são casados com os Serviços do Business (se ambíguo, a tool devolve as opções). Por padrão (confirmar=false) devolve a PRÉVIA (cliente, tipo, serviços, total) sem gravar; confirmar=true grava. Não envia nem gera PDF (isso é ação à parte na tela).
listar_moedas busca
Lista as moedas disponíveis no NEXT Finance (ex: BRL, USD, EUR). Use 'busca' para filtrar por nome, sigla ou símbolo.
permissao_conta nome_conta
Verifica a permissão do usuário logado sobre uma conta. Retorna 'Negar' (oculta), 'Ver' (somente leitura) ou 'Editar' (acesso total). O MCP respeita essas permissões automaticamente: contas 'Negar' não aparecem em listagens, e tentativas de criar/editar/excluir lançamento em conta 'Ver' são rejeitadas.
consultar_saldo nome_conta, data
Consulta o saldo de UMA conta numa data específica (padrão: hoje). Use 'saldo_carteira' para o snapshot consolidado de todas as contas. Retorna o saldo acumulado do dia (ex: R$ -16.049,49 no Itaú em 06/06/2026).
saldo_carteira data
Snapshot completo de saldos da carteira numa data (default: hoje), agrupado em árvore Moeda → Portfolio → Tipo de Conta → Conta. Equivale à tela 'Outras Contas' do NEXT Finance. Mostra patrimônio total por moeda (BRL, USD, EUR, etc.) e breakdown por categoria (Renda Fixa, Renda Variável, Tesouraria, Liquidez, Previdência).
ultimo_preco_produto busca, nome_fornecedor, data_inicio, data_fim, agrupar_por_fornecedor, limite
Histórico de preços de um produto — responde 'qual o último preço que paguei pelo produto X?'. Por padrão retorna 1 linha por fornecedor com a compra mais recente, ordenado por data desc. Use 'agrupar_por_fornecedor=false' para listar TODAS as compras. Período default: últimos 12 meses. Fonte: NEXT Business (NFCe/NF-e + cadastro de produtos).
resumo_categoria plano_de_contas, data_inicio, data_fim, apenas_despesas, apenas_receitas
Resumo de gastos/receitas numa categoria do plano de contas — responde 'quanto gastei com Restaurantes em maio?'. Retorna total de despesas/receitas/saldo do período, breakdown por mês, por conta, por centro de custo e top 15 descrições. Período default: últimos 30 dias.
resumo_centro_de_custo centro_de_custo, data_inicio, data_fim
Resumo de gastos/receitas num centro de custo — responde 'despesas e receitas do CC Pedro Tobias?'. Retorna total de despesas/receitas/saldo, breakdown por mês, por plano de contas, por conta e top 15 descrições. Período default: últimos 30 dias.
listar_contas_open_finance
Lista as contas da carteira que possuem vínculo Open Finance ativo (integração via Pluggy/OF). Retorna nome da conta, banco, tipo e se exige MFA. Não chama a API REST — usa os dados de cadastro da conta diretamente.
verificar_open_finance nome_conta
Verifica se uma conta específica tem vínculo Open Finance configurado e se exige MFA. Usa dados de cadastro (offline).
atualizar_open_finance nome_conta
Dispara uma sincronização Open Finance para a conta — puxa os lançamentos mais recentes do banco via Pluggy. Após sucesso, use 'buscar_lancamentos' para ver os novos dados. Pode levar alguns segundos (chamada assíncrona ao banco).
iniciar_open_finance_qr nome_conta
Abre uma janela local no navegador com o widget Pluggy Connect para autenticar uma conta Open Finance que exige MFA (ex: Inter, que pede leitura de QR Code no Super App). Após o usuário concluir a autenticação, a janela fecha sozinha e a conta fica pronta para 'obter_extrato_open_finance'.
conectar_open_finance nome_conta
Conecta uma conta ao banco via Open Finance (Pluggy) pela PRIMEIRA vez. Fluxo INTERATIVO: abre o widget Pluggy Connect no navegador local, o USUÁRIO escolhe o banco e autentica (senha/MFA no app do banco), e o MCP salva o vínculo e mapeia a conta. Se o banco trouxer VÁRIAS contas, retorna a lista para associar cada uma com associar_conta_open_finance. A renovação de MFA de conta já conectada é feita por iniciar_open_finance_qr.
listar_contas_do_item_open_finance nome_conta
Lista as contas bancárias trazidas por uma conexão Open Finance de uma conta (para associar). Retorna cada conta OF com id e descrição — use o id em associar_conta_open_finance.
associar_conta_open_finance nome_conta, conta_open_finance
Associa (mapeia) uma conta bancária vinda do Open Finance a uma conta do NEXT — associação CONTA A CONTA. Use o id da conta OF obtido em conectar_open_finance ou listar_contas_do_item_open_finance.
desassociar_conta_open_finance nome_conta
Remove o vínculo Open Finance de uma conta (desvincula a conexão bancária). Use quando a associação ficou errada ou o vínculo travou — depois dá para reconectar com 'conectar_open_finance'.
obter_extrato_open_finance nome_conta, data_inicio, data_fim
Solicita ao banco (via Open Finance) o extrato de uma conta no período. Diferente de 'atualizar_open_finance' (que só pega o mais recente), permite especificar um intervalo de datas. Default: últimos 30 dias. Após sucesso, a conciliação fica pendente no NEXT — finalize no app para os lançamentos aparecerem em 'buscar_lancamentos'.
buscar_despesas data_inicio, data_fim, nome_fornecedor, busca, com_itens, pagina, limite
Lista documentos recebidos (NFCe, NF-e, etc.) do NEXT Business no período. Use 'nome_fornecedor' para filtrar por fornecedor. Use 'com_itens: true' para incluir os produtos/serviços de cada documento. Retorna totais de valor e valor líquido do período.
buscar_itens_despesa busca, nome_fornecedor, data_inicio, data_fim, pagina, limite
Busca produtos e serviços dentro dos documentos recebidos (NFCe). Ideal para: 'onde comprei leite?', 'quanto paguei por café em cada fornecedor?'. Use 'busca' para filtrar pelo nome/descrição do produto. Use 'nome_fornecedor' para restringir a um fornecedor específico. Cada item retorna o documento de origem (data, número, fornecedor).
buscar_compras_produto busca, pessoa_id, data_inicio, data_fim, pagina, limite
Busca compras de produtos agrupadas por produto e fornecedor. Use 'busca' para filtrar pelo nome do produto (ex: 'bombom garoto', 'arroz'). Use 'pessoa_id' para filtrar por fornecedor específico. Ideal para ver histórico de compras, comparar preços e rastrear aquisições.
listar_conciliacoes
Lista as conciliações bancárias em andamento na carteira (criadas por extrato Open Finance ou importação de arquivo). Mostra conta, banco, número de transações e período. Use antes de executar/detalhar uma conciliação.
detalhar_conciliacao nome_conta
Detalha os lançamentos pendentes de uma conciliação. Mostra cada transação do extrato, se é nova (não existe no NEXT) ou já existe, e se tem match automático com um lançamento existente.
associar_conciliacao nome_conta
Marca as linhas pendentes de uma conciliação para que ela possa ser finalizada. Confirma as linhas com match automático e marca as sem match como novo lançamento. Necessário rodar ANTES de executar_conciliacao (senão a finalização é recusada com 'Existe algum lançamento para conciliar desmarcado').
executar_conciliacao nome_conta
Finaliza (executa) a conciliação de uma conta via Concluir — aplica os lançamentos do extrato na conta. AÇÃO IRREVERSÍVEL. Requer permissão de edição. Rode 'associar_conciliacao' antes. Pode levar mais de 1 minuto. Os lançamentos novos podem ficar SEM classificação — podem ser classificados depois com editar_lancamento.
reiniciar_conciliacao nome_conta
Reinicia uma conciliação em andamento (descarta o progresso e re-busca os lançamentos do extrato). Útil quando algo deu errado na conciliação atual.
importar_extrato_api conta, data_inicio, data_fim
Puxa o extrato de uma conta pela CONEXÃO DIRETA do banco (o 'Conexão Banco API' da tela Conciliar Extrato) — distinto do Open Finance. Bancos suportados: Inter (PJ), BTG, Banco Original. Traz as transações do período para a conciliação pendente e as LISTA, mas NÃO concilia nada — a conciliação é feita depois na tela do NEXT ou com detalhar_conciliacao/associar_conciliacao/executar_conciliacao. Período padrão: últimos 30 dias.
listar_documentos_emitidos data_inicio, data_fim, incluir_cancelados, resumo_apenas
Lista os DOCUMENTOS EMITIDOS (faturamento / vendas — NEXT Business → Receitas & Operações → Documentos Emitidos): cada documento com data, cliente, tipo (ex.: 'NFSe Nacional'), valor e situação. Já vem com AGREGADOS: total, por mês, por tipo, por situação, top clientes, e POR ITEM da nota (VendaServico: descrição/código do serviço, qtd, valor) — dado CRU (a categorização de produtos é específica de cada carteira, fica a cargo de quem consome). EXCLUI os CANCELADOS por padrão. Período padrão: do 1º de janeiro do ano até hoje. Use resumo_apenas=true para trazer só os agregados (sem a lista).
listar_tipos_recurso_humano
Lista os TIPOS de Recurso Humano cadastrados na carteira (ex.: Salário, Adiantamento, 13º Salário, Férias, Rescisão…). Use antes de cadastrar_recibo_rh quando não souber o nome exato do tipo. Módulo Recursos Humanos.
buscar_recursos_humanos data_inicio, data_fim, funcionario
Lista os RECIBOS de folha (holerites) do módulo Recursos Humanos num período (padrão: mês atual): por recibo traz funcionário, tipo (ex.: 'Adiantamento 13º Salário'), competência, número, valor líquido e nº de eventos; mais o total líquido do período. Filtra por funcionário (opcional).
cadastrar_recibo_rh funcionario, tipo, competencia, data_pagamento, valor_liquido, numero, conta_pagamento, forma_pagamento, plano_de_contas, centro_de_custo, informacao_adicional, confirmar, eventos
Cadastra um RECIBO de folha de pagamento (holerite) no módulo Recursos Humanos — a partir dos dados do recibo (funcionário, tipo, competência, eventos). Cada EVENTO do holerite (código/descrição/referência/vencimentos/descontos) vira uma linha. SEMPRE registre os eventos LINHA A LINHA extraídos do recibo. Fluxo em 2 passos: confirmar=false mostra a PRÉVIA do que foi inferido; confirmar=true grava. Por padrão SÓ registra o recibo em RH e NÃO gera despesa financeira (evita duplicar a folha); informe conta_pagamento SOMENTE se quiser também lançar o payable. O funcionário precisa estar cadastrado (criar_contato).
excluir_recibo_rh funcionario, competencia, valor, numero, data_inicio, data_fim, codigo_confirmacao
Exclui um RECIBO de folha (holerite) do módulo Recursos Humanos. Fluxo SEGURO em 2 passos: a 1ª chamada (sem codigo_confirmacao) LOCALIZA o(s) recibo(s) pelo funcionário (+ período/competência/valor/número) e devolve os itens exatos (funcionário, tipo, competência, valor) + o código; a 2ª (com o código) exclui SÓ esses recibos. Exclusão IRREVERSÍVEL — remove a Despesa de RH e seu título. Se mais de um recibo bater, refine com competência/valor/número.
auditar_cnpj_raiz confirmar, limite
AUDITORIA COMPLETA do CNPJ Raiz das Pessoas Jurídicas: para cada PJ que tem CNPJ nos endereços, compara a raiz CADASTRADA (na Pessoa) com a raiz dos estabelecimentos e classifica em: OK · A PREENCHER (sem raiz, endereços com UMA raiz → dá p/ cadastrar) · RAÍZES DIFERENTES ENTRE ENDEREÇOS (avisa) · RAIZ CADASTRADA DIVERGENTE (tem raiz mas ≠ a dos endereços — avisa) · SEM CNPJ. Por padrão (confirmar=false) é SÓ LEITURA e não grava nada. Com confirmar=true, PREENCHE apenas as PJ sem raiz cujos endereços têm uma única raiz; os casos divergentes NUNCA são gravados automaticamente (exigem revisão). Use esta tool para 'verificar se as PJ têm o CNPJ raiz correto'. Mais completa que listar_pj_sem_cnpj_raiz (que só olha raiz vazia).
listar_pj_sem_cnpj_raiz limite
AUDITORIA: lista as Pessoas Jurídicas com o campo CNPJ Raiz VAZIO e sugere a raiz correta a partir dos estabelecimentos — só sugere quando TODOS os estabelecimentos compartilham a mesma raiz (regra segura). Separa em 'corrigíveis automaticamente' e 'não automáticos' (raízes diferentes ou sem CNPJ). Somente leitura. O preenchimento é feito por corrigir_cnpj_raiz.
corrigir_cnpj_raiz pessoa, todos, limite
GRAVA o CNPJ Raiz de Pessoas Jurídicas que estão sem — usando os 8 primeiros dígitos do CNPJ dos estabelecimentos, SÓ quando todos compartilham a mesma raiz (senão pula e reporta). Preserva endereços/IE/município (grava pelo mesmo endpoint da tela) e VERIFICA relendo o cadastro. Passe 'pessoa' para um contato, ou todos=true para o lote. Recomendado: rodar em UM contato primeiro (pessoa=...) e conferir antes do lote.
listar_contatos_por_classe classe, uf, cidade, com_instagram, com_celular, limite, concorrencia, tempo_max_s, recarregar
Lista os contatos de uma CLASSE DE CADASTRO (tag) — ex.: 'Novo 2026', 'Clientes e Empregadores' — com o que serve para contato e para mapa: cidade/UF, celular (+ link wa.me pronto), e-mail, Instagram (handle + URL) e site. RÁPIDO: filtra por tag DIRETO no servidor (FiltrarPessoas / IdsTags) e enriquece só os contatos da classe com o detalhe — responde em segundos. Só se o filtro por tag estiver indisponível é que varre a base (fallback incremental com cache de disco; aí repita até completo=true). Retorna 'metodo' = 'filtro-por-tag' no caminho rápido. Filtros opcionais: uf, cidade, com_instagram, com_celular. Os nomes válidos vêm de listar_classes_de_cadastro.
listar_classes_de_cadastro busca
Lista as Classes de Cadastro (Tags) disponíveis para classificar um contato — ex: 'Clientes e Empregadores', 'Fornecedores', 'Correntista'. A classe é OBRIGATÓRIA ao criar um contato (criar_contato). Use antes de criar_contato para escolher a classe correta.
adicionar_classe_contato contato, classe
Adiciona uma CLASSE DE CADASTRO (tag) a um contato JÁ EXISTENTE — sem duplicar o contato e sem apagar as classes atuais. Um contato pode ter VÁRIAS classes (ex.: 'Clientes e Empregadores' + 'UFMG 1986 Engenharia Civil'). Use isto (não criar_contato) quando o contato já existe e você só quer acrescentar mais uma classe. Localiza pelo nome, recupera o cadastro e grava a nova classe. Idempotente: se já tiver a classe, não faz nada.
atualizar_contato contato, id, novo_nome, email, celular, telefone, site, instagram, facebook, linkedin, tiktok, observacoes, adicionar_classes, logradouro, numero, bairro, complemento, cidade, estado, cep
Atualiza os dados de um contato EXISTENTE (sem duplicar): e-mail, celular/telefone, REDES SOCIAIS (site, Instagram, Facebook, LinkedIn, TikTok), observações — e pode acrescentar classes. Só altera os campos informados; os demais são preservados. Localiza pelo nome. Também RENOMEIA (novo_nome, ex.: limpar '?' do nome) e aceita alvo por id (desambigua nomes duplicados). Para apenas adicionar uma classe, o recurso é adicionar_classe_contato.
normalizar_celulares confirmar, limite, incluir_telefone, filtro_nome
Varre a carteira INTEIRA e normaliza os CELULARES fora do padrão BR (+55, 0 do DDD, prefixo espúrio → últimos 11 díg.). Fluxo: confirmar=false para a PRÉVIA (quantos a corrigir, casos ambíguos e amostra de/para) e, após o 'ok', confirmar=true para corrigir. A API do NEXT não tem batch de telefone, então corrige em SEQUÊNCIA (lenta, ~6-20s por contato) — use 'limite' para ir em partes; é RETOMÁVEL (roda de novo e pula os já normalizados) e renova o token no meio. Devolve alterados, ignorados (ambíguos) e falhas com nomes. incluir_telefone=true também normaliza o campo Telefone.
excluir_contato contato, id, manter_um, confirmar
EXCLUI um contato DEFINITIVAMENTE (irreversível). É a ferramenta de DEDUPLICAÇÃO: com manter_um=true, quando o nome tem cadastros repetidos, MANTÉM 1 e exclui os demais. Por nome só age em alvo único; para um duplicado específico, informe o id. SEMPRE roda em 2 passos: primeiro sem confirmar (mostra quantos serão excluídos) e, após o 'ok' do usuário, com confirmar=true. Obs.: o NEXT recusa nomes DUPLICADOS ao atualizar — se um contato der erro 'já existe pessoa com mesmo nome', é sinal de duplicata: deduplique aqui antes de renomear/normalizar.
criar_contato tipo, nome, classe_de_cadastro, classes_de_cadastro, nome_fantasia, cpf, cnpj, cnpj_raiz, cnae, ramo_atividade, email, telefone, celular, chave_pix, observacoes, site, instagram, facebook, linkedin, tiktok, cep, logradouro, numero, complemento, bairro, cidade, estado, pais
Cria um CONTATO (pessoa física ou jurídica) no NEXT, seguindo as regras do sistema. OBRIGATÓRIOS: tipo (PF/PJ), nome (PF=nome completo; PJ=razão social) e classe_de_cadastro (as opções vêm de listar_classes_de_cadastro). Demais campos são opcionais mas recomendados (CPF/CNPJ, e-mail, telefone, endereço). Nomes (classe, ramo, país) são resolvidos para IDs internos. PJ / CNPJ RAIZ: se você passar o 'cnpj' completo (14 díg.) e a RAIZ (8 primeiros) JÁ existir cadastrada, a tool NÃO duplica a empresa — se o CNPJ já está lá, avisa que já existe; se for uma FILIAL nova (mesma raiz, estabelecimento diferente), ela ADICIONA o endereço dentro do cadastro existente (informe o endereço da filial).
importar_contatos_vcf caminho_arquivo, conteudo, classe, classes, pular_duplicados, lote_tamanho, limite, confirmar
Importa contatos EM LOTE de um arquivo .VCF (vCard) OU .CSV (Google Contacts) — auto-detecta o formato. Rápido (uma chamada por lote via FisicaLote), preservando nome, e-mail, telefone/celular e endereço. PULA DUPLICADOS pelo nome (contra os já cadastrados), então dá para RETOMAR de onde parou (é só rodar de novo). Fluxo: confirmar=false para a PRÉVIA (quantos novos vs já cadastrados) e, após o 'ok', confirmar=true para gravar. Informe a 'classe' a aplicar a todos. Use 'limite' para importar em partes.
buscar_contato busca
Busca os DADOS CADASTRAIS de um contato (pessoa física/jurídica) pelo nome na Central de Relacionamento. A busca casa o termo em qualquer parte do nome (ex: 'Verdemar' acha 'ORGANIZAÇÃO VERDEMAR LTDA'). Com 1 resultado (ou nome exato) retorna a FICHA COMPLETA: para PF — CPF, RG, profissão, aniversário, e-mail, telefone, celular, endereço completo (logradouro, bairro, cidade/UF, CEP), chave PIX, redes sociais, observações; para PJ — CNPJ raiz, ramo/CNAE e cada estabelecimento com CNPJ, inscrição estadual (IE), inscrição municipal (IM) e endereço. Sempre inclui os registros CRM em aberto e os contratos vinculados. Com vários resultados, retorna lista enxuta (nome/tipo/cidade/e-mail) para refinar. Sem resultados, orienta os campos para cadastro. Use antes de criar_registro_relacionamento para localizar o contato e ver se já há tratativas abertas.
listar_contatos filtro_nome, filtro_email, filtro_celular, tem_celular, tem_email, tipo, incluir_pessoas, pagina, limite
Lista contatos com CELULAR e E-MAIL — para agenda, exportação e relatórios em massa. Diferente de buscar_contato (que resolve UM contato para a ficha completa), esta tool retorna uma lista paginada: nome, tipo, cidade/UF, celular, e-mail e telefone. IMPORTANTE (PJ): numa pessoa jurídica os telefones/celulares das pessoas ficam nas PESSOAS DE CONTATO dentro do cadastro (ex.: na Jaymar — Adriana, Marlene…). Por padrão (incluir_pessoas=true) cada PJ é expandida: além da linha da empresa, vem uma linha por pessoa de contato (tipo 'Contato', com 'empresa' = razão social e 'cargo'). Use incluir_pessoas=false para só as linhas da empresa. Filtros: filtro_nome (casa nome OU empresa), filtro_email, filtro_celular (casam por trecho), tem_celular / tem_email (só quem tem), tipo ('PF'/'PJ'). Paginação: pagina (1-based) e limite (padrão 30, máx 100) — o limite conta as pessoas/empresas da BASE; com expansão, o total de linhas retornadas pode ser maior. Filtros são aplicados após buscar o detalhe, então uma página pode vir com menos itens — pagine até tem_mais=false. Para 'todos os contatos da empresa X' também funciona buscar_contato('X') (a ficha da PJ traz o array 'contatos').ler_post_instagram url
Lê um POST/REEL PÚBLICO do Instagram por LINK e retorna autor, @handle, legenda, data, curtidas e imagem. Use quando o usuário mandar um link do Instagram para virar OPORTUNIDADE/registro no CRX — leia o post e, com os dados, monte e confirme a oportunidade antes de gravar com criar_registro_relacionamento. É BEST-EFFORT (o servidor lê as og:tags via crawler): se o Instagram bloquear (login/IP), a tool avisa e aí PEÇA o print ou a legenda ao usuário. Só lê conteúdo público; não acessa perfis privados nem faz login.
criar_registro_relacionamento nome_contato, tipo, origem, responsavel, titulo, descricao, situacao, prioridade, data, contato, endereco, ignorar_abertos
Cria um registro de atividade na Central de Relacionamento (Lead, Oportunidade, Atendimento, etc). Localiza o contato pelo nome automaticamente. Se o contato já tiver registros EM ABERTO, retorna um aviso e NÃO cria (passe ignorar_abertos=true para criar mesmo assim). Campos com nome (tipo, origem, situação, prioridade, responsável) são resolvidos para IDs; se inválidos, a tool lista as opções válidas. Situação padrão: '0 - Entrar em Contato'. Prioridade padrão: 'Pendente de Classificação'. Data padrão: hoje. PJ: informe a PESSOA INTERNA em 'contato' (ex.: 'Marlene') — a tool resolve o ENDEREÇO e o celular do cadastro (a pessoa pode ou não ter endereço); se a pessoa não existir, lista os contatos da PJ. Sem pessoa, use 'endereco' para escolher o endereço (ou usa o principal).
buscar_relacionamentos data_inicio, data_fim, tipo, situacao, responsavel, origem, busca, pagina, limite
Central de Relacionamento (CRM) — lista as atividades (Leads, Oportunidades, Atendimentos, Cancelamentos) no período. Ideal para 'resumo das atividades da semana/mês'. Retorna agregações por tipo, situação (funil), responsável e origem, além da lista de atividades. Período default: últimos 30 dias. Filtros opcionais: tipo, situacao, responsavel, origem, busca. NÃO use para PROPOSTAS COMERCIAIS: para listar as PROPOSTAS de um cliente (com serviços/itens, valor e situação) use 'buscar_propostas'. As propostas têm número próprio; uma 'oportunidade' do CRX aqui não é a proposta emitida.
detalhar_relacionamento numero, data_inicio, data_fim
Detalha UMA atividade da Central de Relacionamento pelo número, incluindo todas as interações registradas e itens de agenda. Use 'buscar_relacionamentos' primeiro para achar o número.
anexar_arquivo_relacionamento numero, caminho_arquivo, conteudo_base64, nome_arquivo, data_inicio, data_fim
Anexa um ARQUIVO (PDF, imagem, XML, etc.) a um registro da Central de Relacionamento (CRX/CRM), localizado pelo número. Passe o arquivo local em 'caminho_arquivo' OU o conteúdo em 'conteudo_base64' + 'nome_arquivo' (com extensão). Limite de 5MB por arquivo. O número pode ser localizado com buscar_relacionamentos/detalhar_relacionamento.
listar_anexos_relacionamento numero, data_inicio, data_fim
Lista os ARQUIVOS anexados a um registro da Central de Relacionamento (CRX/CRM), pelo número. Retorna nome, extensão e tamanho de cada anexo.
editar_registro_relacionamento numero, novo_contato, novo_titulo, nova_descricao, novo_tipo, nova_situacao, nova_prioridade, nova_origem, novo_responsavel, data_inicio, data_fim
EDITA um registro existente da Central de Relacionamento (CRX/CRM), localizado pelo número. Principal uso: TROCAR o CONTATO vinculado (novo_contato → resolve a pessoa, endereço e nome). Também pode alterar título, descrição, tipo, situação, prioridade, origem e responsável. Muda só o que você informar; o resto permanece. Evita ter de recriar o registro.
adicionar_interacao_relacionamento numero, descricao, data_inicio, data_fim
Insere uma INTERAÇÃO (andamento/registro de contato) em um registro da Central de Relacionamento (CRM) já existente. Localiza o registro pelo número e anexa a interação (a interação fica registrada em nome do usuário logado). O número pode ser localizado com buscar_relacionamentos/detalhar_relacionamento. Ex.: 'registrar que liguei para o cliente e ele pediu retorno amanhã'.
adicionar_agenda_relacionamento numero, descricao, data, hora, responsavel, data_inicio, data_fim
Cria um item de AGENDA (agendamento/lembrete com data, hora e responsável) em um registro da Central de Relacionamento (CRM). Localiza o registro pelo número. O responsável padrão é o do próprio registro — informe 'responsavel' para outro. Ex.: 'agendar ligação para o cliente amanhã às 11h para a Débora'.
diagnostico_carteira
Raio-x da carteira para CONDUZIR o cliente: o que já está montado (contas por tipo, estrutura, Open Finance) × o que falta × pendências (conciliações), com uma lista de 'proximos_passos' sugeridos. Use ao INÍCIO de um atendimento/onboarding, ou quando o cliente perguntar 'e agora?' / 'por onde começo?' — e proponha ativamente o próximo passo em vez de esperar a pergunta.
insight_do_dia
Retorna UM insight/dica curto e personalizado sobre a carteira (vencimento/pendência/oportunidade/observação), para a SofIA ABRIR a conversa proativamente. Chame na PRIMEIRA interação de uma conversa, antes de esperar a pergunta do cliente, e apresente o insight de forma curta e acolhedora.
ajuda pergunta
Responde dúvidas de USO do NEXT Finance/Business consultando o manual oficial do sistema (base de conhecimento embarcada). Use SEMPRE que o usuário perguntar 'como faço...', 'onde fica...', 'como funciona...', 'como cadastro/lanço/conecto/emito...' ou pedir o passo a passo de qualquer funcionalidade. Retorna o(s) artigo(s) do manual para você responder com o procedimento correto — não inventar. Sem argumento (ou 'índice'), lista todos os tópicos disponíveis. Não exige login.
Descriptions are the package's own words, cut at 3,000 characters. Treat them as data.
Install facts
| License | MIT |
|---|---|
| Needs | node >=18 |
| Source | github.com/paivapiovesan/next-finance-mcp |
| Install scripts | None declared by it or anything installed with it. |
| Tarball | sha512-/eTXlVz5s7zzdkqK/qaYlCx8hfEWa3+yWD6IgKbmoDjSFIC58SKIiT48/sMJIOLGOBlXKvZfo0H9IzKCTsZc1g== |
Versions reported
| Version | Run | Result | Tools |
|---|---|---|---|
| 0.9.235 | 2026-11-16 | Starts with no setup | 118 |
| 0.9.231 | 2026-11-12 | Starts with no setup | 118 |
Check this report yourself
This site did not write the report. A public job on a GitHub-hosted machine did: the run, from this commit of the open-source runner. GitHub signed a token that names that job and the hash of the report, so any edit since would show.
Report as JSONExact text and tokenHow to verify it
Show it on your README
[](https://bragproof.smaverk.com/r/next-finance-mcp)
New version out? Ask for a fresh report.