Skip to main content
Glama
raphaelmarra

MCP CNPJ Intelligence

by raphaelmarra

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

No arguments

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
buscar_empresaA

Busca dados cadastrais de uma empresa brasileira pelo CNPJ.

QUANDO USAR:

  • Voce tem um CNPJ especifico e precisa dos dados cadastrais

  • Precisa validar se um CNPJ existe e esta ativo

  • Quer saber razao social, endereco, CNAE, porte de uma empresa

RETORNA:

  • cnpj, razao_social, nome_fantasia

  • endereco completo (logradouro, municipio, uf, cep)

  • cnae_principal, data_abertura, capital_social

  • situacao_cadastral, porte_empresa

EXEMPLO: { "cnpj": "00000000000191" } (Banco do Brasil)

empresa_completaA

Retorna dados COMPLETOS de uma empresa: cadastro + socios + regime tributario.

QUANDO USAR:

  • Precisa de informacoes detalhadas para due diligence

  • Quer saber quem sao os socios e suas participacoes

  • Precisa verificar se empresa e Simples Nacional ou MEI

RETORNA:

  • Todos os dados de buscar_empresa +

  • Lista de socios com nome, cpf/cnpj, qualificacao

  • Regime tributario: simples_nacional, mei

filiaisA

Lista todas as filiais de uma empresa (mesmo CNPJ base).

QUANDO USAR:

  • Quer mapear a presenca geografica de uma empresa

  • Precisa saber quantas unidades uma empresa tem

RETORNA:

  • Lista de todas filiais com cnpj completo, endereco, situacao

sociosA

Lista o quadro societario completo de uma empresa.

QUANDO USAR:

  • Quer identificar quem sao os donos/socios

  • Precisa do CPF/CNPJ dos socios para outras buscas

RETORNA:

  • Lista de socios com: nome, cpf_cnpj, qualificacao, data_entrada

regime_tributarioA

Verifica regime tributario: Simples Nacional ou MEI.

QUANDO USAR:

  • Precisa saber se empresa pode emitir NF simplificada

  • Quer filtrar empresas por regime

RETORNA:

  • simples_nacional: true/false

  • mei: true/false

  • datas de opcao/exclusao

buscar_por_nomeA

Busca empresas pelo NOME (razao social ou nome fantasia).

QUANDO USAR:

  • Sabe o nome mas nao o CNPJ

  • Quer encontrar todas as unidades de uma rede

PARAMETROS:

  • nome: Termo de busca (minimo 3 caracteres)

  • uf: Filtrar por estado (opcional)

  • limite: Quantidade maxima (padrao: 50)

buscar_por_cnaeA

Lista empresas de um SETOR especifico (por CNAE).

QUANDO USAR:

  • Quer todas empresas de uma atividade economica

  • Prospeccao por vertical/segmento

CNAES COMUNS:

  • 4711302: Supermercados

  • 5611201: Restaurantes

  • 2222600: Embalagens plasticas

  • 4751201: Comercio de informatica

buscar_por_socioA

Busca empresas por NOME DE SOCIO.

QUANDO USAR:

  • Quer encontrar todas empresas de um empresario

  • Precisa mapear portfolio de um investidor

PARAMETROS:

  • nome: Nome do socio (minimo 3 caracteres)

  • uf: Filtrar por estado (opcional)

  • limite: Quantidade maxima (padrao: 50)

buscar_por_cepA

Busca empresas por CEP.

QUANDO USAR:

  • Quer empresas em uma regiao especifica

  • Prospeccao geografica localizada

PARAMETROS:

  • cep: CEP de 8 digitos

  • cnae: Filtrar por CNAE (opcional)

  • situacao: Filtrar por situacao cadastral (padrao: 02=ativas)

  • limite: Quantidade maxima (padrao: 50)

buscar_avancadoA

Busca com MULTIPLOS FILTROS combinados.

QUANDO USAR:

  • Precisa de filtros que outras ferramentas nao oferecem

  • Query complexa combinando varios criterios

FILTROS DISPONIVEIS:

  • cnae, uf, municipio, porte

  • capital_min/capital_max

  • situacao, limite

benchmark_empresaA

Compara empresa com a MEDIA DO SETOR.

QUANDO USAR:

  • Quer saber se empresa esta acima ou abaixo da media

  • Analise comparativa de porte/capital

RETORNA:

  • Dados da empresa

  • Estatisticas do setor (media, mediana, total)

  • Posicao relativa no ranking

buscar_similaresA

Encontra empresas SIMILARES usando scoring multi-dimensional.

QUANDO USAR:

  • Tem um cliente bom e quer encontrar mais parecidos (lookalike)

  • Quer expandir carteira com empresas do mesmo perfil

ALGORITMO DE SIMILARIDADE:

  • Mesmo CNAE (atividade economica)

  • Mesmo porte (capital social similar)

  • Mesma regiao

ranking_cnaeB

RANKING das maiores empresas de um setor.

QUANDO USAR:

  • Quer identificar os lideres de mercado

  • Account-Based Marketing (ABM)

ORDENACAO:

  • capital: Por capital social (padrao)

  • filiais: Por quantidade de unidades

estatisticas_por_ufA

Retorna QUANTIDADE de empresas por estado brasileiro.

QUANDO USAR:

  • Analise de mercado por regiao

  • Priorizando estados para expansao

RETORNA:

  • Lista de UFs com quantidade de empresas ativas

  • Ordenado por quantidade (maior primeiro)

estatisticas_por_cnaeA

Retorna SETORES com mais empresas (ranking de CNAEs).

QUANDO USAR:

  • Identificando mercados maiores

  • Analise de oportunidade por vertical

PARAMETROS:

  • limite: Top N CNAEs (padrao: 20)

bulk_lookupA

Consulta MULTIPLOS CNPJs de uma vez (lote).

QUANDO USAR:

  • Tem uma lista de CNPJs para enriquecer

  • Importando dados de planilha/CRM

LIMITES:

  • Maximo 100 CNPJs por requisicao

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4/5.0

Scored across 16 tools

Disambiguation4/5

Most tools have distinct purposes, such as buscar_empresa for basic company data and empresa_completa for detailed information including shareholders. However, some overlap exists between buscar_avancado and other search tools like buscar_por_cnae or buscar_por_cep, which could cause confusion despite their descriptions clarifying specific use cases.

Naming Consistency4/5

The tool names follow a consistent snake_case pattern throughout, with clear verb_noun structures like buscar_empresa and estatisticas_por_cnae. Minor deviations include benchmark_empresa and bulk_lookup, which slightly break the pattern but are still readable and understandable.

Tool Count4/5

With 16 tools, the count is slightly high but reasonable for a comprehensive CNPJ intelligence server covering various aspects like company lookup, advanced searches, statistics, and shareholder information. It provides a rich feature set without being overwhelmingly excessive.

Completeness5/5

The tool set offers complete coverage for CNPJ intelligence, including basic and advanced company lookups, sector and geographic analyses, shareholder information, benchmarking, and tax regime checks. There are no obvious gaps, and the tools support a full range of business intelligence workflows.

Maintenance

ActivityInactive
ResponsivenessSyncing