Verifex sanctions screening

Verifex 制裁筛查 — MCP 服务

一个 Model Context Protocol 服务，可让 AI 助手通过 Verifex 筛查个人或公司、读取过往筛查记录，并获取筛查的 Evidence Capsule — 关于已检查内容和发现结果的审计记录。

• 使用你自己的 Verifex API 密钥。筛查费用计入你现有的 Verifex 套餐。
• 仅向 Verifex 发送姓名、类型（个人或公司）、国家/地区和出生日期。
• 无运行时依赖。Node.js 18.17 或更高版本。通过 stdio 在本地运行。

结果说明

每条结果都以状态行开头，接着是范围，然后是 Verifex API 返回的完整结果。状态遵循 Verifex 自己返回的决定（verdict）；此服务只会添加警示，不会移除警示。

状态行	含义
Potential match — review required	在已检查的名单中至少有一个候选对象，或某个匹配因你的套餐不包含其名单而被暂缓显示。这不是判定：需要由人工决定。
No potential match in the lists checked	Verifex 返回了明确决定，且在下方列出的名单中没有发现结果。这并不表示该对象未出现在任何其他名单中。
Screening incomplete — do not treat as clear	未发现匹配对象，但 Verifex 不会将结果视为已通过筛查，并会说明原因。例如：未筛查必查名单（OFAC、UN、EU 或 UK）；筛查时你的套餐包含的名单不可用；姓名使用非拉丁文字；仅进行精确匹配查询。筛查无法完成或无法读取响应时也会显示此状态。
Review required — no potential match, but this result is not a clearance	必须先由人工查看记录。例如：通过 get_screening 读取的已存记录不包含 Verifex 的判定。

在 Free 套餐中，Verifex 仅筛查 OFAC 和 UN，且每条结果都会说明这一点。EU 和 UK 是必查名单，因此 Free 套餐的结果若未发现匹配对象，会显示 Screening incomplete，并列出套餐未检查的名单。

获取 API 密钥

登录 verifex.dev → Dashboard → API Keys → 创建密钥。 为你的 MCP 客户端单独创建一个密钥，以便单独撤销。该密钥拥有你账户 API 的完整访问权限，不仅限于筛查。请将它保存在 MCP 客户端配置中，切勿粘贴到聊天中。

设置

Claude Desktop

Settings → Developer → Edit Config，然后添加：

{
  "mcpServers": {
    "verifex": {
      "command": "npx",
      "args": ["-y", "[email protected]"],
      "env": { "VERIFEX_API_KEY": "<your Verifex API key>" }
    }
  }
}

重启 Claude Desktop。你也可以从 releases 页面安装 verifex-mcp.mcpb 捆绑包；Claude Desktop 会提示你输入密钥。

Claude Code

claude mcp add verifex --env VERIFEX_API_KEY=<your Verifex API key> -- npx -y [email protected]

Cursor、Windsurf 和其他客户端

在客户端的 MCP 设置中使用与 Claude Desktop 示例相同的 command、args 和 env（Cursor：~/.cursor/mcp.json）。

VS Code

.vscode/mcp.json：

{
  "inputs": [{ "type": "promptString", "id": "verifex-key", "description": "Verifex API key", "password": true }],
  "servers": {
    "verifex": {
      "command": "npx",
      "args": ["-y", "[email protected]"],
      "env": { "VERIFEX_API_KEY": "${input:verifex-key}" }
    }
  }
}

变量	必填	含义
VERIFEX_API_KEY	是	你的 Verifex API 密钥。
VERIFEX_API_URL	否	默认值为 https://api.verifex.dev。仅接受该主机（以及用于开发的 http://localhost），因为你的密钥会发送到此处。设置为任何其他值时，启动时会打印提示。
VERIFEX_ALLOW_CUSTOM_API_URL	否	设为 1 可允许使用非 Verifex 的 VERIFEX_API_URL，例如你自己的代理。否则请勿设置。
VERIFEX_MCP_MAX_SCREENS_PER_10_MIN	否	此服务在任意 10 分钟内执行的筛查次数（默认 20 次，最多 500 次）。可防止失控的助手耗尽你的配额。

固定版本（如上所示的 [email protected]），这样新版本就不会在你选择更新之前在你的计算机上运行。版本发布信息见 releases 页面。

工具

工具	功能	配额
screen_name	筛查一位个人或一家公司（name、可选的 type、作为两字母 ISO 代码的 country、date_of_birth）。	一次筛查
get_screening	根据 request_id，读取你账户中先前筛查的存储记录。存储记录可能不包含 Verifex 的判定；此时会显示 Review required。	无
get_evidence_capsule	获取某次筛查的证据摘要。仍在生成的摘要会显示为待处理。	无

提示词示例

1. “筛查在阿联酋（AE）注册的公司 Acme Trading FZE，并准确告知我核查了哪些名单。”
2. “我们正在为一位新的分销商联系人办理入驻手续，他叫 Ivan Petrov，出生于 1971 年，是俄罗斯公民。请筛查他；如果存在潜在匹配项，请逐一列出候选对象及其所属名单和计划。”
3. “获取请求 scr_… 的证据摘要，并概述筛查了什么、何时筛查，以及依据哪些版本的名单进行筛查，以便我将其附到客户档案中。”

安全

• 你的密钥只会发送给 Verifex。 密钥会作为持有者令牌发送到已配置的源站（默认为 https://api.verifex.dev），不会发送到其他地方。绝不会跟随重定向。密钥绝不会写入 助手、stdout 或日志，并且会从任何可能包含密钥的结果中移除。
• 结果是数据，不是指令。 名称、别名和备注来自记录，其中包括你自己的系统先前筛查过的名称。 服务端会清理这些内容：不含控制字符、不可见字符、双向文本字符或换行符，每项都会加引号并限制长度；完整 JSON 中的相同字符也会进行转义。服务端会告知助手，状态行之后的所有内容都应视为数据。状态行本身由服务端计算。
• 请自行批准筛查。 每次调用 screen_name 都会消耗配额。不要将客户端设置为“始终允许”。上文的单进程限制只是兜底措施，不能取代自行审批。
• 有界限制。 超过 2 MB 的回答会被拒绝；每个请求的时限为 30 秒；没有运行时依赖项。
• 发布。 请使用固定版本。请按照 SECURITY.md 中的说明报告漏洞。

数据与隐私

只有上述四个字段会通过 HTTPS 发送给 Verifex 的 api.verifex.dev，并以你的 API 密钥作为持有者令牌。密钥从环境中读取，绝不会写入助手、stdout 或日志。Verifex 会按照隐私政策和 DPA中的说明，在你的账户中保留筛查记录及其证据摘要。

你询问的名称以及此服务返回的结果（包括候选记录，以及通过 get_screening 获取的账户中先前的筛查记录），都会成为你与 AI 助手对话的一部分。这些内容由该助手的提供商根据其自身条款处理。

Verifex 的结果可为你的合规决策提供支持，但不构成法律建议。

开发

npm test                # node --test, no dependencies
npm run pack:mcpb       # builds dist/verifex-mcp.mcpb

支持：verifex.dev/support。安全问题报告：请参阅 SECURITY.md。许可证：MIT。