Skip to main content
Glama

Fichário — CNPJ Brasil

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.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "uf": "<uf>"
    },
    "name": "busca_avancada"
  }
}

Input Schema

NameRequiredDescriptionDefault
ufYes
cvmNotodas = qualquer companhia com registro na CVM (ativo ou cancelado); ativa = só registro ativo. Cada resultado traz cvm {situacao_registro}. Aí cnae é opcional
cnaeNoCNAE principal, 7 dígitos (opcional se informar UF + cidade)
ordemNopadrão capital_desc; só UF + cidade sem cnae: vale em cidades de até 10.000 empresas, nas maiores sai por atividade com aviso
porteNoME, EPP ou Demais (vírgula para vários)
cidadeNoNome do município; com UF dispensa o cnae
paginaNo
regimeNoRegime: simples (sem MEI), mei, outros (fora do Simples)
listadaNotrue = só companhias abertas listadas: negociou na B3 em 52 semanas ou tem registro ATIVO na CVM (aí cnae é opcional)
situacaoNopadrão ativa; inapta/baixada/suspensa/nula exigem UF + cidade e ignoram os demais filtros (aviso no resultado); todas = ativas + contagens por situação
tem_siteNo
e_commerceNoSó empresas com loja virtual (carrinho de e-commerce detectado no site; pós-filtro sobre amostra de candidatas, total aproximado; MEI/EI sempre excluídos)
plataformaNoPlataforma de e-commerce do site (implica e_commerce): vtex, shopify, nuvemshop, tray, lojaintegrada, woocommerce, magento, wix, stores, bagy, yampi, vnda, jet, wake, opencart, prestashop, salesforce, linx, irroba, xtech, mercadoshops, bigcommerce, squarespace
por_paginaNo
abertura_deNoAberta a partir de (AAAA, AAAA-MM ou AAAA-MM-DD)
capital_maxNo
capital_minNo
abertura_ateNoAberta até (AAAA, AAAA-MM ou AAAA-MM-DD)
tem_telefoneNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

A3.9/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden and discloses the read/list nature, refusal conditions, ignored filters with an aviso, approximate site-filter totals, MEI/EI exclusions, a 50-page cap, and free limits. It remains vague about actual rate limits/auth and does not fully describe pagination behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Packs many necessary rules into one long run-on paragraph with nested parentheses and some repeated points (site-result fields, MEI/EI exclusion). The purpose is front-loaded, but the density makes the definition hard to scan.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given 19 parameters, no output schema, and no annotations, the description covers main outputs and special-case returns plus many filtering caveats. It still leaves several filters and the pagination parameter less explained, so it is not fully complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Adds substantial meaning beyond the schema: CNAE is optional with cidade, ordering behavior depends on city size, situacao has special output and ignores other filters, plataforma implies e_commerce, and faixa_receita_estimada is derived from porte. Some parameters (cvm, regime, tem_telefone, abertura dates) are left to the schema or undescribed, and '20 por página' sits awkwardly with the por_pagina enum.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

Opens with 'Lista empresas por UF...' — a specific verb and resource — and describes the filtering scope (UF, CNAE, cidade). It does not explicitly distinguish itself from sibling lookup tools such as buscar_empresa or consultar_cnpj, so it is clear but not sibling-differentiated.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives explicit parameter-combination rules: only UF is refused, UF + cidade works without CNAE, order is ignored above 10,000 companies with a warning, situacao requires city, and site filters are post-filters. These are strong usage constraints, but no alternative tool is named.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources