# Clickatell MCP for AI Agents MCP > Clickatell gives your AI client full control over global mobile messaging. Send SMS messages to anyone anywhere, check account balances instantly, track exactly where a message is delivered, and automate two-way replies using keyword rules. ## Overview - **Category:** talk-to-me - **Price:** Free - **Tags:** sms-api, mobile-messaging, chat-commerce, two-way-messaging, bulk-sms ## Description Managing global SMS communications used to mean jumping between carrier portals, manually checking balance sheets, and spending hours tracking down delivery status updates. Now, you talk to your AI agent about it. You can send single messages or blast out large batches of text without leaving your workflow. Need to know if a message actually hit the local tower? Your agent checks that for you. Want to automate replies so that when a customer texts a specific keyword, you automatically reply with instructions? That’s built right in. It all lives through natural conversation. If you're using Vinkius, you can connect this Clickatell MCP and manage everything—from monitoring scheduled marketing blasts to verifying international carrier coverage for complex campaigns. You get full control over the entire lifecycle of your mobile message, from dispatch to final delivery confirmation. ## Tools ### list_scheduled_campaigns Retrieves a list of all scheduled text blasts configured within the system. ### upsert_inbound_rule Creates or updates a structural parsing block, allowing you to automate webhooks for incoming messages. ### test_carrier_coverage Runs an automatic validation check on specific phone numbers (MSISDN) to confirm carrier support in that area. ### list_inbound_rules Lists all the keyword-based rules currently active for handling incoming message traffic. ### dispatch_bulk_sms Sends multiple SMS messages in a single batch, optimizing bandwidth and avoiding API slowdowns. ### dispatch_sms_message Sends a single text message payload using the platform's native formatting. ### cancel_queued_message Permanently deletes specific SMS messages that were scheduled to send at a later time. ### wipe_inbound_rule Completely removes an existing, mapped HTTP logic rule from the system. ### get_account_balance Retrieves detailed metrics about your current API funding limits and remaining credits. ### get_delivery_status Checks the final carrier status of a message, confirming if it passed through various network nodes. ## Prompt Examples **Prompt:** ``` What are my current account limits and how many messages can I send? ``` **Response:** ``` **Account Status Report** * **Current Balance:** $45.20 USD * **Available Units:** ~2,200 domestic SMS units * **Last Refill Date:** 2026-06-15 Based on your recent activity volume, you have enough balance for about 2,200 more messages. You should monitor usage closely before the end of the quarter. ``` **Prompt:** ``` Send a bulk message to these 50 numbers and tell me the status. ``` **Response:** ``` **Bulk Dispatch Initiated** Successfully queued 50 messages for dispatch. We've optimized the routing pipeline to prevent throttling. * **Batch ID:** BATCH-20260624- * **Status:** Pending Carrier Hand-off I will monitor these and send updates as I receive delivery confirmations from the network nodes. ``` **Prompt:** ``` Can you check if we can message this number in Ghana? ``` **Response:** ``` **Carrier Coverage Check: Ghana** ✅ **Result:** PASS * **Number Prefix:** +233 * **Coverage Status:** Active (Confirmed) * **Recommendation:** This carrier supports standard Unicode payloads. You can proceed with dispatching messages to this number. ``` ## Capabilities ### Send single or bulk SMS messages You can send individual text alerts or large batches of texts using E.164 formatting and complex character sets. ### Monitor message delivery status The agent pulls structured data to confirm if your messages successfully passed the network nodes and reached the carrier gateway. ### Check account funding limits Get an immediate read on your current API balance and how many more messages you can send. ### Verify international coverage Run a check against specific phone numbers to confirm if the carrier network supports sending messages to that region. ### Manage inbound reply rules and webhooks You can create, list, or delete keyword-based rules so your system automatically replies when it receives a message. ## Use Cases ### Verifying a new market rollout An operations manager needs to know if SMS service works in Vietnam. Instead of calling support, they ask their agent to run `test_carrier_coverage` on several Vietnamese numbers and get confirmation. ### Fixing failed campaign deliveries A marketing team finds out 50 texts failed delivery last night. They use the agent to check the status of those message IDs via `get_delivery_status` to pinpoint if the failure was internal or carrier-side. ### Building a customer FAQ bot A developer needs two-way messaging. They ask their agent to list existing rules with `list_inbound_rules`, then use `upsert_inbound_rule` to add a new keyword reply for returns. ### Preparing for a seasonal sale The marketing team needs to send 5,000 texts at once. They ask the agent to run `dispatch_bulk_sms` and receive confirmation that all messages were successfully queued without hitting rate limits. ## Benefits - Track the exact status of every message. Using `get_delivery_status` confirms if a text passed through carrier nodes, giving you confidence beyond just 'sent.' - Run complex international checks instantly. The `test_carrier_coverage` tool verifies that a specific number is deliverable in its region before you waste credits. - Automate your support flows. You can manage inbound rules using `upsert_inbound_rule`, letting the agent set up keyword replies without developer intervention. - Control your budget and timing. Check available funding limits with `get_account_balance` or stop a planned blast immediately using `cancel_queued_message`. - Scale messaging effortlessly. Sending large groups of texts is simple; just run `dispatch_bulk_sms` instead of sending messages one by one. ## How It Works The bottom line is you manage global messaging workflows by talking to your AI client; no dashboards needed. 1. First, subscribe to the Clickatell MCP on Vinkius and enter your API key from your Clickatell account. 2. Next, you prompt your AI client with a request—for example, 'Send an SMS to +1234...'. 3. The agent runs the tool, gets real-time data from Clickatell, and reports back the status, message ID, or confirmation details directly in the chat. ## Frequently Asked Questions **How do I check the final delivery status of a message using Clickatell MCP?** You simply ask your agent for the delivery status and provide the unique message ID. The agent retrieves detailed records showing if the text passed through all network nodes and was handed off to the local carrier. **How do I send a large number of SMS messages with Clickatell MCP?** You ask your agent to dispatch a bulk message. It handles the entire process, optimizing the routing for many texts at once and giving you a batch ID for tracking. **Can I automate replies when a customer messages using Clickatell MCP?** Yes. You can use your agent to manage inbound rules. By defining keywords, the system automatically handles two-way messaging flows without any manual intervention from you. **Where do I find my current SMS account balance with Clickatell MCP?** Just ask your agent for the account balance. It pulls live metrics on your available funding limits and tells you exactly how many messages you can send right now. **Does Clickatell MCP support sending messages internationally?** Yes, it supports global messaging. Before sending, you should ask the agent to verify carrier coverage for any international number so you know it will actually arrive.