# Persona MCP

> Persona MCP connects your AI agent directly to identity verification workflows. Handle KYC/AML compliance tasks—from managing user accounts and listing inquiries to approving or declining submissions—all through natural conversation. This tool lets you inspect verification results, process transactions, and permanently redact sensitive data without leaving your chat window.

## Overview
- **Category:** fort-knox
- **Price:** Free
- **Tags:** kyc, aml, identity-verification, risk-management, compliance, onboarding

## Description

Connecting Persona through this MCP means your AI agent handles identity verification and KYC/AML compliance right where you work. You don't have to open a dozen browser tabs just to check if a user submitted their ID or what the status is on an old case file. Your agent acts as a dedicated compliance assistant, giving you instant access to critical data points like account records, transaction histories, and detailed verification results. Need to approve a pending submission? You can call `approve_inquiry` right away. Want to clean up sensitive data for GDPR compliance? Use the redaction tools. Because this MCP is hosted on Vinkius, your agent gets instant access to all these identity operations—list inquiries, get accounts, set case statuses, and much more. It makes auditing and acting on verifications immediate, letting you focus on risk management instead of dashboard clicking.

## Tools

### approve_inquiry
Marks a pending identity inquiry as approved.

### create_account
Initializes a new user account record in the system.

### create_inquiry
Starts a new identity verification request for a user.

### create_transaction
Logs a new financial or operational transaction record.

### create_webhook
Sets up automated webhooks to notify other services of status changes.

### decline_inquiry
Marks an identity inquiry as declined, halting the verification process.

### get_account
Retrieves all specific details for a single user account ID.

### get_case
Fetches detailed information about a specific compliance case file.

### get_event
Retrieves records of important system events that occurred for an account or inquiry.

### get_inquiry
Gets the current status and data for a specific identity inquiry ID.

### get_report
Retrieves detailed compliance reports, often covering watchlists or adverse media checks.

### get_transaction
Fetches the full details for a specific transaction record.

### get_verification
Retrieves the complete results and metadata for an identity verification attempt.

### list_accounts
Generates a list of all existing user accounts in the system.

### list_cases
Provides a comprehensive list of open and closed compliance cases.

### list_events
Lists historical events that have occurred across the system's records.

### list_inquiries
Retrieves a list of all identity verification inquiries, allowing filtering and pagination.

### list_reports
Generates a bulk list of compliance reports available for review.

### list_transactions
Provides a paginated list of all recorded transactions.

### list_webhooks
Lists the current webhooks configured to notify other services.

### redact_account
Permanently removes Personally Identifiable Information (PII) from a specific user account record.

### redact_inquiry
Performs permanent data deletion of sensitive PII associated with an inquiry.

### redact_report
Cleans up and permanently redacts PII from a specific report document.

### redact_verification
Deletes sensitive data points associated with an identity verification check.

### set_case_status
Updates the active status of a compliance case (e.g., open, closed).

### trigger_workflow
Starts a predefined workflow run for a specific purpose.

### update_account
Modifies existing data points on an account, such as changing contact details or status.

## Prompt Examples

**Prompt:** 
```
List the most recent 10 identity inquiries.
```

**Response:** 
```
I've retrieved the latest inquiries. There are 10 records found, including Inquiry inq_123abc (Status: completed) and inq_456def (Status: pending). Would you like to inspect the details of the pending one?
```

**Prompt:** 
```
Get the account details for account ID acc_789ghi.
```

**Response:** 
```
Fetching account acc_789ghi... This account is associated with user 'Jane Doe', created on 2023-10-12, and currently has 2 completed verifications linked to it.
```

**Prompt:** 
```
Approve inquiry inq_456def.
```

**Response:** 
```
Processing approval for inq_456def... The inquiry has been successfully approved. The user's status has been updated in the Persona dashboard.
```

## Capabilities

### Process Identity Submissions
You can approve or decline identity inquiries using dedicated tools.

### Manage User Records
Create, update, and retrieve full details on user accounts and associated data.

### Audit Compliance Data
List all inquiries, cases, and reports to audit compliance status or generate throughput metrics.

### Handle Sensitive Data Cleanup
Permanently delete PII from accounts, inquiries, or reports for privacy compliance (e.g., GDPR).

### Review Verification Statuses
Get detailed results and metadata on specific identity checks.

## Use Cases

### Onboarding a New Client
A Support Agent needs to confirm if a new client, Jane Doe, has finished her KYC. She asks the agent to list all inquiries for her ID. The agent uses `list_inquiries` and finds a pending status. The agent then retrieves the details using `get_inquiry`, sees everything is ready, and calls `approve_inquiry`. Done in three steps.

### Handling Data Subject Requests
A Compliance Officer receives a request to delete all data on an inactive user. Instead of manually finding the account ID, they ask the agent to run the redaction tools. The agent executes `redact_account`, and the officer confirms permanent removal from their chat history.

### Investigating Suspicious Activity
A risk analyst suspects an account is compromised. They use the agent to check for unusual activity by calling `list_events` across a range of dates, then fetching all associated transactions via `get_transaction` to build a full timeline.

### Developer Testing and Integration
A developer needs to test their internal system's ability to process new users. They use the agent to call `create_account` with dummy data, then immediately follow up by calling `get_verification` to ensure the record was created correctly.

## Benefits

- Stop switching tabs. Instead of leaving your chat client to check an account's status, you use `get_account` or `list_inquiries` directly with your agent. It keeps all compliance data in one place.
- Handle GDPR and CCPA requests easily. You can run specific redaction tools like `redact_account`, `redact_inquiry`, or `redact_verification` to prove permanent deletion of PII without manual database queries.
- Accelerate decision-making. Need to approve a user? Use the `approve_inquiry` tool instantly, updating their status and completing the onboarding flow in one message exchange.
- Build better reports. You can list all necessary records—from running `list_accounts` to calling `get_report`—to build complex audit trails without exporting CSV files first.
- Maintain data integrity across systems. Use `create_transaction` or `set_case_status` to ensure that every action taken on a user record is logged and traceable for audits.

## How It Works

The bottom line is you use your agent's chat interface to manage complex compliance workflows that used to require multiple manual dashboard logins.

1. Subscribe to this MCP and provide your Persona API Secret Key.
2. Select your preferred AI client (Claude, Cursor, etc.) and authorize the connection.
3. Use natural language prompts with your agent; it executes the necessary functions like `get_inquiry` or `create_account` in the background.

## Frequently Asked Questions

**How do I check if an account has been redacted using Persona MCP?**
You use the `get_account` tool to retrieve the record. If PII was successfully removed, the returned data fields will be null or replaced with redaction markers, confirming compliance.

**Can I list all pending inquiries using Persona MCP?**
Yes, you use `list_inquiries`. You can filter this list by status (e.g., 'pending') and then select specific IDs to fetch full details with `get_inquiry`.

**What is the difference between `create_account` and `update_account`?**
`create_account` establishes a brand new user record. `update_account`, however, modifies an existing account's data—like changing their phone number or status.

**Do I need to manually approve every inquiry after using Persona MCP?**
No. While the tool provides the action via `approve_inquiry`, you still must review the details retrieved by `get_inquiry` first, confirming that all necessary checks passed before giving approval.

**How do I ensure my data is compliant with GDPR using Persona MCP?**
You use the dedicated redaction tools like `redact_account`, `redact_inquiry`, and `redact_report`. These calls permanently delete PII, providing an auditable trail of compliance.