# Clickatell MCP for AI Agents AI Agent Connect > Clickatell lets you manage your entire mobile messaging operation through an AI agent. You can fire off bulk SMS campaigns, check if your messages actually hit the towers, monitor your account balance, and set up automated replies for incoming texts. It handles the heavy lifting of SMS protocols so you can just talk to your agent about your marketing goals. ## Overview - **Category:** communication-messaging - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_Sei6CRnt3dG0uUATMCZteVMq550E49TK7OHsyZlS/ai-agent-connect - **Tags:** sms-api, whatsapp-business, multichannel-messaging, transactional-messaging, global-reach, notification-service ## Description Imagine you're running a global marketing campaign and need to send a thousand notifications across different countries. Instead of logging into a clunky dashboard, jumping between tabs to check balances, and manually verifying if carriers in specific regions are actually accepting your traffic, you just tell your agent what needs to happen. You can ask about your current budget, check which countries are currently reachable, or set up rules for how your system should respond to specific keywords from customers. It turns a fragmented series of manual checks and data entries into a simple conversation. Because this Connector is hosted on Vinkius, you get a reliable way to hook up your Clickatell account to any of your favorite AI clients. You stop worrying about E.164 formatting or complex JSON payloads and start focusing on the actual content of your messages. Whether you're troubleshooting why a specific text didn't arrive or you're trying to scale your outbound volume, you're just giving directions to your agent. It's about moving from how do I do this in the portal to get this message out now. ## Tools ### delete_whatsapp_template Remove template ### get_account_info Get profile details ### get_account_balance Check your current available funds and remaining message limits. It ensures you never run out of credits mid-campaign. ### get_whatsapp_media Get media details ### get_message_status Check delivery status ### list_active_channels ) in the account. List communication channels ### list_message_history List past messages ### list_source_numbers List sending numbers ### list_whatsapp_templates List WhatsApp templates ### send_bulk_messages Send multiple messages ### send_sms Send SMS message ### send_whatsapp Note: Templates required for business initiation. Send WhatsApp message ## Prompt Examples **Prompt:** ``` Can you check if we have enough balance to send 5,000 texts to France? ``` **Response:** ``` I checked your Clickatell account. Your current balance is **$120.00**, which is enough to cover approximately 4,800 domestic messages. You'll need to top up slightly to hit that 5,000 mark. ``` **Prompt:** ``` Send a text to +1555010203 saying 'Your appointment is confirmed for 3 PM'. ``` **Response:** ``` Done. I've sent that confirmation to +1555010203. The message is currently being processed by the gateway. ``` **Prompt:** ``` What's the status of the message I sent to the delivery team? ``` **Response:** ``` The message with ID **msg_8829** has been **Delivered to Gateway**. This means it's successfully reached the local carrier and is on its way to the recipient's device. ``` ## Capabilities ### Send bulk SMS messages Fire off large volumes of text messages to your audience in one go. ### Check message delivery status See exactly where your messages are in the delivery chain. ### Monitor account balance Keep an eye on your available funds and message limits. ### Verify international carrier coverage Check if specific regions can receive messages before you start a campaign. ### Manage inbound reply rules Set up automated responses based on specific keywords from customers. ### Cancel queued messages Stop specific messages from being sent if they are still in the queue. ### List upcoming campaigns View all your active and scheduled text blasts in one place. ## Use Cases ### Marketing Blast A manager asks the agent to send a 500-person invite to a webinar using dispatch_bulk_sms. ### Coverage Check An ops lead wants to know if they can text customers in Brazil, so they use test_carrier_coverage. ### Support Reply A support agent sees a customer asking for 'Help,' and the agent uses upsert_inbound_rule to set up a keyword trigger. ### Balance Check A developer needs to know if there's enough money for a new test, so they use get_account_balance. ## Benefits - Stop manual tracking by using get_delivery_status to see exactly where your messages are in the delivery chain. - Save time on manual data entry by using upsert_inbound_rule to automate your two-way messaging flows. - Avoid wasted spend by using test_carrier_coverage to verify a region's reach before you start a blast. - Keep your budget on track with get_account_balance so you never run out of credits mid-campaign. - Scale your outreach faster with dispatch_bulk_sms which handles the complexities of high-volume sending. - Manage your schedule easily by using list_scheduled_campaigns to see what's going out and when. ## How It Works The bottom line is you turn your AI agent into a direct command center for your mobile messaging. 1. Subscribe to the Clickatell MCP on Vinkius. 2. Add your Clickatell API Key from the portal to your AI client. 3. Ask your agent to send messages, check balances, or manage your SMS rules. ## Frequently Asked Questions **Does Clickatell MCP support international SMS?** Yes, it allows you to check international carrier coverage and send messages globally using standard formatting. **Can I see my account balance with this?** You can ask your agent to check your current funding limits and available credits at any time. **How do I set up automated replies?** You can use the Connector to create keyword-based rules that trigger specific actions when customers text you back. **Can it send messages to thousands of people at once?** Yes, it includes a specific tool for bulk SMS dispatching designed to handle high volumes efficiently. **How do I know if my messages actually arrived?** You can request a delivery status update for any specific message to see its current progress through the carrier network. **Can I stop a message that's already scheduled?** Yes, you can tell your agent to cancel any specific message that's currently waiting in the queue. **Can my agent confirm if an international number is reachable via Clickatell?** Yes. Use the 'test_carrier_coverage' tool. Provide the destination number in international format, and the agent will check Clickatell's network traces to confirm if the route is active and supported. **How do I monitor my remaining SMS credits through the agent?** Ask your agent to get the account balance. It retrieves the explicit funding limits from your Clickatell profile, helping you prevent zero-balance halts during critical messaging flows. **Can I automate replies based on incoming keywords?** Absolutely. You can use the 'upsert_inbound_rule' tool to define keyword triggers and webhook URLs. This allows your agent to configure automated two-way communication schemas without manually editing portal settings. **How do I find my Clickatell API Key?** Log in to your Clickatell account, navigate to **My Workspace** > **API Integrations**, and create a new HTTP API integration to get your key. **Do I need templates for WhatsApp?** Yes, for business-initiated messages, WhatsApp requires the use of pre-approved templates. You can list them using the `list_whatsapp_templates` tool. **Can I check my remaining balance via AI?** Yes! The `get_account_balance` tool retrieves your current remaining funds directly from the Clickatell platform.