# TextP2P MCP > TextP2P connects your AI agent directly to bulk SMS, MMS, and Ringless Voicemail services. It lets you run large-scale outreach campaigns—for political organizing, nonprofits, or sales teams—all through natural conversation. Manage contact lists, drop voicemails without ringing the phone, send rich media messages, and track your remaining credits from a single chat window. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** bulk-sms, mms-marketing, ringless-voicemail, text-marketing, lead-engagement, textp2p ## Description Listen up. This TextP2P server connects your AI agent directly to bulk SMS, MMS, and Ringless Voicemail services. It lets you run huge outreach campaigns—for anything from political organizing to sales pitches—all through natural conversation with your client. Your agent handles the whole mess: managing contacts, dropping voicemails without ringing anybody's phone, sending rich media blasts, and tracking exactly how much credit you've got left. You never gotta jump between a dozen different dashboards; it’s all one chat window. When your agent runs these campaigns, here's what it does: **Sending Messages:** It sends standard text messages using the `send_textp2p_sms` tool, letting you blast out alerts or promos to multiple recipients. You can send multi-media updates—pictures and files included—with the `send_textp2p_mms` tool, which is key when the message needs more than just text. For follow-ups where you don't want people getting annoyed by a ringing phone, your agent triggers pre-recorded voicemails using `send_textp2p_rvm`. This delivers that audio blast without the ringtone, perfect for non-intrusive check-ins. **Managing Contacts and Lists:** You don't just send messages; you build a list first. Your agent pulls up all your existing mailing groups or segments using `list_textp2p_lists`, so you know exactly who you’re hitting with the campaign. Need to add someone new? The `add_textp2p_contact` tool lets you drop single contacts into the system, keeping your recipient database fresh. **Monitoring Your Budget:** It's crucial that you know your spending limits. You check your current credit balance for all three services—SMS, MMS, and RVM—using `get_textp2p_balance`. This tells you what you can afford to send next so you don’t get stuck halfway through a big campaign. Essentially, the process is this: Your AI client talks to your agent. The agent looks at the task—say, 'Send a picture and an audio drop to all members of the 'VIP' list.' It then chains together the necessary steps: first, it uses `list_textp2p_lists` to confirm the group exists; next, it checks `get_textp2p_balance`; finally, it calls `send_textp2p_mms` and `send_textp2p_rvm` with the right attachments and recipients. It handles all that complex logic for you. You just tell your agent what you want done; it executes large-scale outreach across texts, images, audio drops, and voicemails without you ever lifting a finger. ## Tools ### add_textp2p_contact Adds a single new contact record to your TextP2P account. ### get_textp2p_balance Retrieves the current available credit balance for SMS, MMS, and RVM services. ### list_textp2p_lists Lists all existing contact lists or segments within your account. ### send_textp2p_mms Sends a multi-media message (MMS) to specified recipients, supporting image and file attachments. ### send_textp2p_rvm Triggers the delivery of a pre-recorded Ringless Voicemail (RVM) to a target number. ### send_textp2p_sms Sends a standard text message (SMS) to one or more specified recipients. ## Prompt Examples **Prompt:** ``` Send a bulk SMS to '555-0199, 555-0188' saying: 'Flash sale ends in 2 hours!'. ``` **Response:** ``` SMS campaign initiated! I've sent the message to both recipients. I'll let you know if you need to check your remaining credit balance after this broadcast. ``` **Prompt:** ``` Drop a ringless voicemail to +15550177 using audio URL 'https://vinkius.com/vmail.mp3'. ``` **Response:** ``` RVM request sent! I've triggered the ringless voicemail drop to +15550177 with your audio file. It will be delivered directly to the recipient's inbox without ringing. ``` **Prompt:** ``` Check my current credit balance for SMS and RVM. ``` **Response:** ``` Fetching balance... You currently have 1,200 SMS credits and 450 RVM credits available. You have plenty of budget for your upcoming marketing campaigns. ``` ## Capabilities ### Run full SMS campaigns Sends standard text messages to multiple recipients, initiating bulk communication for promotions or alerts. ### Send rich media updates (MMS) Transmits multi-media messages that include images and other files alongside the text body. ### Drop silent voicemails (RVM) Delivers pre-recorded audio messages to phones without triggering a ring, perfect for non-intrusive follow-ups. ### Query and build contact lists Lists existing mailing groups or adds new contacts by name/number so you can precisely target your audience. ### Monitor spending budget Checks the current credit balance for SMS, MMS, and RVM to ensure campaigns stay within budget limits. ## Use Cases ### The Flash Sale Alert A retail marketing manager needs to send an urgent sale announcement. They prompt their agent: 'Send a bulk SMS about the flash sale to the entire VIP list.' The agent executes `list_textp2p_lists` to verify the group, then calls `send_textp2p_sms`, handling the full blast instantly. ### The Donor Nurture Cycle A nonprofit needs to follow up with donors who attended an event. Instead of a mass email, they ask their agent to 'Drop a thank you RVM for last week's gala.' The agent uses `send_textp2p_rvm` to deliver the audio message silently. ### The New Lead Intake A sales rep captures a new contact from a trade show. Instead of manually logging it, they prompt: 'Add John Doe at 555-1234 to my list.' The agent uses `add_textp2p_contact` instantly, keeping the workflow moving. ### Checking Campaign Feasibility A field director needs to know if they can afford a full day of outreach. They start by asking: 'Check my SMS and RVM credit balance.' The agent runs `get_textp2p_balance` immediately, preventing costly overspending. ## Benefits - Budget control is instant. Use `get_textp2p_balance` to check your remaining SMS or RVM credits before launching a campaign. No more guessing if you have enough budget. - Multi-format outreach means one tool covers everything. You can run simple texts via `send_textp2p_sms`, rich media updates with `send_textp2p_mms`, and silent follow-ups using `send_textp2p_rvm`. - Manage your audience list first. Before sending anything, use `list_textp2p_lists` to query segments and ensure you're targeting the right people. No guessing games here. - Build contacts on the fly. Need to add a new lead? Just call `add_textp2p_contact`. It keeps your list clean and accurate without leaving the chat environment. - Streamline campaign execution. The AI agent sequences multiple calls—like checking balance, listing groups, then sending SMS—so you don't have to manage the API steps yourself. ## How It Works The bottom line is: You tell your AI client what outreach needs doing, and the server handles the API calls, credential management, and sequential steps required for messaging delivery. 1. Subscribe to this server and input your TextP2P credentials (API URL, Username, Secret). 2. The AI agent reads the tool definitions and waits for a command (e.g., 'Send an SMS to X list'). 3. Your agent executes the necessary tools in sequence—checking balance first, then listing contacts, then sending messages—and reports success or failure back to you. ## Frequently Asked Questions **How do I check my current credit balance with TextP2P MCP Server?** You call `get_textp2p_balance`. This tool instantly reports your remaining SMS, MMS, and RVM credits. It’s the first step you should always run before a large campaign. **Can I send an image update using TextP2P MCP Server?** Yes, you use `send_textp2p_mms`. This dedicated tool handles rich media files. Don't try to attach images to a standard SMS call; use the MMS function instead. **What is the difference between sending an SMS and RVM using TextP2P MCP Server?** An SMS sends text immediately, requiring the recipient's phone to be active. RVM (`send_textp2p_rvm`) drops a recording that doesn't make the phone ring, making it ideal for follow-up when you don't want an immediate interruption. **How do I add new contacts in TextP2P MCP Server?** Use `add_textp2p_contact` and provide the necessary details. This keeps your contact database accurate without needing to export a CSV and re-upload it. **How do I authenticate or connect to my TextP2P account using any sending tool?** You provide your API URL, Username, and API Secret when setting up the server connection. The agent needs these three credentials—no exceptions—to authorize commands like `send_textp2p_sms` or `send_textp2p_mms`. **What is the purpose of using the `list_textp2p_lists` tool?** This tool retrieves a list of every marketing group and segment you have set up. It lets you confirm who's in your database so you can target the right audience before running any campaign. **What happens if I exceed rate limits while using `send_textp2p_sms`?** The agent stops processing and flags a specific API error message. You'll need to wait for the limit window to reset, or you can ask your agent to break the campaign into smaller chunks. **What types of media are supported when running `send_textp2p_mms`?** The tool handles MMS messages containing both images and audio files. You simply pass a URL for the media content, and your agent bundles it correctly with the text message. **Can I send an SMS to multiple numbers at once?** Yes! Use the `send_textp2p_sms` tool and provide a comma-separated list of phone numbers in the `phone` parameter. The AI agent will trigger the bulk send instantly. **How do I check my remaining credit balance for RVM?** Run the `get_textp2p_balance` query. The agent will retrieve your current available credits for SMS, MMS, and Ringless Voicemail directly from your account. **Is it possible to add a new contact to a specific marketing list?** Absolutely. Use the `add_textp2p_contact` action. Provide the phone number and the `list_name` to register the new lead in your chosen directory instantly.