# CNPJ — how to use (mcp.ai)

Consulta cadastral pública de CNPJ (razão social, nome fantasia, situação, CNAE, porte e sócios) via BrasilAPI — grátis, sem credencial. Também descobre os processos judiciais da empresa (e dos sócios) por nome, via Diário (DJEN).

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

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

### Endpoints
- `POST https://api.mcp.ai/api/cnpj/consultar` — Consulta cadastral de um CNPJ (grátis): razão social, nome fantasia, situação cadastral, CNAE principal, porte, município/UF e SÓCIOS (QSA). Útil pra identificar a empresa e seus sócios antes de busca
  - body: { cnpj: string }
- `POST https://api.mcp.ai/api/cnpj/processos` — DESCOBERTA por CNPJ: resolve o CNPJ em razão social (e sócios) e busca os processos por NOME no Diário (DJEN) — grátis, com número de processo completo. Opcionalmente inclui os processos dos sócios. C
  - body: { cnpj: string, incluir_socios?: boolean }

## Example prompts
- "Consulte o CNPJ 33.000.167/0001-01 e liste os sócios"
- "Quais processos da empresa do CNPJ 33.000.167/0001-01?"
- "Inclua os processos dos sócios também"

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