Skip to main content
Glama

Brazil CNPJ company registry

Server Details

Brazil's open CNPJ registry: filter and count companies by sector, place, size, MEI, partners.

If you are the author of this connector, you can claim ownership. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Uptime
100.0% over the last 24 hours
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
Repository
bnovarini/cnpj-mcp
GitHub Stars
0
ChatGPT
–
Claude
–

TDQS

A3.8/5.0

Scored across 8 tools

Disambiguation4/5

Most tools target a distinct resource+action: get_company (single CNPJ), search_companies (filtered list), count_companies (aggregates), list_partners (company→people), search_partners (person→companies), lookup_codes (reference tables), dataset_info (metadata). Two overlaps remain: companies_at_address largely duplicates search_companies with a 'cep' filter, and list_partners vs search_partners are inverse queries that the names alone don't clarify. Descriptions disambiguate the partner pair reasonably well, but the address tool feels like a redundant narrowing of search_companies.

Naming Consistency4/5

All names are snake_case and the majority follow verb_noun (count_companies, get_company, list_partners, lookup_codes, search_companies, search_partners). Two deviate into bare noun phrases (dataset_info, companies_at_address), which is a minor inconsistency rather than a confusing one. The pattern is still predictable enough for an agent to guess names.

Tool Count5/5

Eight tools is well within the sweet spot for a read-only registry API. Each tool maps to a meaningful query mode (lookup, search, count, partners, codes, metadata) with no filler tools. The surface is broad without bloating.

Completeness4/5

Coverage is strong for a read-only domain: single-record lookup, filtered search with pagination and ordering, aggregation with group_by, partner traversal in both directions, code-table resolution and dataset metadata. Minor gaps: name-based company search requires name_contains plus a uf, so there is no standalone fuzzy/exact company-name lookup, and no batch/multi-CNPJ retrieval. These are workaroundable but would be hit in practice.

Available Tools

8 tools
companies_at_addressBInspect

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.

Inputs: uf, cep, limit, numero, +4 more. Returns: result

count_companiesAInspect

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 (micro = ME, pequeno = EPP, demais, nao_informado), natureza_juridica (code prefix like '2062' or text like 'sociedade limitada'), capital_min/capital_max (BRL), opened_from/opened_to (data_inicio_atividade, YYYY-MM or YYYY-MM-DD), closed_from/closed_to (data da baixa), mei, simples (true/false), name_contains (razao social or nome fantasia; 3-256 characters and uf required), cep, partner_name (a partner's name contains this text). group_by options: uf, municipio, cnae_principal, cnae_divisao, cnae_secao, natureza_juridica, porte, situacao, ano_abertura, mes_abertura, ano_baixa, mes_baixa, mei, simples, matriz_filial, motivo_situacao. unit='estabelecimentos' (default) counts every CNPJ incl. filiais; unit='empresas' counts companies (matriz only). metric='sum_capital' sums declared capital social (BRL, companies only). Examples: MEIs opened per month in a state, active agro companies per municipality, closures by year.

Inputs: uf, cep, mei, cnae, +22 more. Returns: result

dataset_infoAInspect

What data is loaded: source, snapshot month, row counts, field meanings and caveats. Call first if unsure what the tools cover.

Inputs: no named parameters.

get_companyAInspect

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.

Inputs: cnpj (required).

list_partnersAInspect

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.

Inputs: cnpj (required). Returns: result

lookup_codesAInspect

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. CNAE text returns ranked candidates using exact descriptions, curated everyday aliases, word matches and spelling suggestions. Read match_type, match_note and every official description; ambiguous terms are not an automatic classification. Numeric codes/prefixes keep the original lookup. Other tables use literal text. Use this before sector or municipio filtering.

Inputs: kind (required), text (required), limit. Returns: result

search_companiesAInspect

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, demais, nao_informado), natureza_juridica (code prefix like '2062' or text like 'sociedade limitada'), capital_min/capital_max (BRL), opened_from/opened_to (data_inicio_atividade, YYYY-MM or YYYY-MM-DD), closed_from/closed_to (data da baixa), mei, simples (true/false), name_contains (razao social or nome fantasia; 3-256 characters and uf required), cep, partner_name (a partner's name contains this text). Returns up to 100 rows per page, ordered by opening date (newest first) unless order_by is capital_social or razao_social. Use count_companies for 'how many' questions. Set include_contacts to add email, phones, full address and a registry_contact_quality block (0-100 score of how likely the REGISTERED email/phone from Receita is a real direct contact, with the signals behind it; it says nothing about the website) and, when the company's own website was crawled, a separate website_contacts block (WhatsApp, phones, emails, social profiles found on its public pages, each with source_url). A whatsapp_business block appears only when a WhatsApp Business account was found on one of the registered phones (display name, account type, name_match score, checked_at); phones are checked in the background after a query shows them, so a result can appear on a later call, and its absence says nothing about whether the number is on WhatsApp. min_contact_score keeps only companies whose REGISTERED contact (the email and phones on the Receita record, not the website) scores at or above it. Pass an integer 0-100, or a tier name: 'high' = 85, 'medium' = 50, 'low' = 0 (e.g. min_contact_score=50 or 'medium' for medium and high). The filter is applied after the page is read, so a call scans at most 2000 candidates and returns pagination.next_offset to continue.

Inputs: uf, cep, mei, cnae, +22 more.

search_partnersAInspect

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.

Inputs: name (required), uf, limit, offset, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      B
      maintenance
      Enables querying Brazil's official CNPJ company registry data, counting and listing establishments by municipality, state, CNAE activity, size, or status, with caveats about official dump limitations such as non-IBGE municipality codes and secondary activities.
      4
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents and terminal users to search, count, detail, and export Brazilian companies by CNAE, region, and other filters using local Receita Federal CNPJ open data.
      12
      118 npm
      134
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables lookup and validation of Brazilian companies by CNPJ, returning registration status, address, CNAE activities, Simples Nacional/MEI status, and partners from monthly Receita Federal open data, plus validation of numeric or alphanumeric CNPJ check digits and search of active companies by activity and municipality.
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables users to look up Brazilian companies by CNPJ and retrieve registry details such as status, size, capital, CNAE activities, address, phones, Simples/MEI, tax regime, and optional partner or administrator records.
      1
      681 npm
      MIT
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.