# ProTexting MCP

> ProTexting manages your entire SMS marketing stack through natural conversation with your AI agent. Send individual or bulk texts, segment contacts into groups, and monitor campaign keyword performance—all without leaving your chat client. It gives you full programmatic control over mobile messaging.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** mobile-engagement, bulk-sms, mms-marketing, keyword-management, customer-retention, campaign-tracking

## Description

You connect ProTexting to your AI client and take total control of SMS marketing right from the chat window. This server lets you send texts, manage who you're talking to, and check campaign performance—all without switching apps.

**Sending Texts: Blast or Single Send**

Need to hit a crowd with a deal? You use `send_bulk` to blast the same message out simultaneously to tons of contacts. For promotions that require pictures or videos, you've got `send_mms`, which handles multi-media texts to specific people. If all you need is a simple text—just plain words—you fire up `send_sms`. You can send these straight to individual recipients or target defined groups.

**Organizing Your Audience List**

You gotta keep your contacts clean. To add a new person's details, just use `create_contact` and dump them into the ProTexting database. If you mess up, don't sweat it; `delete_contact` permanently scrubs an old record from the system. When you need to see everyone you have on file, run `list_contacts`. To segment your list—say, separating 'VIP Clients' from 'New Leads'—you use `create_group`, and then you can pull up all your pre-made segments using `list_groups`.

**Tracking Messages and Campaigns**

You don't just send texts and forget about them. You need to know if they got there. Use `get_message_status` to check the delivery status of any specific message you sent out; you'll see right away if it failed or if it was delivered successfully. For tracking performance, run `list_keywords` to pull a list of your active marketing keywords and their current metrics. You can get a high-level view of everything with `get_account`, which retrieves usage numbers and core account details for the whole ProTexting setup.

**System Health Checks and Maintenance**

Before you launch a campaign, check the system first. Running `check_protexting_status` verifies your live connection to the account, making sure everything's healthy. You can also run `list_groups` if you just want to see what segments you've already built up.

It’s all about direct action: If you need to know how many contacts you have, use `list_contacts`. If you wanna make a whole new segment for your best customers, you call `create_group`. You get full programmatic control over mobile messaging without leaving the conversation with your AI client.

## Tools

### check_protexting_status
Verifies the live connection status and basic health of your ProTexting account.

### create_contact
Adds a new person's contact details to your ProTexting database.

### create_group
Creates a new segment or group for organizing contacts.

### delete_contact
Permanently removes an existing contact record from your system.

### get_account
Retrieves high-level details and usage metrics for your entire ProTexting account.

### get_message_status
Checks the delivery status of a specific message you sent out (e.g., failed, delivered).

### list_contacts
Retrieves a list of all contacts currently stored in your ProTexting account.

### list_groups
Lists all the contact groups or segments you have created.

### list_keywords
Shows a list of your active marketing keywords and their current performance metrics.

### send_bulk
Sends the same message to multiple contacts simultaneously, ideal for large promotions.

### send_mms
Transmits a multi-media text message (including photos or videos) to specific recipients.

### send_sms
Sends a standard, plain text message to one or more contacts.

## Prompt Examples

**Prompt:** 
```
List all my contact groups in ProTexting.
```

**Response:** 
```
I've retrieved your groups. You have 3 active segments: 'VIP Customers', 'New Leads', and 'Event Attendees'. Which one would you like to send a message to?
```

**Prompt:** 
```
Show me all active text messaging campaigns and their opt-in subscriber counts.
```

**Response:** 
```
6 active campaigns. "Loyalty Rewards" has 4,234 opt-in subscribers (grew 12% this month), 89% delivery rate, 34% redemption rate on offers. "Weekly Specials" reaches 3,891 subscribers with 92% delivery. "Appointment Reminders" serves 2,456 contacts with 97% delivery and reduced no-shows by 42%. "Flash Sales" has 1,678 subscribers. "Birthday Club" has 890 members. "Event Alerts" has 567. Total active subscribers: 13,716.
```

**Prompt:** 
```
Send a promotional text blast to all Loyalty Rewards subscribers with a 20% discount code.
```

**Response:** 
```
Promotional text blast sent to 4,234 Loyalty Rewards subscribers. Message: "Exclusive for you! Save 20% on your next visit with code LOYAL20. Valid through May 31st. Show this text at checkout. Reply STOP to opt out." Delivery: 4,189 delivered (98.9%), 45 undeliverable. Compliance: TCPA compliant with opt-out included. Based on previous promotions, expect 340-420 redemptions (8-10% conversion) generating approximately $6,800 in revenue.
```

## Capabilities

### Send SMS/MMS messages
Sends text blasts or individual multi-media messages (MMS) to specific contacts and groups.

### Organize Contacts and Groups
Creates, reads, updates, and deletes contact records and segments them into named message groups.

### Monitor Campaign Performance
Retrieves statistics on mobile keywords, active campaigns, and overall account usage.

### Check Message Status
Gets real-time status updates for sent messages or checks the contents of your message inbox.

## Use Cases

### Running a flash sale promotion
The Marketing Manager needs to blast a deal. They tell their agent: 'Send a promotional text to all Loyalty Rewards subscribers.' The agent uses `list_groups` first, finds the right segment ID, and then executes `send_bulk`, delivering the message instantly.

### Handling an influx of customer questions
A support rep gets a spike in queries. Instead of digging through emails, they prompt their agent to retrieve real-time message metadata using the inbox access tools. This gives them the context needed to reply immediately via natural conversation.

### Cleaning up old leads
An Ops Analyst needs to prune inactive records. They run `list_contacts` to see who's on file, identify stale accounts, and then use `delete_contact` on a batch of numbers that haven't engaged in months.

### Verifying campaign readiness
Before launching a major campaign, the Marketing Manager uses `list_keywords`. This action confirms current opt-in counts and delivery rates for keywords like 'Annual Sale', making sure the system is ready to handle the traffic.

## Benefits

- Saves time on mass outreach. Instead of manually compiling lists and logging in to send a promo, your AI client runs `send_bulk` to target thousands of people instantly.
- Keeps data clean. You can use `create_group` or `list_contacts` to segment users (like 'VIP Customers') before sending messages, ensuring the right message hits the right group.
- Saves money and effort on support. With access to your inbox metadata, you don't need a separate app; your agent just pulls incoming messages when needed.
- Instant campaign visibility. Don't guess if a promo worked. Use `list_keywords` to pull real-time stats on opt-in rates and delivery performance for every active campaign.
- Full control over media types. Need to send an image? Use `send_mms`. For simple text updates, stick with the reliable `send_sms` tool.

## How It Works

The bottom line is that your AI client acts as a dedicated mobile marketing coordinator, running complex workflows without you ever opening the ProTexting dashboard.

1. First, subscribe to this server and provide your ProTexting OAuth Access Token in the developer settings.
2. Next, point your AI client (Claude, Cursor, etc.) at the MCP endpoint. Your agent now sees all available tools.
3. Finally, you just talk to it. You tell your agent what needs doing—like 'Send a blast to VIP Customers'—and the agent runs the necessary API calls.

## Frequently Asked Questions

**How do I check if my ProTexting account is working before sending anything? Use `check_protexting_status`.**
You run the `check_protexting_status` tool. This instantly verifies your API token and connectivity, confirming that your agent has permission to send messages or access groups.

**Can I segment my contacts into a group using `create_group`?**
Yes, you use `create_group`. You define the name (e.g., 'Gold Tier Leads') and then add the specific contact IDs to that new segment for targeted messaging.

**What's the difference between `send_sms` and `send_bulk`?**
`send_sms` sends a single text or a small list of texts. Use `send_bulk` when you need to send the exact same promotional message out to hundreds or thousands of contacts at once.

**How do I get campaign metrics? Should I use `list_keywords`?**
You run `list_keywords`. This tool pulls performance data for all active keywords, letting you see opt-in counts and delivery rates without leaving your chat window.

**Does ProTexting MCP Server handle multimedia? Can I use `send_mms`?**
Yes, the dedicated `send_mms` tool lets you send multi-media messages. This is for texts that include photos or videos, not just plain text.

**What information does the `get_account` tool provide regarding my ProTexting usage limits or current credits?**
It provides real-time operational metrics, including your total available sending quota and remaining active credits. This allows you to monitor resource consumption before running large campaigns.

**If I need to clean up outdated numbers, how does the `delete_contact` function work?**
The tool permanently removes specific contacts from your ProTexting database. You must pass the unique contact ID; deleting a contact is irreversible.

**What details can I get about message delivery using the `get_message_status` tool?**
You retrieve detailed status codes for any sent text, confirming if it was delivered, failed, or is pending. This ensures you know exactly where your messages stand.

**Can my AI automatically send a mass SMS to a specific contact group?**
Yes! Use the `send_sms` tool. Provide the Group ID and the message body, and your agent will trigger the broadcast via ProTexting's infrastructure instantly.

**How do I find my ProTexting OAuth Access Token?**
Log in to your ProTexting account, navigate to **Settings** > **Developers API Keys**, and you will find your unique OAuth API access token there.