mcp-onfido

@codespar/mcp-onfido

Onfido 向け MCP サーバー — グローバルな本人確認と KYC に対応します。

Onfido は、Revolut、N26、Uber、および数百の規制対象フィンテック企業を支える本人確認レイヤーです。1 つの API で 195 か国以上に対応し、申請者 → 書類 → ライブ写真 → チェック（本人確認を実行）→ レポートという KYC フロー全体をカバーします。

CodeSpar の identity カテゴリーにおける 2 つ目のエントリーです。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	フロントエンドに Onfido Web ／ iOS ／ Android SDK を組み込むための、有効期間の短い 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
EU	https://api.eu.onfido.com
US	https://api.us.onfido.com
CA	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 は、ライブ写真の API アップロードではなく、SDK 経由での撮影を推奨する傾向が強まっています。アカウントによっては、/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

エンタープライズ

エージェントの支払いにガバナンス、予算上限、監査証跡が必要ですか？CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、支払いルーティング、コンプライアンステンプレートを追加します。

ライセンス

MIT