{"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\":[]}}","token":"eyJhbGciOiJSUzI1NiIsImtpZCI6IjM4ODI2YjE3LTZhMzAtNWY5Yi1iMTY5LThiZWI4MjAyZjcyMyIsInR5cCI6IkpXVCIsIng1dCI6InlrTmFZNHFNX3RhNGsyVGdaT0NFWUxrY1lsQSJ9.eyJhY3RvciI6Iml0c0hhZGRhZCIsImFjdG9yX2lkIjoiMTE0NzMyNjEiLCJhdWQiOiJicmFncHJvb2YtcmVwb3J0OmNlMDJiNDQ3YjI2ZTdkZWNiZjIyM2FjZGViZDIwMmFlNmQyZjZlZWYxMGM4MWQ5OGM1NTQyMGZiNDc2NWRhYTQiLCJiYXNlX3JlZiI6IiIsImNoZWNrX3J1bl9pZCI6IjEzMzI2Mzk5NTM3MyIsImV2ZW50X25hbWUiOiJzY2hlZHVsZSIsImV4cCI6MTc5NDgyOTI2MiwiaGVhZF9yZWYiOiIiLCJpYXQiOjE3OTQ4Mjg5NjIsImlzcyI6Imh0dHBzOi8vdG9rZW4uYWN0aW9ucy5naXRodWJ1c2VyY29udGVudC5jb20iLCJqb2Jfd29ya2Zsb3dfcmVmIjoiaXRzSGFkZGFkL2JyYWdwcm9vZi8uZ2l0aHViL3dvcmtmbG93cy9yZXBvcnQueW1sQHJlZnMvaGVhZHMvbWFpbiIsImpvYl93b3JrZmxvd19zaGEiOiJlYWFmZmZmYWY1MjI1NWQxYjc3ZGM0YWFjZmZkZmFmMzUzZjBjMTJjIiwianRpIjoiZjAyNWJhNGYtZWYwNC00NzY3LTg5YzYtNTE0MWIxZWI3YjIxIiwibmJmIjoxNzk0ODI4NjYyLCJyZWYiOiJyZWZzL2hlYWRzL21haW4iLCJyZWZfcHJvdGVjdGVkIjoiZmFsc2UiLCJyZWZfdHlwZSI6ImJyYW5jaCIsInJlcG9zaXRvcnkiOiJpdHNIYWRkYWQvYnJhZ3Byb29mIiwicmVwb3NpdG9yeV9pZCI6IjE0NTQ2MjExODMiLCJyZXBvc2l0b3J5X293bmVyIjoiaXRzSGFkZGFkIiwicmVwb3NpdG9yeV9vd25lcl9pZCI6IjExNDczMjYxIiwicmVwb3NpdG9yeV92aXNpYmlsaXR5IjoicHVibGljIiwicnVuX2F0dGVtcHQiOiIxIiwicnVuX2lkIjoiNDM4NTcwNzAyMTYiLCJydW5fbnVtYmVyIjoiMjQiLCJydW5uZXJfZW52aXJvbm1lbnQiOiJnaXRodWItaG9zdGVkIiwic2hhIjoiZWFhZmZmZmFmNTIyNTVkMWI3N2RjNGFhY2ZmZGZhZjM1M2YwYzEyYyIsInN1YiI6InJlcG86aXRzSGFkZGFkQDExNDczMjYxL2JyYWdwcm9vZkAxNDU0NjIxMTgzOnJlZjpyZWZzL2hlYWRzL21haW4iLCJ3b3JrZmxvdyI6InJlcG9ydCIsIndvcmtmbG93X3JlZiI6Iml0c0hhZGRhZC9icmFncHJvb2YvLmdpdGh1Yi93b3JrZmxvd3MvcmVwb3J0LnltbEByZWZzL2hlYWRzL21haW4iLCJ3b3JrZmxvd19zaGEiOiJlYWFmZmZmYWY1MjI1NWQxYjc3ZGM0YWFjZmZkZmFmMzUzZjBjMTJjIn0.ovPufpBYbXVdGU7A00fqEdL22d33oI3MJtKPmHWf4kdQ6X7Ai7RKJDOrEY7Ym8gSIgkMeClrgYdLENmNYwy-13P1Ioa-lBSPuU6ofN4lwLzllW-jWzvV1LI_UDTabSGp0ITNLFz9E0O-D1fek5vKlJRrWszlUooo9b3RR3G1ZyfAvGvNYUpR05R_h8cdEji7GqJx3_R2Hu3g2p3_GHG-qs9rT6R9Ccczor_I7DdhqUjBnmqFsJz9-70UeUVgN11PBpKHT2qXecVMslIc1h9z8G4k-Z2IyzsCtQ5cb3EQARGPBuHukebhm_myinrIJyUUiFY2cB_zJTl_ZJj5nOQL9A"}