mcp-onfido

@codespar/mcp-onfido

适用于 Onfido 的 MCP 服务——全球身份验证和 KYC。

Onfido 是 Revolut、N26、Uber 以及数百家受监管金融科技公司背后的身份验证层。一个 API 覆盖 195 多个国家/地区和完整的 KYC 流程：申请人 → 证件 → 实时照片 → 检查（运行验证）→ 报告。

这是 CodeSpar identity 类别中的第二个条目，与 Unico（优先服务巴西的 KYC）并列。两者搭配使用：巴西用户使用 Unico（CPF + Receita Federal 生物特征库），流程涉及拉丁美洲以外的用户时使用 Onfido。

工具（20）

工具	用途
create_applicant	创建 Onfido 申请人——用于关联证件、实时照片和检查的人员记录。
retrieve_applicant	按 ID 检索申请人。
update_applicant	更新现有申请人的字段。
upload_document	为申请人上传身份文件图像。
retrieve_document	按 ID 检索证件元数据。
upload_live_photo	为申请人上传实时照片（自拍），供 facial_similarity_photo 报告使用。
retrieve_live_photo	按 ID 检索实时照片记录。
create_check	对申请人运行验证检查。
retrieve_check	按 ID 检索检查。
list_checks	列出指定申请人的所有检查。
retrieve_report	按 ID 检索单份报告。
delete_applicant	软删除申请人。
list_documents	列出为指定申请人上传的所有证件。
download_document	下载已上传证件的原始二进制数据。
list_live_photos	列出为指定申请人上传的所有实时照片（自拍）。
resume_check	恢复已暂停的检查（通常处于 awaiting_applicant 或 paused 状态）。
list_reports	列出指定检查中包含的所有报告。
create_workflow_run	启动 Onfido Studio 工作流运行。
retrieve_workflow_run	按 ID 检索工作流运行。
generate_sdk_token	生成短期 SDK 令牌，用于在前端嵌入 Onfido Web / iOS / Android SDK。

流程

create_applicant
    -> upload_document  (front, and back if driving_licence / national_identity_card)
    -> upload_live_photo
    -> create_check      report_names=["document","facial_similarity_photo","watchlist_standard"]
    -> retrieve_check    (poll until status = complete)
    -> retrieve_report   (for each report id to get the detailed breakdown)

安装

npm install @codespar/mcp-onfido

环境

ONFIDO_API_TOKEN="..."    # API token (required, secret)
ONFIDO_REGION="eu"        # Optional. 'eu' | 'us' | 'ca'. Defaults to api.onfido.com.

身份验证

Onfido 使用非 Bearer 格式的请求头：

Authorization: Token token=<ONFIDO_API_TOKEN>

服务会自动处理此操作。

区域主机

区域	主机
默认	https://api.onfido.com
欧盟	https://api.eu.onfido.com
美国	https://api.us.onfido.com
加拿大	https://api.ca.onfido.com

所有请求均使用 API 版本 v3.6（当前稳定版）。

多部分上传

upload_document 和 upload_live_photo 接受以 base64 编码字符串形式提供的文件。将字节数据传入 file，并提供 file_name 和 content_type：

{
  "applicant_id": "a1b2c3...",
  "type": "passport",
  "file": "<base64-encoded bytes>",
  "file_name": "passport.jpg",
  "content_type": "image/jpeg"
}

服务会在发送前将其封装为 multipart/form-data。

注意：Onfido 越来越建议通过其 SDK 拍摄实时照片，而不是通过 API 上传。在某些账户中，直接上传到 /live_photos 可能会受到限制——不确定时请使用 SDK 流程。

运行

# stdio (default — for Claude Desktop, Cursor, etc)
npx @codespar/mcp-onfido

# HTTP (for server-to-server testing)
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-onfido

何时选择 Onfido 或 Unico

信号	选择
用户是巴西人，需要验证 CPF 并与 Receita Federal 的生物特征进行匹配	Unico
用户在拉丁美洲以外，或流程面向全球用户	Onfido
受监管的金融科技公司需要在全球范围内进行 AML 监控名单和 PEP 筛查	Onfido
面向 20 多个国家/地区的旅行或零工平台用户注册	Onfido

企业版

需要为 Agent 付款设置治理、预算限额和审计跟踪？CodeSpar Enterprise 可在这些 MCP 服务之上增加策略引擎、付款路由和合规模板。

许可证

MIT