# ClickSend MCP for AI Agents MCP

> ClickSend manages your entire communication lifecycle—SMS, voice calls, and physical mail—within one place. Connect this MCP to any AI agent to send messages globally, instantly audit message history, track campaigns, and manage contacts all through natural conversation.

## Overview
- **Category:** talk-to-me
- **Price:** Free
- **Tags:** multi-channel-messaging, voice-messaging, sms-gateway, inbound-sms, business-communication

## Description

This connector lets you take full control of how your business communicates with customers. Instead of logging into a separate dashboard every time you need status updates, you talk directly to your agent. You can draft an SMS to multiple people in different countries or pull up the history for a specific customer's inbound message right from your chat window. It handles everything from sending out single-message alerts to running whole marketing campaigns and even checking records of physical letters sent through the post. If you find yourself jumping between five different tabs just to audit communications, this MCP changes that. You connect it via Vinkius and your agent treats all these channels—SMS, voice, print—as one unified conversation point.

## Tools

### get_clicksend_account_info
Retrieves core account details and shows your current credit balance.

### get_sms_outbound_history
Pulls a detailed log of all the SMS messages you've sent out.

### list_clicksend_contact_lists
Lists all contact groups and lists stored within your account.

### list_received_sms
Shows you every inbound (reply) SMS message that has come into your number.

### get_physical_mail_history
Retrieves a log of any physical letters mailed out using ClickSend Post.

### list_sms_marketing_campaigns
Lists all scheduled and previously sent SMS marketing campaigns for review.

### get_voice_call_history
Retrieves a history log of automated voice calls you have initiated.

### send_clicksend_sms
Sends one or more SMS messages to specified recipients using E.164 phone numbers.

## Prompt Examples

**Prompt:** 
```
What were my last three replies from customers?
```

**Response:** 
```
**Inbound SMS History:**
*   **+1 (555) 901-2345:** 'Yes, send the quote.' (Received today at 11:02 AM)
*   **+1 (555) 888-7777:** 'Thanks for calling back!' (Received yesterday at 3:45 PM)
*   **+1 (555) 111-2222:** 'Stop sending updates.' (Received two days ago).
```

**Prompt:** 
```
Check my account status and see the last voice call.
```

**Response:** 
```
*Account Check:* ✅ Balance: $34.50 available.
*Recent Activity:* A recorded automated outbound call was placed to +1 (212) 555-0099 yesterday at 10:00 AM. Status: Completed.
```

**Prompt:** 
```
List all contacts in the 'VIP Clients' group.
```

**Response:** 
```
**Contact List: VIP Clients**
*   +1 (212) 555-0001 (Acme Corp)
*   +1 (312) 987-6543 (Beta Industries)
*   +1 (650) 111-2222 (Client XYZ)
```

## Capabilities

### Send multi-channel messages
Initiate SMS texts to specific numbers globally, or schedule marketing campaigns across multiple recipients.

### Audit communication history
Pull detailed logs of everything that happened, including inbound replies, outbound texts, automated calls, and physical mail shipments.

### Manage account resources
Check your current credit balance, review contact lists, and look up core account details without navigating a portal.

## Use Cases

### Responding to customer replies
A support agent needs to know what a client said yesterday. They ask their agent to 'list all received SMS from the last 24 hours.' The agent immediately returns three recent messages, allowing the agent to reply instantly without opening the web portal.

### Auditing a marketing blast
A manager needs assurance that a campaign ran correctly. They ask their agent to 'show me the status of the holiday SMS campaign.' The agent checks `list_sms_marketing_campaigns` and confirms which phases are complete, solving auditing bottlenecks.

### Checking system readiness before sending
A DevOps engineer needs to know if there's enough credit for a large batch send. They ask their agent 'what is the current account balance?' The agent runs `get_clicksend_account_info` and provides the exact remaining balance, preventing failed deployments.

### Tracking comprehensive client interactions
A field director needs a full picture of one client. They ask their agent to 'show me everything sent to John Doe.' The agent combines data from `get_sms_outbound_history`, voice call history, and physical mail logs for one complete view.

## Benefits

- Audit every interaction immediately. Use `list_received_sms` to pull up inbound replies the second they arrive, letting support agents handle queries without context switching.
- Verify delivery status across all channels. You can check your balance with `get_clicksend_account_info` and then use `get_sms_outbound_history` to see if a text actually left your system.
- Run complex campaigns effortlessly. Review scheduled marketing efforts by listing campaign states using `list_sms_marketing_campaigns`, letting you check statuses for bulk sends.
- Maintain a clear record of all outreach. You can pull history not just from texts (`get_sms_outbound_history`) but also automated voice calls (`get_voice_call_history`) and physical letters via `get_physical_mail_history`.
- Streamline contact management. Use `list_clicksend_contact_lists` to see who's in your system before you send a message, ensuring compliance and accurate targeting.

## How It Works

The bottom line is you manage complex, multi-channel communications by simply talking to your AI agent.

1. Subscribe to this MCP on Vinkius.
2. Provide your ClickSend API Username and API Key (you find these in your ClickSend dashboard).
3. Start chatting with your agent using Claude, Cursor, or any compatible client; it immediately accesses all communication tools.

## Frequently Asked Questions

**How does the ClickSend MCP help me track all my customer messages?**
It centralizes communication history across SMS, voice calls, and physical mail. You can ask your agent to pull up logs from any channel—like checking recent replies or reviewing old campaign texts—without logging into multiple websites.

**Can I use the ClickSend MCP to send a message right away?**
Absolutely. You can draft and send SMS messages in real time using your agent. Just tell it who you want to reach and what you want to say, and it handles the transmission.

**Does this MCP help me check if I have enough credit?**
Yes. You can ask the agent for an account information check at any time. It instantly reports your current balance, so you know exactly how much message capacity you have left.

**Is it just for SMS messages, or does it do more?**
It handles multi-channel communication. You get full visibility into outbound and inbound SMS texts, automated voice calls, and even physical letters sent through ClickSend Post.

**What if I need to manage my contact groups?**
The MCP lets you list all your defined contact lists inside ClickSend. This helps you verify which customer segments exist before running a large-scale campaign or sendout.