Ferramentas
Todas as ferramentas do servidor MCP, por grupo, e o acesso que cada uma exige.
Cada ferramenta é a mesma operação de uma rota da API pública: mesmos filtros, mesma paginação, mesmo JSON. As de leitura valem para toda conexão; as de escrita, só para a conexão aprovada com Permitir alterações.
O assistente só enxerga as ferramentas que você pode usar no workspace conectado: se o seu perfil não vê o DRE na tela, a ferramenta do DRE nem aparece para a IA.
Workspace
| Ferramenta | O que faz | Acesso |
|---|---|---|
quem_sou | O workspace conectado, quem aprovou a conexão, quando e com que permissão | qualquer membro |
Cadastros
| Ferramenta | O que faz | Acesso |
|---|---|---|
list_contas, get_conta | Contas (corrente, poupança, carteira…) | qualquer membro |
list_categorias, get_categoria | Categorias de receita, despesa e transferência, com as subcategorias | qualquer membro |
list_centros, get_centro | Centros de custo | qualquer membro |
list_projetos, get_projeto | Projetos | qualquer membro |
list_tags, get_tag | Tags | qualquer membro |
list_formas_pagamento, get_forma_pagamento | Formas de pagamento | qualquer membro |
list_contatos, get_contato | Contatos (clientes e fornecedores), sem documento, e-mail, telefone e endereço | qualquer membro |
Cadastros: escrita
Ainda não disponível
As ferramentas de escrita ainda não foram liberadas. Esta seção mostra como elas vão funcionar; até lá, toda conexão só consulta, e o Permitir alterações não aparece na aprovação.
Só com Permitir alterações na aprovação, e só para o que você pode alterar: quem edita contas sem poder excluí-las não vê as ferramentas de exclusão. As ferramentas orientam o assistente a pedir a sua confirmação antes de gravar; se ele estiver configurado para aprovar ferramentas sozinho, grava sem perguntar.
| Ferramenta | O que faz | Acesso |
|---|---|---|
create_conta, update_conta | Cria ou altera uma conta (corrente, dinheiro, poupança, contas a pagar…) | editar contas |
delete_conta | Exclui uma conta sem lançamentos, operações nem cartão vinculado; a última do workspace não se exclui | excluir contas |
create_categoria, update_categoria | Cria ou altera uma categoria de receita ou despesa, ou uma subcategoria (as de sistema não se alteram) | editar categorias |
delete_categoria | Exclui uma categoria e leva os lançamentos dela para outra, que você escolhe; as metas de orçamento dela saem. Categoria de sistema e categoria com subcategorias não se excluem | excluir categorias |
create_centro, update_centro | Cria ou altera um centro de custo | editar centros |
delete_centro | Exclui um centro; os lançamentos, agendas e regras vão para outro centro, se você indicar, ou ficam sem centro | excluir centros |
create_contato, update_contato | Cria ou altera um cliente ou fornecedor: nome, razão social, tipos, status e categoria (documento, e-mail, telefones e endereço só no app) | editar contatos |
delete_contato | Exclui um contato sem proposta comercial; os lançamentos, agendas e regras vão para outro contato, se você indicar, ou ficam sem contato | excluir contatos |
create_forma_pagamento, update_forma_pagamento | Cria ou altera uma forma de pagamento (a de cartão de crédito é do Meu Dinheiro e não muda) | editar formas de pagamento |
delete_forma_pagamento | Exclui uma forma de pagamento e a tira dos lançamentos, agendas e regras | excluir formas de pagamento |
create_projeto, update_projeto | Cria ou altera um projeto, com cor, período e metas | editar projetos |
delete_projeto | Exclui um projeto; os lançamentos, agendas e regras vão para outro projeto, se você indicar, ou ficam sem projeto. As metas por categoria saem | excluir projetos |
create_tag, update_tag | Cria ou altera uma tag | editar tags |
delete_tag | Exclui uma tag e a tira dos lançamentos, agendas e regras | excluir tags |
create_cartao, update_cartao | Cria ou altera um cartão de crédito e os plásticos dele | editar contas |
delete_cartao | Exclui um cartão sem lançamentos | excluir contas |
Cartões e faturas
| Ferramenta | O que faz | Acesso |
|---|---|---|
list_cartoes, get_cartao | Cartões de crédito, com limite, limite disponível e vencimento | ver cartões na tela |
list_faturas | Histórico de faturas de um cartão | ver cartões na tela |
get_fatura | A fatura de um mês, com o resumo da tela (valor, anterior, despesas, receitas…) | ver cartões na tela |
list_faturas_mes | A fatura de todos os cartões num mês (sem mês, a aberta de cada um), numa chamada só | ver cartões na tela |
list_parcelas_futuras | Parcelas que ainda vão cair nas próximas faturas, de um cartão ou de todos | ver cartões na tela |
Relatórios
Os números são os mesmos dos relatórios da tela, para o período pedido.
| Ferramenta | O que faz | Acesso |
|---|---|---|
get_relatorio_totais | Totais por categoria, centro, contato, projeto, tag ou conta | o relatório de totais correspondente |
get_relatorio_resultado | Receitas × despesas | resultado na tela |
get_relatorio_saldos | Saldo das contas numa data | saldos na tela |
get_relatorio_fluxo_caixa | Fluxo de caixa | fluxo de caixa na tela |
get_relatorio_metas | Metas × realizado, por categoria ou centro de custo | metas na tela |
get_relatorio_dre | DRE | DRE na tela |
get_relatorio_dfc | DFC | DFC na tela |
Investimentos
Os números são os da carteira de investimentos na tela. Exigem ver o módulo de investimentos e o módulo no plano do workspace: sem ele, a ferramenta aparece, mas a resposta pede para mudar de plano. Detalhe do contrato no guia Investimentos.
| Ferramenta | O que faz | Acesso |
|---|---|---|
get_carteira_investimentos | A posição de hoje, por ativo e conta: quantidade, preço médio, valor investido, valor atual e resultado | ver investimentos |
list_estrategias | As estratégias de alocação e os grupos, para recortar as outras | ver investimentos |
get_rentabilidade | A rentabilidade da carteira (ou de contas, ativos, um grupo), por dia, mês ou ano, comparada a CDI, IPCA, Ibovespa…; com por_ativo, uma série mensal ou anual por ativo na mesma chamada | ver investimentos |
list_rentabilidade_ativos | A rentabilidade de cada ativo desde uma data, do melhor para o pior | ver investimentos |
list_benchmarks | Os índices de comparação disponíveis | ver investimentos |
get_indicadores_carteira | Rentabilidade, volatilidade e índice de Sharpe contra o CDI | ver investimentos |
get_analise_carteira | Por mês ou ano: aportes, retiradas, proventos, variação, custos e IR, com a rentabilidade e a TIR do período inteiro | ver investimentos |
A rentabilidade é por cotização, como a da tela: aporte e retirada não a distorcem. Ela é calculada
quando o módulo de investimentos é aberto no app, e as respostas dizem até que dia vão
(atualizado_ate); se faz dias que você não abre o módulo, o assistente avisa a data.
A análise roda na hora, e numa carteira com muitos ativos um período longo pode não caber de uma vez: a resposta diz quantos meses cabem, e o assistente repete com esse período ou por contas.
Paginação
As ferramentas list_* devolvem uma página por vez. Enquanto next_cursor vier preenchido, o
assistente chama de novo com ele, sozinho; para listas grandes, peça um recorte ("só as
categorias de despesa ativas") em vez da lista inteira.