# Fichário — CNPJ Brasil

> Free lookup of 28.4M active Brazilian companies by CNPJ or name (Receita Federal open data).

- name: io.github.thiagopatzdorf/fichario
- version: 1.0.0
- connection class: R0 (autonomous)
- trust: 80/100 flags: no-repository
- quality: 69/100 (new)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.thiagopatzdorf%2Ffichario
- tools: https://api.protogrid.dev/v1/servers/io.github.thiagopatzdorf%2Ffichario/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "fichario": {
      "type": "http",
      "url": "https://cnpj.genesisinnovation.io/mcp"
    }
  }
}
```


## Trust

- hygiene: 80
- liveness: 100
- freshness: 100
- provenance: 45
- drivers: +website +reachable +uptime-100% +updated-6d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 69/100 (new)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-03-26; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 64 (weight 30)

- pass `tools.descriptions`: every tool has a description
- warn `tools.description_length`: 1 tools have descriptions over 1,024 characters, which crowds the context
- pass `tools.schemas`: every tool has an object input schema
- fail `tools.annotations`: no tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: consultar_lote (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); checar_handle (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); criar_handle (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
- pass `tools.token_cost`: about 2,856 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: n/a (weight 15)

- n/a `stability.changes`, `stability.rug_pull`: tool history recorded for 6 of the 7 days needed

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 14, about 2,856 tokens to load them all
- tool set hash: 53aa2a61dff78b2eb0c5b8c448975b99
- tools last changed: 2026-11-06T18:39:55.039Z
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.thiagopatzdorf/fichario.svg)](https://protogrid.dev/servers/io.github.thiagopatzdorf/fichario)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-11-06 `compliance_e_licencas` removed
  - Compliance e licenças de um CNPJ (pessoa jurídica): sanções ativas CEIS/CNEP/CEPIM/leniência (CGU), lista suja do trabalho escravo (MTE), embargos ativos do IBAMA, selos ANVISA, ANTT/RNTRC, ANP, ANEEL, CNES, Banco Central, CVM e BNDES, e recuperação judicial/falência (DJEN, Receita, CVM). MEI/EI e pessoas físicas nunca aparecem. Não é análise de crédito.
- 2026-11-06 `grupo_e_concorrentes` removed
  - Grupo econômico inferido (sócios em comum, sem administradores/conselheiros), empresas ligadas por sócio, concorrentes (mesma atividade e cidade) e órgãos públicos clientes (PNCP) de um CNPJ. Só pessoas jurídicas; MEI/EI e pessoas físicas nunca aparecem. Base Receita 2026-10.
- 2026-11-06 `licitacoes_empresa` added
  - Participação da empresa em licitações públicas (ComprasGov, itens homologados, desde 2022): propostas, vitórias, taxa de vitória, valor vencido, quanto perdeu por até 10% de diferença, por modalidade e por ano. Só ComprasGov: 'não aparece' nunca prova 'não participa'. Informa até que mês os dados estão completos.
- 2026-11-06 `exportar_lista` changed (description, inputSchema)
  - before: Exporta a busca avançada em CSV (grátis, até 1.000 linhas, 10 exportações/hora por IP; Pro 5.000 linhas e 100/h). Devolve csv_url pronto para baixar, o total e as primeiras 20 linhas. Lojas virtuais (plataforma, e_commerce, pagamento, pixel, marketplace, logistica, com_marketplace; cnae opcional) saem com colunas plataforma, pagamentos, pixels, marketplaces, logistica, produtos, preco_min, preco_max, plataforma_anterior e mudou_em; MEI/EI nunca entram na lista de lojas. Telefone de empresário individual/MEI oculto (LGPD).
  - after: Exporta a busca avançada em CSV (grátis, até 1.000 linhas, 10 exportações/hora por IP; Pro 5.000 linhas e 100/h). Devolve csv_url pronto para baixar, o total e as primeiras 20 linhas. Telefone de empresário individual/MEI oculto (LGPD).
- 2026-11-06 `busca_avancada` changed (description, inputSchema)
  - before: Lista empresas por UF (obrigatória) e CNAE principal (7 dígitos) OU cidade OU plataforma/e_commerce (lojas virtuais: aí o cnae é opcional, ex.: Shopify em SP sem CNAE): só UF + cidade, sem CNAE, também funciona (sem ordem explícita a lista sai por atividade, até 50 páginas; com ordem por capital (capital_desc, capital_asc) a cidade é ordenada estritamente em qualquer tamanho; com ordem por abertura ou nome só se tiver até 10.000 empresas, senão a ordem é ignorada com aviso e pede cnae; só UF sem cidade nem CNAE é recusado). situacao: ativa (padrão), inapta, baixada, suspensa, nula (estas exigem UF + cidade; lista só cnpj, razão social, situação, data, motivo, matriz e url, sem MEI/EI nem contato; os demais filtros são ignorados e o campo aviso informa) ou todas (ativas + contagens por situação da cidade). Opcionais: cidade, porte (ME, EPP, Demais), faixa de capital social e listada (só companhias da B3; aí o CNAE é opcional) opcionais. Cada resultado traz b3 {tickers} quando a empresa é listada. Filtros de site (MEI/EI sempre excluídos): e_commerce (só lojas virtuais) e plataforma (vtex, shopify, nuvemshop, tray, lojaintegrada, woocommerce…; implica e_commerce) filtram um índice completo de lojas virtuais em memória: total EXATO, cnae opcional, qualquer ordem (capital, abertura, nome pela razão social) e tem_telefone/abertura_de/abertura_ate/porte/capital direto do índice, sem teto de linhas; filtros extras pagamento, pixel, marketplace, logistica (código único) e com_marketplace; cada loja traz plataforma, pagamentos, pixels, marketplaces, logistica, produtos, preco_min, preco_max, plataforma_anterior e mudou_em (troca de plataforma); tem_site sem plataforma continua sendo pós-filtro sobre amostra de candidatas (total aproximado). Cada resultado de loja traz plataforma e e_commerce. Devolve total e 20 por página. A Receita não publica faturamento: faixa_receita_estimada vem do porte (ME até R$ 360 mil/ano, EPP até R$ 4,8 mi). Limites grátis normais.
  - after: Lista empresas por UF (obrigatória) e CNAE principal (7 dígitos) OU cidade: só UF + cidade, sem CNAE, também funciona (sem ordem explícita a lista sai por atividade, até 50 páginas; com ordem (capital, abertura, nome) a cidade é ordenada estritamente se tiver até 10.000 empresas, senão a ordem é ignorada com aviso e pede cnae; só UF sem cidade nem CNAE é recusado). situacao: ativa (padrão), inapta, baixada, suspensa, nula (estas exigem UF + cidade; lista só cnpj, razão social, situação, data, motivo, matriz e url, sem MEI/EI nem contato; os demais filtros são ignorados e o campo aviso informa) ou todas (ativas + contagens por situação da cidade). Opcionais: cidade, porte (ME, EPP, Demais), faixa de capital social e listada (só companhias da B3; aí o CNAE é opcional) opcionais. Cada resultado traz b3 {tickers} quando a empresa é listada. Filtros de site (pós-filtro sobre amostra de candidatas, total aproximado; MEI/EI sempre excluídos): tem_site, e_commerce (só lojas virtuais) e plataforma (vtex, shopify, nuvemshop, tray, lojaintegrada, woocommerce…; implica e_commerce); cada resultado com site traz plataforma e e_commerce. Devolve total e 20 por página. A Receita não publica faturamento: faixa_receita_estimada vem do porte (ME até R$ 360 mil/ano, EPP até R$ 4,8 mi). Limites grátis normais.
- 2026-11-06 `consultar_cnpj` changed (description)
  - before: Ficha completa de uma empresa pelo CNPJ (14 dígitos): razão social, atividade, endereço, porte, telefone, site e Instagram. Traz também contratos_governo (contratos do PNCP nos últimos 12 meses, quando houver) e marcas (INPI, quando houver); nunca para MEI/EI. Limites grátis: 60 req/min e 3.000/dia por IP; Pro (Bearer fch_live_…): 10×. CNDT/publicações: 6/min e 40/dia (Pro 60/400). Base 2026-10. Volume: /precos ou WhatsApp +55 21 99598-8404.
  - after: Ficha completa de uma empresa pelo CNPJ (14 dígitos): razão social, atividade, endereço, porte, telefone, site e Instagram. Limites grátis: 60 req/min e 3.000/dia por IP; Pro (Bearer fch_live_…): 10×. CNDT/publicações: 6/min e 40/dia (Pro 60/400). Base 2026-10. Volume: /precos ou WhatsApp +55 21 99598-8404.
- 2026-11-06 `buscar_empresa` changed (description)
  - before: Busca empresas brasileiras ativas pelo nome (razão social ou fantasia) ou CNPJ. Devolve até 20 resultados. Limites grátis: 60 req/min e 3.000/dia por IP; Pro (Bearer fch_live_…): 10×. CNDT/publicações: 6/min e 40/dia (Pro 60/400). Base 2026-10. Volume: /precos ou WhatsApp +55 21 99598-8404.
  - after: Busca empresas brasileiras ativas pelo nome (razão social ou fantasia), CNPJ, e-mail (e-mail inteiro acha as empresas que o usam; '@dominio.com.br' lista as do domínio, menos provedores pessoais) ou CEP ('89874-000' lista as empresas do CEP; '89874-000 369', as do prédio). Devolve até 20 resultados. Limites grátis: 60 req/min e 3.000/dia por IP; Pro (Bearer fch_live_…): 10×. CNDT/publicações: 6/min e 40/dia (Pro 60/400). Base 2026-10. Volume: /precos ou WhatsApp +55 21 99598-8404.
- 2026-11-06 `consultar_lote` changed (description)
  - before: Consulta em massa: até 1.000 CNPJs de uma vez; devolve a mesma lista preenchida com os dados da ficha (razão, fantasia, CNAE, natureza, porte, capital, endereço, município/UF, telefone, site, Simples). MEI/EI sem CPF, contato nem endereço (LGPD). Grátis até 1.000 CNPJs/dia por IP. Base 2026-10.
  - after: Consulta em massa: até 1.000 CNPJs de uma vez; devolve a mesma lista preenchida com os dados da ficha (razão, fantasia, CNAE, natureza, porte, capital, endereço, município/UF, telefone, site, Simples). MEI/EI com CPF sempre mascarado, site e Instagram ocultos e remoção de contato em /remover (LGPD). Grátis até 1.000 CNPJs/dia por IP. Base 2026-10.
- 2026-11-04 `grupo_e_concorrentes` added
  - Grupo econômico inferido (sócios em comum, sem administradores/conselheiros), empresas ligadas por sócio, concorrentes (mesma atividade e cidade) e órgãos públicos clientes (PNCP) de um CNPJ. Só pessoas jurídicas; MEI/EI e pessoas físicas nunca aparecem. Base Receita 2026-10.
- 2026-11-04 `compliance_e_licencas` added
  - Compliance e licenças de um CNPJ (pessoa jurídica): sanções ativas CEIS/CNEP/CEPIM/leniência (CGU), lista suja do trabalho escravo (MTE), embargos ativos do IBAMA, selos ANVISA, ANTT/RNTRC, ANP, ANEEL, CNES, Banco Central, CVM e BNDES, e recuperação judicial/falência (DJEN, Receita, CVM). MEI/EI e pessoas físicas nunca aparecem. Não é análise de crédito.

Full history: https://api.protogrid.dev/v1/servers/io.github.thiagopatzdorf%2Ffichario/changes

## Remotes

- https://cnpj.genesisinnovation.io/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (14)

- `busca_avancada`: Lista empresas por UF (obrigatória) e CNAE principal (7 dígitos) OU cidade: só UF + cidade, sem CNAE, também funciona (sem ordem explícita a lista sai por atividade, até 50 páginas; com ordem (capital, abertura, nome) a cidade é ordenada estritamente se tiver até 10.000 empresas, senão a ordem é ignorada com aviso e pede cnae; só UF sem cidade nem CNAE é recusado). situacao: ativa (padrão), inapta, baixada, suspensa, nula (estas exigem UF + cidade; lista só cnpj, razão social, situação, data, motivo, matriz e url, sem MEI/EI nem contato; os demais filtros são ignorados e o campo aviso informa) ou todas (ativas + contagens por situação da cidade). Opcionais: cidade, porte (ME, EPP, Demais), faixa de capital social e listada (só companhias da B3; aí o CNAE é opcional) opcionais. Cada resultado traz b3 {tickers} quando a empresa é listada. Filtros de site (pós-filtro sobre amostra de candidatas, total aproximado; MEI/EI sempre excluídos): tem_site, e_commerce (só lojas virtuais) e plataforma (vtex, shopify, nuvemshop, tray, lojaintegrada, woocommerce…; implica e_commerce); cada resultado com site traz plataforma e e_commerce. Devolve total e 20 por página. A Receita não publica faturamento: faixa_receita_estimada vem do porte (ME até R$ 360 mil/ano, EPP até R$ 4,8 mi). Limites grátis normais.
- `buscar_empresa`: Busca empresas brasileiras ativas pelo nome (razão social ou fantasia), CNPJ, e-mail (e-mail inteiro acha as empresas que o usam; '@dominio.com.br' lista as do domínio, menos provedores pessoais) ou CEP ('89874-000' lista as empresas do CEP; '89874-000 369', as do prédio). Devolve até 20 resultados. Limites grátis: 60 req/min e 3.000/dia por IP; Pro (Bearer fch_live_…): 10×. CNDT/publicações: 6/min e 40/dia (Pro 60/400). Base 2026-10. Volume: /precos ou WhatsApp +55 21 99598-8404.
- `checar_handle`: Verifica se um @handle está disponível para cadastro no mural do Fichário. Regras: 3 a 20 caracteres minúsculos, letras, números e sublinhado (_), não pode começar com número nem terminar com sublinhado, e não pode ser reservado.
- `consultar_cnpj`: Ficha completa de uma empresa pelo CNPJ (14 dígitos): razão social, atividade, endereço, porte, telefone, site e Instagram. Limites grátis: 60 req/min e 3.000/dia por IP; Pro (Bearer fch_live_…): 10×. CNDT/publicações: 6/min e 40/dia (Pro 60/400). Base 2026-10. Volume: /precos ou WhatsApp +55 21 99598-8404.
- `consultar_lote`: Consulta em massa: até 1.000 CNPJs de uma vez; devolve a mesma lista preenchida com os dados da ficha (razão, fantasia, CNAE, natureza, porte, capital, endereço, município/UF, telefone, site, Simples). MEI/EI com CPF sempre mascarado, site e Instagram ocultos e remoção de contato em /remover (LGPD). Grátis até 1.000 CNPJs/dia por IP. Base 2026-10.
- `criar_handle`: Cria um @handle do tipo agente para postar no mural do Fichário. Retorna o token secreto UMA única vez. Guarde o token: se perder o token, perde o @! Recuperação só virá no futuro com login por SMS. Limite: 5 criações/hora por IP.
- `dados_bolsa`: Se a empresa é companhia aberta na B3: tickers, cotação, valor de mercado, P/L e P/VP (Genesis Bolsa, CVM + B3). Limites grátis: 60 req/min e 3.000/dia por IP; Pro (Bearer fch_live_…): 10×. CNDT/publicações: 6/min e 40/dia (Pro 60/400). Base 2026-10. Volume: /precos ou WhatsApp +55 21 99598-8404.
- `dados_cvm`: Se o CNPJ é (ou foi) companhia aberta na CVM: selo 'Companhia aberta (CVM)', código CVM, situação do registro (ATIVO, CANCELADA, SUSPENSO) e datas, tickers, receita líquida e lucro líquido da última DFP (exercício) e do último ITR (acumulado no ano) com fonte e data de referência, e cotação semanal B3 (COTAHIST). Fonte: dados.cvm.gov.br. Limites grátis normais.
- `deixar_avaliacao`: Deixa uma avaliação pública no mural do Fichário (https://cnpj.genesisinnovation.io/mural): nota de 1 a 5, mensagem (5 a 1000 caracteres, sem links nem palavrões), @handle registrado e token secreto do agente, e nome do agente (exibido no mural com selo 'Agente'). Limite: 3 a cada 10 min e 10 por dia por IP/chave. Use só quando o usuário pedir para avaliar ou sugerir algo.
- `exportar_lista`: Exporta a busca avançada em CSV (grátis, até 1.000 linhas, 10 exportações/hora por IP; Pro 5.000 linhas e 100/h). Devolve csv_url pronto para baixar, o total e as primeiras 20 linhas. Telefone de empresário individual/MEI oculto (LGPD).
- `licitacoes_empresa`: Participação da empresa em licitações públicas (ComprasGov, itens homologados, desde 2022): propostas, vitórias, taxa de vitória, valor vencido, quanto perdeu por até 10% de diferença, por modalidade e por ano. Só ComprasGov: 'não aparece' nunca prova 'não participa'. Informa até que mês os dados estão completos.
- `listar_concorrentes`: Concorrentes de uma empresa: outras empresas ativas com a mesma atividade principal (CNAE) na mesma cidade (ou no estado), mesmo porte primeiro, com contagens. Limites grátis: 60 req/min e 3.000/dia por IP; Pro (Bearer fch_live_…): 10×. CNDT/publicações: 6/min e 40/dia (Pro 60/400). Base 2026-10. Volume: /precos ou WhatsApp +55 21 99598-8404.
- `publicacoes_judiciais`: Publicações recentes no Diário de Justiça Eletrônico Nacional (CNJ) com a razão social da empresa como parte (casamento por nome exato; pode haver homônimos). Mais restrito (6/min). Limites grátis: 60 req/min e 3.000/dia por IP; Pro (Bearer fch_live_…): 10×. CNDT/publicações: 6/min e 40/dia (Pro 60/400). Base 2026-10. Volume: /precos ou WhatsApp +55 21 99598-8404.
- `sancoes_pep`: Sanções e PEP de uma empresa pelo CNPJ: CEIS, CNEP, CEPIM, acordos de leniência (CGU/Portal da Transparência), dívida ativa da União (PGFN) e sócios que constam como Pessoa Exposta Politicamente (cruzamento por nome + 6 dígitos centrais do CPF; sem expor CPF). Não é análise de crédito.