Organizze

Lista as contas do usuário com ids.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Lista os cartões de crédito do usuário com ids e limites.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Lista as categorias usadas para classificar transações.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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 gastos por categoria, use list_mode='all_transactions' ou informe category_id (auto-switch). O modo 'cashflow' (padrão) mostra fluxo de caixa e NÃO inclui gastos individuais do cartão de crédito. Em cashflow, faturas Open Finance já pagas (Belvo confirmou) não aparecem na lista — o caixa realizado é o lançamento na conta (special_marker invoice_payment). Faturas em aberto aparecem como CreditCardInvoice. O modo 'all_transactions' inclui TODAS as transações incluindo gastos no cartão de crédito com suas categorias. PAGINAÇÃO: Se truncated=true, há mais itens — chame de novo com page+1 ou use filtros mais estreitos. TOTAIS: o campo period_totals já traz receitas/despesas/resultado do PERÍODO COMPLETO com o filtro atual — use-o para somas; NUNCA some as linhas de uma página truncada; para agregados mais ricos (saldo, previsto) use transactions_list_results. LIMITE: Se houver muitas transações no período, use filtros (datas, conta, categoria) ou ferramentas de relatório (ex.: get_categories_report) em vez de pedir o ano inteiro sem filtro. INTERPRETAÇÃO DO STATUS PAGO/PENDENTE: Transações de contas MANUAIS (automatic=false): 'paid' reflete se o usuário marcou como paga. Se paid=false E date < data atual → transação ATRASADA. Se paid=false E date >= data atual → transação A VENCER. Transações de contas AUTOMÁTICAS/conectadas (automatic=true): 'paid' é sempre true (banco já confirmou). IGNORE o campo paid para análise de contas atrasadas/vencendo nestas transações. Faturas de cartão (type=CreditCardInvoice): podem estar genuinamente pendentes ou atrasadas mesmo em cartões automáticos. Verifique o campo 'paid' normalmente. Bulk support: accepts account_ids, credit_card_ids, category_ids for batched execution.

{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string"
    },
    "end_date": {
      "type": "string"
    },
    "account_id": {
      "type": "number"
    },
    "credit_card_id": {
      "type": "number"
    },
    "category_id": {
      "type": "number"
    },
    "order_by": {
      "type": "string"
    },
    "list_mode": {
      "type": "string"
    },
    "page": {
      "type": "number"
    },
    "per_page": {
      "type": "number"
    },
    "installments_only": {
      "type": "boolean"
    },
    "account_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "credit_card_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "category_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Lista transferências entre contas com paginação (page/per_page). Datas em YYYY-MM-DD. Bulk support: accepts account_ids for batched execution.

{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string"
    },
    "end_date": {
      "type": "string"
    },
    "account_id": {
      "type": "number"
    },
    "page": {
      "type": "number"
    },
    "per_page": {
      "type": "number"
    },
    "account_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Lista limites de gastos por categoria. Passe year e/ou month para escopo.

{
  "type": "object",
  "properties": {
    "year": {
      "type": "number"
    },
    "month": {
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Lista faturas de um cartão. Informe credit_card_id. Bulk support: accepts credit_card_ids for batched execution.

{
  "type": "object",
  "properties": {
    "credit_card_id": {
      "type": "number"
    },
    "start_date": {
      "type": "string"
    },
    "end_date": {
      "type": "string"
    },
    "credit_card_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  },
  "required": [
    "credit_card_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string"
    },
    "end_date": {
      "type": "string"
    },
    "year": {
      "type": "number"
    },
    "month": {
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "start_date": {
      "type": "string"
    },
    "end_date": {
      "type": "string"
    },
    "min_amount": {
      "type": "number"
    },
    "max_amount": {
      "type": "number"
    },
    "activity_type": {
      "type": "string"
    },
    "page": {
      "type": "number"
    },
    "per_page": {
      "type": "number"
    },
    "tags_only": {
      "type": "boolean"
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Detalhes completos de uma transação pelo id ou uuid. Bulk support: accepts transaction_ids for batched execution.

{
  "type": "object",
  "properties": {
    "transaction_id": {
      "type": "number"
    },
    "transaction_uuid": {
      "type": "string"
    },
    "transaction_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "credit_card": {
      "type": "string"
    },
    "credit_card_id": {
      "type": "number"
    },
    "invoice_id": {
      "type": "number"
    },
    "month": {
      "type": "number"
    },
    "year": {
      "type": "number"
    },
    "credit_card_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "invoice_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "month": {
      "type": "number"
    },
    "year": {
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string"
    },
    "end_date": {
      "type": "string"
    },
    "periodicity": {
      "type": "string"
    },
    "account_id": {
      "type": "number"
    },
    "account_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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 base por lançamento. Não reconcilie bases diferentes. Bulk support: accepts account_ids, category_ids for batched execution.

{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string"
    },
    "end_date": {
      "type": "string"
    },
    "account_id": {
      "type": "number"
    },
    "category_id": {
      "type": "number"
    },
    "list_mode": {
      "type": "string"
    },
    "account_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "category_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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 aplicar ou confirmar.

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "description": {
            "type": "string"
          },
          "activity_type": {
            "type": "number"
          },
          "amount_in_cents": {
            "type": "number"
          }
        },
        "required": [
          "description"
        ]
      }
    }
  },
  "required": [
    "items"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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_*.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "kind": {
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "days": {
      "type": "number"
    },
    "start_date": {
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "month": {
      "type": "number"
    },
    "year": {
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string"
    },
    "end_date": {
      "type": "string"
    },
    "lens": {
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Evolução de gastos/receitas por categoria ao longo do tempo (diário/semanal/mensal). Ideal para tendências. Padrão: últimos 3 meses.

{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string"
    },
    "end_date": {
      "type": "string"
    },
    "periodicity": {
      "type": "string"
    },
    "category_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "only_parent_category": {
      "type": "boolean"
    },
    "lens": {
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string"
    },
    "end_date": {
      "type": "string"
    },
    "tag_name": {
      "type": "string"
    },
    "tag_name_prefix": {
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string"
    },
    "end_date": {
      "type": "string"
    },
    "cards": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string"
    },
    "end_date": {
      "type": "string"
    },
    "days_threshold": {
      "type": "number"
    },
    "include_automatic": {
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string"
    },
    "end_date": {
      "type": "string"
    },
    "account": {
      "type": "string"
    },
    "min_occurrences": {
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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 (mesmo estabelecimento repetido em vários meses). Classifica por estabilidade do valor (assinatura vs recorrente variável). NÃO inclui parcelamentos (use find_installments). Sem datas, últimos 6 meses.

{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string"
    },
    "end_date": {
      "type": "string"
    },
    "account": {
      "type": "string"
    },
    "min_occurrences": {
      "type": "number"
    },
    "include_recurrences": {
      "type": "boolean"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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".

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "institution": {
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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).

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "number"
    },
    "page": {
      "type": "number"
    },
    "per_page": {
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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".

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "days": {
      "type": "number"
    },
    "start_date": {
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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. NÃO inclui parcelamentos (use find_installments).

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "limit": {
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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_payment e prazos de sincronização. - bulk_transaction_operations: Operações em lote sobre transações existentes: recategorizar, atualizar descrições/tags, duplicatas e limites das ferramentas mass_* / update_transactions_*. - category_and_budget_management: Gerenciar categorias, subcategorias e orçamentos: criar, reorganizar, arquivar, mesclar, limites de gasto e reestruturação do plano de categorias. - credit_card_invoice_queries: Consultas de fatura de cartão: vencimento, fechamento, status pago/aberto e semântica de 'pago' quando a pergunta envolve despesas não pagas com cartões. - credit_card_spending: Análise de gastos no cartão de crédito: listar/filtrar compras por cartão, categorias no cartão e comparação entre faturas. - financial_health: Diagnóstico de saúde financeira: 'está tudo ok?', onde economizar, tendências de gastos — sempre incluindo cartões na análise. - financial_summaries_and_bases: Resumos financeiros do período: quanto gastei/recebi, saldo, visão geral, previsto vs. realizado e bases corretas de cálculo. - installments_search: Encontrar compras parceladas e parcelas restantes: estratégia correta com find_installments. - invoice_payments: Pagamento de fatura de cartão MANUAL: register_invoice_payment — nunca create_transaction para pagar fatura. - latest_open_finance_imports: Importações recentes Open Finance: listar novidades e marcá-las como lidas (clear_latest_imports / remove_from_latest_imports). - open_finance_accounts: Contas e cartões conectados (Open Finance): conciliação e enriquecimento de dados sincronizados sem duplicar importação. - subscriptions_detection: Detectar assinaturas e serviços recorrentes: 'o que pago todo mês', streamings repetidos, o que cancelar. - support_and_connection_issues: Suporte e problemas de conexão Open Finance: banco não atualiza/não sincroniza e canais oficiais de ajuda. - sync_accounts_and_cards: 'Sincronizar/copiar/espelhar' transações entre contas ou cartões sem duplicar (fluxo seguro anti-duplicação). - transaction_listing_and_search: Busca e listagem de transações: períodos, tags, modos list_mode (cashflow vs all_transactions), paginação e truncamento.

{
  "type": "object",
  "properties": {
    "skill_name": {
      "type": "string",
      "enum": [
        "automatic_card_invoice_payments",
        "bulk_transaction_operations",
        "category_and_budget_management",
        "credit_card_invoice_queries",
        "credit_card_spending",
        "financial_health",
        "financial_summaries_and_bases",
        "installments_search",
        "invoice_payments",
        "latest_open_finance_imports",
        "open_finance_accounts",
        "subscriptions_detection",
        "support_and_connection_issues",
        "sync_accounts_and_cards",
        "transaction_listing_and_search"
      ]
    }
  },
  "required": [
    "skill_name"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "description": {
      "type": "string"
    },
    "amount": {
      "type": "number"
    },
    "date": {
      "type": "string"
    },
    "account": {
      "type": "string"
    },
    "category": {
      "type": "string"
    },
    "is_income": {
      "type": "boolean"
    },
    "done": {
      "type": "boolean"
    },
    "observation": {
      "type": "string"
    },
    "tags": {
      "type": "string"
    },
    "times": {
      "type": "number"
    },
    "recurring": {
      "type": "boolean"
    },
    "periodicity": {
      "type": "string"
    },
    "idempotency_key": {
      "type": "string"
    }
  },
  "required": [
    "description",
    "amount",
    "date",
    "account",
    "is_income"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Cria uma conta bancária manual. Bulk support: accepts institution_ids for batched execution.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "institution_id": {
      "type": "string"
    },
    "initial_balance": {
      "type": "number"
    },
    "description": {
      "type": "string"
    },
    "institution_ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "name"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Informa pagamento de fatura em cartão automático (Open Finance). Bulk support: accepts invoice_date_or_ids for batched execution.

{
  "type": "object",
  "properties": {
    "credit_card": {
      "type": "string"
    },
    "invoice_date_or_id": {
      "type": "string"
    },
    "date": {
      "type": "string"
    },
    "observation": {
      "type": "string"
    },
    "invoice_date_or_ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "credit_card"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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 nesta conexão — nunca invente nem sequencie IDs. Para várias linhas, use mass_update_transactions com filtros. Bulk support: accepts transaction_ids for batched execution.

{
  "type": "object",
  "properties": {
    "transaction_id": {
      "type": "number"
    },
    "transaction_uuid": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "amount": {
      "type": "number"
    },
    "date": {
      "type": "string"
    },
    "category": {
      "type": "string"
    },
    "account": {
      "type": "string"
    },
    "paid": {
      "type": "boolean"
    },
    "observation": {
      "type": "string"
    },
    "tags": {
      "type": "string"
    },
    "update_recurrence": {
      "type": "string"
    },
    "transaction_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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 mass_delete_transactions com filtros. Bulk support: accepts transaction_ids for batched execution.

{
  "type": "object",
  "properties": {
    "transaction_id": {
      "type": "number"
    },
    "transaction_uuid": {
      "type": "string"
    },
    "delete_recurrence": {
      "type": "string"
    },
    "transaction_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "paid": {
      "type": "boolean"
    },
    "transaction_id": {
      "type": "number"
    },
    "transaction_uuid": {
      "type": "string"
    },
    "transaction_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  },
  "required": [
    "paid"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "amount": {
      "type": "number"
    },
    "date": {
      "type": "string"
    },
    "credit_account": {
      "type": "string"
    },
    "debit_account": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "done": {
      "type": "boolean"
    },
    "observation": {
      "type": "string"
    },
    "tags": {
      "type": "string"
    },
    "recurring": {
      "type": "boolean"
    },
    "periodicity": {
      "type": "string"
    }
  },
  "required": [
    "amount",
    "date",
    "credit_account",
    "debit_account"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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 invoice_date_or_ids for batched execution.

{
  "type": "object",
  "properties": {
    "credit_card": {
      "type": "string"
    },
    "source_account": {
      "type": "string"
    },
    "amount": {
      "type": "number"
    },
    "date": {
      "type": "string"
    },
    "invoice_date_or_id": {
      "type": "string"
    },
    "observation": {
      "type": "string"
    },
    "invoice_date_or_ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "credit_card",
    "amount",
    "date"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "credit_card": {
      "type": "string"
    },
    "invoice_date_or_id": {
      "type": "string"
    },
    "invoice_date_or_ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "credit_card",
    "invoice_date_or_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Cria uma categoria de despesa ou receita (raiz ou subcategoria via parent_id). Bulk support: accepts group_ids, parent_ids for batched execution.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "kind": {
      "type": "string"
    },
    "group_id": {
      "type": "string"
    },
    "color": {
      "type": "string"
    },
    "parent_id": {
      "type": "number"
    },
    "group_ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "parent_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  },
  "required": [
    "name",
    "kind"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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).

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "color": {
      "type": "string"
    },
    "parent": {
      "type": "string"
    },
    "archived": {
      "type": "boolean"
    }
  },
  "required": [
    "category"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string"
    },
    "substitute_category": {
      "type": "string"
    }
  },
  "required": [
    "category"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string"
    },
    "amount": {
      "type": "number"
    },
    "activity_type": {
      "type": "string"
    },
    "month": {
      "type": "number"
    },
    "year": {
      "type": "number"
    }
  },
  "required": [
    "category",
    "amount"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Atualiza o valor de um orçamento existente. amount = 0 remove o orçamento. Bulk support: accepts budget_ids for batched execution.

{
  "type": "object",
  "properties": {
    "budget_id": {
      "type": "number"
    },
    "amount": {
      "type": "number"
    },
    "budget_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  },
  "required": [
    "budget_id",
    "amount"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Remove um orçamento (limite de gastos) de uma categoria. Bulk support: accepts budget_ids for batched execution.

{
  "type": "object",
  "properties": {
    "budget_id": {
      "type": "number"
    },
    "budget_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  },
  "required": [
    "budget_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "month": {
      "type": "number"
    },
    "year": {
      "type": "number"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "account": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "institution_id": {
      "type": "string"
    },
    "archived": {
      "type": "boolean"
    },
    "hide_balance": {
      "type": "boolean"
    },
    "institution_ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "account"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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).

{
  "type": "object",
  "properties": {
    "account": {
      "type": "string"
    }
  },
  "required": [
    "account"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "billing_due_day": {
      "type": "number"
    },
    "billing_cycle_day": {
      "type": "number"
    },
    "flag": {
      "type": "string"
    },
    "limit": {
      "type": "number"
    },
    "payment_account_id": {
      "type": "number"
    },
    "payment_account_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  },
  "required": [
    "name",
    "billing_due_day",
    "billing_cycle_day"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "credit_card": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "flag": {
      "type": "string"
    },
    "billing_due_day": {
      "type": "number"
    },
    "billing_cycle_day": {
      "type": "number"
    },
    "limit": {
      "type": "number"
    },
    "payment_account_id": {
      "type": "number"
    },
    "archived": {
      "type": "boolean"
    },
    "payment_account_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  },
  "required": [
    "credit_card"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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).

{
  "type": "object",
  "properties": {
    "credit_card": {
      "type": "string"
    }
  },
  "required": [
    "credit_card"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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 redireciona para plan_tabular_import/apply_tabular_import (error_code redirect_to_tabular); no MCP, peça ao usuário importar pelo app ou envie linhas sem fingerprint de anexo. Prefira NOMES de conta/categoria. Executa em uma chamada (sem confirmação interativa no MCP).

{
  "type": "object",
  "properties": {
    "transactions": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "description": {
            "type": "string"
          },
          "amount": {
            "type": "number"
          },
          "date": {
            "type": "string"
          },
          "account": {
            "type": "string"
          },
          "is_income": {
            "type": "boolean"
          },
          "category": {
            "type": "string"
          },
          "done": {
            "type": "boolean"
          },
          "observation": {
            "type": "string"
          },
          "tags": {
            "type": "string"
          },
          "times": {
            "type": "number"
          },
          "recurring": {
            "type": "boolean"
          },
          "periodicity": {
            "type": "string"
          }
        },
        "required": [
          "description",
          "amount",
          "date",
          "account",
          "is_income"
        ]
      }
    },
    "idempotency_key": {
      "type": "string"
    }
  },
  "required": [
    "transactions"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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 NOME. Conjunto vazio ou >200 devolve validation (refine filtros). Para mapa linha-a-linha use update_transactions_categories / descriptions. Irreversível em lote. Bulk support: accepts category_ids, account_ids, credit_card_ids for batched execution.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "start_date": {
      "type": "string"
    },
    "end_date": {
      "type": "string"
    },
    "category_id": {
      "type": "number"
    },
    "account_id": {
      "type": "number"
    },
    "credit_card_id": {
      "type": "number"
    },
    "activity_type": {
      "type": "string"
    },
    "tag_filter": {
      "type": "string"
    },
    "paid_filter": {
      "type": "boolean"
    },
    "new_category": {
      "type": "string"
    },
    "new_description": {
      "type": "string"
    },
    "description_find": {
      "type": "string"
    },
    "description_replace": {
      "type": "string"
    },
    "new_observation": {
      "type": "string"
    },
    "new_tags": {
      "type": "string"
    },
    "tag_action": {
      "type": "string"
    },
    "new_paid": {
      "type": "boolean"
    },
    "category_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "account_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "credit_card_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "transactions": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "transaction_id": {
            "type": "number"
          },
          "transaction_uuid": {
            "type": "string"
          }
        }
      }
    }
  },
  "required": [
    "transactions"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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).

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "transaction_id": {
            "type": "number"
          },
          "transaction_uuid": {
            "type": "string"
          },
          "tags": {
            "type": "string"
          }
        }
      }
    }
  },
  "required": [
    "items"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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_transactions com filtro.

{
  "type": "object",
  "properties": {
    "updates": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "transaction_id": {
            "type": "number"
          },
          "transaction_uuid": {
            "type": "string"
          },
          "category_id": {
            "type": "number"
          },
          "category": {
            "type": "string"
          }
        }
      }
    }
  },
  "required": [
    "updates"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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, prefira mass_update_transactions.

{
  "type": "object",
  "properties": {
    "updates": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "transaction_id": {
            "type": "number"
          },
          "transaction_uuid": {
            "type": "string"
          },
          "id": {
            "type": "number"
          },
          "uuid": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "new_description": {
            "type": "string"
          }
        }
      }
    }
  },
  "required": [
    "updates"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {
    "operations": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "op": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "kind": {
            "type": "string"
          },
          "group_id": {
            "type": "string"
          },
          "color": {
            "type": "string"
          },
          "category": {
            "type": "string"
          },
          "parent": {
            "type": "string"
          }
        },
        "required": [
          "op"
        ]
      }
    }
  },
  "required": [
    "operations"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Show the current MCP platform and adapter versions.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.

{
  "type": "object",
  "properties": {
    "message": {
      "type": "string"
    },
    "context": {
      "default": "",
      "type": "string"
    },
    "conversation": {
      "default": "[]",
      "type": "string"
    }
  },
  "required": [
    "message"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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 (every tool with its id + params, pricing, auth) so you pick the right tool_id → invoke RUNS that tool. KEY: invoke works even when the MCP is NOT installed — it runs the tool pontualmente (one-off), without adding the MCP to the toolkit and without bloating the tool list. If the MCP needs a credential/login, invoke returns a connect link; if it is paid and the wallet is empty, invoke returns a checkout/top-up link (the user opens it, then you retry). Use install only to make an MCP PERMANENT in the active toolkit (its tools then show up natively in future sessions); prefer invoke for a single/occasional use. list_tools lists what is callable right now. subscribe/cancel handle per-MCP billing; report_bug sends feedback; request_mcp asks us to build a NEW MCP when nothing fits. Search/describe flag installed_in_toolkit vs installed_in_workspace. Writes (install/uninstall/subscribe/cancel and the one-off install behind invoke) require workspace owner/admin. It also carries the mcp.ai PROMPT LIBRARY, which is about ready-made prompt TEXT rather than MCPs: search_prompts finds one, get_prompt returns its full text with {{variables}} filled, and publish_prompt saves a prompt and returns a shareable mcp.ai/p/<slug> link that opens without login.

{
  "type": "object",
  "properties": {
    "action": {
      "default": "search",
      "type": "string",
      "enum": [
        "search",
        "describe",
        "install",
        "uninstall",
        "subscribe",
        "cancel",
        "resume",
        "report_bug",
        "request_mcp",
        "list_tools",
        "invoke",
        "search_prompts",
        "get_prompt",
        "publish_prompt"
      ]
    },
    "query": {
      "default": "",
      "type": "string"
    },
    "mcp_id": {
      "default": "",
      "type": "string"
    },
    "limit": {
      "default": 10,
      "type": "number"
    },
    "tier_slug": {
      "default": "",
      "type": "string"
    },
    "immediate": {
      "default": false,
      "type": "boolean"
    },
    "cancel_reason": {
      "type": "string",
      "enum": [
        "too_expensive",
        "missing_features",
        "switched_service",
        "unused",
        "customer_service",
        "too_complex",
        "low_quality",
        "other"
      ]
    },
    "cancel_comment": {
      "default": "",
      "type": "string"
    },
    "message": {
      "default": "",
      "type": "string"
    },
    "report_context": {
      "default": "",
      "type": "string"
    },
    "conversation": {
      "default": "[]",
      "type": "string"
    },
    "request_name": {
      "default": "",
      "type": "string"
    },
    "request_details": {
      "default": "",
      "type": "string"
    },
    "tool_id": {
      "default": "",
      "type": "string"
    },
    "arguments": {
      "default": "{}",
      "type": "string"
    },
    "prompt_slug": {
      "default": "",
      "type": "string"
    },
    "prompt_vars": {
      "default": "{}",
      "type": "string"
    },
    "prompt_category": {
      "default": "",
      "type": "string"
    },
    "prompt_tool": {
      "default": "",
      "type": "string"
    },
    "prompt_title": {
      "default": "",
      "type": "string"
    },
    "prompt_description": {
      "default": "",
      "type": "string"
    },
    "prompt_body": {
      "default": "",
      "type": "string"
    },
    "prompt_targets": {
      "default": [],
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "claude",
          "chatgpt",
          "cursor",
          "lovable"
        ]
      }
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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, or with no args to get the link.

{
  "type": "object",
  "properties": {
    "token": {
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}