​
MCP Server

O Sherlocker disponibiliza um servidor MCP (Model Context Protocol) que permite que agentes de IA como Claude, Cursor, Windsurf e outros clientes compatíveis consultem dados investigativos diretamente.

​
Endpoint remoto

O servidor MCP do Sherlocker esta disponivel na nuvem — nao precisa instalar nada: 
https://mcp.sherlocker.com.br/mcp?token=SEU_TOKEN
Basta conectar seu cliente MCP a essa URL passando seu token de acesso.

​
Conectando no Claude Desktop

1

Abrir configuracoes

No Claude Desktop, va em Settings → Developer → Edit Config (ou edite o arquivo claude_desktop_config.json diretamente).
2

Adicionar o servidor

Adicione a seguinte configuracao no bloco mcpServers:
{
  "mcpServers": {
    "sherlocker": {
      "type": "url",
      "url": "https://mcp.sherlocker.com.br/mcp?token=SEU_TOKEN"
    }
  }
}
Substitua SEU_TOKEN pelo seu token de acesso.
3

Reiniciar o Claude

Feche e reabra o Claude Desktop. O Sherlocker aparecera como servidor MCP conectado.
4

Testar

Envie uma mensagem como:
“Investigue o CPF 12345678900 e me mostre telefones e empresas”
O Claude usara automaticamente as tools do Sherlocker para buscar os dados.

​
Conectando no Claude Code

No terminal, adicione o servidor com o comando: 
claude mcp add sherlocker --transport http "https://mcp.sherlocker.com.br/mcp?token=SEU_TOKEN"
Pronto — o Claude Code ja podera usar as tools do Sherlocker nas suas conversas.

​
Conectando no Cursor

1

Abrir configuracoes MCP

Va em Cursor Settings → MCP → Add new MCP server.
2

Configurar

  • Name: sherlocker
  • Type: http
  • URL: https://mcp.sherlocker.com.br/mcp?token=SEU_TOKEN
3

Salvar e testar

Salve e o Cursor detectara as tools automaticamente. Voce pode pedir ao agente para investigar CPFs e CNPJs diretamente no chat.

​
Tools disponiveis

O servidor MCP expoe 5 tools que os agentes podem chamar:

​
investigar_pessoa

Investiga uma pessoa fisica por CPF. Aceita selecao de modulos especificos ou "todos". 
{
  "cpf": "12345678900",
  "modulos": ["info", "telefones", "empresasSocio"]
}
Modulos disponiveis:
ModuloCustoTempoO que retorna
infogratuito~10sNome, CPF, nascimento, sexo, mae, situacao fiscal
telefones2 tokens~30sNumeros, operadora, WhatsApp, foto do perfil
enderecos2 tokens~10sEnderecos com CEP, foto Street View
emails2 tokens~10sEmails vinculados ao CPF
bancos2 tokens~10sContas bancarias e chaves PIX
documentos2 tokens~10sCertidoes e publicacoes em diarios oficiais
irregularidades2 tokens~30sRestricoes financeiras e pendencias
pessoasRelacionadas2 tokens~60sFamiliares, socios, vizinhos
empresasRelacionadas1 token~30sVinculos empresariais cruzados
empresasSociogratuito~10sEmpresas onde e socio/administrador
relacionamentosgratuito~10sGrafo de parentesco
veiculosgratuito~10sVeiculos registrados
aeronavesgratuito~10sAeronaves e drones (ANAC)
historicoEmpregosgratuito~10sVinculos empregatícios, cargo, salario
dominios1 token~30sDominios de internet registrados
redesSociais5 tokens~3minPerfis em redes sociais
vazamentos5 tokens~30sCredenciais expostas em data breaches
registroEstabelecimentos5 tokens~60sPadroes de consumo
processos17 tokens~2minProcessos judiciais
licitacoes3 tokens~15sParticipacao em licitacoes
dividas5 tokens~5sDivida ativa
protestos4 tokens~5minProtestos em cartorio (CENPROT)
beneficiosGoverno3 tokens~10sBolsa Familia, BPC, Auxilio
propriedadesRurais10 tokens~20sFazendas e terrenos rurais
Comece sempre por info para dados basicos. Use "todos" apenas para investigacao completa — custa ate ~73 tokens e pode levar varios minutos.

​
investigar_empresa

Investiga uma empresa por CNPJ. Mesma logica de selecao de modulos. 
{
  "cnpj": "12345678000100",
  "modulos": ["info", "socios"]
}
Modulos disponiveis: info, socios, funcionariosPat, rendaImpostos, historicoEmpresa, telefones, enderecos, emails, bancos, documentos, irregularidades, dominios, redesSociais, vazamentos, processos, licitacoes, dividas, protestos.
Custo total de todos os modulos de empresa: ~59 tokens.

​
investigar_veiculo

Investiga um veiculo por placa. 
{
  "placa": "ABC1D23",
  "modulos": ["dados", "proprietarios"]
}
Ambos os modulos (dados e proprietarios) sao gratuitos.

​
investigar_email

Busca empresas vinculadas a um email. Gratuito. 
{
  "email": "[email protected]"
}

​
investigar_telefone

Busca empresas vinculadas a um telefone. Gratuito. 
{
  "telefone": "11987654321"
}

​
Formato de resposta

Todas as tools retornam um objeto com results e errors: 
{
  "results": {
    "info": {
      "success": true,
      "results": [
        {
          "name": "Joao da Silva",
          "cpf": "12345678900",
          "birth_date": "1990-01-15"
        }
      ]
    },
    "telefones": {
      "success": true,
      "results": [
        {
          "phone": "11987654321",
          "operator": "Vivo",
          "whatsapp": "success"
        }
      ]
    }
  },
  "errors": {}
}
Quando um modulo falha, o erro aparece no objeto errors: 
{
  "results": { "info": { "..." : "..." } },
  "errors": {
    "processos": {
      "error_code": "insufficient_tokens",
      "message": "Insufficient tokens. Required: 17, Balance: 5",
      "required_tokens": 17,
      "balance": 5
    }
  }
}
Codigo de erroDescricao
insufficient_tokensSaldo insuficiente para o modulo
auth_errorToken invalido ou ausente
timeoutModulo excedeu o limite de tempo
module_exceptionErro interno na execucao
invalid_moduleNome de modulo nao reconhecido

​
Resource: sherlocker://modules

Alem das tools, o servidor MCP expoe um resource sherlocker://modules que contem a referencia completa de todos os modulos — quando usar cada um, campos retornados, custo e tempo estimado. Agentes inteligentes consultam esse resource automaticamente para decidir quais modulos usar.

​
Rodando localmente (opcional)

Se preferir rodar o servidor MCP na sua maquina em vez de usar o endpoint remoto: 
# Via npx (sem instalar)
npx @sherlocker/sdk sherlocker mcp stdio

# Ou via HTTP local
npx @sherlocker/sdk sherlocker mcp http --port 3100
Para o modo stdio, configure no Claude Desktop: 
{
  "mcpServers": {
    "sherlocker": {
      "command": "npx",
      "args": ["@sherlocker/sdk", "sherlocker", "mcp", "stdio"],
      "env": {
        "SHERLOCKER_TOKEN": "SEU_TOKEN"
      }
    }
  }
}

​
Exemplos de uso com agentes

Depois de conectar, basta pedir ao agente em linguagem natural:
  • “Investigue o CPF 12345678900 — quero saber nome, telefones e se tem empresas”
  • “Faca uma due diligence completa do CNPJ 12345678000100”
  • “Descubra quem e o dono da placa ABC1D23”
  • “Busque empresas vinculadas ao email [email protected]”
  • “Faca um background check completo dessa pessoa: CPF 12345678900”
O agente selecionara automaticamente os modulos mais relevantes para cada solicitacao.