# BatchDialer MCP MCP > BatchDialer automates your outbound calling workflows through natural conversation with any AI client. It lets you manage campaigns, update leads, and review call outcomes without ever leaving your agent interface. You can get complete call histories, list all active dialing campaigns, or check the health of managed phone numbers—all from one spot. ## Overview - **Category:** sales-automation - **Price:** Free - **Tags:** outbound-dialing, sales-operations, call-campaigns, lead-management, telephony-automation ## Description Running a high-volume sales operation means constant juggling: checking lead status in one system, campaign metrics in another, and then logging detailed call outcomes somewhere else. This MCP cuts that friction entirely. Now you can talk to your AI client and simply ask it to update your entire process. You tell the agent what needs doing—maybe adding a new contact or listing all failed calls from yesterday—and it handles the API calls instantly. It takes control of everything, letting your team focus on selling instead of clicking through dashboards. By connecting BatchDialer via Vinkius, you give your AI client full visibility into campaign status, lead data integrity, and every single call disposition that happened this week. ## Tools ### add_lead Adds a new contact record, giving them an immediate ID for inclusion in campaigns. ### get_call_details Fetches all specific information about one particular call event using its unique identifier. ### get_campaign Retrieves the full details and setup parameters for a single, specified dialing campaign. ### get_lead Checks specific information on one existing lead using their ID number. ### get_user_profile Retrieves the profile data for the user who is currently authenticated to the system. ### list_call_logs Generates a list of call records and interaction history, allowing you to see what happened over time. ### list_campaigns Provides an inventory of all available dialing campaigns managed by the system. ### list_dispositions Lists every possible outcome or status a call can be marked with, like 'Voicemail' or 'Follow-up'. ### list_leads Provides a complete list of all contacts and leads currently stored in the system. ### list_phone_numbers Displays an inventory of all managed phone numbers, confirming their availability for outbound dialing. ## Prompt Examples **Prompt:** ``` List all our active dialing campaigns on BatchDialer. ``` **Response:** ``` I've fetched your campaigns. You currently have 2 active campaigns: 'Real Estate West' (ID: 5542) and 'Mortgage Leads Q1' (ID: 5560). Which one would you like to drill into? ``` **Prompt:** ``` Add a new lead: John Doe, phone 555-0199, email john@example.com. ``` **Response:** ``` I've successfully added 'John Doe' as a new lead in your BatchDialer system. They have been assigned ID 992834 and are ready for the next campaign sync. ``` **Prompt:** ``` Show the recent call logs from today. ``` **Response:** ``` Today's logs show 15 completed calls. Most interactions resulted in 'Voicemail' (8) or 'Follow-up Needed' (4). Would you like to see the details for the follow-up calls? ``` ## Capabilities ### Manage Lead Records Add new contacts to the dialing list, check existing lead details, or view a complete roster of all potential clients. ### Monitor Active Campaigns List and inspect every running sales campaign to see its status and current activity level. ### Review Call History Retrieve detailed logs of past calls, including the duration and specific outcome recorded for each interaction. ### Track Interaction Results List all possible call outcomes (dispositions) to accurately categorize and report on lead interactions. ### Check Phone Number Status View the list of managed phone numbers, ensuring your caller IDs are active and ready for use. ## Use Cases ### The Sales Manager needs a full status report. A sales manager wakes up needing to know the status of all outreach. They ask their agent to run `list_campaigns` and `list_leads`. The agent compiles this data, giving the manager an immediate overview of which campaigns are active, how many leads they have, and if any numbers need attention. ### The BDR is following up after a call. A BDR just finished a call. Instead of logging into the portal to find the disposition code, they ask their agent to run `list_call_logs`. The agent shows them the history and allows the BDR to confirm or update the status immediately. ### The Ops team needs a cleanup. The ops team realizes some leads are incomplete. They ask the agent to run `list_leads`, spot the missing data, and then use `get_lead` on specific IDs to confirm what details need to be added before re-running campaigns. ### Checking for number changes. The team is prepping a new region. They ask the agent to run `list_phone_numbers`. The agent checks the current roster and flags any numbers that are marked as inactive or unavailable, preventing costly dialer errors. ## Benefits - Instantly monitor campaign status. Instead of opening the BatchDialer app to check if 'Mortgage Leads Q1' is running, you just ask the agent using `list_campaigns` and get a direct answer. - Maintain data hygiene effortlessly. You can add new contacts with `add_lead`, ensuring every prospect in your calling pipeline has up-to-date information without manual form filling. - Deep dive into history. Need to know why that call failed? Use `list_call_logs` and then narrow it down using `get_call_details` for the full context on a single interaction. - Know your numbers are ready. Before launching a campaign, check the phone number health with `list_phone_numbers` to confirm all managed IDs are active and working. - Accurate reporting. By listing call dispositions using `list_dispositions`, you stop guessing about outcomes and start categorizing lead interactions exactly right. ## How It Works The bottom line is that your AI client becomes a direct proxy to your entire calling infrastructure. 1. Subscribe to this MCP and enter your BatchDialer API Key. 2. Your AI client gains access to all tools, allowing you to execute sales tasks via natural conversation. 3. You simply ask the agent a question—like 'List all campaigns'—and get immediate data back without switching apps. ## Frequently Asked Questions **How do I list all my active dialing campaigns using the BatchDialer MCP?** You ask your agent to run `list_campaigns`. The system immediately retrieves and lists every campaign ID and its current status, letting you know exactly what's running. **If I use add_lead, does it automatically sync with my active campaigns?** It adds the lead to the core database. You then need to run a campaign tool or manually select the new ID when starting a specific dialing sequence for them. **What is the difference between list_call_logs and get_call_details?** `list_call_logs` gives you a summary list of many calls, like a timeline. `get_call_details`, however, fetches every single piece of data—notes, disposition, duration—for one specific call ID. **Can I check which phone numbers are managed by BatchDialer?** Yes, you run the `list_phone_numbers` tool. This shows a clear inventory of all your active and managed calling IDs, so you never guess if a number is available. **When I use `get_user_profile`, what information about my account can my agent retrieve?** The tool retrieves your authenticated user profile details. This allows your agent to confirm operational parameters or identify which account the current dialing session belongs to. **If a campaign isn't running, how do I check its specific status using `get_campaign`?** Using `get_campaign`, you get deep details beyond just the name. You can confirm if the campaign is paused, suspended, or active and see when it was last modified. **Can I filter my contacts by status when I use `list_leads`?** Yes, you can pass filters to `list_leads`. This lets your agent narrow down the contact list quickly, for example, pulling only 'uncontacted' or 'hot' leads. **Before tracking call outcomes, how do I view all available categories using `list_dispositions`?** The tool displays the master list of predefined call dispositions. This ensures that when you log a result, your agent uses the exact, standardized category required by BatchDialer. **Can my AI automatically add a new lead to BatchDialer?** Yes! Use the `add_lead` action with the contact's name and phone number. Your agent will register the lead in your BatchDialer system instantly. **How do I easily list all recent call logs?** Simply ask the agent to `list_call_logs`. It will compile the history of recent outbound activities, including status and duration. **Does the integration allow starting an active call from the agent?** No. For security and operational safety, the current toolset focuses on management and auditing (listing campaigns, managing leads, checking logs). Initiating live calls must be done through the BatchDialer interface.