# Mav MCP > Mav is your MCP server for conversational SMS automation. It connects any AI client—Claude, Cursor, or your agent—to run sophisticated lead qualification playbooks directly via SMS. Instead of manual follow-ups, you trigger automated conversations to qualify new leads instantly and track their status in real time. Use Mav to manage entire engagement sequences through natural chat flow. ## Overview - **Category:** artificial-intelligence - **Price:** Free - **Tags:** conversational-ai, lead-qualification, sms-marketing, lead-engagement, automation, playbook-management ## Description Mav handles your conversational SMS automation, letting your AI client—be it Claude, Cursor, or whatever agent you're running—run complex lead qualification playbooks straight through text messages. You don't gotta manually follow up with every new prospect anymore; Mav kicks off automated chats that qualify leads instantly and keep track of where they land in your pipeline. It manages the whole engagement sequence using natural chat flow. When you connect to Mav via the Model Context Protocol, you gain full control over running sophisticated marketing playbooks directly through SMS conversations. Here's what the tools let you do: **List Playbooks.** You can pull a list of every AI-driven conversational playbook already set up in your account. This lets you quickly see all the different qualification paths or conversation strategies you have ready to deploy without having to guess which one works best. **Trigger Lead Conversation.** If you've picked the right playbook and got the target phone number, this tool starts the automated SMS chat immediately. It kicks off the qualification process using a specific playbook ID, so your agent doesn't waste time figuring out how to start talking—it just gets it done. **Inspect Lead Metadata.** You can pull up detailed data points for any given lead ID. This isn't just checking a box; you get all the raw info and current status details associated with that lead, letting you know exactly what kind of person they are in your system records. **Get Lead Outcomes.** To check where a specific lead is right now, you use this tool. It tells you the most recent status or outcome that the lead reached within your pipeline. You instantly know if they qualified, dropped out, or hit some other milestone—you don't have to wait for an email update. Think about it: instead of juggling multiple tabs and manually logging notes after a quick chat, Mav keeps everything centralized. You trigger the initial conversation using the playbook ID, then you use `Inspect Lead Metadata` to grab all the background details on that lead. If you need to know their qualification status—whether they're hot or cold—you hit up `Get Lead Outcomes`. And if you gotta see what other playbooks you can run next week? Just call `List Playbooks` and pull the whole roster of strategies available. It’s about having a predictable, automated process that doesn't rely on someone remembering to send that follow-up message. Mav gives your agent reliable access to manage entire client engagements through chat-driven automation. You just point it at the lead and let the system handle the heavy lifting. ## Prompt Examples **Prompt:** ``` List all my Mav playbooks. ``` **Response:** ``` Retrieving playbooks... You have several active playbooks, including 'Real Estate Qualification' and 'Solar Interest Check'. ``` **Prompt:** ``` Trigger the 'Lead Qual' playbook for +1234567890. ``` **Response:** ``` Triggering playbook... The 'Lead Qual' (ID: 555) conversation has been successfully started for +1234567890. ``` **Prompt:** ``` Show recent outcomes for lead ID 9876. ``` **Response:** ``` Checking lead status... Lead 9876 reached the 'Qualified' outcome yesterday. ``` ## Capabilities ### List Playbooks Retrieves a list of all available AI-driven conversational playbooks configured in your Mav account. ### Trigger Lead Conversation Starts an automated SMS conversation using a specified playbook ID and target phone number, beginning the qualification process immediately. ### Get Lead Outcomes Checks the most recent status or outcome reached by a specific lead ID in your pipeline. ### Inspect Lead Metadata Retrieves detailed data points and current status information for a given lead ID. ## Use Cases ### Following up on a trade show list You get a spreadsheet of 50 cold contacts from a trade show. Instead of sending generic emails, you ask your agent to run the 'Real Estate Qualification' playbook for all numbers using `trigger_lead_qualification`. You then use `get_lead_outcomes` hours later to filter out everyone who hit the 'Qualified' outcome. ### Building a new qualification flow Marketing just launched a solar product. Before writing any SMS copy, you ask your agent to run `list_playbooks`. You see existing playbooks but realize you need something different, so you can build and test the new funnel before deployment. ### Investigating a stalled lead A hot lead suddenly goes silent. You don't know why they stopped responding. Instead of waiting, your agent calls `get_lead_metadata` for that lead ID to pull the last recorded touchpoint and check if any issues were flagged. ### Testing multiple sales funnels You want to see which message resonates best. You ask your agent to run 'Lead Qual' for one number, then immediately repeat the process with a different playbook ID. The automation allows you to A/B test qualification strategies quickly. ## Benefits - **Instant Qualification:** Use the `trigger_lead_qualification` tool to start an automated, natural conversation with a cold lead. You get immediate confirmation that the sequence has begun for a given number. - **Full Playbook Visibility:** The `list_playbooks` tool lets your agent inspect every conversational playbook you've built—whether it's 'Real Estate Qualification' or 'Solar Interest Check.' No more guessing which funnel to run. - **Real-Time Status Tracking:** Instead of logging into the SMS dashboard, use `get_lead_outcomes` to ask your agent directly: 'What was the last outcome for lead 9876?' You get a clean status report instantly. - **Deep Lead Context:** The `get_lead_metadata` tool pulls all available context on a lead—not just the final score, but detailed history and metadata. This is critical before handing off to a human salesperson. - **Actionable Workflow Control:** You move beyond simple messaging. By managing playbooks via tools like `trigger_lead_qualification`, you build complex, automated workflows that act as miniature sales reps. ## How It Works The bottom line is that you never have to leave your AI workflow to manage or track conversational leads again. 1. Subscribe to the Mav MCP server and provide your API Key. 2. Your AI client sends an instruction (e.g., 'Qualify this new lead'). 3. The agent calls the `trigger_lead_qualification` tool, starting the conversation flow via SMS. ## Frequently Asked Questions **How does Mav MCP Server work with my existing SMS platform?** Mav connects to your service via the API key. It acts as a conversational layer on top of your messaging infrastructure, allowing your agent to tell it *what* conversation to run and *who* to send it to. **Can Mav MCP Server handle multiple types of leads?** Yes. The `list_playbooks` tool lets you manage different playbooks—like one for 'Solar Interest' and another for 'Real Estate Qualification.' You just trigger the right one. **What happens if a lead reply is unexpected?** The playbook handles conversational flow. The system tracks real-time events, ensuring that even if the conversation deviates from the script, the outcome and metadata are updated for you to review later. **How many tools does Mav MCP Server have right now?** Mav exposes four key tools: `list_playbooks`, `trigger_lead_qualification`, `get_lead_outcomes`, and `get_lead_metadata`. **When I first set up my agent to use the `List all my Mav playbooks` tool, what credentials do I need?** You must provide your Mav API Key for authentication. Your AI client uses this key to securely connect and manage your account, ensuring every call is tracked against your usage limits. **Are there rate limits if I frequently use the `Trigger 'Lead Qual' playbook for [number]` command?** Yes, Mav enforces specific rate limits to maintain service reliability. If you exceed them, the API will return a clear error code (HTTP 429), allowing your agent to pause and retry automatically. **What detailed data points do I get when using the lead ID lookup command?** The system returns structured metadata detailing the final status, the time of conversion, and which specific playbook drove that outcome. This lets your agent log highly accurate records for reporting. **If I want to change or delete a playbook after running `List all my Mav playbooks`, can the MCP server do it?** The MCP server is built for execution, not modification. While you list and trigger them here, modifying or deleting actual playbooks requires using the dedicated Mav platform dashboard. **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.