# Checkr MCP

> Checkr MCP automates background screening and compliance checks directly from your chat interface. Connect this tool to monitor candidate files, verify credentials, and manage the entire hiring process without leaving your agent environment.

## Overview
- **Category:** human-resources
- **Price:** Free
- **Tags:** background-checks, screening, hiring, compliance, identity-verification

## Description

This MCP gives you full control over candidate screening processes using natural language commands. Instead of opening a separate dashboard and clicking through multiple tabs, your AI client handles the heavy lifting. You can ask about a candidate's status or list all active files instantly. Whether you need to start new checks for candidates, review complex report details, or simply see what screening packages are available, this tool manages it all. This integration lets HR teams move from manual data entry and dashboard hopping to conversation-based workflows. By connecting Checkr through the Vinkius catalog, your agent gets access to a complete set of compliance tools, allowing you to maintain audit logs and manage full candidate oversight right where you're already working.

## Tools

### create_new_candidate
Creates a brand new profile entry for a job applicant in your account.

### start_background_check
Triggers an official background screening process for an existing candidate's profile.

### get_candidate_details
Fetches all core information associated with a specific job applicant or user ID.

### get_report_details
Retrieves the full, detailed outcome and findings of a completed background check report.

### list_checkr_candidates
Pulls a list of every candidate profile currently stored in your Checkr account.

### list_screening_invitations
Shows which candidates have been sent an invitation to complete their own application steps.

### list_screening_packages
Lists all the types of screening packages, like 'Pro' or 'Basic', that you can purchase or use.

### list_background_reports
Generates a list of recent background checks and their current status (Clear, Pending, etc.).

## Prompt Examples

**Prompt:** 
```
List the last 5 background checks in my Checkr account.
```

**Response:** 
```
Retrieving recent reports... I found 5 items: John Doe (Clear), Jane Smith (Pending), Mike Miller (Consider), and 2 others. Would you like to see the details for Mike Miller?
```

**Prompt:** 
```
Check the status of the candidate named 'Jane Smith'.
```

**Response:** 
```
Searching for Jane Smith... I found 1 profile. Her background check is currently 'Pending' (75% complete). We are waiting for the motor vehicle record check to finish.
```

**Prompt:** 
```
What screening packages do I have available?
```

**Response:** 
```
Checking your available packages... You have 3 configured: 'Standard Pro' (Criminal + MVR), 'Basic' (Criminal Only), and 'Executive' (Standard + Credit + Employment).
```

## Capabilities

### Manage Candidate Files
You can list all candidates in your account or retrieve detailed information for a specific person.

### Initiate Screening Checks
Start background checks on new profiles and monitor the status of ongoing investigations.

### Review Compliance Reports
Get detailed results from completed reports, checking for adverse actions or final clearance status.

### Track Screening Progress
View invitations sent to candidates and check the status of required documentation submissions.

### Check Service Plans
List available screening packages, like 'Pro' or 'Basic', to ensure you are using the right plan.

## Use Cases

### A candidate was hired, but we need to confirm their records.
Instead of logging into the dashboard and clicking through reports, I ask my agent: 'What's the status for John Doe?' The agent uses 'get_candidate_details' and 'list_background_reports' to give me a single answer confirming his clearance.

### We have 20 new applicants starting this week.
I tell my agent: 'Create profiles for these 20 people and start their checks.' It uses 'create_new_candidate' followed by multiple calls to 'start_background_check', saving me hours of manual setup.

### We need to audit our current contract coverage.
I ask the agent: 'What screening packages do we have available?' It uses 'list_screening_packages' and reports back on our legal options immediately, ensuring compliance coverage is correct.

### A candidate needs to finish their paperwork.
Instead of checking the dashboard for pending invites, I ask: 'Show me who hasn't finished their application.' The agent uses 'list_screening_invitations' and tells me exactly which candidates need follow-up.

## Benefits

- You no longer have to manually check statuses. By using 'list_background_reports', your agent gives you an immediate, conversational overview of all recent checks.
- Stop opening multiple tabs to manage applicants. You can create a new candidate profile and then trigger the background screening process with one request: calling 'start_background_check'.
- Compliance review is faster when you need specific data points. Instead of skimming PDFs, use 'get_report_details' to pull out adverse action statuses or key findings directly.
- You stay organized by knowing who needs what. Use 'list_screening_invitations' to see exactly which candidates are waiting for them to finish their part of the process.
- Always know your options before starting a job. Quickly check available plans using 'list_screening_packages' so you don't accidentally run a Basic check when you needed Pro coverage.

## How It Works

The bottom line is you talk to your AI client, and it executes the compliance actions using Checkr in the background.

1. Subscribe to this MCP and enter your Checkr API Secret Key from your dashboard.
2. Confirm that your AI client recognizes the connection, giving your agent access to screening tools.
3. Ask your agent a natural language question, such as 'What is Jane Doe's background check status?' or 'List all candidates in my account.'

## Frequently Asked Questions

**How do I use the Checkr MCP to find out how many candidates I have?**
Run 'list_checkr_candidates'. This tool pulls a list of every candidate profile in your account, letting you quickly know your current count and who they are.

**Does the Checkr MCP handle report generation for me?**
No, it handles the *initiation* and retrieval. You use 'start_background_check' to trigger the process, and then you use 'list_background_reports' and 'get_report_details' to retrieve the final outcome.

**What if I need to check a candidate who isn't in my system?**
You must first run 'create_new_candidate' to add them. Once the profile exists, you can then use 'start_background_check' against that new record.

**Can I see which screening packages are available for my account?**
Yes, run 'list_screening_packages'. This tells you exactly what service plans you have access to or can purchase from Checkr.

**Is the Checkr MCP useful if I only care about pending applications?**
Absolutely. Use 'list_screening_invitations' specifically. It isolates all candidates who are waiting on them to complete their own steps, keeping your follow-up tasks organized.