# Onfido MCP for AI Agents AI Agent Connect

> Onfido MCP lets you automate identity verification and KYC processes directly through your AI agent. You can create new applicants, trigger complex verification workflows, and pull detailed reports on document validity or facial similarity. It takes the manual work out of compliance by letting your agent handle the heavy lifting of checking IDs and monitoring status updates in real-time.

## Overview
- **Category:** human-resources
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_iHq1fdFsK8phJjuHtU3g9wtzvzE8nLzkFYMb5kno/ai-agent-connect
- **Tags:** identity-verification, kyc, applicant-screening, compliance, document-verification, biometrics

## Description

Imagine you're trying to onboard a new user for a fintech app. Normally, that means jumping between a dashboard, checking uploaded IDs, and manually verifying that a face matches a passport. With this Connector, you just tell your agent to get it done. You can ask it to set up a new profile for a customer, kick off a full identity check, or ask for the final results on a pending application. It handles the communication with the Onfido platform so you don't have to keep tabs on multiple browser tabs. Because it's part of the Vinkius catalog, you get this capability alongside thousands of other tools, making it easy to build a complete automated pipeline for your business. Instead of hunting for data, you get answers. If a verification fails or needs a manual review, your agent can tell you exactly why and what's missing, letting you focus on actual problems rather than data entry. This turns a tedious manual process into a few quick commands. You can manage high-volume onboarding without increasing your team's workload. Whether you are checking a single high-value user or processing hundreds of sign-ups, your agent handles the heavy lifting of identity verification while you keep your focus on the bigger picture.

## Tools

### create_applicant
Create a new profile for someone who needs to be verified. This lets you get an ID ready for the next steps in the process.

### create_check
Start a classic document or facial similarity check. It's the best way to run specific, standalone verifications.

### create_workflow_run
Trigger a complex, multi-step verification sequence. This handles the heavy lifting for sophisticated KYC requirements.

### get_report
Pull the final results for a completed verification. You get a clear breakdown of every data point checked.

### get_workflow_run
Check the current status of an ongoing verification. It tells you if the process is pending, approved, or needs more info.

### register_webhook
Set up automatic notifications for status changes. This ensures your system knows the moment a verification is finished.

## Prompt Examples

**Prompt:** 
```
Create a new Onfido applicant for Sarah Jenkins (s.jenkins@email.com).
```

**Response:** 
```
I've created the applicant profile for Sarah Jenkins.

**Details:**
- **Applicant ID:** `app_99821`
- **Status:** Ready for verification

You can now ask me to start a workflow or a check for this ID.
```

**Prompt:** 
```
What's the status of the verification for applicant app_99821?
```

**Response:** 
```
The verification for **app_99821** is currently **in progress**.

- **Current Step:** Document Review
- **Status:** Processing

I'll let you know if the status changes, or you can ask me to check again in a few minutes.
```

**Prompt:** 
```
Get the report for rep_55443 and tell me if it's clear.
```

**Response:** 
```
I've retrieved the report for `rep_55443`.

**Result:** Clear

**Breakdown:**
- **Document Validity:** Confirmed
- **Image Integrity:** Confirmed
- **Facial Similarity:** High Match

The applicant has successfully passed all checks.
```

## Capabilities

### Create new identity applicants
Set up a new profile for an individual who needs to undergo verification.

### Trigger multi-step verification workflows
Start complex identity check sequences that involve multiple automated steps.

### Run legacy document checks
Execute specific, standalone checks for document validity and facial similarity.

### Pull detailed verification reports
Get a complete breakdown of every data point checked during the verification process.

### Check current workflow statuses
See if a verification is currently processing, awaiting input, or fully approved.

### Set up real-time status webhooks
Register notifications to get automatic updates on verification status changes.

## Use Cases

### High-volume onboarding
An operations lead asks the agent to create 50 new applicants at once and trigger workflows for all of them.

### Compliance auditing
A compliance officer asks for a summary of all declined reports from the last 24 hours to identify fraud patterns.

### Developer testing
A developer uses the agent to run a legacy check to ensure the API is responding correctly during a sprint.

### Customer support
A support rep asks the agent to check why a specific user's ID was rejected to provide a faster answer to the customer.

## Benefits

- Stop manual data entry by using create_applicant to set up new profiles instantly through your AI agent.
- Speed up onboarding with create_workflow_run, which handles multi-step identity checks without human intervention.
- Get instant answers on verification status using get_workflow_run to see if a user is approved or still pending.
- Access deep data on document integrity with get_report to see exactly why a check passed or failed.
- Automate your backend updates by using register_webhook to get real-time notifications on every verification change.

## How It Works

The bottom line is you move from manual dashboard clicking to natural language identity management.

1. Connect your Onfido API token to the Connector.
2. Describe the verification task to your AI agent.
3. Get immediate status updates or final reports.

## Frequently Asked Questions

**Can the Onfido MCP handle my KYC requirements?**
Yes, it connects your AI agent to Onfido's identity verification tools so you can manage KYC tasks through natural conversation.

**Does the Onfido MCP work with Claude or Cursor?**
Yes, it works with any MCP-compatible client, including Claude, Cursor, and Windsurf.

**How does the Onfido MCP help with compliance?**
It lets you instantly check applicant statuses and pull detailed reports without manually searching a dashboard.

**Can I use the Onfido MCP to automate onboarding?**
Yes, you can have your agent create new applicants and trigger verification workflows automatically as users sign up.

**Does the Onfido MCP support webhooks?**
Yes, you can use it to register webhooks so your system gets notified the moment a verification status changes.

**Is the Onfido MCP for just one type of check?**
No, it supports both complex multi-step workflows and legacy checks for specific document combinations.

**How can I check the current status of a verification process?**
Use the `get_workflow_run` tool with the specific Workflow Run ID. It will return the current state, such as 'awaiting_input', 'processing', 'approved', or 'declined'.

**Can I create a verification check without using Workflow Studio?**
Yes. Use the `create_check` tool for legacy integrations. You can specify a comma-separated list of report names, such as 'document, facial_similarity_photo', for a specific applicant ID.

**How do I get notified when a report is completed?**
You can use the `register_webhook` tool to set up a listener URL for specific events like 'report.completed', 'check.completed', or 'workflow_run.completed'.