# Microvix — how to use (mcp.ai)

Microvix retail ERP (Linx, part of the Stone group) for store chains and franchises, via the official output WebService. Read-only: products, stock and inventory, customers and suppliers, sales movement and billing, orders, salespeople and the group's stores. No pagination, filter by date window and by store (CNPJ). Auth via the portal credentials (user, password, key and IdPortal) provided by Linx.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_microvix?ms=1781684820000`
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. `microvix_clientes_fornec`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/microvix`
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/microvix/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/microvix/clientes/fornec` — Cadastro de clientes e fornecedores (LinxClientesFornec). Filtre por data_inicial/fim, doc_cliente e cnpj_emp.
  - body: { cnpj_emp?: string, data_inicial?: string, data_fim?: string, doc_cliente?: string, account?: string }
- `POST https://api.mcp.ai/api/microvix/grupo/lojas` — Lista os CNPJs das lojas de um grupo (LinxGrupoLojas). Use pra descobrir os cnpj_emp antes de iterar.
  - body: { grupo?: string, account?: string }
- `POST https://api.mcp.ai/api/microvix/list/accounts` — Lista os portais Microvix conectados a este install — id, label.
  - body: { account?: string }
- `POST https://api.mcp.ai/api/microvix/lojas` — Dados das lojas/empresas do portal (LinxLojas): CNPJ, endereço, regime tributário.
  - body: { cnpj_emp?: string, account?: string }
- `POST https://api.mcp.ai/api/microvix/movimento` — Movimento de vendas/fiscal (LinxMovimento): transações, chave da NF, impostos (ICMS/PIS/COFINS/IPI), formas de pagamento. Filtre por data_inicial/fim e cnpj_emp. É a base do faturamento.
  - body: { cnpj_emp?: string, data_inicial?: string, data_fim?: string, account?: string }
- `POST https://api.mcp.ai/api/microvix/pedidos/venda` — Pedidos de venda (LinxPedidosVenda). Filtre por data_inicial/fim, doc_cliente e cnpj_emp.
  - body: { cnpj_emp?: string, data_inicial?: string, data_fim?: string, doc_cliente?: string, account?: string }
- `POST https://api.mcp.ai/api/microvix/produtos` — Cadastro de produtos (LinxProdutos): nome, NCM, CEST, referência, cor/tamanho, marca/linha/setor. Filtre por janela de atualização (dt_update_inicio/fim) e cnpj_emp.
  - body: { cnpj_emp?: string, dt_update_inicio?: string, dt_update_fim?: string, cod_produto?: string, referencia?: string, account?: string }
- `POST https://api.mcp.ai/api/microvix/produtos/detalhes` — Detalhe de produto por loja (LinxProdutosDetalhes): código de barras, quantidade, preco_custo, preco_venda, custo_medio. Filtre por data_mov_ini/fim e cnpj_emp.
  - body: { cnpj_emp?: string, data_mov_ini?: string, data_mov_fim?: string, cod_produto?: string, referencia?: string, account?: string }
- `POST https://api.mcp.ai/api/microvix/produtos/inventario` — Inventário/saldo de estoque por código de barras (LinxProdutosInventario). Informe data_inventario e cnpj_emp.
  - body: { cnpj_emp?: string, data_inventario?: string, account?: string }
- `POST https://api.mcp.ai/api/microvix/vendedores` — Cadastro de vendedores (LinxVendedores). Filtre por data_upd_inicial/fim, cod_vendedor e cnpj_emp.
  - body: { cnpj_emp?: string, data_upd_inicial?: string, data_upd_fim?: string, cod_vendedor?: string, account?: string }

## Example prompts
- "List the store's sales movement between dates X and Y"
- "Show the latest stock inventory"
- "List products updated in the last week"

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