{"report":{"v":1,"package":"next-finance-mcp","version":"0.9.235","ranAt":"2026-11-16T11:35:43.061Z","install":{"ok":true,"bin":"next-finance-mcp","integrity":"sha512-/eTXlVz5s7zzdkqK/qaYlCx8hfEWa3+yWD6IgKbmoDjSFIC58SKIiT48/sMJIOLGOBlXKvZfo0H9IzKCTsZc1g==","deps":143,"scripts":[],"bins":["next-finance-mcp","next-finance-mcp-server"],"license":"MIT","engines":"node >=18","repository":"https://github.com/paivapiovesan/next-finance-mcp"},"start":{"ok":true,"ms":258,"serverName":"SofIA","serverVersion":"0.9.235","protocol":"2025-06-18","stderr":"[11:35:54.710] NEXT Finance MCP server v0.9.235 iniciado. Timeout upstream: 15000ms\n"},"tools":[{"name":"versao","description":"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).","params":[]},{"name":"login","description":"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.","params":[]},{"name":"logout","description":"Encerra a sessão e remove os dados de sessão salvos.","params":[]},{"name":"listar_carteiras","description":"Lista todas as carteiras disponíveis para o usuário logado.","params":[]},{"name":"criar_carteira","description":"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.","params":["nome","email","telefone","tipo_pessoa","cpf","cnpj","estrangeiro","produto","onde_conheceu","aceitar_termos"]},{"name":"selecionar_carteira","description":"Seleciona uma carteira pelo nome (necessário antes de listar contas e lançamentos). Os nomes disponíveis vêm de listar_carteiras.","params":["nome_carteira"]},{"name":"listar_contas","description":"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.","params":["busca","moeda","portfolio","tipo_conta","pagina","limite"]},{"name":"listar_contas_correntes","description":"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).","params":["busca","incluir_saldo"]},{"name":"criar_conta","description":"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.","params":["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"]},{"name":"editar_conta","description":"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.","params":["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"]},{"name":"renomear_conta","description":"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.","params":["nome","novo_nome","moeda"]},{"name":"reparar_planos_transferencia","description":"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.","params":["codigo_confirmacao","remapear_de","remapear_para_conta","reclassificar_de"]},{"name":"listar_tipos_conta","description":"Lista os tipos de conta disponíveis (corrente, poupança, cartão, investimento etc.).","params":[]},{"name":"consultar_rentabilidade","description":"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).","params":["data_inicial","data_final","tipo_conta","indicador","incluir_contribuicao"]},{"name":"simular_parcelamento","description":"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).","params":["valor","numero_prestacoes","prestacao","taxa_juros_mensal","primeira_prestacao_avista","comparar_indicadores"]},{"name":"analisar_ativos_bolsa","description":"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.","params":["tipo_conta","codigo","data_inicial","data_final","ordenar_por","indicador","incluir_zerados","rapido"]},{"name":"analisar_renda_fixa","description":"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.","params":["tipo","agrupar_por","data_inicial","data_final","indicador","incluir_encerrados"]},{"name":"consultar_cota_fundo","description":"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.","params":["cnpj","conta","moeda","data","quantidade"]},{"name":"registrar_come_cotas","description":"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.","params":["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"]},{"name":"analisar_centros_de_custo","description":"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).","params":["filtro","centros_de_custo","data_inicial","data_final","portfolio","incluir_planos"]},{"name":"fluxo_de_caixa","description":"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.","params":["dias","data_inicial","data_final","tipo","contas","incluir_cartoes","usar_padrao"]},{"name":"listar_centros_de_custo","description":"Lista os centros de custo da carteira. Use para descobrir nomes exatos antes de filtrar lançamentos por centro de custo.","params":["busca"]},{"name":"listar_plano_de_contas","description":"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.","params":["busca","tipo","pagina","limite"]},{"name":"criar_centro_de_custo","description":"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'.","params":["nome","pai","descricao"]},{"name":"criar_plano_de_contas","description":"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.","params":["nome","pai","descricao"]},{"name":"buscar_lancamentos","description":"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.","params":["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"]},{"name":"buscar_contas_a_pagar","description":"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.","params":["data_inicio","data_fim","busca","moeda","apenas_vencidos","pagina","limite"]},{"name":"buscar_contas_a_receber","description":"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.","params":["data_inicio","data_fim","busca","moeda","apenas_vencidos","apenas_cobranca","incluir_cobranca","pagina","limite"]},{"name":"baixar_a_receber","description":"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.","params":["cliente","vencimento","valor","moeda","conta_destino","data","documento","valor_parcial","previsao_restante","retirar_previsao","codigo_confirmacao"]},{"name":"baixar_a_pagar","description":"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.","params":["fornecedor","vencimento","valor","moeda","conta_destino","data","documento","valor_parcial","previsao_restante","retirar_previsao","codigo_confirmacao"]},{"name":"enviar_para_cobranca","description":"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.","params":["cliente","vencimento","valor","moeda","conta_cobranca","retirar_previsao","codigo_confirmacao"]},{"name":"enviar_email_cobranca","description":"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.","params":["cliente","vencimento","valor","moeda","conta_cobranca","codigo_confirmacao"]},{"name":"listar_inadimplentes","description":"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.","params":["moeda","min_dias","incluir_contato","limite"]},{"name":"substituir_previsao_por_boleto","description":"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.","params":["linha_digitavel","fornecedor","conta","moeda","competencia","valor","vencimento","confirmar"]},{"name":"buscar_despesas_periodicas","description":"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).","params":["busca","moeda"]},{"name":"buscar_receitas_periodicas","description":"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).","params":["busca","moeda"]},{"name":"conferir_previsto_realizado","description":"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.","params":["tipo","mes","moeda"]},{"name":"listar_clientes","description":"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.","params":["busca","moeda","pagina","limite"]},{"name":"criar_lancamento","description":"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.","params":["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"]},{"name":"criar_transferencia","description":"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.","params":["conta_origem","conta_destino","valor","data","descricao","observacoes","codigo_confirmacao"]},{"name":"editar_lancamento","description":"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).","params":["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"]},{"name":"editar_lancamentos_em_lote","description":"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.","params":["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"]},{"name":"excluir_lancamento","description":"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.","params":["nome_conta","data","data_final","valor","descricao","numero_documento","moeda","excluir_parcelas","codigo_confirmacao"]},{"name":"anexar_arquivo_lancamento","description":"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.","params":["nome_conta","data","valor","descricao","numero_documento","moeda","caminho_arquivo","conteudo_base64","url_arquivo","nome_arquivo"]},{"name":"listar_anexos_lancamento","description":"Lista os arquivos anexados a um lançamento (nome, extensão, tamanho, URL). Localiza pelo trio (nome_conta + data + valor/descrição).","params":["nome_conta","data","valor","descricao","numero_documento","moeda"]},{"name":"remover_anexo_lancamento","description":"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.","params":["nome_conta","data","valor","descricao","numero_documento","moeda","nomes_arquivo"]},{"name":"listar_documentos_recebidos","description":"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.","params":["apenas_nao_importadas","apenas_recorrentes"]},{"name":"importar_documento_recebido","description":"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.","params":["caminho_arquivo","diretorio","conteudo_base64","nome_arquivo","conta_pagamento","parcelas","primeiro_vencimento","plano_de_contas","centro_de_custo","periodicidade","forma_pagamento"]},{"name":"cadastrar_documento_recebido","description":"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.","params":["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"]},{"name":"classificar_documento_recebido","description":"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.","params":["numero","fornecedor","data_inicio","data_fim","conta_pagamento","parcelas","primeiro_vencimento","plano_de_contas","centro_de_custo","periodicidade","forma_pagamento"]},{"name":"editar_documento_recebido","description":"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').","params":["numero","fornecedor","data_inicio","data_fim","itens"]},{"name":"importar_nfce_html","description":"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.","params":["html","conta_pagamento","plano_de_contas","centro_de_custo","confirmar"]},{"name":"importar_nfce_por_url","description":"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.","params":["url"]},{"name":"adicionar_filial_fornecedor","description":"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).","params":["fornecedor","cnpj","ie","logradouro","numero","bairro","cidade","uf","cep"]},{"name":"listar_contratos","description":"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.","params":["pessoa","pagina","limite"]},{"name":"detalhar_contrato","description":"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).","params":["numero","pessoa"]},{"name":"calcular_reajuste","description":"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).","params":["numero","pessoa","indice","meses"]},{"name":"reajustar_contrato","description":"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').","params":["numero","pessoa","indice","meses","parcelas","responsavel"]},{"name":"gerar_faturamento_contrato","description":"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.","params":["numero","pessoa"]},{"name":"criar_contrato","description":"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).","params":["cliente","produto","valor_parcela","periodicidade","prazo_meses","data_inicio","data_primeira_parcela","indice_reajuste","tipo_contrato","conta_recebimento","responsavel","observacao","numero_pedido","confirmar"]},{"name":"listar_modelos_proposta","description":"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.","params":[]},{"name":"buscar_propostas","description":"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).","params":["produto","cliente","situacao","data_inicio","data_fim","dias","limite"]},{"name":"criar_proposta","description":"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).","params":["cliente","tipo","servicos","modelo","email","data","responsavel","confirmar"]},{"name":"listar_moedas","description":"Lista as moedas disponíveis no NEXT Finance (ex: BRL, USD, EUR). Use 'busca' para filtrar por nome, sigla ou símbolo.","params":["busca"]},{"name":"permissao_conta","description":"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.","params":["nome_conta"]},{"name":"consultar_saldo","description":"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).","params":["nome_conta","data"]},{"name":"saldo_carteira","description":"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).","params":["data"]},{"name":"ultimo_preco_produto","description":"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).","params":["busca","nome_fornecedor","data_inicio","data_fim","agrupar_por_fornecedor","limite"]},{"name":"resumo_categoria","description":"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.","params":["plano_de_contas","data_inicio","data_fim","apenas_despesas","apenas_receitas"]},{"name":"resumo_centro_de_custo","description":"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.","params":["centro_de_custo","data_inicio","data_fim"]},{"name":"listar_contas_open_finance","description":"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.","params":[]},{"name":"verificar_open_finance","description":"Verifica se uma conta específica tem vínculo Open Finance configurado e se exige MFA. Usa dados de cadastro (offline).","params":["nome_conta"]},{"name":"atualizar_open_finance","description":"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).","params":["nome_conta"]},{"name":"iniciar_open_finance_qr","description":"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'.","params":["nome_conta"]},{"name":"conectar_open_finance","description":"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.","params":["nome_conta"]},{"name":"listar_contas_do_item_open_finance","description":"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.","params":["nome_conta"]},{"name":"associar_conta_open_finance","description":"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.","params":["nome_conta","conta_open_finance"]},{"name":"desassociar_conta_open_finance","description":"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'.","params":["nome_conta"]},{"name":"obter_extrato_open_finance","description":"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'.","params":["nome_conta","data_inicio","data_fim"]},{"name":"buscar_despesas","description":"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.","params":["data_inicio","data_fim","nome_fornecedor","busca","com_itens","pagina","limite"]},{"name":"buscar_itens_despesa","description":"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).","params":["busca","nome_fornecedor","data_inicio","data_fim","pagina","limite"]},{"name":"buscar_compras_produto","description":"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.","params":["busca","pessoa_id","data_inicio","data_fim","pagina","limite"]},{"name":"listar_conciliacoes","description":"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.","params":[]},{"name":"detalhar_conciliacao","description":"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.","params":["nome_conta"]},{"name":"associar_conciliacao","description":"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').","params":["nome_conta"]},{"name":"executar_conciliacao","description":"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.","params":["nome_conta"]},{"name":"reiniciar_conciliacao","description":"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.","params":["nome_conta"]},{"name":"importar_extrato_api","description":"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.","params":["conta","data_inicio","data_fim"]},{"name":"listar_documentos_emitidos","description":"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).","params":["data_inicio","data_fim","incluir_cancelados","resumo_apenas"]},{"name":"listar_tipos_recurso_humano","description":"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.","params":[]},{"name":"buscar_recursos_humanos","description":"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).","params":["data_inicio","data_fim","funcionario"]},{"name":"cadastrar_recibo_rh","description":"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).","params":["funcionario","tipo","competencia","data_pagamento","valor_liquido","numero","conta_pagamento","forma_pagamento","plano_de_contas","centro_de_custo","informacao_adicional","confirmar","eventos"]},{"name":"excluir_recibo_rh","description":"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.","params":["funcionario","competencia","valor","numero","data_inicio","data_fim","codigo_confirmacao"]},{"name":"auditar_cnpj_raiz","description":"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).","params":["confirmar","limite"]},{"name":"listar_pj_sem_cnpj_raiz","description":"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.","params":["limite"]},{"name":"corrigir_cnpj_raiz","description":"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.","params":["pessoa","todos","limite"]},{"name":"listar_contatos_por_classe","description":"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.","params":["classe","uf","cidade","com_instagram","com_celular","limite","concorrencia","tempo_max_s","recarregar"]},{"name":"listar_classes_de_cadastro","description":"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.","params":["busca"]},{"name":"adicionar_classe_contato","description":"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.","params":["contato","classe"]},{"name":"atualizar_contato","description":"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.","params":["contato","id","novo_nome","email","celular","telefone","site","instagram","facebook","linkedin","tiktok","observacoes","adicionar_classes","logradouro","numero","bairro","complemento","cidade","estado","cep"]},{"name":"normalizar_celulares","description":"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.","params":["confirmar","limite","incluir_telefone","filtro_nome"]},{"name":"excluir_contato","description":"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.","params":["contato","id","manter_um","confirmar"]},{"name":"criar_contato","description":"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).","params":["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"]},{"name":"importar_contatos_vcf","description":"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.","params":["caminho_arquivo","conteudo","classe","classes","pular_duplicados","lote_tamanho","limite","confirmar"]},{"name":"buscar_contato","description":"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.","params":["busca"]},{"name":"listar_contatos","description":"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').","params":["filtro_nome","filtro_email","filtro_celular","tem_celular","tem_email","tipo","incluir_pessoas","pagina","limite"]},{"name":"ler_post_instagram","description":"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.","params":["url"]},{"name":"criar_registro_relacionamento","description":"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).","params":["nome_contato","tipo","origem","responsavel","titulo","descricao","situacao","prioridade","data","contato","endereco","ignorar_abertos"]},{"name":"buscar_relacionamentos","description":"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.","params":["data_inicio","data_fim","tipo","situacao","responsavel","origem","busca","pagina","limite"]},{"name":"detalhar_relacionamento","description":"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.","params":["numero","data_inicio","data_fim"]},{"name":"anexar_arquivo_relacionamento","description":"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.","params":["numero","caminho_arquivo","conteudo_base64","nome_arquivo","data_inicio","data_fim"]},{"name":"listar_anexos_relacionamento","description":"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.","params":["numero","data_inicio","data_fim"]},{"name":"editar_registro_relacionamento","description":"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.","params":["numero","novo_contato","novo_titulo","nova_descricao","novo_tipo","nova_situacao","nova_prioridade","nova_origem","novo_responsavel","data_inicio","data_fim"]},{"name":"adicionar_interacao_relacionamento","description":"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ã'.","params":["numero","descricao","data_inicio","data_fim"]},{"name":"adicionar_agenda_relacionamento","description":"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'.","params":["numero","descricao","data","hora","responsavel","data_inicio","data_fim"]},{"name":"diagnostico_carteira","description":"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.","params":[]},{"name":"insight_do_dia","description":"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.","params":[]},{"name":"ajuda","description":"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.","params":["pergunta"]}],"toolsHash":"97135646c764e20ac034dbc9c1b61bc9ca3da309f4b0457d15422546b41a4549","wrote":[],"host":{"commit":"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c","run":"https://github.com/itsHaddad/bragproof/actions/runs/43857070216"},"network":{"names":["registry.npmjs.org"],"conns":[]}},"summary":{"outcome":"started","needs":[],"contacts":[],"flags":[],"tools":118,"wrote":0,"callsTried":0,"callsAnswered":0,"callContacts":[]},"history":[{"package":"next-finance-mcp","version":"0.9.235","ranAt":"2026-11-16T11:35:43.061Z","outcome":"started","tools":118,"contacts":0,"flags":0,"serious":0,"toolsHash":"97135646c764e20ac034dbc9c1b61bc9ca3da309f4b0457d15422546b41a4549"},{"package":"next-finance-mcp","version":"0.9.231","ranAt":"2026-11-12T17:53:39.557Z","outcome":"started","tools":118,"contacts":0,"flags":0,"serious":0,"toolsHash":"97135646c764e20ac034dbc9c1b61bc9ca3da309f4b0457d15422546b41a4549"}],"page":"https://bragproof.smaverk.com/r/next-finance-mcp"}