# Sinch MCP > Sinch connects your AI agent to global SMS messaging at scale. Send text messages to single numbers or large groups, track real-time delivery status, and manage contact lists directly through natural conversation with your AI client. ## Overview - **Category:** communication-messaging - **Price:** Free - **Tags:** sms-api, bulk-messaging, delivery-tracking, voice-api, customer-engagement, notifications ## Description The Sinch MCP lets you use your AI agent to handle all things text messaging. You can send individual texts or launch bulk campaigns across multiple recipients from a simple chat prompt. Need to know if the messages actually got there? Your agent tracks delivery reports, telling you exactly which messages succeeded and which failed. Beyond sending, you manage contacts by creating and deleting targeted groups, keeping your outreach organized. It also lets you check on large message batches before they even leave—you can list recent activity or update parameters for future sends. This full suite of communication tools makes managing campaigns as easy as talking to a teammate. All this capability is accessible through Vinkius, the central hub connecting your agent to thousands of services. ## Tools ### cancel_sms_batch Stops a pending group of text messages before they are sent out. ### create_sms_group Builds a new, dedicated contact list for sending targeted messages. ### delete_sms_group Permanently removes an entire contact group from the system. ### get_batch_details Retrieves all specific details about a recent SMS message batch. ### get_delivery_report Pulls a detailed report on an SMS batch, showing delivery success rates and failures. ### get_group_details Shows all the members and details associated with a specific contact group. ### list_sms_batches Displays a list of the most recently processed SMS message batches. ### list_sms_groups Retrieves a comprehensive list of all existing contact groups. ### send_sms Sends one or more text messages to specified phone numbers, which must be in international format. ### update_sms_batch Modifies the parameters of an SMS batch that has already been created but not yet sent. ## Prompt Examples **Prompt:** ``` Send an SMS to +1234567890 saying 'Your order has been shipped!' ``` **Response:** ``` SMS sent successfully. - Batch ID: batch-7k2m - Recipient: +1234567890 - Message: 'Your order has been shipped!' - Status: queued for delivery ``` **Prompt:** ``` Get the delivery report for batch 9876. ``` **Response:** ``` Delivery report for batch 9876: - Total recipients: 12,000 - Delivered: 11,842 (98.7%) - Pending: 112 - Failed: 46 - Sender ID: 'Vinkius' Would you like details on the failed deliveries? ``` ## Capabilities ### Send and manage bulk SMS messages Your AI client sends text messages to multiple phone numbers or entire contact groups. ### Track message delivery status The system retrieves detailed reports showing which texts were delivered, are still pending, or failed completely. ### Organize and maintain contacts You can create new contact groups, view existing ones, get group details, or permanently delete them when they're no longer needed. ### Manage message batches The tool allows you to list recent SMS batches, review batch details, update parameters for a pending batch, or cancel the entire batch irreversibly. ## Use Cases ### Sending post-sale follow-ups A sales rep needs to send 'Your invoice is ready' texts to 30 clients. They tell their agent, 'Send the invoice reminder.' The agent uses `send_sms` and then immediately calls `get_delivery_report` to confirm that at least 98% of the messages went through. ### Auditing outreach lists The compliance officer needs to know which contact groups exist. They ask their agent, 'Show all active groups.' The agent executes `list_sms_groups`, providing a clean list of names for audit purposes. ### Pausing an accidental blast The marketing team realizes they are about to send a message with the wrong pricing. They tell their agent, 'Stop batch XYZ.' The agent executes `cancel_sms_batch`, preventing any further messages from being sent. ### Reviewing historical sends A manager needs to check campaign performance from last week. They ask their agent to list recent activity, triggering the `list_sms_batches` tool and getting a summary of all past efforts. ## Benefits - You get instant delivery feedback. Instead of waiting hours for manual reports, your agent runs the `get_delivery_report` tool to tell you exactly what happened with a batch. - Targeting becomes simple. Use `create_sms_group` and then send messages using `send_sms`. You never have to manually compile lists again; just name the group. - Manage large campaigns safely. Before hitting send, use `list_sms_batches` or check details with `get_batch_details` to review everything in one chat exchange. - Stop wasted effort. If a campaign fails or needs adjustment, you can run `update_sms_batch` to change parameters without touching the underlying API console. - Complete lifecycle control: Need to pause outreach? Use `cancel_sms_batch`. It’s a single prompt away from irreversible batch management. ## How It Works The bottom line is that Sinch lets your AI client execute complex communication tasks using simple chat prompts, eliminating manual API calls and dashboard clicks. 1. Connect Sinch MCP to your AI client and provide your required Service Plan ID and API Token. 2. Tell your agent what you need—for example, 'Send a message about the sale to the marketing group.' 3. Your agent executes the necessary steps through this MCP, sending texts, retrieving reports, or managing groups based on your conversational request. ## Frequently Asked Questions **How do I check if my SMS messages actually delivered using Sinch MCP?** You use the `get_delivery_report` tool. This pulls a detailed status report showing total recipients, how many were successfully delivered, and exactly how many failed. **Can I send texts to specific contact groups with Sinch MCP?** Yes. First, you use `create_sms_group` to build the list. Then, your agent sends messages using `send_sms` and targets that group for bulk sending. **What if I need to stop a batch of texts before they go out?** You use the `cancel_sms_batch` tool. This immediately stops any pending messages associated with a specific batch ID, preventing accidental sends. **Does Sinch MCP support international phone numbers?** Yes. When using the `send_sms` tool, you must provide all phone numbers in the full international format (like +1234567890) for accurate sending. **How do I list my existing contact groups with Sinch MCP?** Simply call `list_sms_groups`. This retrieves a complete roster of all defined contact lists, letting you know what groups are ready to use.