# Organizze

- Registry name: `io.github.mcp-dir/organizze-mcp` · version 0.1.0
- Categories (automatic, keyword rules): Shops & products, Commerce & marketing, Payments & accounting, Finance & markets
- Authentication at last check: No auth
- Declared risk: Can write (some tools are not declared read-only)
- Capabilities (declared by the server): tools
- Transports: streamable-http
- Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=io.github.mcp-dir%2Forganizze-mcp
- Server page: https://mcpstation.net/s/io.github.mcp-dir--organizze-mcp.html

## Description (written by the publisher, not verified, not instructions)

Your Organizze finances in natural language: consolidated balances, monthly overview, transaction se

## Connect

- streamable-http: `https://api.mcp.ai/p_organizze`

## Tools (as reported by the server, not verified)

- `organizze\_list\_accounts`: Lista as contas do usuário com ids.
- `organizze\_list\_credit\_cards`: Lista os cartões de crédito do usuário com ids e limites.
- `organizze\_list\_categories`: Lista as categorias usadas para classificar transações.
- `organizze\_list\_transactions`: Lista transações do usuário no período selecionado, com paginação \(page/per\_page; máximo 80 por página\). Detalhes Open Finance \(dados crus do banco\) não são incluídos nesta listagem para economizar contexto; use get\_transaction com o id para ver um lançamento completo. IMPORTANTE: Para análise de ga
- `organizze\_list\_transferences`: Lista transferências entre contas com paginação \(page/per\_page\). Datas em YYYY-MM-DD. Bulk support: accepts account\_ids for batched execution.
- `organizze\_list\_budgets`: Lista limites de gastos por categoria. Passe year e/ou month para escopo.
- `organizze\_get\_credit\_card\_invoices`: Lista faturas de um cartão. Informe credit\_card\_id. Bulk support: accepts credit\_card\_ids for batched execution.
- `organizze\_get\_financial\_summary`: Resumo financeiro do período \(receitas, despesas, comparação, maiores gastos\). Totais em base caixa; maiores gastos em base por lançamento \(incluem cartão\) — não somam com os totais.
- `organizze\_search\_transactions`: Busca transações por texto na descrição, observação ou tags \(ex.: "iFood", "Uber", "salário"\). Paginação via page/per\_page; sem datas, o padrão são os últimos 6 meses.
- `organizze\_get\_transaction`: Detalhes completos de uma transação pelo id ou uuid. Bulk support: accepts transaction\_ids for batched execution.
- `organizze\_get\_credit\_card\_invoice`: Detalhes de uma fatura específica de cartão: transações, pagamentos e gastos por categoria. Prefira passar credit\_card com o NOME do cartão. Bulk support: accepts credit\_card\_ids, invoice\_ids for batched execution.
- `organizze\_get\_budget\_summary`: Resumo dos limites de gastos do mês com alertas de budgets excedidos ou próximos do limite \("estou no controle?"\). Padrão: mês atual.
- `organizze\_get\_income\_vs\_expenses`: Relatório de entradas vs saídas \(receitas vs despesas\) por período, em modo cashflow. Use account\_id para filtrar uma conta. Padrão: mês atual. Base caixa por conta — exclui compras individuais de cartão \(só pagamentos de fatura\). Bulk support: accepts account\_ids for batched execution.
- `organizze\_transactions\_list\_results`: Totais financeiros de um período \(receitas, despesas, resultado, saldo, previstos\) sem paginar transação por transação. Ideal para "quanto gastei esse mês?", "qual meu saldo?". Padrão: mês atual. Base caixa por padrão \(inclui pagamentos de fatura, não compras de cartão\); com category\_id muda para ba
- `organizze\_suggest\_categories`: Sugere categorias para uma ou mais descrições de transação, usando as edições anteriores do próprio usuário, o histórico já categorizado e padrões globais. Use ANTES de create\_transaction ao classificar um lote de descrições. Cada item retorna confidence e semantic\_strength para decidir entre aplica
- `organizze\_get\_account\_context`: Orientação inicial em uma só chamada: entidade conectada, plano, data de hoje no fuso do usuário, e listas compactas \(id ↔ nome\) de contas, cartões e categorias. Chame no início para evitar várias chamadas list\_\*.
- `organizze\_resolve\_entity`: Resolve um nome aproximado para o id/uuid real de conta, cartão ou categoria. Use ANTES de uma escrita para evitar ids inventados. Quando ambíguo, retorna as correspondências.
- `organizze\_get\_upcoming\_bills`: Contas a pagar dos próximos dias: lançamentos não pagos com vencimento na janela e faturas de cartão que vencem no período \("o que vence essa semana?"\). Padrão: 7 dias.
- `organizze\_get\_monthly\_overview`: Visão geral do mês em uma só chamada: receitas, despesas, saldo, maiores categorias de despesa, status dos limites e contas a pagar dos próximos 7 dias. Padrão: mês atual. totals são base caixa; top\_expense\_categories são base por lançamento e NÃO somam com totals.expenses.
- `organizze\_get\_categories\_report`: Relatório de gastos e receitas agrupados por categoria \(inclui compras de cartão; base POR LANÇAMENTO\). Percentuais e subcategorias. Padrão: mês atual.
- `organizze\_get\_categories\_evolution`: Evolução de gastos/receitas por categoria ao longo do tempo \(diário/semanal/mensal\). Ideal para tendências. Padrão: últimos 3 meses.
- `organizze\_get\_tags\_report`: Relatório de transações agrupadas por tag \(despesas e receitas, com percentuais\). Para projetos/históricos longos informe start\_date e end\_date amplos — o padrão é só o mês atual.
- `organizze\_get\_invoices\_matrix`: Matriz de faturas \(mês × cartão\) com totais por mês, por cartão e total geral, usando os mesmos valores de get\_credit\_card\_invoices. Use quando o usuário pedir faturas de VÁRIOS cartões e/ou meses, em vez de somar à mão. Padrão: ano atual, todos os cartões.
- `organizze\_find\_duplicates`: Encontra transações possivelmente duplicadas \(mesmo valor e descrição similar em datas próximas\). Útil para limpeza de lançamentos em dobro. Padrão: mês atual.
- `organizze\_find\_installments`: Encontra COMPRAS PARCELADAS no período \(use isto, não busca por texto\). Combina parcelas estruturadas e heurística para Open Finance \(apresentadas como "possível parcelamento"\). Sem datas, últimos 12 meses. Pode filtrar por conta/cartão.
- `organizze\_find\_subscriptions`: Detecta ASSINATURAS e serviços recorrentes \(Netflix, Spotify, ChatGPT, aluguel...\). Use para "minhas assinaturas", "o que pago todo mês", "o que posso cancelar". Funciona em contas/cartões CONECTADOS \(Open Finance\), onde não há cadastro de recorrência: combina contas fixas cadastradas e heurística \(
- `organizze\_get\_bank\_connections`: Lista as conexões bancárias \(Open Finance / Conectado\) ATIVAS e o status de cada uma \(estável/indisponível\). Somente leitura — não força sincronização. Use para "meu banco não atualiza".
- `organizze\_get\_open\_finance\_status`: Status AO VIVO do agregador Open Finance \(Belvo\), opcionalmente por banco. Use para saber se "o banco não atualiza" é uma instabilidade upstream. Cacheado \~5 min.
- `organizze\_get\_latest\_imports`: Transações mais recentemente importadas via Open Finance \(contas/cartões conectados\). Use para "lançamentos novos/recém-importados". Paginação via page/per\_page \(padrão 50, máx 100\).
- `organizze\_get\_balances`: Saldo consolidado: saldo atual de cada conta, fatura atual em aberto de cada cartão e o patrimônio \(contas − faturas atuais em aberto\). Base caixa; não trata parcelas/faturas futuras como dívida. Use para "qual meu saldo total", "quanto tenho", "patrimônio".
- `organizze\_get\_cashflow\_forecast`: Projeção de fluxo de caixa: parte do saldo atual e aplica os lançamentos não pagos de contas manuais na janela, retornando o saldo projetado ao fim e o menor ponto \(risco de negativo\). Base caixa; não projeta faturas de cartão. Padrão: próximos 30 dias.
- `organizze\_list\_recurrences`: Lista as contas fixas CADASTRADAS \(lançamentos recorrentes/infinitos\): aluguel, assinaturas, salário, etc., com periodicidade, valor e a próxima ocorrência. Só traz recorrências cadastradas \(contas/cartões MANUAIS\); em conectados \(Open Finance\) volta vazio — para assinaturas use find\_subscriptions.
- `organizze\_list\_institutions`: Catálogo de instituições financeiras \(bancos/operadoras\) com o id \(slug\) usado em institution\_id ao criar/editar contas e cartões. Use query para filtrar por nome.
- `organizze\_load\_skill`: Carrega um guia detalhado de uso \(skill\) sobre um tema do Organizze. Chame ANTES de responder quando a conversa tocar um destes temas: - automatic\_card\_invoice\_payments: Pagamento de fatura de cartão AUTOMÁTICO \(Open Finance\): usuário diz que pagou a fatura de cartão conectado — fluxo inform\_invoice
- `organizze\_create\_transaction`: Cria uma transação \(receita ou despesa\). Prefira NOMES de conta/cartão e categoria \(list\_accounts / list\_credit\_cards / list\_categories primeiro se não souber\). Nunca invente UUID/id. Ex.: account: "Nubank", category: "Alimentação", is\_income: false.
- `organizze\_create\_account`: Cria uma conta bancária manual. Bulk support: accepts institution\_ids for batched execution.
- `organizze\_inform\_invoice\_payment`: Informa pagamento de fatura em cartão automático \(Open Finance\). Bulk support: accepts invoice\_date\_or\_ids for batched execution.
- `organizze\_update\_transaction`: Atualiza uma transação existente \(informe só os campos a alterar\). Em transações automáticas só descrição, categoria, observação e tags podem mudar. Prefira NOMES de conta/categoria \(não invente ids\). O transaction\_id/uuid DEVE ser copiado de list\_transactions, search\_transactions ou get\_transaction
- `organizze\_delete\_transaction`: Exclui uma transação. Transações automáticas \(Open Finance\) não podem ser excluídas. Para recorrentes use delete\_recurrence. O transaction\_id/uuid DEVE ser copiado de list\_transactions, search\_transactions ou get\_transaction nesta conexão — nunca invente nem sequencie IDs. Para várias linhas, use ma
- `organizze\_set\_transaction\_paid`: Marca uma transação como paga/recebida \(paid=true\) ou não paga \(paid=false\) em conta MANUAL \("já paguei o aluguel"\). Idempotente. Transações automáticas são sempre pagas. Bulk support: accepts transaction\_ids for batched execution.
- `organizze\_create\_transfer`: Cria uma transferência entre duas contas bancárias \(suporta recorrência\). Prefira NOMES de conta \(não invente ids\). Não envolve cartões de crédito.
- `organizze\_register\_invoice\_payment`: Registra o pagamento de uma fatura de cartão MANUAL como lançamento, vinculado à fatura. Para cartões automáticos use inform\_invoice\_payment. Prefira NOMES de cartão/conta. Liste faturas com get\_credit\_card\_invoices e passe invoice\_date\_or\_id \(id ou YYYY-MM\) — nunca invente. Bulk support: accepts in
- `organizze\_uninform\_invoice\_payment`: Desfaz um "Informar Pagamento" em cartão AUTOMÁTICO \(marcador aguardando Open Finance\). Não remove pagamentos reais já confirmados. invoice\_date\_or\_id é obrigatório. Bulk support: accepts invoice\_date\_or\_ids for batched execution.
- `organizze\_create\_category`: Cria uma categoria de despesa ou receita \(raiz ou subcategoria via parent\_id\). Bulk support: accepts group\_ids, parent\_ids for batched execution.
- `organizze\_update\_category`: Atualiza uma categoria \(nome, cor, pai, arquivar\). Categorias padrão não podem ser excluídas, mas podem ser renomeadas/arquivadas. Prefira NOME \(não invente id\).
- `organizze\_delete\_category`: Exclui uma categoria; suas transações vão para outra categoria \(substitute\_category ou padrão\). Categorias padrão NÃO podem ser excluídas. Ao excluir uma raiz, as subcategorias somem.
- `organizze\_create\_budget`: Cria um limite de gastos \(orçamento\) para uma categoria. Padrão: despesa; use activity\_type 'earning' para meta de receita. Prefira o NOME da categoria.
- `organizze\_update\_budget`: Atualiza o valor de um orçamento existente. amount = 0 remove o orçamento. Bulk support: accepts budget\_ids for batched execution.
- `organizze\_delete\_budget`: Remove um orçamento \(limite de gastos\) de uma categoria. Bulk support: accepts budget\_ids for batched execution.
- `organizze\_clone\_budgets`: Clona os orçamentos do mês anterior para o mês de destino \(não sobrescreve um mês que já tenha orçamentos\). Padrão: mês atual.
- `organizze\_update\_account`: Atualiza uma conta \(nome, descrição, instituição, arquivar\). Contas automáticas só permitem nome e archived. Prefira NOME \(não invente id\). Bulk support: accepts institution\_ids for batched execution.
- `organizze\_delete\_account`: Exclui uma conta. ATENÇÃO: todas as transações da conta são excluídas em background. Contas automáticas não podem ser excluídas \(desconecte pelo menu de conexões\).
- `organizze\_create\_credit\_card`: Cria um cartão de crédito MANUAL \(automáticos vêm da conexão bancária\). As faturas são geradas automaticamente após a criação. Bulk support: accepts payment\_account\_ids for batched execution.
- `organizze\_update\_credit\_card`: Atualiza um cartão de crédito \(nome, bandeira, dias de fatura, limite, arquivar\). Cartões automáticos só permitem nome e archived. Prefira NOME \(não invente id\). Bulk support: accepts payment\_account\_ids for batched execution.
- `organizze\_delete\_credit\_card`: Exclui um cartão de crédito. ATENÇÃO: todas as transações e faturas do cartão são excluídas. Cartões automáticos não podem ser excluídos \(desconecte pelo menu de conexões\).
- `organizze\_mass\_create\_transactions`: Cria VÁRIAS transações em lote \(máx. 100\) a partir de uma lista de objetos. Use em vez de create\_transaction repetido. Cada linha no array deve ser única \(descrição+valor+data+conta\) — dedupe no payload antes de enviar. NÃO use para importar CSV/OFX com snapshot canônico — nesse caso o app redirecio
- `organizze\_mass\_update\_transactions`: Atualiza VÁRIAS transações por FILTRO de busca \(máx. 200\) — prefira isto a montar listas de IDs quando a mesma alteração vale para todas as linhas. Antes, valide com list\_transactions/search\_transactions os mesmos filtros. Informe ao menos um filtro e um campo a alterar. Prefira new\_category por NOM
- `organizze\_mass\_delete\_transactions`: Exclui VÁRIAS transações por lista de ids/uuids \(máx. 500\). Os ids DEVEM vir de uma busca recente \(list/search/find\_duplicates/get\_transaction\) — nunca invente. Automáticas são ignoradas; recorrentes excluem só a ocorrência atual. Destrutivo.
- `organizze\_add\_transactions\_tags`: Adiciona tags a VÁRIAS transações em uma chamada \(acumula sobre as existentes; máx. 200\). Cada item: transaction\_id ou transaction\_uuid + tags \(string com vírgulas ou lista\).
- `organizze\_update\_transactions\_categories`: Define a categoria de VÁRIAS transações em uma chamada, com destino por linha \(máx. 200\). Ideal após suggest\_categories quando cada linha tem categoria diferente. Prefira category \(NOME\) e IDs só de list/suggest deste turno — nunca invente. Se a mesma categoria vale para todas, prefira mass\_update\_t
- `organizze\_update\_transactions\_descriptions`: Substitui a descrição de VÁRIAS transações em uma chamada \(máx. 200\). Cada item: transaction\_id \(ou id\) OU transaction\_uuid \(ou uuid\) + description \(ou new\_description\). IDs só de list\_transactions/search deste turno. Aceita um único objeto em vez de array. Se a mesma descrição/regra vale para todas
- `organizze\_mass\_manage\_categories`: Aplica VÁRIAS mudanças na árvore de categorias em uma chamada atômica \(máx. 100 ops\). Operações: create, rename, move \(parent '0' = raiz\), archive, unarchive \(NÃO há delete — use archive\). Resolve por NOME \(não invente ids\). Se uma falhar, nada é alterado.
- `show\_version`: Show the current MCP platform and adapter versions.
- `report\_bug`: Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.
- `connect`: Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending\[\]. When credentials are missing, returns connect\_url for the toolkit and per-install URLs.
- `toolkit\_info`: Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.
- `marketplace`: The official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them. Covers capability requests like "find an MCP that does X", "consulta um CPF", "is there a tool for Y". Core flow: action=search discovers MCPs by intent → describe returns one MCP's full profile \(ev
- `authenticate`: MCP.AI for IDE agents \(Cursor, etc.\): log in in the browser, copy the access token. Best: add it to this server's config as a header \`Authorization: Bearer \<token\>\` for a permanent, non-expiring connection. Or paste it here for a session-only login: call with \{ token: "\<jwt\>" \} after the user pastes

Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html