# Kudosity MCP for AI Agents MCP > Kudosity lets you manage your entire SMS and WhatsApp messaging strategy through your AI agent. It handles sending and canceling messages, tracking delivery stats, managing contact lists, and formatting phone numbers for international reach. You can also pull account balances and handle opt-outs for marketing compliance, making it a complete messaging hub for your automated workflows. ## Overview - **Category:** marketing-automation - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_cSVKrzzLVIkHlVOFejM4h4XZuN0ImevdgUTONj6p/mcp - **Tags:** sms, whatsapp, messaging, contact-management, delivery-tracking, sms-marketing, whatsapp-business ## Description Kudosity lets you manage your entire SMS and WhatsApp messaging strategy through your AI agent. Managing a multi-channel messaging strategy usually involves jumping between a CRM, a messaging dashboard, and your own internal tools. You have to copy-paste phone numbers, check if a message actually landed, and manually move people into different marketing lists. This MCP changes that by letting your AI agent do the heavy lifting. Instead of toggling tabs, you just tell your agent to send a notification or check on a campaign. It handles the messy stuff like converting messy CRM data into the right international format so your messages don't bounce. You can also manage your subscriber lists and handle opt-outs directly through the conversation. It's a great way to keep your messaging operations organized, especially since it's available in the Vinkius catalog for easy setup. You get a clear view of your account balance and delivery stats without ever leaving your workspace. It turns your AI into a dedicated messaging assistant that knows your customers and your numbers. ## Tools ### list_contact_lists See all your current contact lists in one go. ### remove_contact Take a specific contact off a list to keep your data clean. ### add_contact_to_list Put a new contact into a specific list for targeted messaging. ### get_sms_responses Pull in replies from customers to see what they're saying back. ### get_sms_sent_count Check how many messages you've sent over the last few days. ### get_sms_stats Get a full delivery report for your recent campaigns. ### send_sms Send a text message to one person or a whole group. ### get_balance Check your remaining credit to make sure you don't run out. ### cancel_sms Stop a message that is still scheduled to go out. ### format_number Turn messy phone numbers into the correct international format. ### get_whatsapp See the status and content of a message you already sent. ### list_whatsapp View your recent WhatsApp message history in a list. ### opt_out_contact Unsubscribe a user from your marketing list to stay compliant. ### get_contact_list Get the full details of a specific contact list. ### get_sms_delivery_status Check if a specific message actually reached its destination. ### get_sms_info Pull general information about a specific campaign or message. ### send_whatsapp Send a WhatsApp message using text or pre-approved templates. ## Prompt Examples **Prompt:** ``` Send a text to 1234567890 saying 'Your code is 5544'. ``` **Response:** ``` ### Message Sent - **Recipient:** 1234567890 - **Content:** Your code is 5544 - **Status:** Dispatched - **Cost:** $0.01 I've scheduled this for immediate delivery. You can check the status in a few seconds. ``` **Prompt:** ``` What's my current balance? ``` **Response:** ``` ### Account Balance Your current Kudosity balance is **$50.00 AUD**. You have plenty of credit to continue your current campaigns. ``` **Prompt:** ``` Check delivery for message 999. ``` **Response:** ``` ### Delivery Status - **Message ID:** 999 - **Status:** Delivered ✅ - **Time:** 10:01 AM UTC - **Recipient:** 61411122211 The message reached the recipient successfully. ``` ## Capabilities ### Send SMS to individuals or lists Dispatch text messages to single recipients or entire contact groups instantly. ### Dispatch WhatsApp messages with fallback Send WhatsApp content with an automatic SMS backup for better reach. ### Clean phone numbers for international delivery Convert messy CRM data into the correct E.164 format to prevent delivery failures. ### Track message delivery and bounce rates Get real-time stats on delivered, pending, and failed messages. ### Manage subscriber lists and opt-outs Add contacts to lists and handle unsubscribe requests to stay compliant. ### Monitor account balance and sent counts Check your remaining credits and total sent volumes across timeframes. ### Retrieve customer reply responses Pull in text replies from customers to see what they're saying back. ## Use Cases ### Campaign Launch A marketer tells the agent to send a 'Sale is live' SMS to the 'VIP' list and then asks for a delivery report using get_sms_stats. ### Customer Support A support rep asks the agent to find all replies to a specific message ID to see if a user is still having issues using get_sms_responses. ### Data Cleaning An engineer asks the agent to take a list of messy numbers from a CSV and format them all correctly for a batch send using format_number. ### Subscription Management A user asks to be removed from all marketing lists, and the agent uses the opt_out_contact tool to ensure they are done. ## Benefits - Stop manual data entry by using format_number to fix CRM data before it hits your messaging provider. - Stay on top of your budget by using get_balance to check your credits before launching a big campaign. - Maintain marketing compliance effortlessly by using opt_out_contact to handle unsubscribes instantly. - Get real-time feedback by using get_sms_responses to see what your customers are saying back. - Improve delivery rates by using get_sms_delivery_status to identify and fix problematic numbers. - Save time on multi-channel outreach by using send_whatsapp with SMS fallback for better reach. ## How It Works The bottom line is you get a unified way to manage SMS and WhatsApp without leaving your primary workspace. 1. Connect your Kudosity API keys to your AI client. 2. Give your agent permission to access your messaging account. 3. Ask your agent to send messages, manage contacts, or check stats. ## Frequently Asked Questions **Can I use Kudosity MCP to send WhatsApp messages?** Yes, you can send WhatsApp messages using text, custom content, or pre-approved templates directly through your AI agent. **How do I handle opt-outs with Kudosity?** You can ask your agent to unsubscribe any contact from your lists. This ensures you stay compliant with marketing regulations automatically. **Does Kudosity MCP support international numbers?** Yes, it includes tools to format messy phone numbers into the correct international format to ensure your messages land globally. **Can I check my account balance?** You can ask your agent to check your current balance at any time to monitor your messaging credits. **How does Kudosity MCP track SMS delivery?** It pulls real-time delivery reports, including statuses for delivered, pending, and bounced messages, directly into your chat. **Can I send WhatsApp templates?** Yes, the MCP supports sending pre-approved WhatsApp templates with custom parameters for things like order confirmations. **Can my AI send an SMS to multiple recipients at once?** Yes! Use the `send_sms` tool with up to 500 comma-separated recipient numbers in the `to` parameter, or send to an entire contact list by providing a `list_id`. Numbers must be in E.164 international format, or use the `countrycode` parameter to auto-format local numbers. **How do I check if my SMS was delivered successfully?** Use `get_sms_stats` with the message ID to get aggregate delivery counts (delivered, bounced, pending), or use `get_sms_delivery_status` with both message ID and recipient number to get per-recipient delivery details including the full populated message content. **Can my AI manage contacts and opt-outs for marketing compliance?** Absolutely. Use `add_contact_to_list` to add contacts, `remove_contact` to delete them from lists, and `opt_out_contact` to unsubscribe recipients. The opt-out tool is essential for marketing compliance — by law you must enable an unsubscribe method for marketing campaigns. **Can my AI send WhatsApp messages?** Yes! Use the `send_whatsapp` tool to send text, template, or custom content messages. Templates must be pre-approved in your WhatsApp Business account. The recipient must have an active WhatsApp account and have opted in. You can also retrieve sent messages with `get_whatsapp` and list all messages with `list_whatsapp`.