Brazil CNPJ company registry

Working · 2.5 s

io.github.bnovarini/cnpj-mcpv0.1.0

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

Legal & Government

Source Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://cnpj-mcp.fly.dev/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

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.

ufstring

cepstring

limitinteger

numerostring

offsetinteger

situacaostring

municipiostring

logradouro_containsstring

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (8)

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.

Argument	Type	Description
uf	any
cep	any
limit	integer
numero	any
offset	integer
situacao	any
municipio	any
logradouro_contains	any

Input schema (JSON)

{
  "type": "object",
  "title": "companies_at_addressArguments",
  "properties": {
    "uf": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Uf",
      "default": null
    },
    "cep": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Cep",
      "default": null
    },
    "limit": {
      "type": "integer",
      "title": "Limit",
      "default": 50
    },
    "numero": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Numero",
      "default": null
    },
    "offset": {
      "type": "integer",
      "title": "Offset",
      "default": 0
    },
    "situacao": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Situacao",
      "default": "ativa"
    },
    "municipio": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Municipio",
      "default": null
    },
    "logradouro_contains": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Logradouro Contains",
      "default": null
    }
  }
}

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 (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.

Argument	Type	Description
uf	any
cep	any
mei	any
cnae	any
unit	string
limit	integer

dataset_info

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

No arguments.

Input schema (JSON)

{
  "type": "object",
  "title": "dataset_infoArguments",
  "properties": {}
}

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.

Argument	Type	Description
cnpj*	string

Input schema (JSON)

{
  "type": "object",
  "title": "get_companyArguments",
  "required": [
    "cnpj"
  ],
  "properties": {
    "cnpj": {
      "type": "string",
      "title": "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.

Argument	Type	Description
cnpj*	string

Input schema (JSON)

{
  "type": "object",
  "title": "list_partnersArguments",
  "required": [
    "cnpj"
  ],
  "properties": {
    "cnpj": {
      "type": "string",
      "title": "Cnpj"
    }
  }
}

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.

Argument	Type	Description
kind*	string
text*	string
limit	integer

Input schema (JSON)

{
  "type": "object",
  "title": "lookup_codesArguments",
  "required": [
    "kind",
    "text"
  ],
  "properties": {
    "kind": {
      "type": "string",
      "title": "Kind"
    },
    "text": {
      "type": "string",
      "title": "Text"
    },
    "limit": {
      "type": "integer",
      "title": "Limit",
      "default": 25
    }
  }
}

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, 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.

Argument	Type	Description
uf	any

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.

Argument	Type	Description
uf	any
name*	string
limit	integer
offset	integer
contains	boolean
cpf_middle	any

Input schema (JSON)

{
  "type": "object",
  "title": "search_partnersArguments",
  "required": [
    "name"
  ],
  "properties": {
    "uf": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Uf",
      "default": null
    },
    "name": {
      "type": "string",
      "title": "Name"
    },
    "limit": {
      "type": "integer",
      "title": "Limit",
      "default": 25
    },
    "offset": {
      "type": "integer",
      "title": "Offset",
      "default": 0
    },
    "contains": {
      "type": "boolean",
      "title": "Contains",
      "default": false
    },
    "cpf_middle": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Cpf Middle",
      "default": null
    }
  }
}

{ "type": "object", "title": "count_companiesArguments", "properties": { "uf": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Uf", "default": null }, "cep": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Cep", "default": null }, "mei": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Mei", "default": null }, "cnae": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ], "title": "Cnae", "default": null }, "unit": { "type": "string", "title": "Unit", "default": "estabelecimentos" }, "limit": { "type": "integer", "title": "Limit", "default": 25 }, "order": { "type": "string", "title": "Order", "default": "count_desc" }, "porte": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Porte", "default": null }, "metric": { "type": "string", "title": "Metric", "default": "count" }, "simples": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Simples", "default": null }, "group_by": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ], "title": "Group By", "default": null }, "situacao": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Situacao", "default": null }, "closed_to": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Closed To", "default": null }, "municipio": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Municipio", "default": null }, "opened_to": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Opened To", "default": null }, "cnae_secao": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Cnae Secao", "default": null }, "capital_max": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Capital Max", "default": null }, "capital_min": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Capital Min", "default": null }, "closed_from": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Closed From", "default": null }, "matriz_only": { "type": "boolean", "title": "Matriz Only", "default": false }, "opened_from": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Opened From", "default": null }, "partner_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Partner Name", "default": null }, "name_contains": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name Contains", "default": null }, "municipio_codigo": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Municipio Codigo", "default": null }, "include_secondary": { "type": "boolean", "title": "Include Secondary", "default": false }, "natureza_juridica": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Natureza Juridica", "default": null } } }

{ "type": "object", "title": "search_companiesArguments", "properties": { "uf": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Uf", "default": null }, "cep": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Cep", "default": null }, "mei": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Mei", "default": null }, "cnae": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ], "title": "Cnae", "default": null }, "limit": { "type": "integer", "title": "Limit", "default": 25 }, "porte": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Porte", "default": null }, "offset": { "type": "integer", "title": "Offset", "default": 0 }, "simples": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Simples", "default": null }, "order_by": { "type": "string", "title": "Order By", "default": "data_inicio_atividade" }, "situacao": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Situacao", "default": null }, "closed_to": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Closed To", "default": null }, "municipio": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Municipio", "default": null }, "opened_to": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Opened To", "default": null }, "cnae_secao": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Cnae Secao", "default": null }, "capital_max": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Capital Max", "default": null }, "capital_min": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Capital Min", "default": null }, "closed_from": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Closed From", "default": null }, "matriz_only": { "type": "boolean", "title": "Matriz Only", "default": false }, "opened_from": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Opened From", "default": null }, "partner_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Partner Name", "default": null }, "name_contains": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name Contains", "default": null }, "include_contacts": { "type": "boolean", "title": "Include Contacts", "default": false }, "municipio_codigo": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Municipio Codigo", "default": null }, "include_secondary": { "type": "boolean", "title": "Include Secondary", "default": false }, "min_contact_score": { "anyOf": [ { "type": "integer" }, { "type": "string" }, { "type": "null" } ], "title": "Min Contact Score", "default": null }, "natureza_juridica": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Natureza Juridica", "default": null } } }