# CIGAM

- Registry name: `io.github.mcp-dir/cigam-mcp` · version 0.1.0
- Categories (automatic, keyword rules): Docs & notes, Productivity, Shops & products, Commerce & marketing, Code & repositories, Developer tools
- 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%2Fcigam-mcp
- Server page: https://mcpstation.net/s/io.github.mcp-dir--cigam-mcp.html

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

CIGAM ERP \(management for industry, retail and franchises\) via session capture with your authorizati

## Connect

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

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

- `cigam\_list\_accounts`: Lista as contas CIGAM conectadas a este install — id, label \(instância/usuário\).
- `cigam\_listar\_lojas`: Lista as lojas/empresas que a conta enxerga \(código, nome, CNPJ\). Use o \`loja\` retornado nos demais filtros.
- `cigam\_notas\_fiscais`: Lista notas fiscais de uma loja por período. Retorna número, série, destinatário, valor, status, chave NF-e, etc.
- `cigam\_vendas`: Vendas de uma loja por período \(notas fiscais de saída do tipo Venda\). Retorna as NFs de venda \(data, destinatário, valor\) + \`resumo\` com quantidade e valor total do período.
- `cigam\_compras`: Compras de uma loja por período \(notas fiscais de entrada do tipo Compra\). Retorna as NFs de compra + \`resumo\` com quantidade e valor total.
- `cigam\_devolucoes`: Devoluções de uma loja por período \(notas fiscais com movimento de devolução, entrada e saída\). Retorna as NFs + \`resumo\` com quantidade e valor total.
- `cigam\_vendas\_resumo`: Panorama do período numa loja: totais de vendas, compras e devoluções \(quantidade e valor de cada\). Um único resumo, sem listar as notas.
- `cigam\_fluxo\_caixa`: Fluxo de caixa projetado de uma loja por período: total a receber \(contas a receber em aberto\) vs total a pagar \(contas a pagar\), e o saldo projetado. Janela máxima de 60 dias.
- `cigam\_ranking\_clientes`: Ranking de clientes por valor vendido no período \(agrupa as vendas por destinatário/CNPJ-CPF\). Retorna os maiores compradores ordenados por valor.
- `cigam\_vendas\_por\_dia`: Série de vendas por dia no período \(quantidade e valor por data\) + resumo com total e ticket médio.
- `cigam\_inadimplencia`: Contas a receber vencidas e ainda em aberto \(inadimplência\). Cada item traz dias de atraso e valor em aberto, ordenados do mais atrasado. Default: vencimentos dos últimos 60 dias \(janela máxima de 60 dias por consulta\).
- `cigam\_resultado`: Resultado gerencial simplificado de uma loja por período: receita \(vendas faturadas líquidas de devolução\) menos despesas \(lançamentos financeiros por plano de contas\), com o detalhe das despesas por categoria.
- `cigam\_formas\_pagamento`: Mix de formas de recebimento de uma loja por período: total recebido por forma de pagamento, por bandeira de cartão e por adquirente \(maquininha\). Janela máxima de 60 dias.
- `cigam\_relatorio`: Gera um relatório do CIGAM \(operação LENTA, \~2 min, produz um arquivo Excel\). Espera inline até \`aguardar\_segundos\`; se não ficar pronto, retorna um \`job\_id\` \(busque depois com cigam\_job, sem ficar repetindo\). Retorna \`arquivo\_url\` \(link temporário do Excel\). Ex. de report\_id: REL\_201 \(Vendas por Pe
- `cigam\_job`: Busca o resultado de um job assíncrono \(ex.: relatório\) pelo \`job\_id\` retornado por outra tool. Espera inline até \`aguardar\_segundos\`. Sem polling: só chame de novo se voltar status 'running'. Bulk support: accepts job\_ids for batched execution.
- `cigam\_estoque`: Posição atual de estoque \(saldo por código de barras\). Operação LENTA \(gera um relatório, \~1 min\); espera até \`aguardar\_segundos\`, senão retorna um job\_id \(busque com cigam\_job\). Informe \`codigo\_barra\` para o saldo de um produto específico, ou nada para um resumo \(total de SKUs, SKUs com saldo, unid
- `cigam\_contas\_receber`: Lista contas a receber por período. Cliente, vencimento, forma de pagamento, valores, parcelas, NSU/autorização de cartão.
- `cigam\_contas\_pagar`: Lista contas a pagar por período. Fornecedor, vencimento, plano de contas, nota fiscal/duplicata, valores, juros.
- `cigam\_caixa`: Lista fechamentos de caixa por período. Entradas, saídas, fundo de caixa, vendas líquidas/do dia, saldo.
- `cigam\_lancamentos`: Lista lançamentos financeiros por período. Competência, plano de contas, histórico, valor, forma de pagamento, tipo \(débito/crédito\).
- `cigam\_fornecedores`: Lista/pesquisa fornecedores cadastrados. Razão social, nome fantasia, CNPJ, endereço, contato, situação.
- `cigam\_consulta`: Consulta genérica ao gateway do CIGAM \(ObterCarga\) para listas auxiliares \(planos de conta, formas de pagamento, marcas, etc.\). Informe o \`guid\` e os \`params\`.
- `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