# Cleared (ClearedIn) MCP MCP

> ClearedIn gives your AI agent direct access to all identity verification, background screening, digital signature, and security audit logs for compliance workflows. Track user status changes, retrieve deep screening reports, and manage account metadata without opening a single portal.

## Overview
- **Category:** fort-knox
- **Price:** Free
- **Tags:** identity-verification, background-screening, trust-and-safety, compliance-auditing, user-onboarding

## Description

Managing client onboarding used to mean juggling multiple secure portals: one for identity checks, another for background screenings, and yet a third just for signatures. This MCP lets your AI agent handle all of it through natural conversation. You get full oversight on who passed verification, the status of every screening request, and which security logs were accessed—all from within your chat interface. Because this runs on Vinkius, you connect once to manage these compliance checks across any compatible client. It’s about getting a single source of truth for user trust and regulatory data right when you need it.

## Tools

### get_cleared_account_info
Retrieves core metadata about the account and its associated users.

### get_screening_details
Gets detailed results for a specific background screening request.

### get_signature_details
Checks the status and details of a particular digital signature request.

### get_verification_details
Retrieves detailed information on a single identity verification process.

### list_cleared_audit_logs
Pulls a list of security audit logs showing data access history.

### list_background_screenings
Lists every background screening request made against the account.

### list_digital_signatures
Lists all digital signature requests and their current completion status.

### list_identity_verifications
Provides a list of all identity verification requests made to the account.

## Prompt Examples

**Prompt:** 
```
List the last 5 identity verifications in Cleared.
```

**Response:** 
```
Retrieving your recent verifications... I found 5 items: John Doe (Verified), Jane Smith (Pending), Mike Scott (Rejected), and 2 others. Would you like the details for the pending request?
```

**Prompt:** 
```
Show me the results for screening ID 'scr_12345'.
```

**Response:** 
```
Checking screening scr_12345... This background check for 'Jane Doe' has been completed. Status: Cleared. All requested checks (Criminal, Employment, Education) were successful.
```

**Prompt:** 
```
What is the status of the signature request for 'Employment Contract'?
```

**Response:** 
```
Retrieving signature status... The 'Employment Contract' sent to John Doe is currently 'Partially Signed'. The employer has signed, but the candidate is still pending.
```

## Capabilities

### Get basic account details
Retrieves core metadata about the overall cleared account and associated users.

### Check identity status
Lists all identity verification requests, showing their current status (e.g., Pending or Verified).

### Monitor screenings
Retrieves detailed results for a specific background screening check.

### List pending signatures
Gives a list of all digital signature requests and their completion status.

### Audit security actions
Accesses the system's security logs to see exactly who accessed sensitive data and when.

## Use Cases

### Compliance officer needs a risk summary.
A compliance officer asks their agent, 'Give me a status report on all new users this month.' The agent automatically runs `list_identity_verifications` and summarizes the count of Pending versus Verified records.

### HR manager needs to check employee background history.
The HR manager asks, 'Show me Jane Doe's full screening report.' The agent uses `get_screening_details` with her ID and returns a clean, readable summary of all checks.

### Operations team needs to audit data access.
An operations lead asks the agent, 'Who viewed the executive records last night?' The agent runs `list_cleared_audit_logs` and provides a time-stamped list of users who accessed sensitive data.

## Benefits

- Instead of navigating multiple screens to check user status, you simply ask the agent to list all identity verifications using `list_identity_verifications` and instantly see who is Pending or Verified.
- Need a deep dive on one person? Use `get_screening_details` to pull comprehensive results for background checks without leaving your chat window.
- Track compliance signatures effortlessly. You can list all digital signature requests via `list_digital_signatures` to know exactly which documents are still waiting for a sign-off.
- When suspicious activity pops up, use `list_cleared_audit_logs` to pull an immediate record of who accessed what data and when, speeding up incident response.
- The system keeps track of user profiles. Use `get_cleared_account_info` to retrieve core account metadata so you always know the scope of the client's identity.

## How It Works

The bottom line is you get a single conversational interface for complex, multi-step compliance checks.

1. Subscribe to this MCP on Vinkius and enter your Cleared API Key, which you get from the Admin Portal.
2. Connect this MCP to your preferred AI client (like Cursor or Claude).
3. Ask your agent specific questions, like 'What's the status of Jane Doe’s background check?' The MCP runs the query and delivers the results directly.

## Frequently Asked Questions

**How do I check if all background screening requests are complete using `list_background_screenings`?**
The agent lists every request, giving you the current status of each one. You can then follow up by asking for details on a specific ID to see exactly which checks passed or failed.

**What data does `list_identity_verifications` provide?**
`list_identity_verifications` provides a list of all verification requests, showing key metadata like the user's name, request date, and current status (Pending, Verified, etc.).

**Can I audit who saw sensitive data using `list_cleared_audit_logs`?**
Yes. `list_cleared_audit_logs` gives you a record of activity, detailing which user accessed what type of sensitive data and exactly when they did it.

**How do I get the full details for one specific signature? Use `get_signature_details`.**
You provide the request ID, and `get_signature_details` pulls all status information—who signed it, when they signed it, and if any parties still need to take action.

**If a verification fails, how do I find out why using `get_verification_details`?**
The response object contains a detailed status code and an error message. You check the 'status' field to see if it returned 'Failed.' The accompanying metadata tells you exactly which step or requirement caused the failure.

**I have many signature requests; how do I get a summary of all pending items with `list_digital_signatures`?**
You can filter the results by status like 'Pending' or 'Partial.' The list provides a quick count and a date range for every request, so you know exactly what needs attention without opening any portal.

**What core metadata does `get_cleared_account_info` provide about my active user accounts?**
This tool retrieves the overall account health and key user data. You get an overview of your established users, API limits, and system configuration details right in your chat interface.

**Using `get_screening_details`, how do I see which specific checks were run for a given background screen?**
The output breaks down the screening into component reports. You'll find separate sections detailing results for criminal, employment, and education records, giving you full visibility of every check performed.

**Can I see if a user has finished their background check?**
Yes! Use the `get_screening_details` tool with the screening ID. The agent will return the current status and the final result of the check.

**How do I find out who accessed a specific verification record?**
Use the `list_cleared_audit_logs` tool. Your agent will fetch the account's security logs, allowing you to audit access to sensitive personal information.

**Where do I find my Cleared API Key?**
Log in to your Cleared (ClearedIn) Admin Portal and navigate to the **Integrations** section. You can generate and copy your API key from there.