# Mav MCP for AI Agents AI Agent Connect

> Mav lets your AI agent handle the heavy lifting of candidate screening through SMS. It automatically qualifies prospects, schedules interviews, and manages high-volume recruiting campaigns without you having to manually text every single applicant. It turns messy outreach into a structured, conversational flow that actually gets people to respond.

## Overview
- **Category:** artificial-intelligence
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_qQLFfDboeWBC45KPcRsFWBJGftwQoyzZy5QSHszO/ai-agent-connect
- **Tags:** conversational-ai, lead-qualification, sms-marketing, lead-engagement, automation, playbook-management

## Description

Managing a high-volume recruiting pipeline usually feels like a constant game of phone tag. You're stuck toggling between tabs, copy-pasting candidate info, and trying to keep up with SMS replies that come in at all hours. This Connector changes that by letting your AI agent do the front-line work for you. Instead of manually vetting every lead, your agent can trigger automated screening conversations and handle the back-and-forth. You can ask your agent to check a candidate's status, pull transcripts from recent chats, or launch a new SMS campaign for a specific role. It brings your Mav account directly into your daily workspace, making it easier to see who's actually qualified and who's just browsing. By connecting this to the Vinkius catalog, you get a direct line into your recruiting funnel, allowing you to focus on the actual interviews rather than the initial screening grind.

## Tools

### get_lead
Pull up specific details for a single candidate to see where they are in the funnel. This helps you quickly identify high-priority leads.

### get_playbook
View the specific screening logic and steps for a given recruiting campaign. Use this to understand the automated flow.

### list_events
List conversation events

### list_leads
Get a full list of all candidates currently in your Mav account. This provides a bird's eye view of your pipeline.

### list_outcomes
g., qualified, unqualified).

List possible conversation outcomes

### list_playbooks
See all the different screening flows available to your recruiting team. Use this to manage your campaign library.

### trigger_playbook
Trigger a playbook for a lead

### update_lead
Change candidate details or status markers on the fly. This keeps your lead data accurate as you move them through the funnel.

## Prompt Examples

**Prompt:** 
```
Show me the completion rates for our active SMS campaigns.
```

**Response:** 
```
### Active SMS Campaigns

| Campaign Name | Candidates | Reply Rate | Completion Rate |
| :--- | :--- | :--- | :--- |
| **Retail Store Manager** | 450 | 68% | 45% ⭐ |
| **Warehouse Staff** | 1,200 | 42% | 28% |
| **Customer Support** | 300 | 55% | 38% |

**Total Screened Today:** 145
**Total Qualified:** 42
```

**Prompt:** 
```
Launch a screening flow for the new retail manager list.
```

**Response:** 
```
✅ **Campaign Launched!**

*   **Campaign ID:** `cmp_890`
*   **Target List:** 'Retail_Applicants_Q2' (150 candidates)
*   **Screening Flow:** 'Basic Retail Qualification'
*   **Status:** First SMS sent to all 150 candidates.
*   **Estimated Completion:** 2-4 hours.
```

**Prompt:** 
```
Give me the transcript for the most recent qualified candidate.
```

**Response:** 
```
### Qualified Candidate: Sarah J. (Retail Manager)

**Score:** 95%
**Key Notes:** 
*   Has 5+ years retail management experience.
*   Available immediately.

**Transcript Summary:**
*   *Agent:* Asked about leadership experience.
*   *Sarah:* Mentioned managing a team of 15.
*   *Agent:* Asked about availability.
*   *Sarah:* Confirmed immediate start.

[Link to full transcript available]
```

## Capabilities

### Trigger automated screening conversations
Start an automated SMS flow to vet new candidates immediately.

### Launch outbound SMS recruiting campaigns
Deploy new SMS outreach sequences for specific job roles.

### Browse candidate qualification statuses
See which leads are qualified and which ones are still in progress.

### Monitor message open and reply rates
Track how candidates are interacting with your automated messages.

### Access screening transcripts and responses
Pull the full history of candidate conversations for review.

### Manually opt-out leads from sequences
Remove specific candidates from automated messaging instantly.

### Stop active playbooks for specific leads
Pause an automated flow for a candidate who needs a human touch.

## Use Cases

### High-volume warehouse hiring
A recruiter asks the agent to launch a screening campaign for 100 warehouse applicants using a specific playbook to handle the initial vetting.

### Candidate follow-up
An HR manager asks the agent to find all leads who haven't responded in 48 hours and check their last activity to prioritize outreach.

### Transcript review
A hiring manager asks the agent to pull the screening transcript for a top-scoring candidate before scheduling a phone interview.

### Campaign monitoring
A talent lead asks the agent to show the reply rates and completion percentages for all active SMS campaigns to see what's working.

## Benefits

- Stop manually texting every applicant by using create_lead to trigger automated SMS screening flows.
- Get a clear picture of your pipeline by using list_leads to see every candidate's status in one view.
- Save time on follow-ups by using list_activities to see exactly how candidates are interacting with your messages.
- Quickly pivot your strategy by using list_playbooks to see which screening flows are currently active.
- Ensure a better candidate experience by using stop_playbook to intervene manually when a human touch is needed.
- Keep your data clean by using opt_out_lead to remove candidates who aren't a fit from your automated sequences.

## How It Works

The bottom line is you get to stop manually texting candidates and start managing the results of automated outreach.

1. Subscribe to the Mav MCP on Vinkius.
2. Add your Mav API Key to your agent's configuration.
3. Start asking your agent to manage campaigns or screen leads.

## Frequently Asked Questions

**Can Mav MCP help me screen hundreds of applicants at once?**
Yes, it triggers automated SMS flows that vet candidates for you. This means you can handle high-volume hiring without having to text every person individually.

**How does the Mav MCP handle candidate opt-outs?**
It allows your agent to manually opt people out of automated sequences. This ensures you stay compliant and respect candidate preferences.

**Can I see what candidates are saying in their SMS chats?**
Yes, you can pull transcripts of the screening conversations. This helps you understand the candidate's background before you jump on a call.

**Is the Mav MCP good for high-volume warehouse hiring?**
It's perfect for it. It automates the repetitive screening questions for large applicant pools, letting you focus on the qualified hires.

**How do I start a new screening campaign with Mav MCP?**
Just tell your agent to create a new lead or launch a playbook. It will trigger the automated SMS sequence based on the rules you've set in Mav.

**Can I see which candidates are actually qualified?**
Yes, you can ask your agent to list all leads and see their qualification status. It highlights who is ready for the next step.

**Can I trigger AI screening conversations?**
Yes. Launch SMS or web-based screening flows and track candidate responses automatically.

**How does Mav authentication work?**
Mav uses a custom API Key header against `hiremav.com/api/v2`.

**Can I track campaign engagement metrics?**
Yes. Monitor open rates, reply rates, completion rates, and candidate drop-off points.

**How do I find my Mav API Key?**
Log in to your Mav dashboard and navigate to Settings to find your API Key.

**Can I trigger a playbook for a specific phone number?**
Yes! Use the `trigger_playbook` tool and provide the playbook ID and the lead's phone number.

**Is my data secure?**
Absolutely. Your token is encrypted at rest and injected securely at runtime.