Brazil CNPJ company registry
Brazil's open CNPJ registry: filter and count companies by sector, place, size, MEI, partners.
| Endpoint | https://cnpj-mcp.fly.dev/mcp (streamable-http) |
|---|---|
| Registry version | 0.1.0 |
| Now | 8 tools · grade C (67) · pin ts_3d4894be90615e7b726c808a1673b3f3 · protocol 2025-06-18 |
| First / last listed | 2026-10-26 02:59 UTC / 2026-10-26 02:59 UTC |
| Grade over time | 2026-10-26: C (67), 8 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: dataset_info search_companies count_companies get_company list_partners search_partners companies_at_address lookup_codes
dataset_info | What data is loaded: source, snapshot month, row counts, field meanings and caveats. Call first if unsure what the tools cover. params: none |
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_codigo, situacao (ativa, baixada, suspensa, inapta, nula), matriz_only, porte (micro = ME, pequeno = EPP, params: cnae, cnae_secao, include_secondary, uf, municipio, municipio_codigo, situacao, matriz_only, porte, natureza_juridica, capital_min, capital_max, opened_from, opened_to, closed_from, closed_to, mei, simples, name_contains, cep, partner_name, order_by, include_contacts, min_contact_score, limit, offset |
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, accents ignored), municipio_codigo, situacao (ativa, baixada, suspensa, inapta, nula), matriz_only, porte params: group_by, unit, metric, cnae, cnae_secao, include_secondary, uf, municipio, municipio_codigo, situacao, matriz_only, porte, natureza_juridica, capital_min, capital_max, opened_from, opened_to, closed_from, closed_to, mei, simples, name_contains, cep, partner_name, order, limit |
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. params: cnpj* |
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. params: cnpj* |
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 (uf required). Optionally narrow with cpf_middle (the 6 digits Receita publishes, e.g. '240659') because the same name can belong to different people. Returns company name, status and role. params: name*, contains, cpf_middle, uf, limit, offset |
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. params: cep, logradouro_contains, numero, municipio, uf, situacao, limit, offset |
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. params: kind*, text*, limit |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.