# SimpleTexting MCP > SimpleTexting connects your text messaging platform to any AI client, letting you run SMS campaigns and manage customer conversations entirely through natural language chat. Forget manual exports or switching tabs; this server lets you send broadcasts, segment lists, and track two-way history using simple commands. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** sms-marketing, mass-messaging, customer-engagement, text-campaigns, two-way-messaging, contact-management ## Description Yo, listen up. This SimpleTexting MCP Server connects your text messaging platform straight into whatever AI client you're running—your agent, Claude, Cursor, whoever. You get full control over handling mass SMS campaigns and managing customer conversations right in the chat window. Forget juggling dashboards or doing manual exports; this thing lets you send broadcasts, segment lists, and track two-way conversation history using plain natural language commands. **Sending Messages and Scheduling Campaigns** You can fire off texts immediately with `send_sms_message`, whether it's a single person or an entire group. Need to reach a whole list? You don't gotta use the general subscriber list; you tell your agent to target specific groups using **`list_audience_segments`** for dynamic, rule-based segments, or by referencing static mailing lists pulled from **`list_contact_lists`**. If you want that message out at 9 AM tomorrow, you don't send it now. Instead, you use **`schedule_sms_delivery`** to set the text message for a specific future date and time. **Managing Contacts in Your Database** Dealing with contacts is straightforward. If someone new signs up, your agent can add them immediately using **`create_subscriber`**, needing just their phone number or email address. Need to tweak an existing lead's info? You use **`update_subscriber_info`** to change details like a phone number or name for any record. Sometimes you gotta clean house. If a contact leaves, you simply tell the agent to run **`remove_subscriber`**, deleting that specified record from your system. To see who's in the books, you can pull a full roster of every current number and record by calling **`list_subscribers`**. And if you only care about one person—maybe you need to know their name or what lists they belong to—you run **`get_subscriber_details`** on that single contact. **Tracking Conversations and System Health** Customer service is all about history. When a customer texts your business, the agent pulls the complete message log between you two using **`list_chat_conversations`**, needing only their phone number to pull up the full thread. You also need to know what's going on behind the scenes. To check if everything's connected right, run **`get_api_status`**; this confirms the connection health and pulls general account metadata. If you're setting up automated triggers or webhooks, you can view all current event configurations using **`list_active_webhooks`**. **The Mechanics of Targeting** This server doesn't just send texts; it helps you organize your audience first. You pull a list of all groups—both the dynamically generated segments via **`list_audience_segments`** and the manually defined lists from **`list_contact_lists`**—so you know exactly who you're talking to before you hit send. The agent also lets you verify that your current webhook setup is correct by showing you what **`list_active_webhooks`** has configured. Basically, you talk to your agent like you're talking to a teammate who knows the system inside and out. You tell it: 'Send this message now to everyone in the Fall Leads segment.' It handles the API calls, manages the data transfer between your chat and SimpleTexting, and gives you clear confirmation of what happened every single time. You don't touch a dashboard; you just talk to your agent. ## Tools ### create_subscriber Adds a new contact record into your system using a phone number or email address. ### remove_subscriber Deletes a specified contact record from your SimpleTexting database. ### get_api_status Checks the current connection status and metadata for the SimpleTexting account. ### get_subscriber_details Retrieves specific information about a single contact, including their name or list membership. ### list_subscribers Pulls a comprehensive list of all current phone numbers and contact records. ### list_chat_conversations Gets the full message history between your company and a specific customer phone number. ### list_contact_lists Lists static, manually defined groups of contacts you maintain (e.g., 'Fall 2024 Leads'). ### list_audience_segments Retrieves a list of dynamic, rule-based groups (segments) you have created for contacts. ### list_active_webhooks Shows the current event configurations for webhooks linked to your account. ### schedule_sms_delivery Schedules a text message to be sent automatically at a specific date and time in the future. ### send_sms_message Sends an immediate, single-recipient or broadcast text message right now. ### update_subscriber_info Modifies data for an existing contact record, like changing their phone number or name. ## Prompt Examples **Prompt:** ``` Send an SMS broadcast to the 'New Arrivals' list: 'Check out our new collection!'. ``` **Response:** ``` SMS broadcast triggered! I've sent the message to all 150 contacts in your 'New Arrivals' list via SimpleTexting. ``` **Prompt:** ``` Schedule a text to +1234567890 for tomorrow at 10 AM saying 'Don't forget our meeting'. ``` **Response:** ``` Message scheduled! I've set the SMS to be delivered to +1234567890 at the specified time. Would you like to see your other pending scheduled messages? ``` **Prompt:** ``` Search for a contact with phone number +1987654321. ``` **Response:** ``` Searching contacts... I found 'Alice Cooper' associated with that number. She is in the 'VIP' list and has received 3 messages recently. Should I retrieve her full interaction history? ``` ## Capabilities ### Send broadcast or scheduled SMS Sends immediate text messages to a defined group of contacts, or sets up texts for delivery at a future date. ### Manage contact records Adds new subscribers (`create_subscriber`), modifies existing phone numbers and details (`update_subscriber_info`), or removes users from your system. ### Segment audience lists Retrieves dynamic groups of contacts (segments) or static mailing lists, allowing you to target specific subsets of your subscriber base. ### Retrieve conversation history Fetches the full log of messages between your business and a customer using `list_chat_conversations`. ### Check API status and metadata Confirms the connection health or pulls general account information via `get_api_status`. ## Use Cases ### Post-purchase follow-up sequence A customer bought an item last week. The agent asks: 'Send a reminder text to the entire 'New Buyers' segment in two days.' The AI runs `list_audience_segments` (to find the right group) and then uses `schedule_sms_delivery`, confirming the exact date and time for the follow-up. ### Handling a PR crisis response A key client calls with an issue. The support agent asks: 'Show me everything we talked about with +1987654321.' The AI runs `list_chat_conversations`, providing the full, chronological history immediately so the agent can respond accurately and professionally. ### Cleaning up old contact data The marketing team realizes a few contacts are out of date. They ask: 'List all subscribers and find anyone whose details need updating.' The AI runs `list_subscribers`, identifies the necessary records, and then uses `update_subscriber_info` to correct phone numbers or names in bulk. ### Launching a time-sensitive promotion The campaign manager needs to hit three different lists (VIP, Bronze, New). They prompt: 'Send the sale notice now to all contacts who are in the 'VIP' list.' The AI executes `send_sms_message` and limits the scope only to that segment. ## Benefits - Target the right people instantly. Use `list_audience_segments` or `list_contact_lists` to pull specific, predefined groups of contacts before running a mass blast with `send_sms_message`. No more guessing which list to use. - Maintain context on every interaction. Instead of jumping to a separate CRM tab, just ask your agent to run `list_chat_conversations` and get the full message thread instantly for any client. - Plan outreach months ahead. Use `schedule_sms_delivery` to set up promotional texts or follow-ups that fire automatically on specific dates. You write the plan once; the system handles the timing. - Keep your database clean. Easily add new users with `create_subscriber` and correct bad data by running `update_subscriber_info`, all without leaving your primary workspace. - Get real-time visibility into your account health. Use `get_api_status` to confirm connectivity or check the delivery status of a recent campaign, ensuring reliable outreach every time. ## How It Works The bottom line is that your AI client becomes a command center, managing complex messaging tasks via simple chat prompts. 1. First, subscribe to this server on Vinkius and input your SimpleTexting API v2 Token. 2. Next, prompt your AI client (Claude, Cursor, etc.) with a direct command, like 'Send an SMS broadcast to the VIP list: Sale ends today.' 3. The agent executes the necessary tools—calling `send_sms_message` and targeting the specified list—and returns confirmation of delivery count. ## Frequently Asked Questions **How do I get a list of my current subscribers using SimpleTexting? (list_subscribers)** You run `list_subscribers` through your agent. It pulls all active phone numbers and basic contact info from your system, giving you a complete overview of who's in the database right now. **Can I schedule an SMS with SimpleTexting? (schedule_sms_delivery)** Yes. You instruct the agent to use `schedule_sms_delivery`, specifying the exact date and time, and it sets up the message for future automated sending. **What does list_chat_conversations do with SimpleTexting? (list_chat_conversations)** It fetches the full message history between your company and a specific phone number. This is crucial for agents who need context on past customer interactions. **How do I send a mass text using SimpleTexting? (send_sms_message)** You use `send_sms_message` and specify the target list or segment. The agent handles the broadcast mechanism, ensuring the message goes out to all recipients simultaneously. **How do I verify that my SimpleTexting connection works correctly using the `get_api_status` tool?** It immediately checks your API credentials and access rights. Running this tool confirms that your AI client has active permission to send messages and manage contacts through SimpleTexting. **If a contact moves or changes their number, how do I update them? Does `update_subscriber_info` work?** Yes, you use the `update_subscriber_info` tool to modify existing records. You can change phone numbers, names, and other data points for a subscriber without having to create a whole new contact. **I need to know what kind of events SimpleTexting is tracking. How do I use `list_active_webhooks`?** This tool retrieves a list of all active webhooks configured on your account. It shows which external services or endpoints listen for specific actions, like message delivery or contact creation. **How do I permanently delete a subscriber record using the `remove_subscriber` tool?** The `remove_subscriber` tool deletes the specified contact from your database. Use this command carefully, as it is a permanent action and cannot be undone. **Can my AI automatically send an SMS broadcast to a specific contact list?** Yes! Use the `send_message` tool with the mode set to 'BROADCAST'. Provide the list name or destination, and your agent will trigger the mass SMS instantly. **How do I schedule a text message for a future date using the AI?** Simply ask the agent to run the `schedule_message` action. Provide the phone number, message text, and the target ISO date/time for the delivery. **How do I find my SimpleTexting API v2 Token?** Log in to your SimpleTexting account, navigate to **Settings** > **API**, and you will find your unique secret API v2 Token there.