MCP App Store
by KeenEthics
Granatum Financeiro icon

Granatum Financeiro MCP Server for ChatGPT

By Granatum

Overview

O Granatum Financeiro conecta o ChatGPT à conta Granatum Empresarial do usuário para consultar relatórios financeiros, investigar lançamentos, registrar movimentos e entender a situação de caixa em linguagem natural. O app permite analisar DRE por período, acompanhar Fluxo de Caixa, abrir drill-down de lançamentos por categoria, consultar o plano de contas, as contas bancárias, os centros de custo, as formas de pagamento e o cadastro de pessoas, e selecionar empresas quando a conta tiver múltiplas empresas. Com autorização adicional concedida pelo usuário, também permite criar, editar e excluir lançamentos. * A edição e exclusão cobrem lançamentos simples; séries, lançamentos compostos e transferências seguem pela interface do Granatum.

How to connect

  1. ChatGPT: Open the Granatum Financeiro listing in the ChatGPT app directory and choose Connect. ChatGPT listing Granatum Financeiro exposes 28 tools here.

Tools

anexar_arquivo

ChatGPT
Anexa um arquivo (nota fiscal, boleto, comprovante) a um lançamento do cliente, em DUAS chamadas. O arquivo NUNCA vai como argumento nem volta em resposta: ele vai direto ao armazenamento, por um comando de envio que a tool entrega pronto. Requer autorização de escrita (lancamentos:write) e altera dados reais; o perfil Somente relatórios não anexa, e o perfil Lançamentos por usuário só anexa em lançamento que criou. (1) PEDIR O ENVIO: informe lancamento_id, nome_arquivo (com a extensão) e tamanho_bytes (de 1 byte a 5 MB (5242880 bytes)). Nada é anexado ainda: a tool devolve status 'envio_pendente' com envio_id, url, campos, valido_ate (o envio vale 10 minutos) e exemplo_de_comando, um curl com os campos reais. (2) ENVIAR: se você consegue executar comandos (shell com acesso à rede, como no Claude Code ou em agentes com terminal), execute o exemplo_de_comando por conta própria, trocando <caminho do arquivo> pelo caminho real do arquivo; o esperado é HTTP 204. (3) CONFIRMAR: chame de novo com lancamento_id e envio_id (sem nome_arquivo nem tamanho_bytes). A tool confere que o arquivo chegou, registra o anexo e devolve status 'anexado' com o anexo criado. O envio_id vale 1 hora e uma confirmação só. SEM SHELL OU SEM REDE (comum em apps de conversa): se você não consegue executar o comando, NÃO insista, NÃO tente outro caminho e NÃO afirme que anexou: nada foi anexado até a confirmação devolver 'anexado'. Explique ao usuário e oriente-o a anexar o arquivo pela tela do lançamento no Granatum. Se a confirmação voltar com codigo 'arquivo_nao_enviado' (o arquivo não chegou, o link venceu ou o envio já foi confirmado), peça UM envio novo (chamada sem envio_id) e envie de novo; se falhar outra vez, oriente o usuário a anexar pela interface. SÉRIE: se o lançamento é de série e escopo_serie não vem na confirmação, a tool NÃO anexa e devolve status 'escopo_necessario' com a posição e o tamanho da série; pergunte ao usuário e chame de novo (o arquivo já enviado e o envio_id continuam valendo). 'so_este' anexa só a esse lançamento; 'este_e_proximos' põe o mesmo arquivo, sem enviá-lo de novo, nesse lançamento e nos seguintes da série, e a resposta diz em quantos lançamentos o anexo entrou (lancamentos_alcancados); esta escolha grava de uma vez, sem prévia, então não a faça por conta própria. url, campos e envio_id são credenciais temporárias: não os mostre ao usuário nem os repita.

anexar_arquivo_direto

ChatGPT
Anexa a um lançamento do cliente um arquivo que o USUÁRIO ANEXOU NESTA CONVERSA do ChatGPT (nota fiscal, boleto, comprovante). O ChatGPT entrega o arquivo no argumento arquivo (download_url e file_id) e o Granatum o baixa sozinho: você não envia bytes nem roda comando. Requer autorização de escrita (lancamentos:write) e altera dados reais; o perfil Somente relatórios não anexa, e o perfil Lançamentos por usuário só anexa em lançamento que criou. SÓ para arquivo que o usuário anexou nesta conversa: não invente nem reaproveite link, e file_id é identificador do ChatGPT, nunca um id de anexo do Granatum. (1) Com arquivo: o arquivo é baixado e anexado na mesma chamada e a tool devolve status 'anexado' com o anexo criado (lancamentos_alcancados diz em quantos lançamentos ele entrou). Repetir a chamada com o mesmo arquivo não duplica o anexo: devolve o que já foi criado (repetido: true). NADA é anexado sem a resposta: só afirme que anexou quando a resposta trouxer status 'anexado'; qualquer erro quer dizer que NADA foi anexado. SÉRIE: se o lançamento é de série e escopo_serie não vem, a tool não baixa nem anexa e devolve status 'escopo_necessario' com a posição e o tamanho da série; pergunte ao usuário e chame de novo com os mesmos argumentos mais escopo_serie. 'so_este' anexa só a esse lançamento. 'este_e_proximos' põe o mesmo arquivo nesse lançamento e nos seguintes da série e NÃO anexa na primeira vez: baixa o arquivo e devolve status 'confirmacao_necessaria' com a quantidade de lançamentos que receberiam o anexo (quantidade_a_anexar), quais são (lancamentos_afetados) e um envio_id. Apresente isso ao usuário e pergunte explicitamente se deve prosseguir; só confirme APÓS o sim explícito dele — nunca autoconfirme. (2) CONFIRMAR a prévia: chame de novo com lancamento_id, envio_id, escopo_serie e confirmado: true, SEM o argumento arquivo: o arquivo já foi baixado e a confirmação não depende do link do ChatGPT (o envio_id vale 1 hora; confirmar de novo com o mesmo envio_id não duplica o anexo e devolve o que já foi criado). Se o arquivo não chegar (argumento ausente, ou texto como "chat_upload" no app de celular), a tool recusa sem baixar nada: peça ao usuário para anexar o arquivo de novo pelo ChatGPT na web. Arquivo maior que 5 MB (5242880 bytes) não pode ser anexado. envio_id é credencial temporária: não o mostre ao usuário. Para ler um anexo depois use obter_anexo com o id do anexo.

anexar_arquivo_por_url

ChatGPT
Anexa a um lançamento do cliente um arquivo que está num LINK HTTPS (nota fiscal, boleto, comprovante): por exemplo o link de download que o usuário passou, ou que você obteve numa ferramenta já autorizada (Basecamp, Drive...). O Granatum baixa o arquivo sozinho: você não envia bytes nem roda comando. Em DUAS chamadas. Requer autorização de escrita (lancamentos:write) e altera dados reais; o perfil Somente relatórios não anexa, e o perfil Lançamentos por usuário só anexa em lançamento que criou. Essas conferências, a do lançamento e a do nome vêm ANTES de baixar. O LINK precisa ser HTTPS público ou assinado e baixar o arquivo com um GET simples: sem login, cookie, token ou cabeçalho. Link que abre uma página (login, visualização) não serve e é recusado se devolver HTML no lugar do arquivo; só use um link que o usuário deu ou que você obteve em contexto autorizado, nunca invente nem troque o link. Se não houver link de download, oriente o usuário a anexar pela tela do lançamento no Granatum. Para o arquivo que o usuário anexou na conversa do ChatGPT use anexar_arquivo_direto, não esta tool. (1) IMPORTAR: informe lancamento_id, url e nome_arquivo (com a extensão, como deve aparecer no lançamento). Nada é anexado ainda: a tool baixa o arquivo (até 5 MB (5242880 bytes)) e devolve status 'envio_pendente' com envio_id, nome_arquivo, tamanho_bytes e a validade (1 hora). Não há comando a executar. (2) CONFIRMAR: chame de novo com lancamento_id e envio_id (sem url nem nome_arquivo). A tool registra o anexo e devolve status 'anexado' com o anexo criado; o arquivo não é baixado outra vez. O envio_id vale 1 hora e uma confirmação só. NADA é anexado até a confirmação devolver 'anexado': só afirme que anexou quando a resposta trouxer esse status; qualquer erro quer dizer que NADA foi anexado. NÃO é idempotente por link: dois pedidos iguais criam dois envios pendentes, e confirmar os dois anexaria o arquivo duas vezes. Não repita o pedido por conta própria depois de um erro ou de uma resposta perdida: confira antes com obter_lancamentos (campos_adicionais: ["anexos"]). SÉRIE: se o lançamento é de série e escopo_serie não vem na confirmação, a tool NÃO anexa e devolve status 'escopo_necessario' com a posição e o tamanho da série; pergunte ao usuário e chame de novo com lancamento_id, envio_id e escopo_serie. 'so_este' anexa só a esse lançamento; 'este_e_proximos' põe o mesmo arquivo nesse lançamento e nos seguintes da série e NÃO anexa na primeira vez: devolve status 'confirmacao_necessaria' com a quantidade de lançamentos que receberiam o anexo (quantidade_a_anexar) e quais são (lancamentos_afetados). Apresente isso ao usuário e pergunte explicitamente se deve prosseguir; só reenvie, com os mesmos argumentos mais confirmado: true, APÓS resposta humana explícita — nunca autoconfirme. Com 'so_este' não há confirmação. url e envio_id são credenciais temporárias: não os mostre ao usuário nem os repita. Para ler um anexo depois use obter_anexo com o id do anexo.

atualizar_lancamento

ChatGPT
Atualiza um lançamento avulso existente nos livros do cliente. Requer autorização de escrita (lancamentos:write). Chama a API do Granatum em nome do usuário autenticado e altera dados reais. Antes de chamar, confirme com o usuário o lançamento e os campos que serão alterados. Opera somente em lançamento simples; séries, lançamentos compostos e transferências devem ser editados pela interface do Granatum.

buscar_pessoas

ChatGPT
Busca clientes e fornecedores da empresa autenticada por nome, nome fantasia ou documento. Cliente e fornecedor são atributos da mesma pessoa — uma pessoa pode ser ambos. Use para descobrir o pessoa_id ao criar um lançamento. O valor 0 representa 'sem pessoa vinculada'.

conciliar

ChatGPT
Concilia (em lote, de 1 a 100 pares) movimentos do extrato bancário com lançamentos: cada par {movimento_id, lancamento_id} liga o movimento ao lançamento e, quando preciso, baixa o lançamento. Requer autorização de escrita (lancamentos:write). Altera dados reais do cliente e só vale para os perfis Administrador e Lançamentos. Um par vale quando o movimento está pendente (sem vínculo e não ignorado) e o lançamento está sem vínculo, em aberto ou já pago, com o mesmo sinal e o valor exato ao centavo, de qualquer conta; não precisa ter sido sugerido por obter_conciliacoes_pendentes. O que cada par faz no lançamento: se já está pago no mesmo dia e na mesma conta do movimento, só liga (o lançamento não muda); se está em aberto, dá baixa com a data do movimento e a conta do extrato; se já está pago em outra data ou conta, a data do pagamento e a conta passam a ser as do movimento. O movimento importado por CSV não se concilia pelo MCP (fica para a tela do Granatum): o par é recusado. Quando o lançamento muda, vale o caixa fechado: com a data antiga ou a nova até a data de bloqueio de caixa da empresa o par é recusado. CONFIRMAÇÃO: sem confirmado: true a chamada NÃO grava: devolve status 'confirmacao_necessaria' com a quantidade e o que cada par faria (acao: vincular, baixar, mudar_data_do_pagamento, mudar_conta, mudar_data_do_pagamento_e_conta). Na ação baixar de um lançamento de outra conta (conta_antes_id diferente de conta_depois_id), diga ao usuário que a baixa leva o lançamento para a conta do extrato. Fluxo: leia com obter_conciliacoes_pendentes, conte as confiáveis ao usuário (isso só informa); o pedido dele para conciliar autoriza só a prévia (conciliar sem confirmado); mostre a prévia, termine a resposta ali perguntando "concilio estes N?" e só confirme depois do sim dele à prévia; nunca concilie um movimento revisar ou bloqueado sem antes mostrar o movimento, o motivo e o(s) candidato(s) e o usuário escolher o lançamento; só depois da escolha chame a prévia. Nunca mande parâmetro opcional vazio ou zero: omita. Mostre isso ao usuário e só reenvie, com os mesmos pares mais confirmado: true, numa resposta seguinte a uma mensagem nova do usuário que veio DEPOIS da prévia e a aceita; um "pode", "sim" ou "confirma" dito antes da prévia não vale; nunca chame conciliar duas vezes na mesma resposta; nunca autoconfirme. A confirmação confere cada par de novo na hora de gravar. LOTE: todo par do pedido é alvo. Se algum estiver impedido (caixa fechado, movimento ou lançamento já conciliado, par que deixou de valer, id de outra empresa ou inexistente), o pedido INTEIRO é recusado, nada é gravado, e a resposta lista cada par impedido com o motivo (status erro, codigo alvos_impedidos, impedidos). Isso acontece quando algo mudou entre a leitura e o sim. Diga ao usuário "N mudaram desde a consulta: motivos; concilio as outras M?" e, se ele aceitar, refaça sem os impedidos, mostrando a prévia nova antes de confirmar. Não faz (fica na tela do Granatum): valor diferente, vários lançamentos para um movimento, criar lançamento a partir do movimento, ignorar movimento e voltar a data de bloqueio. Perfis sem acesso à conciliação (só Administrador e Lançamentos a usam) recebem a recusa "Seu perfil nesta empresa não dá acesso à conciliação": não insista.

criar_categoria

ChatGPT
Cria uma categoria do plano de contas na empresa, para usar o id como categoria_id em criar_lancamento. Requer autorização de escrita (lancamentos:write). ANTES de chamar, confira listar_categorias: o Granatum aceita a mesma descrição repetida e duplicaria o cadastro. Sem parent_id a categoria nasce na raiz e o tipo é obrigatório; com parent_id ela é filha, herda o tipo e a cor do pai (o tipo informado é ignorado) e o pai passa a não aceitar lançamento. Se o pai já tem lançamentos diretos, sem migrar_para_nova nem migracao_id nada é criado e a resposta traz a quantidade (status recusado): pergunte ao usuário para onde movê-los. Com o destino, a primeira chamada NÃO grava: devolve a prévia (confirmacao_necessaria, com quantos lançamentos seriam movidos e os impedidos) e só cria e move com confirmado: true, depois que o usuário disser sim. A resposta traz a categoria criada no formato de listar_categorias.

criar_centro_custo_lucro

ChatGPT
Cria um centro de custo/lucro na empresa, para usar o id como centro_custo_lucro_id em criar_lancamento. Requer autorização de escrita (lancamentos:write). ANTES de chamar, confira listar_centros_custo_lucro: o Granatum aceita a mesma descrição repetida e duplicaria o cadastro. Com parent_id o centro é filho dele (o pai continua aceitando lançamento). A resposta traz o centro criado no formato de listar_centros_custo_lucro.

criar_forma_pagamento

ChatGPT
Cria uma forma de pagamento na empresa, para usar o id como forma_pagamento_id em criar_lancamento. Requer autorização de escrita (lancamentos:write). ANTES de chamar, confira listar_formas_pagamento: o Granatum aceita a mesma descrição repetida e duplicaria o cadastro. A resposta traz a forma criada no formato de listar_formas_pagamento.

criar_lancamento

ChatGPT
Cria um lançamento avulso (receita ou despesa) nos livros do cliente. Requer autorização de escrita (lancamentos:write). Chama a API do Granatum em nome do usuário autenticado — é uma escrita real, não simulação. Antes de chamar, confirme com o usuário os dados do lançamento. Se a resposta trouxer status 'confirmacao_necessaria', apresente os lancamentos_existentes ao usuário e pergunte explicitamente se deve criar mesmo assim; só reenvie com confirmar_duplicata: true após resposta humana explícita — nunca autoconfirme.

criar_pessoa

ChatGPT
Cadastra um cliente ou um fornecedor nos livros do cliente, para usar o id dele em criar_lancamento (pessoa_id). Requer autorização de escrita (lancamentos:write). Chama a API do Granatum em nome do usuário autenticado e altera dados reais. ANTES de chamar, use SEMPRE buscar_pessoas (por nome): se a pessoa já existe, use o id dela e NÃO cadastre de novo. O Granatum ACEITA o mesmo nome repetido e duplicaria o cadastro. papel diz o que a pessoa é neste cadastro: 'fornecedor' (você paga a ela; vale em despesa) ou 'cliente' (ela paga você; vale em receita). tambem_outro_papel: true quando ela também é o outro (cliente que também é fornecedor, ou o inverso); false (padrão) quando é só um. Só nome é obrigatório; contato e endereço são opcionais, mas informe só o que o usuário disse. A resposta traz a pessoa no formato de buscar_pessoas, com o id. Dados inválidos (e-mail, CEP) voltam como erro_validacao com o nome do campo, sem cadastrar nada. Editar e excluir pessoa não existem aqui.

criar_tag

ChatGPT
Cria uma tag (etiqueta livre) na empresa, para usar o id em tag_ids de criar_lancamento. Requer autorização de escrita (lancamentos:write). ANTES de chamar, confira listar_tags: a tag que já existe (viva, ativa ou inativa; sem diferença de maiúscula, acento ou espaço no fim) é recusada, e você deve usar o id dela. A resposta traz a tag criada no formato de listar_tags.

desconciliar

ChatGPT
Desfaz a conciliação (em lote, de 1 a 100, por movimento_ids OU por lancamento_ids, nunca os dois) de movimentos do extrato bancário; quando o usuário falar do lançamento ("desfaz a conciliação daquele pagamento"), use lancamento_ids: cada lançamento resolve para o movimento do seu vínculo ativo, e o que não está conciliado é recusado com o motivo "o lançamento não está conciliado": remove o vínculo de cada movimento e, se o lançamento não tiver outro vínculo ativo, restaura pelo estado de antes da conciliação a data de pagamento (a que era em aberto volta a em aberto), o vencimento e o valor. Requer autorização de escrita (lancamentos:write). Altera dados reais do cliente e só vale para os perfis Administrador e Lançamentos. A conta do lançamento NÃO volta: a resposta diz em que conta ele ficou. Vínculo antigo, sem o estado de antes, só tem o vínculo removido: o lançamento continua pago, e reabrir é o estorno (registrar_pagamento com pago: false). A restauração segue o caixa fechado: se ela mudar uma data até a data de bloqueio de caixa da empresa, o movimento é recusado. Lançamento conciliado no mesmo dia volta igual. CONFIRMAÇÃO: sem confirmado: true a chamada NÃO grava: devolve status 'confirmacao_necessaria' com o que cada vínculo desfeito faria. Mostre ao usuário e só reenvie com confirmado: true numa resposta seguinte a uma mensagem nova do usuário que veio DEPOIS da prévia e a aceita; um "pode" ou "sim" dito antes da prévia não vale; nunca chame desconciliar duas vezes na mesma resposta; nunca autoconfirme. LOTE: todo movimento do pedido é alvo. Um movimento impedido (não conciliado, de outra empresa, inexistente, caixa fechado) recusa o pedido INTEIRO, nada é gravado, e a resposta lista cada impedido com o motivo; refaça sem eles, com prévia nova. Com o estado de antes da conciliação (snapshot), a restauração volta a data de pagamento (nula volta a em aberto), o vencimento e o valor. Sem ele (vínculo antigo), só o vínculo sai: diga ao usuário que o lançamento continua pago e que reabrir é o estorno.

excluir_anexo

ChatGPT
Exclui um anexo de lançamento (exclusão lógica; o arquivo só sai do armazenamento quando nenhum lançamento o usa mais). Requer autorização de escrita (lancamentos:write) e apaga dados reais; antes de chamar, confirme com o usuário qual anexo será excluído. O anexo_id vem de obter_lancamentos com campos_adicionais: ["anexos"]. O perfil Somente relatórios não exclui; o perfil Lançamentos por usuário só exclui anexo de lançamento que criou. ANEXO DE SÉRIE: um anexo que foi posto em vários lançamentos da série (este_e_proximos ao anexar) exige escopo_serie; sem ele a tool NÃO exclui e devolve status 'escopo_necessario'. 'so_este' exclui o anexo só do lançamento pedido e os outros continuam com ele; 'este_e_proximos' exclui o anexo desse lançamento e dos seguintes da série. CONFIRMAÇÃO: escopo_serie 'este_e_proximos' alcança mais de um lançamento e NÃO exclui na primeira vez: devolve status 'confirmacao_necessaria' com a quantidade de anexos a excluir, os lançamentos afetados (lancamentos_afetados) e se o arquivo sairia do armazenamento (arquivo_sera_apagado). Apresente isso ao usuário e pergunte explicitamente se deve prosseguir; só reenvie, com os mesmos argumentos mais confirmado: true, APÓS resposta humana explícita — nunca autoconfirme. A segunda chamada exclui e devolve o resultado real, que pode diferir da prévia se algo mudou no intervalo. Com 'so_este' ou com anexo de um lançamento só não há confirmação. Em anexo de lançamento fora de série, ou que não foi posto em vários lançamentos, não informe escopo_serie: ele é recusado.

excluir_lancamento

ChatGPT
Exclui um lançamento avulso existente dos livros do cliente. Requer autorização de escrita (lancamentos:write). Chama a API do Granatum em nome do usuário autenticado e apaga dados reais. Antes de chamar, confirme explicitamente com o usuário. Opera somente em lançamento simples; séries, lançamentos compostos e transferências devem ser excluídos pela interface do Granatum.

ignorar_movimentos

ChatGPT
Ignora (em lote, de 1 a 100) movimentos do extrato bancário que não precisam de conciliação, ou, com desfazer: true, restaura os já ignorados. O movimento ignorado deixa de aparecer em obter_conciliacoes_pendentes; restaurar o devolve às pendências. Requer autorização de escrita (lancamentos:write). Altera dados reais do cliente e só vale para os perfis Administrador e Lançamentos. Só muda o movimento no extrato (e o status da importação de que ele veio: 2 sem movimento pendente, 1 com algum, recalculado para cada importação tocada): nenhum lançamento, vínculo ou saldo muda. Recusas por movimento: de outra empresa ou inexistente (movimento_nao_encontrado), já ignorado ao ignorar (movimento_ja_ignorado), não ignorado ao restaurar (movimento_nao_ignorado), conciliado (movimento_conciliado: desconcilie antes) e de origem que o MCP não trata (importação CSV, ou origem não registrada: movimento_de_importacao_csv, fica na tela do Granatum). CONFIRMAÇÃO: sem confirmado: true a chamada NÃO grava: devolve status 'confirmacao_necessaria' com a quantidade e cada movimento (data, descrição, valor). Mostre ao usuário e só reenvie, com os mesmos movimentos mais confirmado: true, numa resposta seguinte a uma mensagem nova do usuário que veio DEPOIS da prévia e a aceita; um "pode", "sim" ou "confirma" dito antes da prévia não vale; nunca chame ignorar_movimentos duas vezes na mesma resposta; nunca autoconfirme. A confirmação confere cada movimento de novo na hora de gravar. Nunca mande parâmetro opcional vazio: omita. LOTE: todo movimento do pedido é alvo. Se algum estiver impedido, o pedido INTEIRO é recusado, nada é gravado, e a resposta lista cada impedido com o motivo (status erro, codigo alvos_impedidos, impedidos); diga ao usuário e, se ele aceitar, refaça sem os impedidos, mostrando a prévia nova antes de confirmar. Perfis sem acesso à conciliação (só Administrador e Lançamentos a usam) recebem a recusa "Seu perfil nesta empresa não dá acesso à conciliação": não insista.

listar_categorias

ChatGPT
Lista as categorias do plano de contas da empresa autenticada. Use para entender a estrutura contábil disponível, para descobrir IDs de categoria a usar em filtros de obter_dre, obter_fluxo_caixa ou obter_lancamentos, ou quando o usuário quiser ver/explicar a hierarquia de categorias.

listar_centros_custo_lucro

ChatGPT
Lista os centros de custo/lucro da empresa autenticada, com a hierarquia em caminho. Use para descobrir IDs a passar em centro_custo_lucro_ids nos filtros de obter_dre, obter_fluxo_caixa ou obter_lancamentos. O valor 0 representa 'sem centro de custo' e não é um item desta lista.

listar_contas

ChatGPT
Lista as contas bancárias (corrente, poupança, cartão de crédito) da empresa autenticada. Use para descobrir IDs a passar em conta_ids nos filtros de relatório, ou para escolher a conta ao criar um lançamento. Só crie lançamentos em contas com permite_lancamento true.

listar_empresas

ChatGPT
Lista as empresas Granatum acessíveis pelo usuário autenticado. Chame esta tool quando o usuário não especificou qual empresa deseja analisar, ou quando quiser trocar de empresa durante a conversa. Use o wgi_conta_id retornado nas demais tools.

listar_formas_pagamento

ChatGPT
Lista as formas de pagamento cadastradas na empresa autenticada. Use para descobrir o forma_pagamento_id ao criar um lançamento. O valor 0 representa 'sem forma de pagamento' e não é um item desta lista.

listar_tags

ChatGPT
Lista as tags (etiquetas livres) da empresa. Use para descobrir IDs a usar em tag_ids de obter_lancamentos, ou quando o usuário mencionar uma tag pelo nome. Tags não têm hierarquia. Para ver as tags de cada lançamento, use obter_lancamentos com campos_adicionais: ["tags"].

obter_anexo

ChatGPT
Devolve o link temporário para baixar um anexo de lançamento (válido por 30 minutos), com nome, tipo e tamanho do arquivo. Somente leitura. O anexo_id vem de obter_lancamentos com campos_adicionais: ["anexos"]. Você recebe só o link, não o conteúdo do arquivo. O link dá acesso ao arquivo a quem o tiver: entregue-o apenas ao usuário que o pediu, não o repita nem o guarde para outros usos; vencido, peça outro. Todos os perfis com acesso ao Financeiro podem, inclusive Somente relatórios; o perfil Lançamentos por usuário só baixa anexos de lançamentos que ele criou.

obter_conciliacoes_pendentes

ChatGPT
Lê os movimentos do extrato bancário que ainda esperam conciliação (sem vínculo com lançamento e não ignorados) e sugere o lançamento de cada um. Só lê: não concilia nada; quem concilia é a tool conciliar, e só depois do sim do usuário. SEM conta_id devolve o resumo por conta: quantos movimentos pendentes há, quantos por grau (confiavel, revisar, sem_sugestao) e quantos estão bloqueados (os bloqueados já contam em revisar). Comece por aqui quando o usuário perguntar quais conciliações estão pendentes. COM conta_id e periodo_inicio e periodo_fim devolve os movimentos pendentes da conta, paginados (pagina, limite, proxima_pagina, total_disponivel; filtro opcional grau), cada um com: grau (confiavel, revisar ou sem_sugestao), motivo escrito, bloqueio (quando existir: motivo e opções) e até 5 candidatos (lancamento_id, valor, datas, conta, pessoa, acao). O grau e o bloqueio vêm do servidor: confiavel é só o que pode ser gravado agora (um único candidato confiável, da mesma conta do extrato); o movimento bloqueado nunca é confiavel e não entra no filtro grau=confiavel. Não reclassifique: não promova revisar a confiavel nem conte como confiável o que o servidor não marcou. Como usar: com as confiaveis, diga ao usuário quantas são ("38 confiáveis, concilio?") e só então chame conciliar com os pares movimento_id e lancamento_id do primeiro candidato. As bloqueadas, mostre o motivo e as opções do bloqueio (voltar a data de bloqueio de caixa na tela do Granatum e pedir de novo; deixar pendente; conciliar com outro candidato quando a opção trouxer lancamento_ids). As de revisar, ANTES de qualquer conciliar mostre o movimento, o motivo e o(s) candidato(s) e peça a escolha ao usuário; só depois da escolha chame a prévia de conciliar. As sem_sugestao, não há lançamento na janela (em aberto com vencimento a até 30 dias, ou já pago a até 3 dias): tente obter_lancamentos (pela data e valor do movimento) antes de dizer que fica para a tela, porque conciliar aceita qualquer lançamento válido, não só o sugerido (mesmo sinal, valor exato ao centavo, sem vínculo). Movimento importado por CSV não se concilia pelo MCP: vem em revisar com bloqueio (conciliar_na_tela) e sem candidatos; encaminhe o usuário à tela de conciliação do Granatum. Fica na tela do Granatum, não no MCP: valor diferente (ajustar, diferença, baixa parcial), vários lançamentos para um movimento ou juntar movimentos, criar lançamento ou transferência a partir do movimento, ignorar e restaurar movimento, e voltar a data de bloqueio. Só os perfis Administrador e Lançamentos usam a conciliação; os outros recebem a recusa "Seu perfil nesta empresa não dá acesso à conciliação": não insista, informe o usuário.

obter_dre

ChatGPT
Resumo dinâmico da DRE com árvore de tópicos, valores assinados, análises (variação/participação/base), resumos por nível, principais categorias e alertas de mapeamento. Quando não houver filtros, utilize periodicidade 'mensal', quantidade_periodos 6 e considere como período de referência o mês imediatamente anterior (YYYY-MM). Procure destacar movimentos relevantes de receita, custos e margens, explicando impactos no EBITDA e resultado líquido.

obter_fluxo_caixa

ChatGPT
Resumo do fluxo de caixa com períodos contíguos (recebido/pago/líquido, saldos inicial/final/acumulado, principais categorias e comparações). Se nenhum filtro for informado, utilize periodicidade 'mensal', quantidade_periodos 6 e período de referência igual ao mês imediatamente anterior (formato YYYY-MM). Destaque entradas vs. saídas, evolução do saldo acumulado e categorias que mais impactaram o período.

obter_lancamentos

ChatGPT
Lista lançamentos (recebimentos/pagamentos) de uma empresa em um período. Use para listagem livre ("lançamentos de abril") ou drill-down após obter_dre/obter_fluxo_caixa (passando os categoria_ids da linha que o usuário quer investigar). Todos os filtros além de período são opcionais — sem nenhum filtro, retorna todos os lançamentos da janela, paginados.

registrar_pagamento

ChatGPT
Registra o pagamento de lançamentos nos livros do cliente: dá baixa, corrige a data de pagamento de quem já está pago ou estorna a baixa. Requer autorização de escrita (lancamentos:write). Chama o banco do Granatum em nome do usuário autenticado e altera dados reais. Antes de chamar, confirme com o usuário os lançamentos e a data do pagamento: nunca presuma que 'pagou hoje'. O parâmetro pago decide a operação: (1) pago: true e data_pagamento DÁ BAIXA em quem está em aberto; (2) pago: true e data_pagamento em quem JÁ ESTÁ PAGO só TROCA a data do pagamento (sem estorno; valor e conta não mudam); (3) pago: false ESTORNA a baixa (limpa a data de pagamento; não leva data_pagamento). BAIXA COM VALOR DIFERENTE: valor_pago (só com um id): igual ao valor do lançamento quita; MAIOR é juros e multa (na competência aberta a diferença fica no valor do lançamento; na competência fechada ela vira lançamento próprio, veja a regra a seguir); COMPETÊNCIA FECHADA (até a data de bloqueio de competência da empresa): o valor do lançamento NÃO muda; o juros, a multa e o desconto nascem como um lançamento próprio, pago na data do pagamento, com a competência nessa data e o vencimento do original, na conta e na categoria do original (do tipo do original no juros e na multa, do tipo contrário no desconto), e a resposta traz lancamentos_da_diferenca com os ids criados (e lancamento_composto_das_diferencas_id quando formam um dividido novo); a data do pagamento não pode cair até a data de bloqueio de competência. REGRA: pagar MENOR exige desconto: true; pagar MAIOR, na competência fechada, cria o lançamento de juros sem nenhuma flag; gerar_restante na competência fechada é recusado (pague o valor cheio ou com desconto: true). Na competência aberta, MENOR tem duas saídas, e quem escolhe é o usuário: desconto: true (a diferença vira desconto e o lançamento fica pago pelo valor informado) OU gerar_restante: true (BAIXA PARCIAL: o lançamento fica pago pelo valor informado e a diferença nasce como um novo lançamento em aberto, o saldo restante, 'Diferença ref.: ...', com o mesmo vencimento, categoria, pessoa, centro, tags e demais dados do original). desconto e gerar_restante se excluem; pagar menos sem nenhum dos dois é recusado. O restante é um lançamento comum e INDEPENDENTE do original: não há vínculo entre os dois, e estornar a baixa do original não o apaga. Em dividido nasce um restante por item que ficou com diferença, e com dois ou mais restantes eles nascem agrupados num dividido novo (sem ligação com o do original; com um só, ele é avulso). A resposta da baixa diz valor_original (o valor do lançamento antes desta baixa, não necessariamente o original histórico), valor_pago e diferenca (tratamento 'juros', 'desconto' ou 'parcial'); na baixa parcial traz também valor_restante e lancamentos_restantes (os ids criados; lancamento_composto_dos_restantes_id quando formam um dividido novo). valor_pago NÃO vale em lançamento que já está pago: estorne antes (pago: false) e dê a baixa de novo. ESTORNO: limpa só a data de pagamento; o valor do lançamento NÃO VOLTA ao que era antes da baixa (na competência aberta, juros, desconto e baixa parcial reescrevem o valor, e o valor anterior está no histórico do lançamento; na competência fechada o valor do lançamento não mudou na baixa e a diferença é outro lançamento, que o estorno não toca). Todo estorno responde com o mesmo aviso, sem número: o estorno não sabe se a baixa teve juros, desconto ou restante. Avise o usuário e não afirme um valor anterior; um restante gerado pela baixa continua em aberto e é independente, e a diferença de uma competência fechada continua paga. SÉRIE: paga ou estorna só a ocorrência pedida, nunca as próximas, e não há escopo_serie. DIVIDIDO: o id de qualquer item paga o lançamento dividido INTEIRO, mas só os itens em aberto: um item já pago fica como está (data e valor); e estorna o lançamento dividido INTEIRO. Recusas, com o motivo e o que fazer: data futura, até a data de bloqueio de caixa ou anterior ao saldo inicial da conta; lançamento conciliado; transferência (não tem baixa …

Capabilities

Writes

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/granatum-financeiro"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/granatum-financeiro)