# Brazil CNPJ company registry

Connects Brazil's open federal business registry to your AI assistant. Ideal for bulk market research, counting registrations, and mapping corporate partners.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6
- Author: bnovarini
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/bnovarini/cnpj-mcp
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/brazil-cnpj-company-registry

## What it does

This server interfaces with monthly open records from Receita Federal, combining establishments, partners, and Simples or MEI tax flags into typed Parquet datasets. Standard public APIs handle single-record lookups without trouble. Instead, this MCP server focuses on analytical bulk queries: tracking business openings across states, filtering by CNAE industry codes, and finding companies sharing an address.

It computes a contact quality score from 0 to 100 based on corporate domains and phone configurations, filtering out generic accounting addresses. It can also deliver details harvested from verified company sites, including direct WhatsApp lines. Since around half of all entries in the dump are closed entities, working with live businesses requires an explicit filter on the `situacao` status.

You can query the hosted HTTP endpoint or build the dataset locally. Running local ingestion demands `curl` and `unzip` inside your `PATH`, while the final build step requires about 20 GB of free drive space for sorting.

## Requirements
- Remote server: `https://cnpj-mcp.fly.dev/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http cnpj-mcp https://cnpj-mcp.fly.dev/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add brazil-cnpj-company-registry --url https://cnpj-mcp.fly.dev/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "brazil-cnpj-company-registry": {
            "url": "https://cnpj-mcp.fly.dev/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "brazil-cnpj-company-registry": {
            "type": "http",
            "url": "https://cnpj-mcp.fly.dev/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http brazil-cnpj-company-registry https://cnpj-mcp.fly.dev/mcp
```

## When to use it
- aggregate Brazilian company formations by region and CNAE sector
- identify businesses registered at the exact same location
- separate direct business phones from shared accountant contacts
- retrieve corporate partners and linked company owners

## Example prompts
- Count how many MEI records were registered in Minas Gerais each month since 2023.
- List active grain companies in Mato Grosso with high contact reliability scores.
- Check which firms share this specific address and retrieve their partners.

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16730
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40459
- [dbx](https://affpapa.org/en/nevibecode/mcp/dbx.md) — MCP server · ★ 27844
- [Metabase](https://affpapa.org/en/nevibecode/mcp/metabase.md) — MCP server · ★ 49863

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md