# Brazil CNPJ company registry

Подключает базу открытых данных юрлиц Бразилии к ассистенту. Помогает собирать аналитику по отраслям, искать совладельцев и проверять контакты компаний.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6
- Автор: bnovarini
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/bnovarini/cnpj-mcp
- Обновлён: 2026-10-21
- HTML: https://affpapa.org/nevibecode/mcp/brazil-cnpj-company-registry

## Что делает

Сервер обрабатывает открытый реестр Receita Federal, объединяя данные компаний, филиалов, партнёров и налогового режима Simples/MEI в таблицы Parquet. Обычные публичные API закрывают разовые проверки номеров. Этот инструмент спроектирован для массовой аналитики: подсчёта открытых или закрытых фирм по штатам, группировки по отраслевым кодам CNAE и поиска организаций с общим адресом.

Для оценки актуальности данных система рассчитывает рейтинг контактов от 0 до 100, сопоставляя корпоративные домены и телефонные номера. Это помогает отсекать адреса внешних бухгалтеров. Сервер также может подгружать контакты, найденные краулером на официальных сайтах компаний. Около половины записей в реестре относятся к ликвидированным предприятиям, поэтому для среза по работающему бизнесу обязателен фильтр по статусу `situacao`.

Запустить сервер можно через готовый удалённый HTTP-эндпоинт либо локально. Для самостоятельной загрузки и сборки данных понадобятся утилиты `curl` и `unzip` в системном пути, а для этапа сортировки потребуется около 20 ГБ свободного места на диске.

## Требования
- Удалённый сервер: `https://cnpj-mcp.fly.dev/mcp`

## Установка

### Claude Code (родная платформа)

**Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http cnpj-mcp https://cnpj-mcp.fly.dev/mcp
```

### Codex

**Командой платформы: удалённый сервер**
```bash
codex mcp add brazil-cnpj-company-registry --url https://cnpj-mcp.fly.dev/mcp
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "brazil-cnpj-company-registry": {
            "url": "https://cnpj-mcp.fly.dev/mcp"
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "brazil-cnpj-company-registry": {
            "type": "http",
            "url": "https://cnpj-mcp.fly.dev/mcp"
        }
    }
}
```

### Gemini CLI

**Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http brazil-cnpj-company-registry https://cnpj-mcp.fly.dev/mcp
```

## Когда брать
- отфильтровать открытые компании Бразилии по коду CNAE и региону
- найти предприятия, зарегистрированные по одному юридическому адресу
- проверить достоверность контактов фирмы по рейтингу качества
- составить список партнёров и совладельцев бизнеса

## Примеры запросов агенту
- Посчитай, сколько компаний со статусом MEI регистрировалось в штате Minas Gerais каждый месяц с 2023 года.
- Найди работающие агропредприятия в Mato Grosso с высоким рейтингом контактов.
- Покажи все организации по данному адресу и выведи имена их совладельцев.

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

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
