MCP CNPJ Intelligence

You have an MCP server that lets you query Brazilian company data by CNPJ and retrieve rich company details, partnerships, tax regime, and more. It integrates with MCP clients like Claude Desktop and Cursor, enabling fast lookups and advanced search capabilities across tens of thousands of Brazilian CNPJs.

How to use

Configure your MCP client to connect to the CNPJ Intelligence server. You can run the server locally via a standard MCP runtime, or use the provided configuration for Claude Desktop or Cursor to load it as an MCP source.

Once configured, you can perform actions such as looking up cadastral data by CNPJ, retrieving complete company data with ownership and tax regime, listing branches, and searching by name, sector, or region. You can also benchmark, find lookalikes, and generate statistics by state or sector.

Key commands you will use include looking up a specific CNPJ, listing top sectors in a region, and performing advanced searches with multiple filters. The server exposes a set of tools for basic queries, discovery, analysis, benchmarks, and statistics.

How to install

Prerequisites: You need Node.js and npm installed on your system.

Clone the project repository, install dependencies, and run in development mode. Use these commands exactly as shown.

git clone https://github.com/raphaelmarra/mcp-cnpj-intelligence.git
cd mcp-cnpj-intelligence

# Install dependencies
npm install

# Run in development mode
npm run dev

# Run tests
npm test

# Build for production
npm run build

Configuration for MCP clients

To load the MCP server in Claude Desktop, add a server entry to your claude_desktop_config.json with the following configuration.

{
  "mcpServers": {
    "cnpj": {
      "command": "npx",
      "args": ["-y", "mcp-cnpj-intelligence"]
    }
  }
}

Configuration for Cursor / VS Code

To load the MCP server in Cursor or Visual Studio Code, add an MCP server entry to your configuration file.

{
  "mcpServers": {
    "cnpj": {
      "command": "npx",
      "args": ["-y", "mcp-cnpj-intelligence"]
    }
  }
}

Available tools

buscar_empresa

Query cadastral data by CNPJ to retrieve registration details.

empresa_completa

Return full company data including shareholders and tax regime information.

filiais

List all branches of a given company.

socios

Provide the complete board of directors and ownership structure.

regime_tributario

Identify the tax regime (e.g., Simples Nacional, MEI) for a company.

buscar_por_nome

Search by corporate name or trade name.

buscar_por_cnae

Find companies within a specific industry code.

buscar_por_socio

Lookup companies by partner or shareholder name.

buscar_por_cep

Find companies located in a specific postal code region.

buscar_avancado

Perform multi-criteria searches with combined filters.

benchmark_empresa

Compare a company against sector averages.

buscar_similares

Find similar companies using lookalike analysis.

ranking_cnae

Rank the largest companies within a sector by various metrics.

estatisticas_por_uf

Count of companies by state.

estatisticas_por_cnae

Industry sectors with the most companies.

bulk_lookup

Lookup multiple CNPJs in a single request (up to 100).