# CommPeak MCP

> CommPeak connects your AI agent to a powerful dialer and SMS gateway. Use this MCP to manage full-cycle sales outreach: list active campaigns, add new leads, pull campaign status reports, and send targeted text messages directly from chat.

## Overview
- **Category:** sales-automation
- **Price:** Free
- **Tags:** dialer-campaigns, lead-management, sms-gateway, call-queues, outbound-calling

## Description

This MCP lets you run complex communication workflows without leaving your conversation window. Instead of jumping between a CRM, an email platform, and an SMS dashboard, you handle it all through natural language commands. You can list every active dialing campaign to see which ones need attention, pull detailed lead lists for qualification, or even add fresh leads straight into the dialer queue. Need to follow up? Send targeted text messages using a custom sender ID right from your agent. And if a message goes out, you can check its delivery status and view recent activity logs. By integrating CommPeak through Vinkius, your AI client becomes an operational layer that controls both outreach campaigns and lead data—all in one place.

## Tools

### create_lead
Adds a new contact record to an active dialer campaign queue.

### delete_lead
Removes a lead from the system permanently.

### get_campaign_details
Fetches specific information about one dialer campaign by its ID.

### get_lead_details
Retrieves all contact and status details for a single lead record.

### get_sms_status
Checks the final delivery or failure status of an SMS message you sent previously.

### list_dialer_campaigns
Retrieves a complete list and summary of every active dialer campaign.

### list_leads
Gathers a detailed list of leads currently assigned to a specific campaign.

### list_recent_sms
Retrieves a history summary of the most recent outbound SMS messages sent.

### send_sms
Sends a text message to a specified phone number using CommPeak's texting API.

## Prompt Examples

**Prompt:** 
```
Send an SMS to '+1234567890' saying 'Your order has been shipped!'
```

**Response:** 
```
SMS sent successfully to +1234567890. Message ID: msg-7x2k9. Status: delivered. Sender ID: default.
```

**Prompt:** 
```
Show me all active dialer campaigns.
```

**Response:** 
```
You have 3 active campaigns:
1. 'Q1 Outreach' — 450 leads, 62% contacted
2. 'Renewal Follow-up' — 180 leads, 35% contacted
3. 'New Prospects' — 920 leads, 12% contacted
Would you like to add leads to any of these?
```

**Prompt:** 
```
Check the delivery status of SMS message ID 'msg-7x2k9'.
```

**Response:** 
```
Message ID 'msg-7x2k9' to +1234567890 was successfully delivered on Oct 25 at 14:30 UTC.
```

## Capabilities

### View campaign status
Retrieve a list of all active dialer campaigns and their current statuses.

### Manage leads
Add new prospects to specific campaigns or permanently remove old lead records from the system.

### Send text messages
Dispatch immediate SMS texts to any number using a custom sender ID.

### Check message history
Retrieve lists of recently sent texts or check the delivery status of a single message ID.

## Use Cases

### The quarterly clean-up
A manager needs to know which leads are active but haven't been touched in months. They ask the agent to first run `list_leads` for Campaign Alpha, then use `get_lead_details` on the results list to filter out contacts that fail validation checks, prepping a clean slate.

### Immediate outreach follow-up
A salesperson closes a call and needs to send immediate information. They tell their agent to use `send_sms` right away with the client's number, followed by checking `get_sms_status` in case of delivery issues.

### Preparing for a new launch
The marketing team needs to start a new outreach cycle. They ask the agent to first call `list_dialer_campaigns` to confirm available slots, then use `create_lead` to dump 50 fresh contacts into the queue.

### Investigating message failures
A user notices some messages aren't going out. They ask the agent to pull a summary using `list_recent_sms`, and then drill down on one specific failure with `get_sms_status` to figure out why it bounced.

## Benefits

- You stop switching between a CRM, your campaign dashboard, and your messaging app. This MCP handles lead creation (`create_lead`) and sending texts (`send_sms`) in one flow.
- Never miss a status update again. Use `list_dialer_campaigns` to see the health of all your campaigns, or use `get_campaign_details` for deep dives on specific outreach efforts.
- Qualification gets faster. Instead of guessing if data is clean, call `get_lead_details` instantly to pull full contact records and validate information before making a move.
- Messaging tracking is built-in. You don't just send texts; you track them. Use `list_recent_sms` or check specific status with `get_sms_status`. 
- Lead hygiene improves dramatically. Need to pull all leads from one place? Run `list_leads` for a full roster, and if a lead is dead weight, run `delete_lead`.

## How It Works

The bottom line is your AI client uses these tools to perform complex communications tasks that used to require multiple logins and API calls.

1. Add the CommPeak integration to your AI client's toolset and provide your API credentials.
2. Tell your agent what you need, like 'List all active campaigns' or 'Send an SMS to 555-1234.'
3. The MCP executes the command against CommPeak and returns structured data—campaign details, lead lists, or a confirmation of message delivery.

## Frequently Asked Questions

**How do I check if an SMS sent via CommPeak has been delivered?**
You use the `get_sms_status` tool. This retrieves the final delivery or failure status for a specific message ID, giving you immediate confirmation.

**Can I list all ongoing dialer campaigns using list_dialer_campaigns?**
Yes, calling `list_dialer_campaigns` immediately shows you every active campaign. It's the best way to see your overall outreach footprint.

**What is the difference between create_lead and list_leads?**
Use `create_lead` when you have a new contact that needs adding to a queue. Use `list_leads` when you need to see all existing leads currently in a specific campaign.

**How do I send an SMS using the send_sms tool?**
You simply tell your agent to use `send_sms`, providing the recipient's number and the message text. The platform handles the API connection for you.

**If I use delete_lead, does it just archive the lead or permanently remove it from CommPeak?**
It permanently removes the lead. Be sure you know which records you want to delete before running this command, as the action cannot be undone.

**When I run list_leads, do I need to specify a campaign ID to get accurate results?**
Yes, you must provide the Campaign ID. Without it, you'll receive an incomplete list of leads that aren't tied to a specific active outreach effort.

**What happens if I try to use send_sms but the phone number is invalid?**
The tool will fail and return an explicit error code. You should check the API response for details indicating whether the issue was the format, country code, or if the destination number isn't active.

**When I get_lead_details, what types of data points can my agent retrieve about a lead?**
It retrieves comprehensive information. Expect to see contact details, current campaign status, and any historical interaction logs associated with that specific lead record.

**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.