# Onfido MCP

> Onfido connects your AI agent to identity verification services, automating KYC and compliance checks. You can create new applicant profiles, trigger complex multi-step verification workflows, run specific document comparisons, and pull detailed reports—all through natural conversation. This MCP lets you manage the entire user onboarding process without leaving your chat interface.

## Overview
- **Category:** human-resources
- **Price:** Free
- **Tags:** identity-verification, kyc, applicant-screening, compliance, document-verification, biometrics

## Description

Running compliance checks used to mean logging into a dedicated dashboard, filling out forms, clicking 'start,' waiting for an email, and then manually cross-referencing results. Now, connecting Onfido through Vinkius changes that. You talk to your AI agent, tell it the task (like checking a new applicant's ID), and the system handles everything. The MCP lets you start by creating a profile using `create_applicant`. Next, you initiate the full process with `create_workflow_run`, which manages every step—document validation, face matching, etc.—in the background. You don't need to worry about the status; your agent tracks it and uses `get_workflow_run` to tell you exactly where things stand. When everything clears, you pull a full breakdown using `get_report`. It’s all conversational. Your agent manages identity verification from start to finish.

## Tools

### create_applicant
Makes a brand new record for an individual who needs identity verification.

### create_check
Runs a classic, targeted check by combining specific document types or data points.

### create_workflow_run
Starts an entire complex verification process that handles multiple steps automatically.

### get_report
Pulls the final, detailed report for a completed identity verification run.

### get_workflow_run
Retrieves the current status and history of an active or completed workflow process.

### register_webhook
Sets up a system notification to alert you when a verification status changes.

## Prompt Examples

**Prompt:** 
```
Create a new Onfido applicant for John Doe (john.doe@example.com).
```

**Response:** 
```
I've created the applicant John Doe. The Applicant ID is 'app_12345'. You can now use this ID to start a verification workflow or a check.
```

**Prompt:** 
```
Start a verification workflow 'wf_abc' for applicant 'app_12345'.
```

**Response:** 
```
Workflow run 'wr_999' has been started for applicant 'app_12345'. The current status is 'awaiting_input'.
```

**Prompt:** 
```
Retrieve the details for report ID 'rep_xyz789'.
```

**Response:** 
```
I've fetched the report 'rep_xyz789'. The result is 'clear' with a breakdown showing document validity and image integrity are confirmed.
```

## Capabilities

### Manage Applicant Records
Create and track new profiles for individuals undergoing compliance checks.

### Run Full Verification Workflows
Start and monitor complex, multi-step identity verification processes automatically.

### Perform Specific Document Checks
Execute classic, targeted checks, such as comparing a photo to an uploaded ID document.

### Retrieve Detailed Reports
Pull comprehensive reports containing granular identity data and verification results.

### Get Status Updates
Check the real-time status of a running workflow run, like 'processing' or 'approved'.

### Set Up Status Alerts
Register webhooks to get immediate notifications when verification statuses change.

## Use Cases

### Onboarding a high-value contractor
The Ops Manager needs to verify a new contract employee. They tell their agent, 'Start the full onboarding check for Jane Doe.' The agent uses `create_applicant` first, then triggers `create_workflow_run`. When finished, they pull the final audit trail using `get_report`.

### Checking compliance status during an audit
A Compliance Officer needs to know if 50 applicants are ready. Instead of running 50 manual checks, they ask their agent to check the status of multiple runs using `get_workflow_run` and get a compiled list of 'approved' or 'declined.' 

### Testing identity logic in a script
A Fintech Developer needs to test if their code correctly handles a failed document check. They use the MCP tools, specifically `create_check`, and feed the expected failure report directly into their testing environment.

### System integration for real-time alerts
The system needs to know when an applicant moves from 'awaiting input' to 'approved.' Instead of polling a database, the developer uses `register_webhook` with the agent to guarantee instant, push-based notification.

## Benefits

- Eliminate manual dashboard searching. Instead of clicking into a portal just to see if an applicant is ready, you ask your agent for the status using `get_workflow_run` and get instant answers.
- Build robust onboarding flows that handle multi-step checks automatically. Using `create_workflow_run` means you don't have to manually trigger document validation followed by face matching—it’s one command.
- Speed up developer testing. You can integrate identity verification into code or scripts, using the MCP tools to test specific report retrievals via `get_report` without needing a live sandbox environment.
- Maintain continuous compliance awareness. By setting up webhooks with `register_webhook`, you ensure your systems get immediate alerts when critical verification milestones are hit, eliminating manual checks.
- Streamline user intake by automating record keeping. You can instantly initiate the process for a new person using `create_applicant` right from your chat client.

## How It Works

The bottom line is: you get to treat complex compliance tasks like simple chat commands.

1. Subscribe to this MCP and enter your Onfido API Token within Vinkius.
2. Your AI agent authenticates the connection, making identity services available through natural language prompts.
3. You simply tell your agent what needs doing—like 'Start a verification for John Doe'—and it executes the necessary steps.

## Frequently Asked Questions

**How do I start a new verification workflow using Onfido MCP?**
You initiate the process by calling `create_workflow_run`. This single action tells the system to run all necessary, multi-step checks required for compliance.

**What is the difference between create_check and create_workflow_run?**
`create_check` runs a specific, isolated comparison (like face matching). `create_workflow_run` starts the full, multi-stage identity onboarding process that includes multiple checks.

**Can I retrieve the final report details with Onfido MCP?**
Yes. After a workflow completes successfully, you use `get_report` to pull all the detailed verification data into your chat conversation for easy review.

**How do I get notified when an applicant's status changes?**
You set up an alert using `register_webhook`. This tells your system to send a notification immediately whenever the Onfido verification status shifts.

**Does Onfido MCP help with record keeping for new users?**
Absolutely. You first use `create_applicant` to establish the person's profile in the system, making them ready for subsequent checks and workflow runs.