Retorna as métricas do dashboard financeiro de um mês: receitas, despesas, saldo, valor projetado, comparação com o mês anterior e histórico dos últimos 6 meses. Use como primeira ferramenta para entender a situação financeira do período.

Retorna de uma vez todas as seções do dashboard de um mês: métricas, saldos das contas, status de pagamentos, distribuição de despesas por condição/forma de pagamento, quebra por categoria e despesas por pessoa. Payload maior que get_dashboard_overview; use quando precisar de uma visão completa em uma única chamada.

Lista os itens que precisam de atenção no mês: faturas abertas, contas a pagar vencidas ou próximas do vencimento, orçamentos estourados ou perto do limite e metas em risco. Retorna também unavailableSources quando alguma fonte não pôde ser lida.

Lista transações paginadas com filtros por período, texto, tipo, condição, forma de pagamento, situação, pessoa, categoria, tag, conta, cartão e faixa de valor. Retorna o total e os itens (versão compacta por padrão). Use detail: "full" quando precisar de todos os campos de um item específico.

Retorna todos os campos de uma transação: valores, rateio entre pessoas, cartão/conta, categoria, vencimento, parcelas, recorrência, reembolsos e anexos.

Lista as contas financeiras do usuário com tipo, saldo e indicação de exclusão do saldo consolidado.

Retorna os dados completos de uma conta, incluindo saldo e resumo do período.

Retorna o fluxo de caixa diário de uma conta em um mês: saldo inicial, lançamentos do dia, valor fora do mês e histórico mensal.

Lista os cartões de crédito do usuário com limite, fatura atual e status. Aceita um período opcional para alinhar a fatura ao mês.

Retorna os dados de um cartão, incluindo limite, uso e fatura corrente.

Retorna o histórico de faturas de um cartão, com totais e situação de pagamento por período.

Lista as faturas de todos os cartões em um mês: total, fechamento, vencimento, pagamentos, ajustes e rateio por pessoa. Os itens vêm em versão compacta por padrão; use detail: "full" para o objeto completo.

Lista as contas a pagar de um mês com total em aberto, quantidade de vencidas, contas de origem e itens (com rateio por pessoa, vencimento e status). Os itens vêm em versão compacta por padrão; use detail: "full" para o objeto completo.

Lista os orçamentos de um mês por categoria, com valor planejado, gasto, restante e percentual de uso.

Lista as metas financeiras com valor alvo, valor atual, restante, progresso, prazo e ritmo (adiantado, no prazo, atrasado).

Lista as categorias de receita e despesa do usuário. Use os IDs retornados em filtros e ao criar transações ou orçamentos.

Lista as tags disponíveis para classificar transações.

Lista as pessoas da instalação (administrador e pessoas externas) com papel, status e vínculo. Use os IDs em rateios e filtros.

Retorna o resumo financeiro de uma pessoa em um mês: total de despesas, histórico e distribuição por categoria.

Retorna o relatório mensal completo de uma pessoa externa em um período: linhas de despesas e reembolsos, totais e rateios — o mesmo conteúdo do PDF enviado por e-mail. O administrador não possui relatório (a API responde 400 nesse caso); para ele use get_person_summary.

Retorna a distribuição das despesas e receitas de um mês por categoria, forma de pagamento e condição, no escopo do administrador ou de todas as pessoas. mode: "forecast" inclui valores previstos.

Compara a evolução de gastos por categoria entre dois meses (inclusive). Útil para responder o que aumentou ou diminuiu no período.

Projeta os compromissos financeiros entre dois meses (inclusive): parcelas, recorrências e faturas já contratadas. Limite de até 24 meses.

Lista as despesas recorrentes ativas em um mês, com regra, frequência, valor e ocorrências.

Retorna as preferências da conta (defaults de transação, preferências do dashboard) e as configurações de segurança, em uma única chamada.

Lista as notificações acionáveis do usuário, como faturas próximas do vencimento, orçamentos excedidos e metas em risco. Retorna itens, contagem de não lidas, ativas e arquivadas.

Lista as notificações capturadas (inbox) por status, app de origem, data ou regra aplicada. Cada item traz o texto original, o nome/valor interpretado e o status.

Resumo rápido do inbox: contagens por status e os últimos itens pendentes. Útil para saber se há capturas aguardando revisão.

Lista as regras que categorizam automaticamente as notificações capturadas, com prioridade, condições e ação (categoria/pessoa).

Mostra qual categoria e pessoa as regras aplicariam a um item da caixa de entrada, sem confirmar nada.

Envia um arquivo de extrato (OFX, CSV ou XLSX) e retorna o que seria importado: conta/cartão detectado, período, transações com duplicatas e categoria sugerida. Nada é gravado. Aceita filePath (host do MCP) ou fileName + contentBase64.

Exporta as transações filtradas em CSV ou XLSX e grava o arquivo no diretório de exportação do host (padrão: ~/Downloads/openmonetis-mcp). Retorna o caminho absoluto e o número de linhas.

Baixa o modelo de planilha aceito pela importação e grava no diretório de exportação do host. Retorna o caminho do arquivo.

Lista os anexos (comprovantes, notas) vinculados a uma transação.

Gera uma URL assinada e temporária para baixar (ou visualizar) um anexo. Retorna a URL e o instante de expiração.

Lista os anexos do usuário em um mês, com filtros por texto, tipo (image/pdf) e pessoa, paginado.

Lista as séries parceladas do usuário no mês: séries abertas/concluídas, parcelas pagas e pendentes, valores e progresso. As séries vêm em versão compacta por padrão; use detail: "full" para o objeto completo.

Calcula quantidade e valor total das parcelas informadas — usado antes de antecipar para uma fatura.

Lista as conexões ativas entre o titular e outras pessoas (perspectiva de dono ou destinatário), com status e data.

Lista os convites de conexão enviados, com status (pending, claimed, confirmed, cancelled, expired) e prazos.

Resumo do que cada pessoa deve ao titular (ou tem de crédito) no período, com os acertos já registrados.

Retorna o saldo financeiro com uma pessoa no período: quanto ela deve ou tem de crédito, e os acertos registrados.

Mostra se o assistente de IA está habilitado na instalação, quais provedores estão conectados, as ferramentas permitidas e os escopos de dados compartilhados.

Lista os diagnósticos financeiros gerados por IA, com período, provedor, status e saúde financeira.

Retorna um diagnóstico completo, incluindo status, resultado, pontos de atenção e falha quando houver.

Lista as conversas com o assistente financeiro (título, período, provedor e modelo).

Retorna uma conversa com todo o histórico de mensagens.

Cria uma transação de receita, despesa, transferência, compra parcelada ou série recorrente. Transferências (type: 'transfer') só aceitam condition: 'single' e paymentMethod: 'bank_transfer' — a API do OpenMonetis não suporta transferência recorrente nem parcelada. A API valida todas as regras de domínio (categoria obrigatória em receita/despesa, cartão obrigatório no crédito, contas distintas em transferência, etc.). Sem confirm: true a ferramenta apenas devolve o payload que seria enviado.

Atualiza campos de uma transação existente. Envie apenas os campos que devem mudar — campos omitidos são preservados (inclusive condition, installmentCount e recurrenceFrequency). Sem confirm: true a ferramenta devolve o payload que seria enviado.

Exclui definitivamente uma transação. A ferramenta busca a transação antes de excluir para mostrar nome, valor e data no dry-run. Exige confirm: true para executar.

Marca ou desmarca uma ou mais transações como liquidadas, opcionalmente informando data, valor pago e conta usada. Exige confirm: true para executar.

Cria uma conta financeira. Sem confirm: true a ferramenta apenas devolve o payload que seria enviado.

Atualiza uma conta existente (nome, tipo, logo, nota, exclusão do saldo consolidado, arquivamento). Envie apenas os campos que devem mudar.

Registra o pagamento de uma fatura de cartão, com rateio por pessoa e conta de origem opcional. Exige confirm: true para executar; sem isso devolve o payload proposto.

Registra o pagamento de uma conta a pagar (lançamento recorrente) informando a conta de origem, a data e, opcionalmente, o valor pago. Exige confirm: true para executar.

Cria (ou atualiza) o orçamento de uma categoria em um mês. Exige confirm: true para executar.

Cria uma meta financeira. Use trackingType: "manual" com currentAmount, ou trackingType: "account" com accountId para acompanhar o saldo de uma conta. Exige confirm: true para executar.

Converte um item capturado em transação. Recebe os mesmos campos de create_transaction. Exige confirm: true; sem isso devolve o payload proposto.

Descarta um ou mais itens da caixa de entrada. Exige confirm: true.

Cria uma regra que categoriza automaticamente notificações capturadas. Informe ao menos categoria ou pessoa. Exige confirm: true.

Exclui uma regra do inbox. A API exige a versão atual do registro em expectedVersion. Exige confirm: true.

Grava no OpenMonetis as linhas já revisadas de uma importação de extrato. Use o sourceFingerprint e as linhas de preview_transaction_import, associando personId e categoryId a cada linha. Exige confirm: true.

Remove um lote de importação e as transações criadas por ele. Exige confirm: true.

Envia um arquivo do host (PDF ou imagem) para uma transação usando o fluxo de upload assinado: prepare → upload → confirm. Exige confirm: true.

Exclui definitivamente um anexo. Exige confirm: true.

Move parcelas futuras de uma série para uma fatura alvo, aplicando desconto opcional. Exige confirm: true.

Desfaz uma antecipação, devolvendo as parcelas ao período original. Exige confirm: true.

Cria um convite de conexão para uma pessoa externa. O retorno inclui um token de uso único que dá acesso aos dados compartilhados — trate como segredo e não registre em log. Exige confirm: true.

Cancela um convite de conexão ainda não confirmado. Exige confirm: true.

Revoga o acesso de uma pessoa conectada. Exige confirm: true (ação destrutiva).

Registra um acerto (recebimento) de uma pessoa. Exige confirm: true.

Exclui um acerto registrado. Exige confirm: true.

Enfileira um diagnóstico financeiro do período no provedor escolhido. A geração é assíncrona: consulte com get_ai_diagnosis. Requer AI_ENABLED=true. Exige confirm: true.

Cancela um diagnóstico em andamento. Exige confirm: true.

Exclui uma conversa e seu histórico. Exige confirm: true.