# AvoSMS MCP MCP > AvoSMS automates high-volume mobile communication. This MCP lets your AI agent send scheduled or instant SMS messages across global networks. You can manage sender identities, build and audit contact lists, and process incoming replies—all without touching a dashboard. It transforms complex messaging operations into simple natural language commands. ## Overview - **Category:** communication-messaging - **Price:** Free - **Tags:** global-sms, messaging-api, sender-id, contact-lists, bulk-messaging, notification-delivery ## Description Getting bulk messages out used to feel like juggling five different dashboards. Now, your agent handles the whole flow. Instead of manually logging in, fetching contacts, checking credit balances, and hitting 'send,' you just ask your AI client to handle it. Your agent acts as a real-time operations manager for your business, sending notifications, scheduling future broadcasts, and managing approved sender identities on your behalf. If you're tracking customer responses or monitoring account health, the process is invisible—you just get the result. Connecting AvoSMS via Vinkius lets your AI client access this deep suite of messaging tools alongside everything else in the catalog. ## Tools ### add_contact Adds a specific phone number to an existing contact list. ### create_list Creates an entirely new, dedicated contact group. ### create_sender Requests and registers a new name that will appear on outgoing messages. ### delete_list Removes an existing, unused contact list entirely. ### delete_sender Deactivates and removes a previously registered sender name. ### get_account_check Verifies that your connection to the AvoSMS service is working correctly right now. ### get_balance Checks how many SMS credits you have left on your account. ### list_lists Retrieves a full list of all contact groups you have set up. ### list_responses Fetches and displays the most recent incoming messages from customers. ### list_senders Displays all the sender names that have been approved for use. ### send_sms Sends a single SMS message to a specified phone number. ## Prompt Examples **Prompt:** ``` Send an SMS to +33600000000 saying 'Your order is ready for pickup!' using sender 'ShopAlert'. ``` **Response:** ``` I've sent the SMS to +33600000000. It will appear on the recipient's phone as 'ShopAlert'. ``` **Prompt:** ``` Check my AvoSMS credit balance and list recent replies. ``` **Response:** ``` Your current balance is 450.5 credits. I also found 3 recent responses from customers. Would you like me to read them for you? ``` **Prompt:** ``` Add the phone number +123456789 to my 'VIP Customers' list. ``` **Response:** ``` I've added +123456789 to the 'VIP Customers' list (ID: 9876). Your list is now updated and ready for future campaigns. ``` ## Capabilities ### Send and schedule messages The agent sends single, scheduled SMS alerts globally using specified sender identities. ### Manage contact groups You can create new lists of contacts or add specific phone numbers to existing ones. ### Control brand identity The agent requests, lists, and manages the approved names (Sender IDs) your messages appear under. ### Audit communications You can pull a list of incoming replies to keep a two-way dialogue with your audience. ### Monitor account status The agent checks the remaining credit balance and verifies the connection health instantly. ## Use Cases ### Post-purchase follow-up A marketing manager needs to send a 'Your order is ready' alert. They ask their agent, and it executes `send_sms` using a predefined sender name. The system automatically ensures the message goes out with the correct brand identity. ### Handling customer inquiries A support team member receives an SMS reply from a client. They ask their agent to list responses, and it calls `list_responses`. This keeps the conversation history visible directly in the chat interface for immediate action. ### Auditing outreach compliance An ops lead needs to know if they have enough funds before a major campaign. They ask their agent, and it runs `get_balance` first. This prevents them from wasting time on failed campaigns due to insufficient credits. ### Building a new campaign target list A manager needs to compile a group of VIP contacts. They ask the agent to `add_contact` several numbers and then use `create_list` to save that group, making it available for future bulk sends. ## Benefits - You can keep track of your budget by calling `get_balance` before running any bulk campaign, ensuring you don't run out of credits mid-send. It’s just good ops practice. - Instead of remembering list IDs or manually managing names, you tell the agent to use a specific Sender ID (via `list_senders`) and it handles the rest. Your brand always shows up right. - Need to update contacts? Just ask the agent to `add_contact` with a new number; no need to jump into a separate management UI just for one entry. - The best part is two-way comms. By calling `list_responses`, your agent reads incoming replies, keeping you looped in without manual polling or dashboard refreshers. - If a list gets corrupted or abandoned, you can use `delete_list` and `delete_sender` to clean up the backend records cleanly. ## How It Works The bottom line is, you talk to your agent like a normal person, and it handles all the API calls in the background. 1. Subscribe to this MCP, then provide your AvoSMS Account ID and API Key. 2. Your AI client accesses the tools. You ask it to perform a messaging operation (e.g., 'Send an SMS to X'). 3. The agent executes the command through the appropriate tool and returns the result or confirmation. ## Frequently Asked Questions **How do I check if my SMS credits are running low using the AvoSMS MCP?** You run `get_balance`. This tool immediately tells you your remaining credit count, letting you plan your outreach budget without guesswork. **Can I list all approved sender names with the AvoSMS MCP?** Yes. Use `list_senders` to pull a complete manifest of every Sender ID that is ready for use in your outgoing messages. **What should I do if my contact list needs updating on the AvoSMS MCP?** First, you can run `list_lists` to see what groups exist. Then, you simply call `add_contact` with the new numbers and the agent updates the group. **How do I send an SMS message using the AvoSMS MCP?** You use the `send_sms` tool by providing the recipient's number, your chosen sender ID, and the message content in one prompt. **How do I check incoming customer replies using the AvoSMS MCP?** Run `list_responses` to pull all recent messages sent directly to your business number. This ensures your agent can maintain a complete, two-way conversation history with your audience. **How do I verify my AvoSMS account connection using the AvoSMS MCP?** Start by calling `get_account_check`. This function instantly verifies that your API keys and credentials are active, preventing you from sending messages before confirming your setup. **How do I manage multiple contact groups using the AvoSMS MCP?** You can begin by running `create_list` to segment contacts. Later, use `list_responses` and `add_contact` in conjunction with `list_lists` to keep track of all your defined groupings. **How do I request or remove a custom sender identity using the AvoSMS MCP?** Use `create_sender` when you need to formally request and approve a new Sender ID name. If an identity is no longer needed, you can clean it up with `delete_sender`. **What is a sender ID and why do I need one?** A sender ID is the alphanumeric label (3-11 characters) that appears as the sender on the recipient's phone. Approved sender IDs help increase trust and open rates for your messages. **Can I receive replies to my SMS messages?** Yes! Use the `list_responses` tool to retrieve any incoming messages from your customers. This allows your agent to handle two-way communication workflows. **How do I ensure my SMS is delivered at a specific time?** When using the `send_sms` tool, provide a YYYY-MM-DD HH:MM:SS string in the `date` parameter. AvoSMS will queue the message and deliver it exactly at the requested time.