# Clickatell MCP MCP

> Clickatell connects global messaging across SMS, WhatsApp, and chat channels. Your agent handles everything from sending bulk notifications to tracking delivery status and checking account balances in one conversation thread. It gives you full control over automated business communication without leaving your AI client.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** sms-api, whatsapp-business, multichannel-messaging, transactional-messaging, global-reach, notification-service

## Description

Managing customer communications used to mean jumping between multiple portals—one for SMS campaigns, another for WhatsApp templates, and a third just to check if the message actually got read. Now, you talk to your agent instead. You tell it, 'Send an order confirmation to these 50 users via WhatsApp.' It handles the connection and the delivery using high-fidelity global channels. Need to know how many credits are left? Just ask. The AI manages everything—from sending messages to monitoring historical logs and ensuring you're following best practices. This deep level of control is available through Vinkius, connecting your agent directly to this entire communication infrastructure.

## Tools

### delete_whatsapp_template
Removes a specified message template from your account.

### get_account_balance
Checks the available credit balance for your messaging account.

### get_account_info
Retrieves general profile and account details.

### get_message_status
Checks the current delivery status (sent, delivered, read) for a specific message ID.

### get_whatsapp_media
Fetches details about multimedia content used in WhatsApp messages.

### list_active_channels
Lists all currently configured and active communication channels for your account.

### list_message_history
Retrieves a detailed list of past messages sent through the platform.

### list_source_numbers
Lists all configured sending phone numbers available for use in campaigns.

### list_whatsapp_templates
Fetches a list of existing, pre-approved WhatsApp message templates.

### send_bulk_messages
Dispatches multiple messages to a list of recipients simultaneously.

### send_sms
Sends a standard SMS text message to a single recipient or group.

### send_whatsapp
Initiates sending a WhatsApp message, requiring an approved template for business use.

## Prompt Examples

**Prompt:** 
```
Send a WhatsApp notification to '+447911123456': 'Your package has been delivered'.
```

**Response:** 
```
WhatsApp message dispatched! I've successfully sent the delivery notification to +447911123456. The status is currently 'Sent'. Shall I alert you as soon as it's delivered?
```

**Prompt:** 
```
Check the delivery status for message ID 'omni_12345'.
```

**Response:** 
```
Fetching status... Message omni_12345 has been successfully 'Delivered' and was 'Read' by the recipient at 2:30 PM today. Would you like to see the full interaction history?
```

**Prompt:** 
```
What is my current Clickatell account balance?
```

**Response:** 
```
Scanning account... Your current balance is $25.50. Based on your recent usage, you have enough credits for approximately 1,200 SMS messages. Need a breakdown of recent sending costs?
```

## Capabilities

### Send multi-channel messages
Dispatches bulk or single transactional messages via SMS and WhatsApp using a unified command.

### Check message delivery status
Retrieves real-time updates for any sent message, confirming if it was delivered or read by the recipient.

### Monitor account usage
Checks your current credit balance and overall profile details to keep track of global messaging budgets.

### Manage WhatsApp templates
Accesses, lists, and deletes pre-approved message templates required for initiating business conversations on WhatsApp.

### View communication history
Retrieves detailed logs of past messaging activity to audit performance or troubleshoot issues.

## Use Cases

### Handling an order delay notification
A customer service agent needs to inform a client about a shipment delay. They ask their agent, 'Send WhatsApp message to +1234567890 with the tracking update.' The agent executes `send_whatsapp` and confirms the status, giving the client peace of mind.

### Running a compliance-checked marketing blast
A growth marketer must send 1,000 messages. First, they run `list_whatsapp_templates` to verify their content is compliant, then use `send_bulk_messages` and track the entire effort using `list_message_history`.

### Auditing past communication failures
An ops engineer needs to know why a message failed last week. They ask their agent to run `list_message_history` and then use the specific ID to check the precise failure reason with `get_message_status`.

### Starting a new automated workflow
A developer needs to integrate WhatsApp into a script. They start by calling `list_active_channels` to ensure all endpoints are configured before writing the final sending logic using `send_whatsapp`.

## Benefits

- Consolidate comms: You don't need to switch between separate portals. Your agent handles both `send_sms` and `send_whatsapp`, making sure your message gets out, regardless of the channel.
- Maintain compliance: Before running a campaign, you can use `list_whatsapp_templates` to ensure every communication follows approved business guidelines.
- Know the status: Never wonder if a message was sent. Use `get_message_status` and `list_message_history` to confirm delivery, read receipts, and full activity logs.
- Budget control: Keep your spending tight by running `get_account_balance` whenever you need to know how many credits are left for the next campaign.
- Scale campaigns fast: Instead of manual sends, use `send_bulk_messages` to hit hundreds of users instantly while maintaining detailed oversight.

## How It Works

The bottom line is you give the AI a natural language command, and it runs the complex communication workflow for you.

1. Subscribe to the MCP and grab your API Key from your Clickatell Workspace.
2. Provide your agent with the target number, message content, and preferred channel (SMS/WhatsApp).
3. Your agent executes the send request, then provides immediate status updates or fetches historical logs upon request.

## Frequently Asked Questions

**How do I check my credit balance using get_account_balance?**
You ask your agent to run `get_account_balance`. The AI pulls the live data and tells you exactly how many credits or funds are available for sending messages.

**What is the difference between send_sms and send_whatsapp?**
`send_sms` handles standard text messaging, while `send_whatsapp` uses WhatsApp's dedicated channel. Remember that WhatsApp requires you to use a pre-approved template.

**Can I check the status of an old message using list_message_history?**
Yes. First, run `list_message_history` to find the specific Message ID for that past communication. Then you use `get_message_status` with that ID to see its final delivery state.

**How do I manage templates before a campaign?**
Use `list_whatsapp_templates` to view all currently approved templates. If you need to remove one, the `delete_whatsapp_template` tool handles that cleanup for you.

**How can I verify my overall account details using get_account_info?**
It returns your general profile information. Use this tool to confirm that your AI client has successfully authenticated with the platform and pulled basic, up-to-date workspace data before attempting any actions.

**What is the purpose of list_source_numbers when I need to send a message?**
The tool provides a complete directory of all configured sending numbers. This is essential because it confirms which specific channels or virtual lines your agent must route messages through.

**What should I know before using send_bulk_messages for large campaigns?**
This function efficiently handles multiple recipients at once. Be aware that platform rate limits apply; if you are sending a very high volume, your agent may need to batch the requests or pause between runs.

**If I want an image in my WhatsApp message, how do I use get_whatsapp_media?**
It fetches details about any associated multimedia content. You must call this tool first if you need your AI client to reference or attach a picture before sending the final chat message.