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

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
buscar_empresa

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_completa

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

filiais

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

socios

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_tributario

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_nome

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_cnae

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_socio

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_cep

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_avancado

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_empresa

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_similares

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_cnae

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_uf

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_cnae

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_lookup

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

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/raphaelmarra/mcp-cnpj-intelligence'

If you have feedback or need assistance with the MCP directory API, please join our Discord server