Fairquery Agent Trust MCP

Redaçao de PII/segredos, validação de e-mail, triagem de sanções e verificações de vulnerabilidades de dependências OSV para agentes de IA. Ferramentas locais gratuitas, além de ferramentas avançadas opcionais pagas com suporte da Apify.

GitHub

Documentação

Fairquery Agent Trust & Data Safety (servidor MCP)

Um servidor MCP para agentes de IA que lidam com dados não confiáveis. Ele cobre quatro tarefas:

Redação de PII e segredos: verifica o texto antes de chegar a um LLM.
Verificações de e-mail: sintaxe, erros de digitação, endereços descartáveis e de função, além de MX/SPF/DMARC na ferramenta paga.
Triagem de sanções: listas OFAC, UE, Reino Unido e ONU.
Vulnerabilidades de dependências: consultas ao OSV.dev.

As ferramentas gratuitas não precisam de token ou conta e rodam na sua máquina. As ferramentas pagas são opcionais. Elas chamam os Apify Actors públicos da Fairquery com seu próprio APIFY_TOKEN, e as execuções são cobradas na sua conta Apify.

Ferramentas

Ferramenta	Custo	O que faz
`pii_list_detectors`	Grátis (local)	Catálogo de detectores, estilos de redação e preços de cada ferramenta paga
`pii_scan_text`	Grátis (local)	Encontra PII e segredos em texto. Os resultados são paginados e mostram apenas valores mascarados
`pii_redact_text`	Grátis (local)	Redige com estilo de placeholder, máscara ou hash. Pode retornar um mapa de placeholders
`pii_guard_documents`	$0,0015/doc + $0,0002/achado	Adiciona nomes/endereços NER, URLs e PDFs, e modo de restauração
`email_check_syntax`	Grátis (local)	Sintaxe, normalização, sugestões de erros de digitação, sinalizadores de descartável/função/provedor gratuito
`email_validate_deliverability`	$0,00079/e-mail	DNS/MX, MX nulo, SPF/DMARC, provedor de e-mail, veredito
`sanctions_list_sources`	Grátis (local)	Lista cobertas, autoridades emissoras, aviso legal
`sanctions_screen_names`	$0,003/nome + $0,007/chamada	Triagem difusa contra OFAC SDN/Consolidado, UE, Reino Unido e ONU
`osv_query_packages`	Grátis (api.osv.dev)	Vulnerável ou não, além de IDs de avisos, para até 200 versões exatas
`osv_get_vulnerability`	Grátis (api.osv.dev)	Registros completos de avisos OSV
`osv_audit_dependencies`	$0,0005/pacote + $0,0015/vuln	Auditoria de manifesto/lockfile com gravidade, correções e versão recomendada
`trust_screen_lead`	$0,00079/e-mail + $0,003/nome + $0,007/chamada	Verificação de e-mail e triagem de sanções em paralelo, mescladas em uma decisão de aprovar/revisar/bloquear por lead

Cada descrição de ferramenta tem seções WHAT / WHEN / WHEN NOT / COST / RETURNS / EXAMPLE. As saídas são paginadas (limit, offset, nextOffset, hasMore). Erros usam códigos nomeados: APIFY_TOKEN_MISSING, APIFY_TOKEN_INVALID, APIFY_PAYMENT_REQUIRED, APIFY_ACTOR_RUN_FAILED, APIFY_TIMEOUT, INPUT_EMPTY, INPUT_TOO_LARGE, INVALID_ECOSYSTEM, OSV_FETCH_FAILED e VULN_NOT_FOUND.

As ferramentas pagas usam estes Apify Actors: fairquery/llm-data-guard-pii-secrets, fairquery/email-validator-mx-disposable, fairquery/sanctions-watchlist-screener e fairquery/osv-dependency-vulnerability-check.

Quando usar qual ferramenta

Você quer…	Use	Custo
Verificar um prompt, ticket ou log para PII e segredos antes de chegar a um LLM	`pii_scan_text`, depois `pii_redact_text`	Grátis, local
Também capturar nomes e endereços, escanear PDFs ou URLs, ou restaurar placeholders após a resposta do LLM	`pii_guard_documents`	Pago
Capturar erros de digitação, endereços descartáveis ou de função em um formulário de cadastro	`email_check_syntax`	Grátis, local
Verificar se o domínio de um e-mail pode receber mensagens (MX, MX nulo, SPF/DMARC)	`email_validate_deliverability`	Pago
Ver quais listas de sanções são cobertas e o aviso legal	`sanctions_list_sources`	Grátis, local
Triar pessoas ou empresas contra listas de sanções OFAC, UE, Reino Unido e ONU	`sanctions_screen_names`	Pago
Obter uma decisão de aprovar/revisar/bloquear para um novo lead (e-mail e nome juntos)	`trust_screen_lead`	Pago
Descobrir se versões exatas de pacotes têm vulnerabilidades conhecidas	`osv_query_packages`, depois `osv_get_vulnerability` para detalhes	Grátis (api.osv.dev)
Auditar um manifesto ou lockfile inteiro com gravidade, correções e versões recomendadas	`osv_audit_dependencies`	Pago

Comece com as ferramentas gratuitas. Use uma ferramenta paga apenas quando precisar do que ela adiciona; cada chamada paga executa um Apify Actor cobrado no seu próprio token.

Instalação

Requer Node.js 20 ou posterior. APIFY_TOKEN é opcional e só é necessário para ferramentas pagas. Obtenha um em https://console.apify.com/settings/integrations.

Início rápido (stdio):

npx -y @fairquery/agent-trust-mcp

As configurações abaixo executam o pacote npm com npx -y: sem necessidade de clone ou etapa de build.

Claude Desktop (`claude_desktop_config.json`)

{
  "mcpServers": {
    "fairquery-trust": {
      "command": "npx",
      "args": ["-y", "@fairquery/agent-trust-mcp"],
      "env": { "APIFY_TOKEN": "<optional-your-apify-token>" }
    }
  }
}

Cursor (`~/.cursor/mcp.json` ou `.cursor/mcp.json`)

{
  "mcpServers": {
    "fairquery-trust": {
      "command": "npx",
      "args": ["-y", "@fairquery/agent-trust-mcp"],
      "env": { "APIFY_TOKEN": "<optional-your-apify-token>" }
    }
  }
}

VS Code (`.vscode/mcp.json`)

{
  "inputs": [{ "type": "promptString", "id": "apify-token", "description": "Apify token (optional, paid tools only)", "password": true }],
  "servers": {
    "fairquery-trust": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@fairquery/agent-trust-mcp"],
      "env": { "APIFY_TOKEN": "${input:apify-token}" }
    }
  }
}

A partir do código-fonte / Docker

git clone https://github.com/fairquery/fairquery-agent-trust-mcp && cd fairquery-agent-trust-mcp
npm ci && npm run build && node dist/index.js            # stdio
node dist/index.js --http                                # Streamable HTTP on http://127.0.0.1:3000/mcp (PORT, HOST env)
docker build -t fairquery-trust-mcp . && docker run -i --rm -e APIFY_TOKEN fairquery-trust-mcp

Testes

npm run smoke        # initialize + tools/list + guide/annotation checks, no token
npm run test:live    # every free tool live, ReDoS probes, paid tools without token -> APIFY_TOKEN_MISSING
npm run test:paid    # also ONE paid call per family using APIFY_TOKEN from env (costs < $0.02)

Segurança

Consulte SECURITY.md. As ferramentas gratuitas nunca entram em contato com Apify ou Fairquery, e o código não contém segredos.

Aviso legal

Os resultados de sanções vêm de correspondência difusa automatizada e não são um serviço de triagem certificado. Revise cada possível correspondência você mesmo. As verificações de e-mail não sondam caixas de correio SMTP.