API e servidor MCP

Grátis. Fonte: dados abertos do CNPJ da Receita Federal, base 2026-10 (campo fonte em cada JSON; header X-Fichario-Base).

Limites

• Grátis (por IP): 60 req/min e 3.000 req/dia; CNDT/DJEN 6/min e 40/dia
• Plus (R$ 100/mês): 600/min e 30.000/dia — header Authorization: Bearer fch_live_…
• Estouro grátis → HTTP 429 com links de upgrade, ou HTTP 402 (x402/USDC na Base) se o cliente pedir pagamento

Ver preços e assinar Pro · Suporte (+55 21 99598-8404)

Não faça loop de milhares de CNPJs. Para volume enterprise, fale no WhatsApp de suporte.

REST

GET https://fichario.app/api/v1/cnpj/07396951000170
GET https://fichario.app/api/v1/busca?q=petrobras
GET https://fichario.app/api/v1/busca?q=padaria&uf=SC&cidade=Blumenau

A busca casa o começo do nome fantasia (ou da razão social, quando não há fantasia), sem acento e sem diferença de maiúsculas. Toda resposta traz fonte.base.

Busca avançada

GET https://fichario.app/api/v1/busca-avancada?cnae=4781400&uf=SC&cidade=Blumenau&porte=ME&capital_min=0&capital_max=100000&ordem=capital_desc&por_pagina=25&pagina=1
GET https://fichario.app/api/v1/busca-avancada?cnae=4781400&uf=SC&formato=csv
GET https://fichario.app/api/v1/busca-avancada?uf=SP&listada=1
GET https://fichario.app/api/v1/busca-avancada?uf=SP&plataforma=shopify
GET https://fichario.app/api/v1/busca-avancada?uf=SP&fornecedor_governo=1&ordem=contratos_desc

UF é obrigatória, mais CNAE principal (7 dígitos) ou plataforma/e_commerce=1 (lojas virtuais, sem CNAE, total exato, sem MEI/EI; ordem por capital, abertura ou nome; filtros extras pagamento, pixel, marketplace, logistica (código único, ex.: pagamento=pix) e com_marketplace=1; cada loja traz plataforma, pagamentos, pixels, marketplaces, logistica, produtos, preco_min, preco_max, plataforma_anterior e mudou_em, também no CSV/XLSX) ou cidade (só UF + cidade funciona, sem CNAE: ordem por razão social, até 50 páginas; só UF sem cidade nem CNAE é recusado); porte (ME, EPP, Demais; vírgula para vários) e faixa de capital social são opcionais. situacao=ativa|inapta|baixada|suspensa|nula|todas (padrão ativa): inapta/baixada/suspensa/nula exigem UF + cidade e devolvem cnpj, razao_social, situacao, data_situacao, motivo_situacao, matriz e url (sem MEI/EI, telefone, e-mail ou endereço; os demais filtros são ignorados e o campo aviso informa); todas = ativas + contagens_por_situacao da cidade. 20 por página (até 50 páginas), total exato até 10.000. CSV grátis: até 1.000 linhas por exportação e 10 exportações/hora por IP (Pro: 5.000 linhas e 100/hora); headers X-Fichario-Export-*. Telefone/e-mail de empresário individual e MEI ficam ocultos (LGPD, coluna contato_oculto). MCP: exportar_lista. A Receita não publica faturamento: faixa_receita_estimada vem do porte (ME até R$ 360 mil/ano, EPP até R$ 4,8 mi). listada=1: só companhias abertas listadas (negociou na B3 em 52 semanas ou registro ativo na CVM; aí o CNAE é opcional); cvm=todas ou cvm=ativa: companhias com registro na CVM (cada resultado traz cvm: {situacao_registro}); ficha CVM com receita e lucro (DFP/ITR): GET /api/v1/cnpj/{cnpj}/cvm; cada resultado listado traz b3: {tickers, nome_pregao, setor} e o CSV ganha a coluna b3_tickers. Página: /busca-avancada. MCP: busca_avancada. Agentes com navegador (sem MCP): /agentes.

MCP (agentes de IA)

Endereço do servidor (transporte HTTP): https://fichario.app/mcp. Ferramentas: buscar_empresa, consultar_cnpj, busca_avancada, dados_cvm, listar_concorrentes, dados_bolsa, publicacoes_judiciais. Limites e base da Receita vêm na descrição de cada ferramenta e em fonte no resultado.

{
  "mcpServers": {
    "fichario": { "url": "https://fichario.app/mcp" }
  }
}

curl -s https://fichario.app/mcp -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"consultar_cnpj","arguments":{"cnpj":"07396951000170"}}}'