🇧🇷 CNPJ MCP Server

MCP server para consulta de CNPJ, sócios e atividades de empresas brasileiras.

Parte do Brazil MCP Bundle — ferramentas brasileiras para Claude Code, Cursor e qualquer cliente MCP.

Instalação

# Claude Code
claude mcp add cnpj -- npx @brazil-mcp/cnpj

# claude_desktop_config.json / Cursor / VS Code
{
  "mcpServers": {
    "cnpj": {
      "command": "npx",
      "args": ["@brazil-mcp/cnpj"]
    }
  }
}

Tools Disponíveis

| Tool | Descrição | |------|-----------| | cnpj_lookup | Dados completos da empresa (razão social, endereço, capital social, sócios, CNAEs) | | cnpj_validate | Valida dígitos verificadores (local, sem API) | | cnpj_partners | Lista de sócios (QSA) com qualificação | | cnpj_activities | Atividades econômicas (CNAE principal e secundárias) | | cnpj_address | Endereço completo registrado na Receita Federal |

Exemplos de Uso

No Claude Code ou Cursor, simplesmente peça:

• "Quem são os sócios do CNPJ 33.000.167/0001-01?"
• "Valide o CNPJ 12345678000195"
• "Qual o endereço da empresa com CNPJ 33000167000101?"
• "Liste as atividades econômicas do CNPJ 33.000.167/0001-01"

APIs Utilizadas

• BrasilAPI (principal — gratuita, sem auth)
• ReceitaWS (fallback — gratuita, 3 req/min)

Cache em memória com TTL de 24h para reduzir chamadas.

Desenvolvimento

npm install
npm run dev          # Roda em modo dev
npm test             # Testes unitários
npm run test:integration  # Testes com APIs reais
npm run build        # Compila TypeScript
npm run inspect      # Abre MCP Inspector

Licença

MIT

🇧🇷 CNPJ MCP Server (English)

MCP server for querying Brazilian company data (CNPJ), partners, and economic activities.

Part of the Brazil MCP Bundle — Brazilian business tools for Claude Code, Cursor, and any MCP client.

All tool responses are in Portuguese (Brazilian data from Receita Federal).