关于 mcp-jumio
mcp-jumio 是 Jumio 全球身份验证(KYX / Netverify)的 MCP 服务,面向受监管的银行和金融科技公司。它通过 20 个工具覆盖账户、KYC 流程、证件提取、活体检测和 AML 筛查。
主要功能
- 01账户与 KYC 流程管理
- 02证件字段提取与人脸比对结果
- 03活体检测与防伪评分
- 04AML 与制裁名单筛查结果
- 05GDPR 数据导出与删除
- 06Webhook 回调地址配置
适用场景
- 01银行或金融科技的新客户开户核验
- 02高价值业务的身份与欺诈风险审核
- 03在 AI Agent 中查询与回写 KYC 审核状态
MCP 相关
该服务以 MCP 服务的形式暴露 Jumio 的账户、流程和结果查询能力,MCP 客户端可调用对应工具完成核验流程。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
npx -y @codespar/mcp-jumioJUMIO_API_TOKEN密钥Jumio API token (sent as the username component of HTTP Basic auth).JUMIO_API_SECRET密钥Jumio API secret (sent as the password component of HTTP Basic auth).JUMIO_USER_AGENTMerchant User-Agent string. Jumio requires a custom User-Agent header identifying the calling application (e.g. 'AcmeCorp KYX/1.0').JUMIO_REGIONRegion for the API host: 'us' (api.amer-1.jumio.ai), 'eu' (api.emea-1.jumio.ai), 'sg' (api.apac-1.jumio.ai). Defaults to 'us'.本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。
工具
20收录的工具列表 · 更新于 2 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| callbackUrl | string | 否 | Jumio 用于 POST 工作流结果的 HTTPS 回调 URL。 |
| userReference | string | 否 | 在 Jumio 流程中向用户显示的不透明引用(例如,经过掩码处理的电子邮件)。 |
| workflowDefinition | object | 否 | 可选:在创建账户时立即运行的内联工作流定义。通常省略此项,另行调用 initiate_transaction。 |
| workflowDefinition.key | number | 否 | 来自 Jumio 门户的数字工作流键(例如,200 表示 ID+selfie)。 |
| workflowDefinition.credentials | array | 否 | 所需的凭证类别(ID、SELFIE 等)。 |
| customerInternalReference | string | 是 | 您的内部用户 ID。存储在 Jumio 账户中,并会在 webhook 中回传。 |
详细介绍
@codespar/mcp-jumio
Jumio 的 MCP 服务——全球企业级身份验证(KYX / Netverify)。
当 Onfido 在欺诈模式检测方面不够深入时,银行和大型受监管金融科技公司会选择 Jumio 作为身份验证层。它拥有更长的运营历史、更丰富的风险情报,并专为大规模受监管商业活动打造。
这是 CodeSpar identity 类别中的第三个条目,完善了这一梯队:
| 服务 | 优势 |
|---|---|
| Unico | 巴西领先者——本地 KYC、PEP、法院记录、Receita Federal 生物特征数据库 |
| Onfido | 全球挑战者——简洁的开发者 API、覆盖 195+ 个国家/地区、出色的 SDK 体验 |
| Jumio(本服务) | 全球企业级——更深入的欺诈模式检测、更长的运营历史、银行级别 |
何时选择 Jumio
- 受监管银行或一级金融科技公司,审计人员期望供应商具有可靠的长期信誉
- 高价值用户 onboarding 场景,欺诈损失远大于验证成本
- 深度欺诈情报至关重要(频率检查、设备/会话信号、纵向身份关系图)
- 你已在组织的其他业务中使用 Jumio,并希望采用统一的 KYC 技术栈
对于常住巴西的用户,可与 Unico 配合使用(CPF + Receita 生物特征匹配);其他地区则使用 Jumio。
工具(20)
| 工具 | 用途 |
|---|---|
initiate_account | 创建持久化的 Jumio 终端用户账户。 |
initiate_transaction | 在现有账户上启动新的 KYC 工作流执行。 |
get_transaction | 获取工作流执行摘要——状态('INITIATED' | 'PROCESSED' | 'SESSION_EXPIRED' | 'TOKEN_EXPI... |
list_transactions | 列出某个账户的工作流执行记录。 |
get_transaction_details | 获取工作流执行的完整结果载荷——所有能力的输出(提取、活体检测、相似度…… |
retrieve_document_data | 获取从身份证件中提取的字段(姓名、出生日期、证件号码、有效期、签发国家/地区、MRZ 等…… |
retrieve_similarity_score | 获取面部相似度结果(自拍与证件照片的比对)。 |
delete_transaction | 删除工作流执行记录(GDPR 删除权)。 |
update_transaction_status | 更新工作流执行的商户端状态(PATCH)。 |
retrieve_credentials | 列出工作流执行的凭证(采集的材料:身份证件正反面、自拍、地址证明等)。 |
cancel_transaction | 取消正在进行的工作流执行(状态为 'INITIATED' 或 'ACQUIRED')。 |
retry_transaction | 重试失败、过期或被拒绝的工作流执行。 |
retrieve_extraction_data | 获取已完成工作流的原始 OCR / 提取能力输出——每个提取字段及其来源…… |
retrieve_liveness_result | 获取活体检测能力结果——被动/主动活体检测判定及逐帧反欺骗评分…… |
retrieve_facemap | 获取工作流期间生成的生物特征 facemap(面部模板)。 |
retrieve_screening_result | 获取工作流的 AML / 观察名单筛查输出——制裁名单命中、PEP 命中、负面媒体命中及其…… |
retrieve_data_export | 获取账户符合 GDPR 要求的完整数据导出——每次工作流执行、采集的图像 URL 等…… |
register_callback_url | 设置或更新账户级 Webhook(回调)URL,Jumio 会向该 URL POST 工作流结果通知。 |
delete_account | 删除 Jumio 终端用户账户及其下的所有工作流执行记录(GDPR 删除权)。 |
list_accounts | 列出授权方/商户下的 Jumio 终端用户账户。 |
流程
initiate_account (once per end-user)
-> initiate_transaction returns redirectUrl
-> user completes capture at redirectUrl
-> get_transaction poll until status = PROCESSED
-> get_transaction_details full decision payload
-> retrieve_document_data extracted ID fields
-> retrieve_similarity_score face-match result
-> update_transaction_status ("APPROVED" / "REJECTED" — feedback loop)
安装
npm install @codespar/mcp-jumio
环境
JUMIO_API_TOKEN="..." # API token (required)
JUMIO_API_SECRET="..." # API secret (required, secret)
JUMIO_USER_AGENT="AcmeCorp KYX/1.0" # required by Jumio — identifies the caller
JUMIO_REGION="us" # 'us' | 'eu' | 'sg'. Default 'us'.
身份验证
使用 HTTP Basic 身份验证,API token 作为用户名,API secret 作为密码:
Authorization: Basic base64(JUMIO_API_TOKEN:JUMIO_API_SECRET)
User-Agent: <JUMIO_USER_AGENT>
Jumio 会拒绝不带自定义 User-Agent 标头的请求——请使用能标识你的商户和集成的信息(例如 "AcmeCorp KYX/1.0")。服务会自动设置这两个标头。
区域主机
| 区域 | 主机 |
|---|---|
| 美国(默认) | https://api.amer-1.jumio.ai |
| 欧盟 | https://api.emea-1.jumio.ai |
| 新加坡 / 亚太地区 | https://api.apac-1.jumio.ai |
所有端点均位于 /api/v1 下。
运行
# stdio (default — for Claude Desktop, Cursor, etc)
npx @codespar/mcp-jumio
# HTTP (for server-to-server testing)
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-jumio
企业版
需要对 Agent 付款进行治理、设置预算限额并保留审计跟踪?CodeSpar Enterprise 在这些 MCP 服务的基础上,增加了策略引擎、付款路由和合规模板。
许可证
MIT
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。