company-investigator-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| UVX_PATH | No | Path to the uvx executable, used by the npx launcher if uvx is not found in PATH. | |
| SEARCH_API_KEY | No | API key for the search provider (e.g., Serper). Enables news, social profiles, LinkedIn, corporate network discovery, and name search. | |
| DATAJUD_API_KEY | No | API key for DataJud to confirm judicial processes by number. | |
| SEARCH_PROVIDER | No | Search provider to use. Defaults to 'serper'. | serper |
| PORTAL_TRANSPARENCIA_API_KEY | No | API 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
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
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.
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.
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.
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.