Skip to main content
Glama
CalebePrates

company-investigator-mcp

by CalebePrates

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
UVX_PATHNoPath to the uvx executable, used by the npx launcher if uvx is not found in PATH.
SEARCH_API_KEYNoAPI key for the search provider (e.g., Serper). Enables news, social profiles, LinkedIn, corporate network discovery, and name search.
DATAJUD_API_KEYNoAPI key for DataJud to confirm judicial processes by number.
SEARCH_PROVIDERNoSearch provider to use. Defaults to 'serper'.serper
PORTAL_TRANSPARENCIA_API_KEYNoAPI key for Portal da Transparência for official PEP verification.

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
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
pingA

Verifica se o servidor MCP esta operante.

buscar_empresaA

Busca dados cadastrais reais de uma empresa a partir do CNPJ, consultando a BrasilAPI (fonte publica e oficial de dados de CNPJ da Receita Federal). Parametro 'cnpj' (string, obrigatorio): aceita com ou sem pontuacao, por exemplo '12.345.678/0001-90' ou '12345678000190'. Retorna um objeto com 'cnpj' (normalizado, apenas digitos), 'razao_social', 'nome_fantasia' e 'situacao'. Erros possiveis: CNPJ vazio, com letras, com quantidade errada de digitos, com digitos verificadores matematicamente invalidos, falha ao consultar a BrasilAPI, ou CNPJ valido porem sem empresa cadastrada.

buscar_informacoes_publicasA

Abre uma URL publica com um navegador headless e extrai informacoes basicas da pagina: titulo e texto visivel. Nao interage com formularios nem executa acoes na pagina, apenas le o conteudo apos o carregamento. Parametro 'url' (string, obrigatorio): precisa ser uma URL http/https valida e publicamente acessivel. Retorna um objeto com 'url', 'titulo' (pode ser nulo se a pagina nao tiver a tag ou ela estiver vazia) e 'texto' (texto visivel extraido da pagina, sem scripts/estilos). Erros possiveis: URL invalida, timeout ao carregar a pagina, ou falha de navegacao.

investigar_empresaA

Investiga uma empresa a partir de um CNPJ ou de um nome (razao social/nome fantasia), combinando dados cadastrais oficiais (BrasilAPI) com buscas publicas (via uma Search API) por noticias, perfis em redes sociais (LinkedIn, Instagram, Facebook, YouTube, X/Twitter, TikTok), pessoas-chave no LinkedIn, processos judiciais publicos, rede societaria (outras empresas dos socios) e verificacao de PEP. Parametro 'identificador' (string, obrigatorio): um CNPJ (com ou sem pontuacao) ou um nome de empresa. Parametro 'profundidade' (inteiro, padrao 1, maximo 2): quantos niveis de 'socio -> nova empresa' sao expandidos; 0 investiga so a empresa pedida. IMPORTANTE: esta tool NAO devolve os dados completos da investigacao — ela coleta e guarda tudo, e devolve um INDICE pequeno: um 'investigation_id' e, para cada secao (socios, noticias, empresas_relacionadas, processos, peps, etc.), quantos itens existem. Nenhum dado e descartado; para ler o conteudo de uma secao (com todos os seus itens, paginado se for grande), use a tool 'obter_secao_investigacao' com esse investigation_id, ou o resource MCP 'investigation://{investigation_id}/{secao}'. Empresas relacionadas tambem tem sua propria sub-investigacao completa, acessivel pelo investigation_id que aparece dentro da secao 'empresas_relacionadas' — percorra recursivamente para ver 100% da rede.

obter_secao_investigacaoA

Recupera o conteudo completo (paginado) de UMA secao de uma investigacao criada por 'investigar_empresa', usando o 'investigation_id' que essa tool devolveu. Nenhum dado e descartado: percorrendo todas as paginas de uma secao (veja 'total_paginas' na resposta) voce chega a 100% do que foi coletado. Parametro 'secao' (obrigatorio), uma das: empresa, candidatos, socios, pessoas_chave, linkedin, redes_sociais, noticias, contatos, processos_confirmados, processos_referencias, processos_status, movimentos_processuais, fontes, empresas_relacionadas, pessoas_relacionadas, relacionamentos, possiveis_relacoes_familiares, peps, limitacoes. Para a secao 'empresas_relacionadas', cada item traz seu proprio 'investigation_id' — use-o para percorrer a sub-investigacao completa daquela empresa relacionada (recursivamente, se ela tambem tiver empresas relacionadas). Os movimentos de cada processo confirmado ficam na secao 'movimentos_processuais' (cada item traz o 'numero_processo'), nao dentro de 'processos_confirmados'. Parametros 'pagina' (padrao 1) e 'tamanho_pagina' (padrao 20, maximo 50) controlam a paginacao. Erro se o investigation_id nao existir (ou tiver expirado da memoria do servidor) ou a secao for invalida.

obter_indice_investigacaoA

Recupera novamente o indice (resumo estrutural) de uma investigacao ja criada por 'investigar_empresa', usando seu 'investigation_id'. Util para re-consultar quantos itens cada secao tem sem precisar refazer a investigacao. Erro se o investigation_id nao existir.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4.1/5.0

Scored across 6 tools

Disambiguation4/5

Most tools have clearly distinct purposes, but buscar_empresa (single CNPJ lookup) overlaps with investigar_empresa, which also fetches cadastral data. The obter_indice_investigacao vs obter_secao_investigacao pair is related but the descriptions clearly differentiate index vs section retrieval, so an agent can pick correctly.

Naming Consistency4/5

Tools follow a consistent Portuguese verb_noun pattern (buscar_*, obter_*, investigar_*), which is predictable and readable. The lone exception is 'ping', an English outlier, though it is a conventional health-check verb.

Tool Count5/5

Six tools is well-scoped for a company-investigation server. Each tool (health check, CNPJ lookup, URL fetch, run investigation, fetch index, fetch section) earns its place without redundancy.

Completeness4/5

The investigation lifecycle is well covered: start an investigation, retrieve its index, and page through any section. Minor gaps exist, such as no tool to list previously created investigations or clean them up, but core workflows have no dead ends.

Maintenance

ActivityMaintained
ResponsivenessNo issues