ZooxEye — PLD & Compliance
Servidor MCP que transforma assistentes de IA em uma ferramenta de due diligence: a partir de um CPF, CNPJ ou nome, consulta bases atualizadas de sanções, processos, PEP, mandados e notícias para análise de risco e prevenção à lavagem de dinheiro no Brasil.
01O que é o ZooxEye PLD
Um agente de compliance acoplado ao seu assistente de IA.
O ZooxEye PLD é um servidor MCP (Model Context Protocol) especializado em Prevenção à Lavagem de Dinheiro (PLD) e compliance. Uma vez conectado a um cliente compatível (como o Claude), ele dá ao assistente acesso a consultas estruturadas de pessoas e empresas brasileiras.
A ideia central: modelos de linguagem não conhecem dados como bases de sanções atualizadas, a lista PEP brasileira, processos judiciais em tempo real ou mandados ativos. O ZooxEye fornece esses dados a partir de fontes oficiais e indexadas — eliminando o risco de respostas inventadas em decisões de compliance.
Para quê serve
02Fontes de dados consultadas
O que o ZooxEye cruza a cada consulta.
Sanções nacionais
Penalidades e listas restritivas aplicadas a pessoas e empresas.
Processos judiciais
Ações como autor e réu, com categorias, estados e status.
Mandados de prisão
Mandados ativos, com órgão expedidor e número do processo.
PEP
Pessoas Expostas Politicamente, incluindo cargos de alto escalão.
Recuperação judicial & falência
Processos ativos e encerrados de empresas.
Dados financeiros
Scores, segmento, patrimônio e classe social (quando disponíveis).
Notícias negativas
Cobertura midiática indexada com score de severidade.
Vínculos societários
Empresas relacionadas, QSA e histórico de pessoas vinculadas.
03Pré-requisitos
- Uma conta ZooxEye ativa com créditos de PLD disponíveis.
- Um cliente MCP compatível — por exemplo, o app Claude (web, desktop ou mobile), Claude Code, ou qualquer cliente que suporte conectores MCP.
- A URL do servidor MCP do ZooxEye PLD e suas credenciais de acesso (fornecidas pela equipe ZooxEye / seu administrador).
04Como conectar
Adicione o conector ao seu cliente MCP em poucos passos.
- Obtenha a URL do servidor. Solicite ao seu administrador ZooxEye a URL do conector PLD e o token/credencial de autenticação.
- Abra os conectores do seu cliente. No Claude, vá em
Configurações → Conectorese escolha Adicionar conector personalizado. - Informe a URL e autentique. Cole a URL do servidor e conclua o fluxo de autenticação solicitado.
- Confirme as ferramentas. Após conectar, as ferramentas com prefixo
pld_*ficam disponíveis para o assistente.
Em clientes que usam configuração por arquivo, a entrada do conector tem este formato.
Informe a URL do conector ZooxEye PLD recebida no campo url:
{
"mcpServers": {
"zooxeye-pld": {
"type": "url",
"url": "URL_DO_CONECTOR_ZOOXEYE_PLD",
"name": "ZooxEye PLD"
}
}
}
05Ferramentas disponíveis
Quatro ferramentas, do mapeamento gratuito à consulta detalhada.
Resolve o documento (CPF/CNPJ) a partir de um nome de pessoa ou razão social. Útil quando você só tem o nome. Desambigua automaticamente: se houver mais de um resultado, o assistente confirma qual é o correto.
Ficha estruturada completa de uma pessoa física: indicadores de risco, sanções, processos, PEP, vínculos empresariais, renda, notícias e mais. É a base de toda análise — inclusive narrativas e perfis comportamentais.
Ficha estruturada completa de uma empresa: situação cadastral, sócios e QSA, processos, recuperação judicial/falência, sanções, notícias e vínculos.
Consulta um datapoint específico que não vem na ficha padrão — FGTS, antecedentes, certidões, frota, Boa Vista, entre outros. Cada addon é cobrado separadamente e sempre confirmado com você antes da execução.
06Como consultar
Basta pedir em linguagem natural. O assistente escolhe a ferramenta certa.
Você não precisa nomear a ferramenta nem informar se é pessoa ou empresa. Mande um CPF, um CNPJ ou um nome acompanhado de uma palavra de consulta de risco (como “risco”, “compliance”, “due diligence”, “verifica”, “analisa”, “perfil”).
Depois da ficha, você pode aprofundar pedindo seções específicas, sem nova cobrança (a ficha já consultada é reaproveitada na mesma sessão):
07Níveis de risco
Toda ficha traz uma classificação geral em escala fixa.
08Indicadores de risco
Cada ficha apresenta os principais indicadores com status e severidade.
| Indicador | Pessoa física (CPF) | Pessoa jurídica (CNPJ) |
|---|---|---|
| Sanções | Sanções nacionais ativas | Sanções aplicadas à empresa |
| Processos judiciais | Como autor e/ou réu | Processos da empresa |
| Mandados de prisão | Mandados ativos | — |
| PEP | Exposição política / alto escalão | Pessoas vinculadas com flag PEP |
| Recuperação / Falência | — | Processos ativos ou encerrados |
| Notícias negativas | Cobertura indexada | Cobertura indexada |
| Restrições / Cadastro | Block list, risco de fronteira | Situação cadastral irregular |
Cada indicador recebe um sinal visual:
09Formatos de resposta
A apresentação se adapta ao que os dados mostram.
Card visual
Para perfis com risco alto/crítico ou grande volume de dados. Traz header, resumo executivo, indicadores e seções condicionais — fácil de escanear.
Resumo em texto
Para perfis limpos, de baixo risco ou sem registros. Header de uma linha, indicadores em lista e um veredito objetivo.
Para perguntas pontuais (“tem processo?”, “está ativo?”) a resposta vem direta, em texto, focada só no que foi perguntado. Se preferir um formato específico, é só pedir — “monta o card” ou “responde em texto” sempre prevalece.
10Créditos & latência
Transparência de custos
| Ferramenta | Custo | Confirmação |
|---|---|---|
pld_find_document_by_name | Gratuita | Não exige aviso |
pld_get_person_details_cpfpld_get_company_details_cnpj | Crédito PLD | Avisado na primeira consulta da sessão |
pld_qualify_addon | Crédito de addon (extra) | Sempre confirmado, por addon |
Tempos de resposta
As fichas detalhadas têm latência variável conforme o volume de histórico do perfil:
| Perfil | Tempo típico |
|---|---|
| Pequeno ou limpo | 3 – 10 segundos |
| Médio (com processos e vínculos) | 15 – 60 segundos |
| Grande (muito histórico) | até ~5 minutos |
11Solução de problemas
Os erros são repassados diretamente da API, sem retry automático.
| Situação | O que significa | O que fazer |
|---|---|---|
| 400 Documento inválido | CPF/CNPJ malformado ou tipo de addon incompatível. | Verifique a contagem de dígitos (CPF = 11, CNPJ = 14). Para addon, use um tipo válido da lista retornada. |
| 404 Sem registros | Não é erro de infraestrutura. O documento não tem registro PLD nas bases. | Trate como “sem registros nas bases consultadas”. Os indicadores ficam ⚪. |
| 503 Serviço indisponível | O backend de PLD está temporariamente fora do ar. | Aguarde alguns minutos e tente novamente. Não há reexecução automática. |
| i “Tool not loaded yet” | Carregamento sob demanda do cliente MCP. | Transparente — o assistente carrega a ferramenta e refaz a consulta sozinho. |
Documento “ambíguo”
Se você enviar um número com uma contagem de dígitos que não seja 11 nem 14, o assistente pede confirmação antes de consultar, para evitar gastar crédito à toa.
Não consigo conectar / sem acesso a um domínio
Verifique a URL e as credenciais com seu administrador ZooxEye. Em ambientes corporativos, configurações de rede podem precisar ser atualizadas por um owner da organização.
12Privacidade & LGPD
O ZooxEye PLD trata dados pessoais sensíveis. Use-o apenas para finalidades legítimas de compliance, KYC e prevenção à lavagem de dinheiro, em conformidade com a LGPD e as políticas da sua organização.
- Documentos são exibidos mascarados nas respostas (ex.: parte do CPF/CNPJ oculta).
- As consultas devem ter base legal adequada para o tratamento de dados pessoais.
- Trate fichas e resultados como informação confidencial.
13Perguntas frequentes
Preciso saber se é CPF ou CNPJ antes de consultar?
Não. O assistente identifica pela contagem de dígitos. Se você só tem o nome,
ele resolve o documento gratuitamente com pld_find_document_by_name antes de prosseguir.
Por que a consulta às vezes demora?
A latência depende do volume de histórico. Perfis com muitos processos e vínculos podem levar de alguns segundos a alguns minutos.
Consultar de novo o mesmo documento cobra outra vez?
Não, dentro da mesma sessão. A ficha já consultada é reaproveitada para aprofundamentos como “detalha os processos”.
404 quer dizer que deu erro?
Não. Significa que não há registros PLD para aquele documento — é um resultado válido, tratado como “sem registros nas bases consultadas”.
O que são os addons?
Datapoints específicos fora da ficha padrão (FGTS, antecedentes, certidões, frota, Boa Vista). São opcionais, cobrados à parte e sempre confirmados antes da consulta.
14Suporte
Para credenciais, créditos, limites de uso ou problemas de conexão, fale com o seu administrador ZooxEye ou com o suporte da plataforma.
Acesso & créditos
Administrador da sua organização na ZooxEye.
Suporte técnico
Canal de suporte da plataforma ZooxEye.