# CIGAM — how to use (mcp.ai)

CIGAM ERP (management for industry, retail and franchises) via session capture with your authorization. Since CIGAM has no public API, you provide your access key, user and password and the platform logs into your account to read your own data, on the same API the CIGAM portal uses. Read-only: invoices, accounts payable and receivable, cash register closings, financial entries and suppliers.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_cigam?ms=1781857680000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `cigam_caixa`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/cigam`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/cigam/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/cigam/caixa` — Lista fechamentos de caixa por período. Entradas, saídas, fundo de caixa, vendas líquidas/do dia, saldo.
  - body: { loja: string, data_inicial?: string, data_final?: string, numero_caixa?: string, situacao?: string, page?: integer, limit?: integer, account?: string }
- `POST https://api.mcp.ai/api/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`.
  - body: { guid: string, params?: string, account?: string }
- `POST https://api.mcp.ai/api/cigam/contas/pagar` — Lista contas a pagar por período. Fornecedor, vencimento, plano de contas, nota fiscal/duplicata, valores, juros.
  - body: { loja: string, data_inicial?: string, data_final?: string, numero_nf?: string, duplicata?: string, cod_fornecedor?: string, cod_plano_contas?: string, situacao?: string, tipo_data?: string, page?: integer, limit?: integer, account?: string }
- `POST https://api.mcp.ai/api/cigam/contas/receber` — Lista contas a receber por período. Cliente, vencimento, forma de pagamento, valores, parcelas, NSU/autorização de cartão.
  - body: { loja?: string, data_inicial?: string, data_final?: string, cod_cliente?: string, situacao?: string, tipo_data?: string, page?: integer, limit?: integer, account?: string }
- `POST https://api.mcp.ai/api/cigam/fornecedores` — Lista/pesquisa fornecedores cadastrados. Razão social, nome fantasia, CNPJ, endereço, contato, situação.
  - body: { cnpj?: string, page?: integer, limit?: integer, account?: string }
- `POST https://api.mcp.ai/api/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).
  - body: { loja: string, data_inicial?: string, data_final?: string, cod_plano_contas?: string, tipo_conta?: string, tipo_data?: string, page?: integer, limit?: integer, account?: string }
- `POST https://api.mcp.ai/api/cigam/list/accounts` — Lista as contas CIGAM conectadas a este install — id, label (instância/usuário).
  - body: { account?: string }
- `POST https://api.mcp.ai/api/cigam/listar/lojas` — Lista as lojas/empresas que a conta enxerga (código, nome, CNPJ). Use o `loja` retornado nos demais filtros.
  - body: { account?: string }
- `POST https://api.mcp.ai/api/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.
  - body: { loja: string, data_inicial?: string, data_final?: string, numero_nf?: integer, referencia?: string, status?: integer[], page?: integer, limit?: integer, account?: string }

## Example prompts
- "List this month's invoices for store Z136"
- "Which accounts payable are due in the next 7 days?"
- "Show last week's cash register closings"

## More
- Page: https://mcp.ai/cigam
- Agent spec (llms.txt): https://mcp.ai/cigam/llms.txt
- Postman collection: https://mcp.ai/cigam/postman.json