SkillFoxx

radar-cnpj-mcp

MCP server and CLI that find Brazilian companies by CNAE code and region in a local copy of Receita Federal open data.

  • 133 ★ on the repository
  • Last commit
  • MIT
MCP server

Extended access

Why this level

  • Keeps a local database with entrepreneur contacts: MEI phones and emails often belong to individuals.
  • With a cloud agent, query results go to its provider.
All reasons and checks

wendersoon/radar-cnpj-mcpAuthor:wendersoon

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/radar-cnpj-mcp

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • Keeps a local database with entrepreneur contacts: MEI phones and emails often belong to individuals.
  • With a cloud agent, query results go to its provider.

This is third-party code. Review the repository files before installing.

What it does

radar-cnpj-mcp turns the open CNPJ registry of Brazil's tax authority (Receita Federal) into a local database an agent queries in milliseconds. The agent maps a description such as an auto repair shop to a CNAE code, counts companies by state, municipality, district, size or opening year and exports lists to CSV for Excel. There are twelve tools: company search and counts, a CNPJ detail view, a municipality profile, comparison of up to five regions, opening and closing trends and data download. The same queries run from a terminal: `npx radar-cnpj-mcp contar`, `buscar`, `status`.

Who it is for. Analysts, sales people and market researchers in Brazil who need company lists by industry and city without paid databases.

Good fit when

  • You want to know how many auto repair shops operate in Campinas and how many of them are MEIs.
  • A list of clinics or gyms for a district is prepared, with phone numbers and without MEIs.
  • Several cities are compared by the number of companies in one industry.
  • You check whether the number of new companies in an industry grows year by year.

Not a fit when

  • The companies of interest are outside Brazil.
  • Partner and owner details matter, since the database does not import partner data.
  • The list feeds a cold mailing with no way to opt out, which the LGPD law requires.

Example request

How many active auto repair shops are in Campinas? Split them into MEIs and microenterprises and export the list to CSV.

MCP

Transport
stdio
Authentication
not required

Limitations

Before the first query you must download Receita Federal data: about 7 GB even for one state, because the tax authority does not split files by state, plus about 20 GB of free space during processing. According to the README, loading SP and AC took about 33 minutes and the final database weighs 1.9 GB. Each download replaces the current database, so include every state you want to keep. Partner data is not imported. MEI contacts often belong to the person, and the `--ocultar-contatos-mei` flag hides them. If the agent runs in the cloud, query results go to its provider. Node.js 20 or newer is required.

How to disable. Run `claude mcp remove radar-cnpj` or delete the `radar-cnpj` entry from the client configuration. Delete the local database by hand.

FAQ

How do I connect radar-cnpj-mcp to Claude Code?

Run `claude mcp add radar-cnpj -- npx -y radar-cnpj-mcp`. For Cursor, VS Code and Claude Desktop use a `mcpServers` JSON entry with `npx -y radar-cnpj-mcp`.

Where does the data come from?

From the open CNPJ files of Receita Federal. The `baixar` command downloads the latest month and builds a local database; the project itself stores and distributes no data.

Can I download the data through a browser?

Yes. Put `Estabelecimentos*.zip`, `Empresas*.zip`, `Simples.zip`, `Cnaes.zip` and `Municipios.zip` in one folder, then run `npx -y radar-cnpj-mcp importar <folder> --ufs SP,MG`.

How do I hide MEI contacts?

In a terminal add `--ocultar-contatos-mei`; in an agent ask it to hide MEI contacts.

How much disk space is needed?

About 7 GB to download even for one state and about 20 GB of free space during processing. The final database for SP and AC weighs 1.9 GB.

Discussion

No questions or reviews yet.

MCP servers

An MCP server for Brazil's open data: economy, laws, public procurement, courts, elections, environment and more

MCP serverExtended access1.9K
Official

An MCP server for Brazilian public procurement with PNCP and company registry data, no key or signup.

MCP serverMinimal access80

An MCP server that finds and quotes the exact text of over 1.2 million Brazilian legal norms with a link to the official source

MCP serverExtended access66
Official

DataNewton's cloud MCP server: an agent checks Russian companies and sole proprietors by INN and reads finances, courts, links and risks

MCP serverBroad access
Official

DaData official MCP: an agent looks up companies by tax ID, standardizes addresses and identifies a domain or email owner

MCP serverExtended access

README in short

Covers downloading the Receita Federal database, connecting to agents, the twelve tools, terminal commands and a privacy and LGPD section.

README badge

Report a problem