# AT&T Messaging MCP for AI Agents MCP > AT&T Messaging MCP lets your AI agent send and manage all SMS/MMS communication directly through AT&T's API. Handle transactional alerts, run large-scale campaigns, track delivery status in real time, and process inbound customer replies—all from a single chat window. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** cpaas, sms-api, mms-messaging, transactional-alerts, shortcode, bulk-messaging ## Description You can take full control of your text messaging workflows using this MCP. Instead of logging into the AT&T console or switching between multiple platforms, your AI agent manages every step conversationally. Need to alert customers about an order change? Send a simple SMS notification instantly. Want to run a massive promotion? Broadcast a message to hundreds of people while tracking which ones actually got it. The system handles everything from sending the initial text using a registered shortcode to managing the entire campaign lifecycle, including provisioning new numbers and monitoring how recipients reply. It’s also great for customer service. Your agent retrieves incoming messages—like replies or opt-out requests—so you never miss an alert. This capability means your AI client becomes the single command center for all things texting. Because Vinkius hosts this MCP, you connect once to access powerful messaging tools that were previously locked behind complex dashboards. ## Tools ### create_shortcode Provisions a new messaging shortcode with an associated keyword for running marketing campaigns or service alerts. ### delete_shortcode Decommissions a messaging shortcode when retiring a campaign or transferring numbers to a different service. ### get_inbound_messages Retrieves recent SMS/MMS messages from customers, showing the sender number and the keyword matched. ### get_keyword_responses Reviews your configured auto-reply logic for shortcode keywords to verify opt-in or opt-out flows. ### get_message_status Checks the delivery status of a specific message, useful for tracking campaign performance or debugging failed sends. ### list_messages Lists historical outbound and inbound messages, providing timestamps, senders, recipients, and content snippets for auditing. ### send_bulk_sms Sends SMS to a large list of multiple recipients in one request, returning job IDs and per-recipient status. ### send_mms Sends an MMS message that includes a media attachment, requiring sender ID, recipient number, text, and media URL. ### send_sms Sends a single SMS message to a specific phone number using a defined sender ID for transactional alerts or OTPs. ## Prompt Examples **Prompt:** ``` Send out a 'Sale starts now!' SMS to all users who haven't logged in this week. ``` **Response:** ``` **Bulk SMS Campaign Status** * **Job ID:** bulk-9f3d2b * **Recipients Targeted:** 450 * **Status Summary:** Launched successfully. * `+12125551001`: Delivered (Timestamp: 2026-06-12 10:01 AM) * `+12125551003`: Failed (Reason: Invalid Number) * `+12125551004`: Delivered (Timestamp: 2026-06-12 10:02 AM) ``` **Prompt:** ``` Check my recent customer messages. Did anyone send 'STOP' or reply to the last alert? ``` **Response:** ``` I pulled the last 50 inbound messages: * **+13105554567:** Sent 'STOP' (Opt-out detected) at 14:32 UTC. Status: Added to suppression list. * **+18005551234:** Replied 'YES, I want more info.' This was a keyword match for your sales flow. * **+17779998888:** Sent message body: 'Where is my order?' (Unmatched query) ``` **Prompt:** ``` I need to send a visual alert about the new product launch. Can I attach an image? ``` **Response:** ``` **MMS Send Request** The message was sent successfully using your configured sender ID. * **Message Type:** MMS (Image/Video) * **Recipient:** +12125559999 * **Content:** 'Check out our new gear!' (Attached image: product_x.jpg) * **Delivery Status:** Delivered. The rich media asset was successfully received. ``` ## Capabilities ### Send single and bulk SMS alerts Dispatch individual or mass text messages (SMS) for everything from two-factor authentication codes to marketing announcements. ### Dispatch rich MMS content Send multimedia messages that include images, videos, or audio attachments for richer campaigns and visual alerts. ### Manage campaign numbers Provision new shortcodes with associated keywords or decommission old ones when a marketing campaign ends. ### Monitor message flow Check the real-time delivery status of any sent message, confirming if it was delivered, failed, or read. ### Process customer replies and logs Retrieve inbound messages from customers, including keyword-triggered auto-responses and opt-out commands. ## Use Cases ### Handling a sudden system outage The DevOps engineer asks the agent to send an immediate alert. The agent uses `send_bulk_sms` to blast a message to all key personnel, and then immediately uses `get_message_status` to confirm that 95% of recipients received the warning. ### Launching a new marketing campaign The Marketing Manager wants to test a new keyword. The agent first runs `create_shortcode` to provision the number, then uses `get_keyword_responses` to ensure the auto-reply logic is correctly set up for opt-in flow. ### Processing customer replies and complaints A support agent asks the system to check recent activity. The agent calls `get_inbound_messages`, retrieving a complaint message, which confirms the customer replied using a specific keyword match. ### Auditing compliance records The Compliance Officer needs proof of all communications last quarter. They ask the agent to use `list_messages` to pull a full log with necessary timestamps and content snippets for an audit report. ## Benefits - Audit messaging history using `list_messages` to provide full compliance records with timestamps, directions, and content. - Keep customers engaged by reviewing replies and opt-outs via `get_inbound_messages`, ensuring your automated responses are accurate. - Run massive promotional blasts efficiently. Use `send_bulk_sms` to send alerts to hundreds of numbers in a single request while tracking individual delivery status. - Improve rich marketing campaigns by using `send_mms` to include images or videos, moving beyond plain text alerts. - Control your messaging infrastructure by creating new campaign shortcodes with `create_shortcode`, or decommissioning old ones with `delete_shortcode`. ## How It Works The bottom line is you manage all messaging campaigns and alerts through natural chat commands, eliminating manual dashboard switching. 1. Start by connecting your AT&T Messaging API Key and Secret to this MCP via your AI client. 2. Tell your agent the task: 'Send a bulk SMS campaign for the new product launch.' 3. Your agent executes the required steps, sending messages while reporting back real-time status updates, like job IDs or delivery confirmations. ## Frequently Asked Questions **How can I use AT&T Messaging to send alerts when my system has an issue?** You can trigger mass, immediate alerts using the AI agent. By leveraging bulk sending tools, you ensure every relevant employee or customer gets the alert simultaneously and get confirmation on who received it. **Can I use AT&T Messaging to manage my marketing keywords?** Yes. You can provision new shortcodes for different campaigns and check existing keyword responses using the agent, making sure your opt-in/opt-out flows are perfect before launch. **What if a customer replies to my campaign message? How do I see it?** The AI agent retrieves all inbound messages for you. It pulls the sender, the message body, and notes whether the reply was related to a specific keyword or just general conversation. **Does AT&T Messaging help me track if my texts actually got delivered?** Absolutely. After sending any message—whether one-off or bulk—the agent checks the delivery status, giving you real-time confirmation on whether it was sent, failed, or successfully delivered. **What is the best way to audit my messaging communications?** The MCP allows you to list message history. You can pull comprehensive logs of all outbound and inbound messages with detailed timestamps for compliance reporting.