@td_scale/mcp-granatum

MCP server somente leitura para a API do Granatum Financeiro.

Configuração

1. Obtenha seu token: no Granatum, acesse Configurações → Minha Empresa → API (requer perfil Super admin).
2. Adicione ao seu client MCP (Claude Code, Claude Desktop, Cursor...):

{
  "mcpServers": {
    "granatum": {
      "command": "npx",
      "args": ["-y", "@td_scale/mcp-granatum@latest"],
      "env": {
        "GRANATUM_ACCESS_TOKEN": "seu_token_aqui"
      }
    }
  }
}

Tools disponíveis

| Tool | Descrição | | --- | --- | | listar_lancamentos | Lançamentos com filtros (conta, pessoa, categoria, período, tipo) e paginação | | obter_lancamento | Um lançamento pelo ID | | listar_categorias | Categorias de receita/despesa | | listar_contas | Contas bancárias | | listar_clientes | Clientes (busca por nome/documento) | | listar_fornecedores | Fornecedores (busca por nome/documento) | | listar_centros_custo | Centros de custo/lucro | | listar_formas_pagamento | Formas de pagamento | | listar_transferencias | Transferências entre contas | | listar_cobrancas | Cobranças emitidas | | relatorio_fluxo_caixa | Fluxo de caixa por período | | relatorio_dre | DRE por período |

Todas as operações são de leitura — este server não cria, altera nem exclui dados.

Variáveis de ambiente

| Variável | Obrigatória | Descrição | | --- | --- | --- | | GRANATUM_ACCESS_TOKEN | Sim | Token de acesso da API | | GRANATUM_BASE_URL | Não | Sobrescreve a base URL (padrão https://api.granatum.com.br/v1) |

Limites

A API do Granatum permite 100 requisições/minuto. Em caso de 429, o server aguarda 2s e tenta 1 vez novamente antes de reportar o erro.