# Avochato MCP MCP > Avochato connects your AI client to manage all business messaging through natural conversation. Send and track SMS/MMS messages, segment contacts using tags, or coordinate full mass broadcast campaigns without leaving your chat window. It lets you handle everything from simple follow-up texts to complex campaign audits. ## Overview - **Category:** communication-messaging - **Price:** Free - **Tags:** business-messaging, sms-marketing, mms-messaging, contact-management, broadcast-messaging, customer-engagement ## Description Your agent takes over the repetitive parts of your communications stack. Instead of jumping between a CRM, a spreadsheet, and a separate messaging platform just to send out updates, you keep it all in one place. You can talk to your AI client and have it handle everything: sending an SMS or MMS message, getting full delivery status on that message, and managing the entire conversation history for context. It's more than just texting; you manage contacts by creating them or updating their details, and you control mass messaging campaigns. Need to send a bulletin to 50 people? You can coordinate and audit those broadcasts right from your chat. For full transparency, it even lets you check the current API user details and monitor specific inboxes for security checks. This makes Avochato part of the Vinkius catalog, giving your AI agent access to messaging power that used to require a dozen clicks. ## Tools ### create_broadcast Schedules or sends a message to a large list of recipients. ### create_contact Adds a completely new person to your contact database. ### get_account_check Verifies that the Avochato account connection is working correctly. ### get_contact Retrieves all details for a single, specified contact. ### list_broadcasts Lists the scheduled or previously run mass message campaigns. ### list_contacts Searches and retrieves lists of contacts based on criteria or tags. ### list_messages Gets a history log of all past incoming and outgoing messages. ### send_message Sends a single SMS or MMS message to a recipient's number. ### update_contact Modifies the details of an existing contact record. ### who_am_i Retrieves information about the current API user and associated inbox details. ## Prompt Examples **Prompt:** ``` Send a message to '555-0199': 'Hi there, your order is ready for pickup!' ``` **Response:** ``` Sending message to 555-0199... Success! The SMS has been transmitted. The current status is 'sent'. Would you like me to notify you when it's delivered? ``` **Prompt:** ``` List the last 10 messages from today. ``` **Response:** ``` I've retrieved your recent message history. I found 10 messages from today, including 4 outgoing SMS and 6 incoming responses. Most are related to 'Pickup Notifications'. Shall I summarize the incoming replies for you? ``` **Prompt:** ``` Find all contacts with the tag 'High-Value'. ``` **Response:** ``` Searching contacts... I found 5 contacts matching the 'High-Value' tag: John D., Sarah M., Robert P., Emily W., and Kevin S. Would you like to schedule a broadcast message for this group? ``` ## Capabilities ### Send and Track Messages Transmits SMS or MMS messages and provides real-time status tracking and conversation history. ### Manage Contacts and Segments Creates new contacts, finds specific people by name or tag, and updates existing contact records. ### Run Mass Broadcasts Coordinates the scheduling and execution of bulk messaging campaigns to defined groups of recipients. ### Audit Messaging Inboxes Checks specific subdomains and verifies current API user details for secure communication logging. ### View Message History Retrieves logs of past interactions, showing both outgoing messages and incoming responses. ## Use Cases ### Follow-up after a demo. A sales rep just finished a product demo. Instead of manually looking up the client's details, they ask their agent to `get_contact` for John Doe. They then tell it to send an SMS follow-up message using `send_message`, referencing notes from the meeting. ### Quarterly product announcement. The marketing team needs to notify 50 segment leaders. Instead of building a list and uploading it, they ask their agent to find all contacts tagged 'Leadership' using `list_contacts` and then run the campaign via `create_broadcast`. ### Data cleanup for compliance. The ops team needs to verify which users have active API credentials. They simply ask the agent to run `get_account_check`, getting immediate confirmation without logging into any separate admin portal. ## Benefits - Saves time on contact management. Instead of manually updating a spreadsheet, you can ask the agent to `update_contact` details or use `create_contact` for new leads, keeping the data fresh automatically. - Campaigns are effortless. You don't need to jump through multiple web forms; just tell your agent to run a broadcast using `create_broadcast`, and it handles the scheduling and sending. - Full visibility on conversations. With `list_messages` and `get_contact`, you can instantly audit message history and see exactly what was said, when, and who sent it. - Auditing is simple. Use `get_account_check` to verify your connection details or run a query using `who_am_i` before launching any major campaign, eliminating guesswork. - Targeting gets better. You can use `list_contacts` to filter by tags and then immediately feed that segmented list into the agent for a broadcast via `create_broadcast`, all in one chat session. ## How It Works The bottom line is that once connected, your AI client treats Avochato as just another set of tools it can call on demand. 1. First, subscribe to this MCP and provide your required Avochato Auth ID and Auth Secret. 2. Next, connect it to your preferred AI client (like Cursor or Claude). 3. Finally, ask your agent to perform the action: 'List all contacts tagged 'VIP' and send them a follow-up text.' It handles the rest. ## Frequently Asked Questions **How do I send a single text message using Avochato MCP?** You use the `send_message` tool by providing the recipient's number and the exact text. The agent handles sending it through the platform, giving you instant feedback on its status. **Can I find all my VIP clients with Avochato MCP?** Yes. You use `list_contacts` and specify the 'VIP' tag as a filter parameter to pull up an accurate, searchable list of everyone who matches that criteria. **How do I check if my messaging account is working with Avochato MCP?** Run `get_account_check`. This tool verifies your credentials and connection status immediately, letting you know if there's an API issue before a campaign goes out. **What if I need to change a contact's phone number? Do I use Avochato MCP?** Yes. You run `update_contact`, providing the ID of the person and the new phone number, which immediately changes their record in the system. **What should I use to manage mass messaging or schedule campaigns with the `create_broadcast` tool in Avochato MCP?** The `create_broadcast` function lets you coordinate and send messages to large groups. You can schedule the campaign for a later date, ensuring your message hits all target inboxes at the right time. **If I need to audit past customer conversations or review logs, how does the `list_messages` function in Avochato MCP help?** The `list_messages` tool retrieves your complete message history. You can filter these records by date range, sender type, and conversation topic for detailed auditing. **What steps are needed to onboard a completely new customer using the `create_contact` function with Avochato MCP?** You use `create_contact` to establish records for people who don't exist yet. You must provide all required fields, like name and phone number, so your audience segmentation is accurate from day one. **If I need to verify my current API user and inbox details, how should I use the `who_am_i` tool in Avochato MCP?** Running `who_am_i` quickly confirms your connected account's identity and general API user information. This is a good way to validate connectivity before starting complex workflows. **Can the AI automatically send an SMS to a new contact?** Yes! Use the `send_message` tool. You'll need to provide the phone number and the message body. Your agent will instantly transmit the SMS through your Avochato inbox. **How do I find all contacts that have been tagged with a specific label?** Simply ask the agent to run the `get_contacts` tool with the target tag. It will return a list of matching contact profiles, including their names and phone numbers. **Does the integration allow for sending images through MMS?** Yes. The `send_message` tool supports a `media_url` parameter, allowing you to include images or other media files in your outgoing messages.