Documentação do MCP Zoox Compliance / PLD


ZooxEye PLD & Compliance — Documentação do MCP
Documentação · Model Context Protocol

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.

Due diligence KYC Análise de risco Prevenção à lavagem de dinheiro Sanções & PEP

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

Due diligence de CPF/CNPJ KYC (Know Your Customer) Onboarding de clientes Triagem de fornecedores Monitoramento de risco Investigação de vínculos societários

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.

+
Addons opcionais: datapoints específicos sob demanda, como FGTS, antecedentes, certidões, frota de veículos e Boa Vista. Cobrados à parte e sempre confirmados antes da consulta.

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.

  1. Obtenha a URL do servidor. Solicite ao seu administrador ZooxEye a URL do conector PLD e o token/credencial de autenticação.
  2. Abra os conectores do seu cliente. No Claude, vá em Configurações → Conectores e escolha Adicionar conector personalizado.
  3. Informe a URL e autentique. Cole a URL do servidor e conclua o fluxo de autenticação solicitado.
  4. 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"
    }
  }
}
i
Carregamento sob demanda (deferred tools): em alguns clientes (como o claude.ai web), quando há muitos conectores, as ferramentas só são carregadas no primeiro uso. Isso é transparente — o assistente carrega a ferramenta e prossegue com a consulta automaticamente. Você não precisa fazer nada.

05Ferramentas disponíveis

Quatro ferramentas, do mapeamento gratuito à consulta detalhada.

pld_find_document_by_name Gratuita

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.

Entrada: nomeCusto: não consome créditoLatência: ~2–3 s
pld_get_person_details_cpf Pessoa física Consome crédito PLD

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.

Entrada: CPF (11 dígitos)Custo: 1 crédito PLDLatência: variável (ver abaixo)
pld_get_company_details_cnpj Pessoa jurídica Consome crédito PLD

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.

Entrada: CNPJ (14 dígitos)Custo: 1 crédito PLDLatência: variável (ver abaixo)
pld_qualify_addon Addon · opt-in Crédito extra

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.

Entrada: documento + tipo de addonCusto: crédito de addonLatência: variável

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”).

“Faz uma due diligence do CPF 123.456.789-00.”
“Analisa o risco de compliance do CNPJ 12.345.678/0001-99.”
“Verifica a Construtora Exemplo Ltda para KYC.”
“Traz o perfil de risco do João da Silva.”

Depois da ficha, você pode aprofundar pedindo seções específicas, sem nova cobrança (a ficha já consultada é reaproveitada na mesma sessão):

“Detalha os processos.” · “Aprofunda o PEP.” · “Detalha as notícias negativas.”
i
Documentos com máscara são aceitos normalmente — pode mandar com pontos, traços e barras. O assistente limpa a formatação antes de consultar.

07Níveis de risco

Toda ficha traz uma classificação geral em escala fixa.

🟢 BAIXO0 – 20Sem alertas relevantes nas bases consultadas.
🟡 MODERADO21 – 50Indicadores em atenção que merecem revisão.
🟠 ALTO51 – 80Risco consolidado relevante — recomenda-se validação.
🔴 CRÍTICO> 80Alertas graves — recomenda-se monitoramento ou bloqueio.

08Indicadores de risco

Cada ficha apresenta os principais indicadores com status e severidade.

IndicadorPessoa física (CPF)Pessoa jurídica (CNPJ)
SançõesSanções nacionais ativasSanções aplicadas à empresa
Processos judiciaisComo autor e/ou réuProcessos da empresa
Mandados de prisãoMandados ativos
PEPExposição política / alto escalãoPessoas vinculadas com flag PEP
Recuperação / FalênciaProcessos ativos ou encerrados
Notícias negativasCobertura indexadaCobertura indexada
Restrições / CadastroBlock list, risco de fronteiraSituação cadastral irregular

Cada indicador recebe um sinal visual:

⚪ Sem dado 🟢 Limpo 🟡 Atenção (1–50) 🔴 Alto (51–100)

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

FerramentaCustoConfirmação
pld_find_document_by_nameGratuitaNão exige aviso
pld_get_person_details_cpf
pld_get_company_details_cnpj
Crédito PLDAvisado na primeira consulta da sessão
pld_qualify_addonCrédito de addon (extra)Sempre confirmado, por addon
i
Reconsultar o mesmo documento na mesma sessão não gera nova cobrança — a ficha já consultada é reaproveitada para aprofundamentos.

Tempos de resposta

As fichas detalhadas têm latência variável conforme o volume de histórico do perfil:

PerfilTempo típico
Pequeno ou limpo3 – 10 segundos
Médio (com processos e vínculos)15 – 60 segundos
Grande (muito histórico)até ~5 minutos
!
Perfis grandes podem levar minutos — não significa que travou. O assistente avisa quando a consulta pode demorar.

11Solução de problemas

Os erros são repassados diretamente da API, sem retry automático.

SituaçãoO que significaO que fazer
400 Documento inválidoCPF/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 registrosNã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ívelO 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.
Os dados retornados apoiam decisões de compliance, mas não substituem a análise humana. Decisões de alto impacto (bloqueio, recusa de onboarding) devem passar por validação manual.

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.

ZooxEye — PLD & Compliance · Documentação do conector MCP.