# BulkSMS.com MCP MCP > BulkSMS.com connects global messaging power to your AI agent, letting you manage thousands of SMS messages from one conversation. Send high-fidelity alerts worldwide, build and maintain contact lists programmatically, track delivery status in real time, or check current account credits—all without leaving your workflow. ## Overview - **Category:** communication-messaging - **Price:** Free - **Tags:** bulk-messaging, transactional-sms, customer-notifications, global-messaging, api-integration, message-tracking ## Description You can use this MCP to take full control of automated business communication. Need to alert 500 customers about a sale? You send the bulk message directly through natural language commands. It’s not just about sending; it's about managing the whole process. Your agent checks your credit balance first, then sends the SMS to multiple groups, and finally retrieves detailed logs showing which messages were delivered, failed, or are still pending. Managing contacts is equally simple—you can programmatically create new subscribers or list specific groups using simple queries. This MCP gives you deep visibility into every step of your communication process, making manual reporting obsolete. Connect it through Vinkius to access this global messaging power from any compatible AI client. ## Tools ### check_bulksms_status Verifies if your API connection and overall service connectivity are working correctly. ### create_contact Adds a brand new individual contact into your system's address book. ### delete_message Removes a specific message from the stored records. ### get_credits Retrieves the current available credit balance for your SMS account. ### get_delivery_status Checks the real-time status of a message send, confirming if it went through or failed. ### get_message Fetches all specific details about one particular message interaction. ### get_profile Retrieves high-level account information and metadata for your BulkSMS account. ### list_contacts Lists all contacts currently stored in your system's directory. ### list_groups Retrieves a list of predefined contact groups you manage. ### list_messages Pulls back the most recent history of sent and received messages. ### send_bulk_sms Sends a single message to multiple recipients simultaneously using a defined group or list. ### send_sms Dispatches a standard SMS message to one specific recipient phone number. ## Prompt Examples **Prompt:** ``` Send an SMS to +1234567890: 'Your order is ready for pickup'. ``` **Response:** ``` SMS dispatched! I've sent the notification to +1234567890 via BulkSMS.com. The message is queued for delivery. Shall I check your remaining credits? ``` **Prompt:** ``` List my last 5 sent messages and their status. ``` **Response:** ``` Accessing logs... Your last 5 messages include a delivery to @user1 (Status: Delivered) and 4 others. I've retrieved the detailed timestamps for each interaction. ``` **Prompt:** ``` What is my current BulkSMS credit balance? ``` **Response:** ``` Scanning account... Your current balance is 1,240.50 credits. Based on your recent usage, you are in good standing for your next campaign. Need any help with a new broadcast? ``` ## Capabilities ### Send Mass Alerts Dispatch high volumes of SMS messages to recipients globally using a single command. ### Manage Contacts and Groups Programmatically create new contacts or list existing subscriber groups for coordinated campaigns. ### Check Delivery Status Retrieve real-time status updates, checking if a message was delivered, failed, or is still pending. ### Track Message History List and retrieve detailed logs for specific sent or received messages, including timestamps. ### Monitor Account Finances Check your current credit utilization and account profile metadata to manage your messaging budget. ## Use Cases ### Onboarding New Users A new user needs to verify 50 people's phone numbers for a beta test. The agent first uses `list_contacts` to see who already exists, then uses `send_sms` repeatedly to send verification codes to each number, and finally runs `get_delivery_status` on the batch of messages. ### Running a Flash Sale Campaign The marketing team needs to announce a time-sensitive discount. They use the agent to execute `list_groups` to pull the 'VIP' segment, then invoke `send_bulk_sms` with the deal details, and immediately follow up by requesting a summary of success rates using `list_messages`. ### Handling Customer Service Escalations A client reports an order delay. The agent uses `get_profile` to confirm account ownership, then sends a personalized update using `send_sms`, and immediately stores the interaction details via `create_contact` for future reference. ### Auditing Messaging Activity An audit requires proof of all messages sent last month. The agent calls `list_messages` to retrieve a comprehensive history, then uses `get_message` on specific IDs to pull the exact content and timestamps needed for compliance. ## Benefits - Stops manual message tracking. After using `list_messages` or `get_message`, you get detailed logs instantly, eliminating the need to dig through complex delivery reports. - Maintains budget control by running `get_credits` at any time. Your agent checks your current balance before sending, so you never accidentally exceed quota. - Simplifies audience management. Instead of manually adding users, use `create_contact` or `list_contacts` to build and maintain clean subscriber profiles for targeted campaigns. - Handles massive scale effortlessly. The `send_bulk_sms` tool lets you reach thousands of people at once, coordinating complex broadcasts without leaving your chat interface. - Provides instant operational checks. Running `check_bulksms_status` confirms the entire messaging pipeline is up and running before a critical send window opens. ## How It Works The bottom line is that your AI client acts as a dedicated operations coordinator for all your global texting needs. 1. First, subscribe to this MCP and retrieve your API Token ID and Secret from the BulkSMS dashboard. 2. Next, tell your AI client what you need to do—for example, 'Send an SMS reminder to the Acme group'. 3. Finally, your agent executes the necessary tools, sending the message while tracking credits and reporting the final delivery status back to you. ## Frequently Asked Questions **How do I check my current credit balance with get_credits?** You simply ask your agent to run `get_credits`. The tool reads the account data and reports back your exact remaining balance, so you know if you can afford the campaign. **Does send_sms work for groups of people?** No. If you need to message multiple people, use `send_bulk_sms`. The single `send_sms` tool is strictly for sending a notification to one specific phone number. **What should I do if my connection fails? (check_bulksms_status)** Run the `check_bulksms_status` tool first. It verifies your API credentials and overall connectivity, telling you right away if the issue is with your token or the platform itself. **Can I list all my messages using list_messages?** Yes. `list_messages` pulls a comprehensive summary of your recent activity. If you need the full details, use `get_message` and provide the specific ID from that list. **How do I use `get_profile` to check my overall account details?** It retrieves your full account metadata, giving you a snapshot of service limits and credentials. You can verify the operational health of the entire connection here, checking more than just your current credit balance. **How do I use `create_contact` to build my address book?** You pass the contact's name and phone number directly into the tool. This lets your agent automatically populate new contacts for targeted campaigns before you send anything out, keeping your list accurate. **If I need details about a single message, how do I use `get_message`?** You provide the unique message ID to the tool. It returns all associated data, including the exact send timestamp and the final delivery status for that one specific interaction. This is useful for auditing. **Can I use `delete_message` to clean up old records?** Yes, you specify a message ID to remove it from the system record. Use this when a message was sent in error or needs removal for compliance reasons. Always confirm the ID first. **How do I find my BulkSMS Token ID and Secret?** Log in to BulkSMS, navigate to **Settings** > **Developers** > **API Tokens**, and generate a new token to get your ID and Secret. **Can I manage contact groups via AI?** The current toolset focuses on messaging and credit checks. You can query your account profile to see high-level metadata about your groups. **How do I check my remaining balance?** Use the `get_credit_balance` tool to retrieve your current remaining funds directly from the BulkSMS platform.