# BulkSMS MCP for AI Agents MCP > BulkSMS MCP gives your AI agents total command over global SMS communications. Send single alerts or massive promotional campaigns, list entire contact groups, and monitor delivery status—all through conversation. Get real-time credit balances and detailed message logs without leaving your chat window. ## Overview - **Category:** communication - **Price:** Free - **Tags:** sms-messaging, bulk-messaging, notification-service, customer-engagement, delivery-tracking ## Description Need to manage high-volume messaging but hate logging into a separate portal? This MCP connects your global SMS operations directly to your AI agents. You can send anything from quick verification codes to multi-stage marketing blasts, all by talking to your agent. Imagine needing to notify 50 clients that their package tracking number changed. Instead of copy-pasting numbers into a dashboard and hitting 'send' fifty times, you just tell your AI client what needs to happen. It handles the message dispatch, targets the right contacts from your existing groups, and tracks every single delivery status. When your agent runs this MCP through Vinkius, it doesn't just send messages; it manages the entire lifecycle of communication. You can check if you have enough credits using natural language, view detailed logs for specific message IDs, or even pull a list of all contacts within a predefined group—all while staying in your workflow tool. It turns complex, multi-step manual processes into simple conversational commands. ## Tools ### get_message Retrieves full details and metadata for a specific message ID you provide. ### get_profile Pulls your account profile data, including the real-time credit balance. ### get_account_info Retrieves fundamental core information about your BulkSMS account setup. ### list_group_members Lists all individual contacts belonging to a specified contact group name. ### list_groups Provides an overview and list of all the customer groups you have set up. ### list_messages Fetches a paginated list of messages that have been sent through your account. ### send_bulk_sms Sends multiple SMS messages to several recipients at once, ideal for campaigns. ### send_sms Dispatches a single, immediate SMS message to one specific phone number. ## Prompt Examples **Prompt:** ``` What are my current credits, and how many people are in the 'Priority' group? ``` **Response:** ``` **Account Status:** * **Credits Remaining:** 120.50 units * **Last Check:** Moments ago **Group Members:** The 'Priority' group has 34 active members, including: John Doe (+123-...) and Jane Smith (+987-...). ``` **Prompt:** ``` Send a message saying our annual report is ready to the contacts in the sales team. ``` **Response:** ``` **SMS Sent Successfully** * **Message:** Annual Report link attached. * **Recipients:** 15 unique numbers. * **Status:** All 15 messages queued for delivery. Message ID: msg_XYZ789. ``` **Prompt:** ``` Show me the details for message msg-442 and check my profile again. ``` **Response:** ``` **Message Details (msg-442):** * **Status:** Delivered. * **To:** +15559001111 * **Sent At:** 2026-06-12 10:30 AM UTC **Account Check:** You currently have **98.75 credits** remaining. ``` ## Capabilities ### Sending Single and Bulk Alerts Send one-off messages or massive batches of SMS texts to any international number. ### Checking Account Status Retrieve your current credit balance and overall account profile information instantly. ### Listing Contact Groups See all defined contact groups available in your BulkSMS account. ### Retrieving Group Memberships Get a list of specific contacts belonging to any designated group. ### Monitoring Message Delivery List all messages sent and retrieve detailed metadata, including the delivery status for each one. ## Use Cases ### Automating Appointment Reminders A support lead needs to send a reminder SMS to 20 clients who missed their appointment. They tell their agent: 'Send the confirmation message to all members of the 'Missed Appt' group.' The MCP uses `send_bulk_sms` and `list_group_members`, ensuring every contact gets the alert automatically. ### Post-Campaign Audit A marketing manager needs to confirm if a specific promotion hit its target. They ask the agent to 'Show me all messages sent yesterday and check their delivery status.' The MCP uses `list_messages` and then `get_message`, providing immediate, auditable results. ### Verifying Contact Lists An operations analyst needs a list of contacts for an old client segment. They prompt the agent to 'List everyone in the legacy clients group.' The MCP runs `list_group_members`, giving them the precise, actionable list they need without manual lookups. ### Quick Error Resolution A support team member gets a report that one critical message failed. They ask: 'What's wrong with message ID msg-987?' The MCP immediately uses `get_message` to pull the detailed failure metadata, allowing them to fix the issue in seconds. ## Benefits - Send bulk messages instantly. Instead of manually entering dozens of numbers, just tell your agent to 'blast the VIP group,' and it handles the entire send job using `send_bulk_sms`. - Stop guessing about credits. Use the `get_profile` tool to pull your real-time credit balance whenever you need to know if a campaign is feasible. - Know exactly what happened after sending. You can use `list_messages` and then ask for specific details with `get_message` to track delivery status per message ID. - Avoid manual contact list management. Use `list_groups` followed by `list_group_members` to pull accurate lists of contacts for any campaign segment. - Simplify operations oversight. Get core account health checks and information using the dedicated `get_account_info` tool, keeping your focus on messaging, not dashboards. ## How It Works The bottom line is: managing global SMS communications becomes as simple as asking questions in plain English, without needing any manual portal logins. 1. Subscribe to this MCP within Vinkius and provide your BulkSMS.com username and password credentials. 2. Your AI client connects using these credentials, authorizing it to manage your SMS campaigns through natural conversation. 3. You simply tell your agent what you need—like 'Send a reminder alert to the VIP group' or 'Check my remaining credits.' The MCP executes the action immediately. ## Frequently Asked Questions **How do I use the BulkSMS MCP to send mass alerts?** You simply tell your agent who needs the message and what it says, like 'Send a reminder to all users in the Support group.' The MCP handles grouping and bulk dispatching so you don't have to copy numbers manually. **Can I use BulkSMS MCP if my contacts are organized into groups?** Yes, absolutely. You can ask the agent to list any of your predefined contact groups or pull a full roster of members from that group for a targeted campaign. **Does this MCP help me track which messages actually got delivered?** It does. After sending, you can ask the agent to check the delivery status using `list_messages` and get specific details on any message ID that might have failed. **What if I need to send a single verification code? Is BulkSMS MCP good for that?** Yes. For quick, one-off alerts or codes, you can prompt the agent to use the `send_sms` tool directly with just the recipient number and message text. **How do I know if my account has enough credits before running a campaign?** Just ask your agent to check your profile. The MCP uses `get_profile` to pull real-time credit balances, stopping you from starting a job that will fail due to insufficient funds.