CIGAM

io.github.mcp-dirPublished by GitHub account mcp-dirv0.1.0Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableFinanceData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Read-only access to a CIGAM ERP account: sales, invoices, payables and receivables, cash closings, stock and suppliers, queried by an AI assistant.

What you can do
  • List connected CIGAM accounts and the stores/companies each account can see
  • Query invoices, sales, purchases and returns for a store and period, plus period summaries, daily sales series and customer rankings
  • Review finance: projected cash flow, overdue receivables, payables, cash closings, journal entries and payment-method mix
  • Check stock position by barcode and look up suppliers
  • Generate CIGAM Excel reports and fetch slow asynchronous jobs by job id
  • Run generic gateway lookups for auxiliary lists, and manage the toolkit connection, marketplace and authentication
When to use it
Useful when you want an assistant to answer questions about a Brazilian retail, industry or franchise operation running on CIGAM — for example how much a store sold this month, which payables are due next week, or last week's cash closing — without exporting spreadsheets by hand.
Requirements
A remote MCP endpoint over HTTP; no local package or runtime. You need a CIGAM access key, user and password, which the platform uses to log into your own account. Some tools are slow (reports and stock take about one to two minutes) and return a job id to poll with the job tool.
Before you install
You hand over your CIGAM access key, user and password so the service can log into your account on your behalf; the server is proprietary and hosted, not open source. Data returned by the tools is sent to whichever LLM host you use, a sub-processor outside the provider's control. Paid plans exist beyond a free tier. The README claims read-only access but also mentions read and write, so confirm before relying on it.

Installation

In SourceWeft

  1. Open CIGAM in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.mcp-dir%2Fcigam-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "cigam": {
      "type": "http",
      "url": "https://api.mcp.ai/p_cigam"
    }
  }
}

README

CIGAM

CIGAM para Claude, ChatGPT e agentes de IA

ERP CIGAM (gestão para indústria, varejo e franquias) por captura de sessão com a sua autorização. Como o CIGAM não tem API pública, você informa a sua Chave de acesso, usuário e senha e a plataforma entra na sua conta para ler os seus próprios dados, na mesma API que o portal CIGAM usa. Somente leitura: vendas, notas fiscais, contas a pagar e a receber, fechamento de caixa, lançamentos financeiros e fornecedores.

  • 📊 22 ferramentas
  • ✏️ Leitura e escrita
  • 💬 Funciona com qualquer cliente MCP: Claude Desktop, Cursor, VS Code, Cline, Continue
  • 🔑 Login via magic-link (sem senha)

English version · Documentação completa · Skill pra agentes


Instalar em 1 clique

Claude (Web e Desktop)

A Anthropic unificou a instalação de MCPs em claude.ai/customize/connectors. O mesmo link serve pra Claude Web e Claude Desktop (basta estar logado):

➕ Abrir no Claude e conectar

Manual (se o deeplink não abrir): claude.ai/customize/connectors → + → Adicionar conector personalizado → cole Nome CIGAM e URL https://api.mcp.ai/p_cigam.

Cursor

➕ Instalar CIGAM no Cursor

VS Code (Copilot Chat)

➕ Instalar CIGAM no VS Code

ChatGPT, Manus, OpenClaw e mais 40+ clientes

Funciona em qualquer cliente MCP que suporte MCP over HTTP. A URL do servidor é sempre:

https://api.mcp.ai/p_cigam

Detalhes por cliente: INSTALL.md.


Exemplos de uso

Quanto a loja Z136 vendeu neste mês?Quais contas a pagar vencem nos próximos 7 dias?Mostre o fechamento de caixa da última semana

22 ferramentas disponíveis

ToolDescrição
cigam_list_accountsLista as contas CIGAM conectadas a este install — id, label (instância/usuário).
cigam_listar_lojasLista as lojas/empresas que a conta enxerga (código, nome, CNPJ).
cigam_notas_fiscaisLista notas fiscais de uma loja por período.
cigam_vendasVendas de uma loja por período (notas fiscais de saída do tipo Venda).
cigam_comprasCompras de uma loja por período (notas fiscais de entrada do tipo Compra).
cigam_devolucoesDevoluções de uma loja por período (notas fiscais com movimento de devolução, entrada e saída).
cigam_vendas_resumoPanorama do período numa loja: totais de vendas, compras e devoluções (quantidade e valor de cada).
cigam_fluxo_caixaFluxo 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.
cigam_ranking_clientesRanking de clientes por valor vendido no período (agrupa as vendas por destinatário/CNPJ-CPF).
cigam_vendas_por_diaSérie de vendas por dia no período (quantidade e valor por data) + resumo com total e ticket médio.
cigam_inadimplenciaContas a receber vencidas e ainda em aberto (inadimplência).
cigam_resultadoResultado 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_pagamentoMix 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).
cigam_relatorioGera um relatório do CIGAM (operação LENTA, ~2 min, produz um arquivo Excel).
cigam_jobBusca o resultado de um job assíncrono (ex.: relatório) pelo job_id retornado por outra tool.
cigam_estoquePosição atual de estoque (saldo por código de barras).
cigam_contas_receberLista contas a receber por período.
cigam_contas_pagarLista contas a pagar por período.
cigam_caixaLista fechamentos de caixa por período.
cigam_lancamentosLista lançamentos financeiros por período.
cigam_fornecedoresLista/pesquisa fornecedores cadastrados.
cigam_consultaConsulta genérica ao gateway do CIGAM (ObterCarga) para listas auxiliares (planos de conta, formas de pagamento, marcas, etc.).

Detalhe de cada tool: docs/ferramentas.md


Preços

Planos a partir do tier grátis. Veja docs/precos.md.


Privacidade & LGPD

  • Sub-processadores: CIGAM (Senior Sistemas), o LLM host que você escolher (Claude, ChatGPT, Cursor, agente próprio). Lista completa em docs/privacidade-lgpd.md.
  • Os dados retornados pelas tools são enviados ao LLM host que você escolher, sub-processador fora do nosso controle. Recomendamos planos com opt-out de treinamento.

Perguntas frequentes

O servidor é open source? O servidor é proprietário (hosted). Este repositório é o wrapper público com manifestos, docs e skills — tudo MIT.

Posso usar com agente próprio (não Claude/Cursor)? Sim — qualquer cliente que suporte MCP over HTTP. URL: https://api.mcp.ai/p_cigam.


Suporte


Licença

MIT — veja LICENSE. O servidor MCP em api.mcp.ai/p_cigam é proprietário (hosted); este repositório (manifestos, docs, skills) é MIT.

Source: README.md at commit c1110f7

Tools

28

cigam_list_accounts

Lista as contas CIGAM conectadas a este install — id, label (instância/usuário).

Parametersaccount

cigam_listar_lojas

Lista as lojas/empresas que a conta enxerga (código, nome, CNPJ). Use o `loja` retornado nos demais filtros.

Parametersaccount

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.

Parameterslojarequiredpagelimitstatusaccountnumero_nfdata_finalreferenciadata_inicial

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.

Parameterslojarequiredpagelimitaccountdata_finaldata_inicial

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.

Parameterslojarequiredpagelimitaccountdata_finaldata_inicial

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.

Parameterslojarequiredpagelimitaccountdata_finaldata_inicial

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.

Parameterslojarequiredaccountdata_finaldata_inicial

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.

Parameterslojarequiredaccountdata_finaldata_inicial

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.

Parameterstoplojarequiredaccountdata_finaldata_inicial

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.

Parameterslojarequiredaccountdata_finaldata_inicial

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

Parameterslojarequiredpagelimitaccountdata_finaldata_inicial

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.

Parameterslojarequiredaccountdata_finaldata_inicial

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.

Parameterslojaaccountdata_finaldata_inicial

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 Período), REL_610 (posição atual de estoque). Bulk support: accepts report_ids for batched execution.

Parametersaccountfiltrosreport_idrequiredreport_idsaguardar_segundos

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.

Parametersjob_idrequiredaccountjob_idsaguardar_segundos

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, unidades) + amostra dos itens com saldo. Obs.: traz só o código de barras, sem nome de produto.

Parameterslimitaccountcodigo_barraaguardar_segundos

cigam_contas_receber

Lista contas a receber por período. Cliente, vencimento, forma de pagamento, valores, parcelas, NSU/autorização de cartão.

Parameterslojapagelimitaccountsituacaotipo_datadata_finalcod_clientedata_inicial

cigam_contas_pagar

Lista contas a pagar por período. Fornecedor, vencimento, plano de contas, nota fiscal/duplicata, valores, juros.

Parameterslojarequiredpagelimitaccountsituacaoduplicatanumero_nftipo_datadata_finaldata_inicialcod_fornecedorcod_plano_contas

cigam_caixa

Lista fechamentos de caixa por período. Entradas, saídas, fundo de caixa, vendas líquidas/do dia, saldo.

Parameterslojarequiredpagelimitaccountsituacaodata_finaldata_inicialnumero_caixa

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

Parameterslojarequiredpagelimitaccounttipo_datadata_finaltipo_contadata_inicialcod_plano_contas

cigam_fornecedores

Lista/pesquisa fornecedores cadastrados. Razão social, nome fantasia, CNPJ, endereço, contato, situação.

Parameterscnpjpagelimitaccount

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

Parametersguidrequiredparamsaccount

show_version

Show Version

Show the current MCP platform and adapter versions.

Takes no parameters.

report_bug

Report Bug

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

Parameterscontextmessagerequiredconversation

connect

Connection Status

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.

Takes no parameters.

toolkit_info

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.

Takes no parameters.

marketplace

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

Parameterslimitqueryactionmcp_idmessagetool_idargumentsimmediatetier_slugprompt_bodyprompt_slugprompt_tool+11 more

authenticate

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

Parameterstoken

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts