# CommPeak MCP for AI Agents AI Agent Connect

> CommPeak MCP lets your agent handle outbound SMS and dialer campaigns directly. It gives your agent the ability to manage lead lists, monitor call queues, and send text messages to customers without you having to switch tabs or copy-paste data between your CRM and communication platform.

## Overview
- **Category:** sales-automation
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_28bo2UdSxbVLV4cpToGvX1H1G6fnfDvWqjn3Ie2R/ai-agent-connect
- **Tags:** dialer-campaigns, lead-management, sms-gateway, call-queues, outbound-calling

## Description

You can now let your agent handle the heavy lifting of outbound communications. Instead of manually moving leads from a spreadsheet into a dialer or copy-pasting phone numbers to send a blast of texts, your agent handles the data flow for you. It can pull your active campaigns, see which leads are already in the queue, and push new ones in based on your instructions. If you need to send a quick follow-up text to a customer, your agent just does it. You can also check if those messages actually landed or if a campaign is hitting its targets. It's a way to keep your sales pipeline moving without the constant back-and-forth between your communication tools and your chat interface. You can find this in the Vinkius catalog to get your agent connected to the CommPeak API in minutes.

## Tools

### create_lead
Add a new lead to a campaign. This helps you populate your dialer quickly.

### get_lead_details
Retrieve detailed information about a specific lead. You can check specific contact info for any lead in your list.

### get_sms_status
Retrieve the status of a previously sent SMS. This lets you confirm if a message actually reached the customer.

### list_dialer_campaigns
Retrieve a list of all dialer campaigns. Use this to see what outreach is currently running.

### delete_lead
Permanently remove a lead from the system. Use this to clean up your outreach lists.

### get_campaign_details
Retrieve detailed information about a specific campaign. This gives you a clear look at your active dialer stats.

### list_leads
Retrieve leads from a specific campaign. This lets you see every contact currently in a specific queue.

### list_recent_sms
Retrieve a list of recently sent SMS messages. This provides a quick history of your recent outbound texts.

### send_sms
Send a text message via CommPeak SMS API. This lets your agent send direct messages to any phone number.

## Prompt Examples

**Prompt:** 
```
Add a new lead to the 'New Prospects' campaign with the number +15550123 and name John Doe.
```

**Response:** 
```
I've added **John Doe** (+15550123) to the **New Prospects** campaign.

**Status:** Success
**Campaign:** New Prospects
**Lead ID:** lead_99283

Would you like me to send a confirmation text to this lead now?
```

**Prompt:** 
```
Show me the status of the 'Q1 Outreach' campaign.
```

**Response:** 
```
Here is the current status for the **Q1 Outreach** campaign:

| Metric | Value |
| :--- | :--- |
| Total Leads | 450 |
| Contacted | 62% |
| Active Queue | 12 |

Your team is currently making great progress on this outreach.
```

**Prompt:** 
```
Send a text to +15559876543 saying your appointment is confirmed for tomorrow.
```

**Response:** 
```
✅ **SMS Sent**

**Recipient:** +15559876543
**Message:** "Your appointment is confirmed for tomorrow."
**Status:** Delivered
**Message ID:** msg_44210

Is there anything else you need help with?
```

## Capabilities

### Send outbound SMS
Send text messages to any number with a custom sender ID.

### Manage dialer campaigns
View active campaigns and monitor call queues.

### Add new leads
Insert new contact details into specific dialer campaigns.

### Track message delivery
Check the status of previously sent SMS messages.

### Remove old leads
Delete leads from your system permanently.

### Review campaign details
Get full information on specific dialer campaigns.

## Use Cases

### Adding leads after a call
An SDR finishes a call and asks the agent to add this person to the Q1 Outreach campaign using create_lead.

### Checking campaign health
A manager asks how is the Renewal Follow-up doing and the agent uses list_dialer_campaigns to show progress.

### Sending a quick follow-up
A marketer tells the agent to send a text to the last lead saying thanks using send_sms.

### Cleaning up a list
An admin tells the agent to remove the leads that did not pick up using delete_lead.

## Benefits

- No more manual data entry. Use create_lead to push contacts into your dialer without leaving your chat window.
- Real-time campaign monitoring. Use list_dialer_campaigns to see how your outreach is performing instantly.
- Faster follow-ups. Use send_sms to reach out to customers the moment a lead qualifies.
- Better data hygiene. Use delete_lead to keep your outreach lists clean and up to date.
- Instant delivery confirmation. Use get_sms_status to know exactly when a customer sees your message.
- Comprehensive lead visibility. Use list_leads to see every person in your queue at a glance.

## How It Works

The bottom line is you get a hands-off way to manage high-volume outbound sales communications.

1. Connect the CommPeak MCP to your AI client and provide your SMS API token and dialer credentials.
2. Ask your agent to perform a task like send a text to this lead or show my active campaigns.
3. The agent executes the command through the API and reports back with the success status or data.

## Frequently Asked Questions

**Can I use the CommPeak MCP to send bulk SMS?**
Yes, you can use the Connector to send messages to your contacts. It connects your agent to the CommPeak SMS gateway so you can handle outreach at scale through your chat interface.

**How does the CommPeak MCP handle my lead data?**
The Connector acts as a bridge. It allows your agent to pull, add, or remove lead information from your CommPeak campaigns based on your direct commands.

**Can my agent see my active dialer campaigns?**
Yes, your agent can list all active dialer campaigns and provide you with specific details on lead counts and progress without you having to log into a dashboard.

**How do I check if a text actually reached the customer?**
You can ask your agent to check the status of a specific message. It will query the CommPeak API and tell you if the text was delivered or is still pending.

**Can I use CommPeak MCP to clean up my lead lists?**
Absolutely. You can tell your agent to remove specific leads from your campaigns, which helps keep your dialer lists organized and accurate.

**Does the CommPeak MCP work with my existing dialer?**
It works with your existing CommPeak account. As long as you have the correct API credentials, your agent can manage your existing campaigns and queues.

**How do I find my SMS API token?**
In the CommPeak Portal, go to **SMS > SMS Platform > API Keys**. Generate or copy your existing token and paste it below.

**Do I need dialer credentials to send SMS?**
No. SMS and Dialer use separate credentials. You only need the SMS Token to use the SMS tools.

**How do I whitelist my IP for the Dialer API?**
In CommPeak Dialer settings, go to **API Management** and add your IP addresses in the IP ACL field.