io.github.bnovarini/cnpj-mcp · v0.1.0 · data-and-databases
Brazil CNPJ company registry is healthy: it completed an MCP handshake in 882 ms and exposes 8 tools.
Brazil's open CNPJ registry: filter and count companies by sector, place, size, MEI, partners.
Endpoint: https://cnpj-mcp.fly.dev/mcp (streamable-http)
Repository · JSON · Add to my inventory
| Users (last 30 days) | 0 |
| Handshake | Healthy |
| Auth needed | None |
| Tool count | 8 |
| Latency | 882 ms |
| Last checked (UTC) | 2026-10-16T06:55:37.639Z |
| Checked (UTC) | Status | Latency | Error |
|---|---|---|---|
| 2026-10-16T06:55:37.639Z | Healthy | 882 | |
| 2026-10-15T03:05:37.724Z | Healthy | 2752 |
dataset_info | What data is loaded: source, snapshot month, row counts, field meanings and caveats. Call first if unsure what the tools cover. |
search_companies | Find companies/establishments matching filters. Filters (all optional, combined with AND): cnae (CNAE code or prefix, e.g. '4711' or '47', list ok; add include_secondary to also match secondary activities), cnae_secao (letter A-U), uf, municipio (name as in Receita, accents ignored), municipio_codig |
count_companies | Count companies or establishments, optionally grouped by one or two fields. Filters (all optional, combined with AND): cnae (CNAE code or prefix, e.g. '4711' or '47', list ok; add include_secondary to also match secondary activities), cnae_secao (letter A-U), uf, municipio (name as in Receita, accen |
get_company | One company by CNPJ (14 digits, with or without punctuation; or the 8-digit root to get the matriz): registration, company data, Simples/MEI, address and contacts, secondary CNAEs, partners (with names), and how many establishments the company has. |
list_partners | Partners (socios) of one company by CNPJ root or full CNPJ: names, type, role (qualificacao), entry date, age band. CPFs are masked by Receita. faixa_etaria: 1 = 0-12, 2 = 13-20, 3 = 21-30, 4 = 31-40, 5 = 41-50, 6 = 51-60, 7 = 61-70, 8 = 71-80, 9 = over 80, 0 = not applicable. |
search_partners | Find the companies a person or entity is a partner of, by name. Exact (accent-insensitive, case-insensitive) match on the partner name by default; set contains=true for a substring match. Optionally narrow with cpf_middle (the 6 digits Receita publishes, e.g. '240659') because the same name can belo |
companies_at_address | Establishments registered at one address, by CEP (8 digits), optionally narrowed by street text, number, municipio or uf. Use it to find companies sharing an address. |
lookup_codes | Look up Receita's code tables by text or code. kind: cnae (activity), natureza_juridica (legal form), municipio, motivo (reason for status), qualificacao (partner role), pais. Use it to find the CNAE code for a sector, or the municipio name Receita uses, before filtering. |