# BulkSMS MCP for AI Agents AI Agent Connect

> BulkSMS lets you manage global SMS campaigns and contact lists from your AI agent. It handles sending single or bulk messages, tracks real-time delivery status, and monitors your account credits automatically. No more manual portal clicking for your notifications.

## Overview
- **Category:** communication
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_V1DMuR9ivzWah0QL6km1BgGcD9H4zmzEE9nLLuJf/ai-agent-connect
- **Tags:** sms-messaging, bulk-messaging, notification-service, customer-engagement, delivery-tracking

## Description

Managing global SMS communications usually means juggling multiple tabs, copying phone numbers into spreadsheets, and constantly refreshing a dashboard to see if your messages actually landed. It is a tedious cycle of manual data entry that breaks your focus. This Connector changes that by bringing your BulkSMS.com account directly into your AI workflow. You can just tell your agent to send a notification to a specific group or check if your credit balance is getting low without ever opening a new browser tab. Because it is part of the Vinkius catalog, you can connect it once and let your AI handle the heavy lifting of message dispatching and contact organization. It is about moving from manual data entry to just describing the outcome you want. Instead of worrying about the mechanics of the REST API or formatting headers, you just focus on getting your message to the right person at the right time. Whether you are sending a single verification code to a customer or blasting a promotional alert to thousands of subscribers, the process stays the same. You describe the task, and your AI client executes the communication. It turns a multi-step administrative chore into a single natural language command.

## Tools

### get_message
Get specific details and metadata for a single message ID. This is useful for investigating delivery issues.

### get_account_info
Pull core account details and configuration data. This helps you keep your account settings organized.

### get_profile
Retrieve your current account profile and remaining credit balance. Use this to monitor your spending.

### list_group_members
See every contact currently assigned to a specific group. This makes it easy to verify your audience size.

### list_groups
Get a complete list of all your organized contact groups. Use this to see how your segments are structured.

### list_messages
View a history of all sent SMS messages and their statuses. This gives you a clear view of your recent activity.

### send_bulk_sms
Send a large volume of SMS messages to multiple destinations at once. This is the primary tool for mass outreach.

### send_sms
Send a single SMS message to a specific phone number. This is ideal for one-off alerts or verification codes.

## Prompt Examples

**Prompt:** 
```
Send an SMS to +1234567890 saying 'Your appointment is confirmed'.
```

**Response:** 
```
I've sent that for you. The message was delivered successfully. **Message ID:** msg_9982
```

**Prompt:** 
```
How many credits do I have left?
```

**Response:** 
```
Checking your account... You have **450.25 credits** remaining in your BulkSMS.com balance.
```

**Prompt:** 
```
Who is in the VIP group?
```

**Response:** 
```
I found 12 members in your 'VIP Customers' group:
- John Doe (+1234567890)
- Sarah Smith (+0987654321)
- [10 more members]
```

## Capabilities

### Send bulk SMS messages
Dispatch notifications to thousands of recipients at once.

### Track delivery status
See exactly which messages were delivered and which failed.

### Manage contact groups
Organize your audience into segments like VIPs or new leads.

### Monitor account credits
Check your balance in real-time to avoid service interruptions.

### Retrieve message details
Pull specific metadata for any individual message ID.

## Use Cases

### Mass promotional blasts
A marketing team needs to send a 'Flash Sale' alert to 5,000 people. The user asks the agent to use send_bulk_sms to blast the message to the 'Active Subscribers' group.

### Instant verification codes
A support rep needs to verify a user's identity. The rep tells the agent to use send_sms to deliver a 6-digit code to the customer's phone.

### Proactive credit monitoring
An ops lead is worried about overspending. They ask the agent to use get_profile to check the remaining credit balance before a big push.

### Audience verification
A manager needs to see who is in the VIP list. They ask the agent to use list_group_members to see the names and numbers of the 'VIP Customers'.

## Benefits

- Stop manual data entry by using send_bulk_sms to reach thousands of people at once without opening a browser.
- Know your reach with list_messages which lets you see exactly what was sent and where it landed.
- Organize your audience better by using list_groups to keep your marketing segments clean and accessible.
- Avoid service gaps by checking your balance with get_profile before starting a large campaign.
- Speed up support by using send_sms to deliver one-off verification codes or status updates in seconds.

## How It Works

The bottom line is you can manage your entire SMS communication pipeline using only natural language.

1. Subscribe to the BulkSMS MCP and provide your BulkSMS.com credentials.
2. Connect the Connector to your AI client like Claude or Cursor.
3. Ask your agent to send messages, list groups, or check your balance.

## Frequently Asked Questions

**Can I use the BulkSMS MCP to send notifications to my customers?**
Yes, you can use it to send one-off updates or mass notifications to your entire contact list. Your AI agent handles the heavy lifting of connecting to the service for you.

**How does the BulkSMS MCP help with marketing?**
It lets you manage contact groups and send bulk SMS messages without leaving your workspace. You can target specific segments and see the results immediately.

**Can the BulkSMS MCP check my remaining credits?**
Yes, your agent can pull your current account profile and credit balance in real-time. This helps you stay on top of your spending during large campaigns.

**Is the BulkSMS MCP good for sending verification codes?**
It is perfect for that. You can trigger a single SMS to a specific number for things like 2FA or appointment confirmations through your AI client.

**Can I see if my messages actually arrived?**
You can use the Connector to list all sent messages and retrieve detailed delivery metadata. This lets you verify that your communications reached their destination.

**How do I manage my contact lists with the BulkSMS MCP?**
The Connector lets your agent see your contact groups and list all the members within them. You can organize your audience and query them using natural language.

**Can I check my remaining credit balance using the agent?**
Yes! Use the `get_profile` tool. Your agent will fetch your account profile, including the current total credit balance available for sending messages.

**How do I send an SMS to multiple people at once?**
Simply ask the agent to `send_bulk_sms` and provide a JSON array of messages. Each object should include the recipient's phone number and the message body.

**Does the integration support checking if a message was delivered?**
Yes. Use the `get_message` tool with the Message ID. It will retrieve the current delivery status directly from BulkSMS.com.