Monay

Exclui em uma única operação atômica pelo menos duas transações avulsas já localizadas, após o usuário confirmar a lista e o alcance. Informe todos os transaction_ids correspondentes aos lançamentos pedidos. A tool valida tenant, espaços visíveis e permissão antes de excluir; se um ID não existir, não for acessível, representar recorrência ou transferência, ou qualquer exclusão falhar, nenhum registro é alterado e a resposta será um erro. Use as tools específicas para recorrências, ocorrências e transferências. A exclusão altera saldos e projeções. Use IDs internos apenas na chamada; responda sem expor UUIDs.

delete-transactions-tool

Exclui o registro de uma transferência interna e os lançamentos vinculados após o usuário confirmar as contas e o valor. A exclusão altera saldos e projeções, mas não movimenta dinheiro entre bancos. Use IDs internos apenas na chamada; responda sem expor UUIDs.

delete-transfer-tool

Mostra as faturas dos cartões em uma interface interativa, com vencimentos e detalhes de compras e recorrências previstas. Use quando a pessoa quiser explorar visualmente suas faturas; para apoio interno ao raciocínio, use a consulta de faturas.

show-card-statements-tool

Mostra um ranking interativo dos gastos por categoria e permite consultar os lançamentos que compõem cada valor. Use quando uma comparação visual dos gastos ajudar; para apoio interno ao raciocínio, use a consulta de gastos por categoria.

show-expenses-by-category-tool

Lista contas financeiras com saldo, finalidade e participação no caixa disponível. Use para selecionar uma conta ou analisar saldos por conta. Não use para responder a posição financeira geral; nesse caso, consulte a posição financeira atual. Por padrão, omite contas de reserva de meta.

get-accounts-tool

Lista o contexto durável que o Monay lembra sobre o usuário autenticado. Use quando a pessoa perguntar o que está salvo ou quiser revisar uma memória.

get-agent-memories-tool

Consulta faturas de cartão, seus valores, vencimentos e status. Use sem statement_id para listar faturas e com statement_id para detalhar uma fatura específica, incluindo transações e recorrências projetadas. Não use como busca geral de lançamentos fora de uma fatura. O padrão consulta o mês atual, e um resultado vazio nesse recorte não prova que o cartão ou a cobrança não existe.

get-card-statements-tool

Lista cartões com limite, fatura atual, valores em aberto e quantidade de transações. Use para identificar um cartão antes de consultar suas faturas ou movimentos. Não use como extrato detalhado da fatura. Em current_statement, expected_total é o total esperado, materialized_total é o valor já registrado e projected_recurrence_amount representa recorrências ainda projetadas.

get-cards-tool

Projeta o saldo dia a dia a partir de hoje, nos próximos 30, 60 ou 90 dias, com base no saldo atual das contas, lançamentos pendentes, recorrências e faturas de cartão. Use para perguntas como "vou ficar no negativo nos próximos 30 dias?", "em que dia o saldo fica negativo?" ou "qual o menor saldo até tal data?". A janela é contada em dias a partir de hoje; para o fechamento do mês corrente, use get-current-financial-position-tool. Responde com o saldo inicial, o menor saldo e sua data, o primeiro dia negativo, os valores atrasados considerados hoje e os dias com movimentação. Transferências futuras entre contas não entram na projeção.

get-cashflow-projection-tool

Lista categorias disponíveis para selecionar ou validar a classificação de transações. Use antes de criar ou alterar um lançamento quando a categoria correta ainda não estiver resolvida. Não use para consultar gastos, rankings ou transações.

get-categories-tool

Avalia se o saldo atual e as entradas previstas cobrem os compromissos do período. Use para perguntas sobre saldo, capacidade de pagar contas e fechamento financeiro. O padrão responde pelo mês atual; escolha financial_outlook somente quando a pessoa pedir explicitamente vários meses ou uma análise de médio prazo.

get-current-financial-position-tool

Mostra as dívidas em aberto e os parcelamentos de fatura: quanto falta pagar, parcela mensal, juros estimados, próxima parcela e a data prevista para ficar sem dívidas. Use para perguntas como "quanto eu devo?", "qual dívida custa mais caro?" ou "quando fico livre das dívidas?".

get-debts-tool

Consulta os lançamentos que compõem uma categoria do ranking, incluindo compras de cartão e recorrências previstas quando aplicável. Não altera dados.

get-expense-category-details-tool

Agrupa despesas por categoria e retorna um ranking com total, quantidade de lançamentos, participação e limite mensal. Use para entender onde a pessoa mais gasta ou comparar categorias em um período. Não use para tendência entre períodos nem para listar lançamentos individuais. O padrão é a visão consolidada do mês atual; apenas status=pending filtra para pendentes. status=paid é aceito por compatibilidade, mas não significa somente pagos.

get-expenses-by-category-tool

Lista as metas financeiras com valor-alvo, quanto já foi guardado, quanto falta, percentual de progresso e data-alvo. Use para perguntas como "como estão minhas metas?" ou "quanto falta para a viagem?". Por padrão traz só metas ativas e pausadas.

get-goals-tool

Lista os espaços financeiros disponíveis, indicando qual é o padrão e se cada espaço está ativo. Use para escolher ou confirmar o espaço antes de outra consulta. Não use quando o pedido já identifica claramente o espaço ou quando o espaço padrão é suficiente.

get-spaces-tool

Mostra as assinaturas e serviços recorrentes do mês (streaming, apps, academia e similares): valor de cada uma, onde é cobrada, data, total do mês, próxima cobrança e a evolução do gasto nos últimos três meses. Também aponta cobranças que parecem assinatura, mas ainda não foram cadastradas como recorrência. Use para perguntas como "quanto gasto com assinaturas?" ou "qual a próxima assinatura a cobrar?".

get-subscriptions-tool

Lista as etiquetas que a pessoa usa para marcar transações, com a quantidade de transações em cada uma. Use para descobrir o identificador de uma etiqueta antes de filtrar transações por ela em get-transactions-tool.

get-tags-tool

Primeiro passo para criar qualquer lançamento avulso em conta ou cartão: retorna sugestões de descrição, categoria, conta ou cartão com base no histórico, como o formulário de transações do Monay, e também as categorias, contas e cartões disponíveis em options, na mesma ordem do formulário, com o espaço de cada conta e cartão. Com esse resultado já dá para criar o lançamento; não consulte categorias, contas ou cartões à parte. Quando category_rule vier preenchido, a descrição bate com uma palavra-chave que o usuário cadastrou na categoria: prefira essa categoria às sugestões do histórico. Não use como prova de que um lançamento existe ou foi pago; para isso consulte transações ou faturas.

get-transaction-description-suggestions-tool

Retorna um feed compacto de movimentos financeiros para consultas de extrato, últimas despesas, últimas receitas, busca por descrição e manutenção de transações. Inclui receitas, despesas, transferências e ocorrências de recorrência do período. Transações de cartão só aparecem quando card_id é informado ou include_cards é true; para procurar gastos de uma descrição ou estabelecimento em contas e cartões juntos, use include_cards=true em vez de consultar cartão por cartão. Para o total de despesas de uma categoria ou de todas as categorias no período, use get-expenses-by-category-tool, que já soma contas e cartões, em vez de somar este feed. Quando truncated for true, a lista pode estar incompleta: refaça a consulta com limit maior ou período menor antes de somar. Para saber se um comprovante ou pagamento já foi registrado, busque pelo valor (amount_cents) com status all, sem depender do nome do recebedor, com start_date no primeiro dia do mês anterior ao pagamento e end_date no último dia do mês seguinte ao pagamento: a descrição guardada é o que o usuário digitou e o vencimento raramente coincide com o dia do pagamento. Não use um resultado vazio com filtros estreitos como prova de ausência. Itens com is_projected=true ainda não são transações reais: para marcar uma delas como paga, use mark-entry-paid-tool; para materializar ou editar, use a tool de atualização de ocorrência de recorrência, sempre com o recurrence_id e a data exibidos.

get-transactions-tool

Lista as contas a pagar e os recebimentos previstos em conta, de hoje até os próximos dias, incluindo lançamentos atrasados e ocorrências previstas de recorrências. Use para perguntas como "o que vence esta semana?" ou "quais contas estão atrasadas?". Faturas de cartão não entram nesta lista; consulte get-card-statements-tool para elas.

get-upcoming-dues-tool

Abre o Monay com a posição financeira do mês atual, sem alterar os dados da conta conectada.

open-monay-tool

Registra no Monay o pagamento de uma fatura de cartão: marca a fatura e as compras dela como pagas e debita o valor na conta de pagamento. Use quando o usuário disser que pagou a fatura ou enviar o comprovante desse pagamento. Obtenha card_id e statement_id em get-card-statements-tool; quando a fatura do mês ainda não fechou, confira também a fatura vencida do mês anterior. Não movimenta dinheiro no banco. Responda sem expor UUIDs.

pay-card-statement-tool

Apresenta uma visão visual da posição financeira, com saldo atual, compromissos, projeção e nível de risco. Use quando o pedido da pessoa for especificamente sobre sua posição financeira e a comparação visual ajudar; para consultas usadas apenas como apoio de raciocínio, use a ferramenta de consulta de posição financeira.

show-financial-position-tool

Salva ou substitui uma memória durável para conversas futuras somente quando o usuário pedir ou confirmar. Use para preferências de análise, objetivos duráveis, restrições pessoais ou contexto estável que não pode ser consultado nas ferramentas financeiras. Pode sobrescrever uma memória existente. Nunca salve saldos, faturas, transações, valores momentâneos, estados operacionais ou resultados de simulações.

remember-user-context-tool

Compara a projeção atual com hipóteses de novas receitas, novas despesas ou mudanças de valor, sem alterar dados reais. Use para perguntas hipotéticas como comprar, parcelar, receber, reduzir ou substituir um valor. Não use para excluir faturas ou categorias já existentes da projeção; nesse caso, use a simulação de fluxo de caixa.

simulate-budget-hypotheses-tool

Compara a projeção atual com um cenário que exclui faturas ou categorias já existentes, sem alterar dados reais. Use somente quando a pessoa pedir explicitamente para ignorar, adiar, não pagar ou retirar esses compromissos da projeção. Não use para consultar a posição financeira normal nem para adicionar novos valores hipotéticos.

simulate-cashflow-scenario-tool

Atualiza um lançamento em conta já localizado. Envie todos os campos editáveis, inclusive os que não mudaram, para comparar séries corretamente, exceto date e paid_at, que devem ser omitidos quando não mudarem; recurrence e convert_to_recurrence não fazem parte desses campos. Para transformar o lançamento avulso em recorrência ou parcelamento, somente a pedido explícito do usuário, envie convert_to_recurrence=true com recurrence; sem essa flag, recurrence é ignorado. Se já pertencer a uma recorrência, use installment_count e scope para alterar o parcelamento. Não infira um escopo de série sem pedido explícito. Use IDs internos apenas na chamada; responda sem expor UUIDs.

update-account-transaction-tool

Atualiza uma compra no cartão já localizada. Envie todos os campos editáveis, inclusive os que não mudaram, para comparar séries corretamente, exceto date e paid_at, que devem ser omitidos quando não mudarem; recurrence e convert_to_recurrence não fazem parte desses campos. Compras ficam pendentes e são pagas pela fatura; esta tool não cobra o cartão. Para transformar a compra avulsa em recorrência ou parcelamento, somente a pedido explícito do usuário, envie convert_to_recurrence=true com recurrence; sem essa flag, recurrence é ignorado. Se já pertencer a uma recorrência, use installment_count e scope para alterar o parcelamento. Não infira um escopo de série sem pedido explícito. Responda sem expor UUIDs.

update-card-transaction-tool

Materializa ou atualiza uma ocorrência de recorrência ou parcelamento já localizada. Se ainda for projeção (is_projected=true), use this_occurrence para criar o lançamento real. Com this_and_future ou all, uma ocorrência projetada continua projetada. Envie só os campos que mudam e omita os demais, que herdam da recorrência. Para só registrar que a ocorrência foi paga ou recebida, use mark-entry-paid-tool. Não infira escopo de série sem pedido explícito. Responda sem expor UUIDs.

update-recurrence-occurrence-tool

Atualiza o registro de uma transferência entre contas do Monay já localizada. Envie todos os campos editáveis, inclusive os que não mudaram, exceto date, que deve ser omitida quando não mudar; recurrence e convert_to_recurrence não fazem parte desses campos. Para transformar a transferência avulsa em recorrência, somente a pedido explícito do usuário, envie convert_to_recurrence=true com recurrence; sem essa flag, recurrence é ignorado. Não movimenta dinheiro entre bancos. Use IDs internos apenas na chamada; responda sem expor UUIDs.

update-transfer-tool