# InfoVetted MCP

> InfoVetted lets you run full candidate background screenings using your AI client. It verifies employment history, checks criminal records, and confirms education credentials for new hires. Manage the entire vetting process—from listing candidates to tracking results and canceling old requests—all through conversation.

## Overview
- **Category:** human-resources
- **Price:** Free
- **Tags:** background-screening, identity-verification, employment-checks, criminal-records, compliance-vetting

## Description

This MCP manages all phases of employee screening. Instead of navigating separate portals for criminal checks, educational verification, or employment histories, you talk to your agent. You can list existing vetting requests to see who's in the pipeline, create entirely new background checks, and track status updates as they come in. If a candidate passes certain criteria, you get confirmation; if not, you know exactly what failed.

It’s built for compliance teams and HR staff that need reliable data. You can also manage contacts by creating screening profiles or listing out existing groups to keep track of who needs checking. The whole InfoVetted catalog is managed through Vinkius, making it accessible from any MCP-compatible client you use.

This lets you move beyond just collecting reports; you actually control the lifecycle: initiate checks, view the full list of supported check types, and even cancel active vettings if a candidate drops out before completion. It's about keeping your onboarding workflow accountable.

## Tools

### cancel_active_vetting
Cancels a running background check request immediately.

### check_api_connectivity
Verifies the operational status of your InfoVetted API connection.

### create_screening_contact
Adds an individual to the system who needs to be screened.

### create_contact_group
Creates an organizational group for managing related screening contacts.

### create_new_vetting_check
Starts a new background check process for a specific candidate.

### get_contact_details
Retrieves full profile data for a specific person in your network.

### get_vetting_request_status
Checks the current completion status and progress of an active vetting request.

### list_screening_contacts
Lists all individuals currently in the screening system who are awaiting checks.

### list_contact_groups
Shows a list of existing organizational contact groups you've set up.

### list_vetting_requests
Shows a directory of all historical and active vetting requests in your account.

### list_supported_check_types
Retrieves a list of background check types that InfoVetted accepts, like criminal or education verification.

### list_configured_webhooks
Displays all webhooks currently set up within your InfoVetted account.

## Prompt Examples

**Prompt:** 
```
Show all active vetting requests and create a new background check for a candidate.
```

**Response:** 
```
Active vetting requests: 8 total. In Progress: 5. Pending: 2. Awaiting Review: 1. Recent: 'Maria Silva' (Standard Package, 60% complete, criminal + employment). 'James Lee' (Premium Package, 40% complete, full background). Contact created: Carlos Mendes (screening_089). Vetting initiated: Standard Background Package (criminal check, employment verification, education verification). Status: Pending. Expected completion: 3-5 business days.
```

**Prompt:** 
```
Check the status of Maria Silva's background check and list all screening contacts.
```

**Response:** 
```
Maria Silva (vetting_4521): Status: In Progress (60%). Criminal check: ✅ Clear. Employment verification: ✅ Confirmed (3 employers). Education verification: ⏳ In progress (university confirmation pending). Credit check: ⏳ Pending. Expected completion: Apr 28. Screening contacts: 34 total. Active checks: 8 contacts. Completed: 22. No checks: 4. Would you like to view results or create a new check?
```

**Prompt:** 
```
Show completed vetting results and cancel the pending check for candidate #3.
```

**Response:** 
```
Completed vettings (last 30 days): 22 total. ✅ Clear: 18 (82%). ⚠️ Flagged: 3 (14%). ❌ Failed: 1 (4%). Flagged details: 'João Santos' — employment gap (6 months unaccounted). 'Ana Costa' — minor traffic violation. 'David Kim' — degree verification delayed. Cancelled: Pending check for candidate #3 (vetting_4519, 'Lisa Park', Basic Package). Refund: credited. Status: ❌ Cancelled.
```

## Capabilities

### Initiate Background Checks
Starts a new vetting process for a candidate using specified background packages.

### Manage Candidate Profiles
Creates and manages detailed records for individuals who need to be screened.

### Track Vetting Statuses
Checks the current progress of any background check or vetting request.

### View Check Results
Retrieves specific pass/fail status and compliance details for completed checks.

### Cancel Vettings
Stops an active background check process before it is complete.

## Use Cases

### The Candidate Dropped Out
An HR specialist realizes a candidate, 'Jane Doe,' just left the process before checks were finished. Instead of logging into the portal to find the ID and manually clicking cancel, they prompt their agent: 'Cancel Jane Doe's vetting.' The agent uses `cancel_active_vetting`, confirms the cancellation, and updates the record.

### Setting Up a New Department
A manager needs to screen five people for a new project team. They first use `create_contact_group` to label them 'Project Phoenix Team,' then loop through `create_screening_contact` for each person, making the entire process traceable and organized.

### Auditing Compliance Records
A compliance officer needs to prove that all hires in Q1 were properly vetted. They prompt the agent to 'list vetting requests' and then use `get_vetting_request_status` repeatedly until they have a full, auditable report showing pass/fail for every required check.

### Investigating a Missing Record
A staffer needs to verify if 'John Smith' was previously screened by the company but the record is hard to find. They use `list_screening_contacts` first, and then narrow it down using `get_contact_details` to pull up the old history.

## Benefits

- Manage the whole screening lifecycle from one place. You don't need to jump between tabs; you just ask your agent to 'list vetting requests,' and it gives you the status, history, and completion dates instantly.
- Ensure compliance by tracking required checks. Need to know what background check types are available? Use `list_supported_check_types` to validate parameters before calling `create_new_vetting_check`.
- Organize your staff. Instead of losing track of who needs vetting, use `list_screening_contacts` and `get_contact_details` to keep all necessary profile data together.
- Handle high volume efficiently. You can create multiple screening contacts using `create_screening_contact`, making it easy for staffing agencies dealing with dozens of applications daily.
- Maintain a clean audit trail. Viewing the `list_vetting_requests` and checking their status is straightforward, keeping your team compliant and organized.

## How It Works

The bottom line is you manage complex compliance workflows using natural language prompts instead of clicking through multiple forms.

1. First, you subscribe to this MCP and input your InfoVetted API Key.
2. Next, tell your agent what you need. For example, 'Check the status of vetting request X' or 'Create a new check for Y'.
3. The MCP executes the command against InfoVetted and returns structured data confirming the current status, results, or newly created records.

## Frequently Asked Questions

**How do I start a new background check with InfoVetted? (create_new_vetting_check)**
You tell your agent to 'create a new vetting check.' You must specify the candidate's details and which checks you want, like criminal or education verification. The tool will then initiate the process.

**What is the best way to track multiple candidates? (list_vetting_requests)**
Use `list_vetting_requests` first; this gives you a master list of all checks. You can then drill down using `get_vetting_request_status` for specific, actionable updates.

**If I need to stop a check, what tool should I use? (cancel_active_vetting)**
`cancel_active_vetting` lets you halt an ongoing check. Just provide the request ID and confirm cancellation; it handles the process cleanly.

**How do I ensure my data is clean before adding a contact? (create_screening_contact)**
Always use `get_contact_details` first to pull existing information. This prevents duplicate records and ensures you have the most current profile data for screening.

**How do I check if my API key is connected properly using `check_api_connectivity`?**
It immediately verifies your InfoVetted API status. This confirms that your credentials are active and ready to run checks through any MCP-compatible client.

**I only have a contact's ID, how do I get all their details using `get_contact_details`?**
This function pulls the full profile data for one specific individual. It gives you every piece of information available on that person, beyond what appears in a simple screening list.

**What does `list_contact_groups` do if I need to organize my candidates?**
It lists all existing organizational contact groups. This is useful for understanding your internal structure and grouping multiple people before you run any checks.

**Before starting a check, how can I see what types are available using `list_supported_check_types`?**
This function lists every background check type InfoVetted supports. You use this to define the precise scope of your vetting process, ensuring full compliance.

**Can I initiate a background check through the AI agent?**
Yes. Use `create_new_vetting_check` with the contact ID and vetting package to initiate a background check. Use `create_screening_contact` first if the person isn't in your system. Track progress with `get_vetting_request_status`.

**Can I track the status of active vetting requests?**
Yes. Use `list_vetting_requests` to see all requests with their current status. Use `get_vetting_request_status` for detailed progress on a specific check. Use `cancel_active_vetting` to stop a check that's no longer needed.

**Can I manage screening contacts and their data?**
Yes. Use `list_screening_contacts` to browse all contacts, `get_screening_contact` for individual profiles, and `create_screening_contact` to add new people to the system. Each contact can have multiple vetting requests associated.