# Avochato MCP MCP

> Avochato MCP lets you handle high-fidelity customer texting and engagement directly from your agent. You send SMS/MMS messages to customers, manage entire ticket lifecycles, and keep a clean record of every interaction—all without leaving your workflow. It's all about automating two-way business messaging on the channels your clients actually use.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** business-messaging, sms-marketing, mms, shared-inbox, customer-engagement, two-way-messaging

## Description

Need to run customer communications that feel personal? This MCP connects your agent directly into Avochato for two-way, high-fidelity texting. You treat it like a natural conversation—your AI client handles all the heavy lifting: sending messages and keeping track of who said what.

It's not just about blasting out texts; you can manage an entire customer relationship programmatically. Want to know who you talk to? Your agent pulls your whole contact directory, giving you detailed profiles and interaction histories. Dealing with support requests? You keep team workflows organized by creating and updating tickets in real time. And when a conversation pops up, you get complete logs for total oversight of your digital voice. This kind of integration makes sure you never miss a critical client message or spend hours logging data manually. Since Vinkius hosts this connector, you can wire it into any MCP-compatible agent you already use.

## Tools

### create_contact
Creates a new contact record in Avochato.

### create_webhook
Sets up a webhook to listen for specific events from Avochato.

### delete_webhook
Removes an existing, active webhook listener.

### get_contact
Fetches specific details for a single, known contact.

### get_account_info
Retrieves high-level information about the Avochato account identity.

### list_contacts
Retrieves a full list of SMS contacts currently in the system.

### list_messages
Lists recent incoming and outgoing SMS/MMS messages from the account.

### list_tickets
Gets a list of active conversation tickets that need attention.

### list_webhooks
Lists all webhooks configured for monitoring account events.

### send_message
Sends a new SMS or MMS message to a specified recipient.

### update_contact
Modifies the details of an existing contact record.

### update_ticket
Changes the status (e.g., open to closed) of a conversation ticket.

## Prompt Examples

**Prompt:** 
```
Send a SMS 'Your order is ready!' to '+14155550123'.
```

**Response:** 
```
Message dispatched! I've successfully sent the notification to +14155550123 via Avochato. The status is currently 'Sent'. Shall I alert you as soon as the recipient replies?
```

**Prompt:** 
```
List all active tickets in my Avochato inbox.
```

**Response:** 
```
I've retrieved your inbox. You currently have 5 active tickets, including @user1 and @user2. One ticket is flagged as high priority. Would you like the detailed conversation history for any of these?
```

**Prompt:** 
```
Update ticket '12345' status to 'closed'.
```

**Response:** 
```
Ticket updated! I've successfully closed ticket 12345 in your organization's workflow. It's now moved to the historical records. Need help with any other organizational tasks?
```

## Capabilities

### Send messages to customers
Dispatch SMS and MMS texts instantly, automatically handling links and media.

### Track and organize customer contacts
Fetch detailed profiles and interaction histories for your entire business contact directory.

### Manage support tickets
Create, update, and assign ownership to conversation tickets in real time.

### Monitor message activity
Access complete logs of message threads for a full view of organizational conversations.

### Configure system alerts
Set up webhooks to receive real-time notifications for incoming messages or account changes.

## Use Cases

### The sales follow-up
A rep needs to send a personalized 'Thanks for the chat, here's the link!' message. They prompt their agent: 'Send a follow-up SMS using the contact info.' The agent uses `send_message` and pulls the latest details from `get_contact`, ensuring the message is perfect.

### Closing out support cases
A support manager reviews tickets. They prompt: 'List all open chats for Widget X.' The agent uses `list_tickets`. After reviewing the history, they use `update_ticket` to mark it as resolved and notify the customer.

### Updating client records
Marketing gets new data points on a key account. Instead of updating their internal spreadsheet manually, they ask the agent: 'Update John Doe's phone number.' The agent uses `update_contact` to keep Avochato current.

### Setting up monitoring
The ops engineer needs to know immediately if a specific client replies. They prompt the agent: 'Set up an alert for all incoming messages.' The agent executes `create_webhook`, ensuring instant notification every time something changes.

## Benefits

- Send messages without context switching. You can use `send_message` to dispatch personalized order updates or follow-ups directly from your agent's conversation flow. No more manual copy/pasting of details.
- Keep an accurate record. Instead of sifting through email chains, you can call `list_messages` to pull up the complete, high-fidelity message history for any client interaction.
- Tame the support queue. Your agent handles ticket management; you use tools like `list_tickets` and `update_ticket` to organize ownership and change status without logging into a separate dashboard.
- Build out your contact data. You can call `get_contact` or `list_contacts` first, then use `create_webhook` to set up alerts for when that specific customer responds next.
- Stay informed on the backend. By accessing account metadata via `get_account_info`, you can configure real-time webhooks (`create_webhook`) and get instant reports on activity.

## How It Works

The bottom line is you tell your agent what communication needs doing; the MCP handles the connection and execution through Avochato.

1. Subscribe to this MCP and pull your Avochato Auth ID and Auth Secret from their API settings.
2. Your agent uses these credentials to connect, allowing it to read existing contacts or send a new message.
3. You prompt your AI client—say, 'Send an update to John Doe'—and the agent executes the necessary operations.

## Frequently Asked Questions

**How do I send a message using the Avochato MCP?**
You use the `send_message` tool. You just need to tell your agent who to talk to and what you want to say, and it handles dispatching the SMS/MMS.

**What if I only want a list of people? Which Avochato MCP tool should I use?**
Use `list_contacts` to get all contacts. If you need details on just one specific person, call `get_contact`. It's more precise.

**Can the Avochato MCP help me with support tickets?**
Yes. You can list open cases using `list_tickets`, and then close them or change their status by calling `update_ticket` right from your agent prompt.

**How do I make sure my system knows when a customer replies?**
You need to set up real-time alerts. Use the `create_webhook` tool, and your agent will notify you instantly whenever Avochato registers an incoming message.

**How do I use get_account_info to verify my Avochato connection details?**
It immediately retrieves your account's core identity and metadata. Running this tool confirms that your AI client has the necessary permissions and credentials before you start sending messages or listing contacts.

**If a customer changes their phone number, how do I use update_contact to keep records current?**
You just provide the new details along with the contact identifier. The update_contact tool ensures your record is instantly accurate in Avochato for all future communication attempts.

**How do I check which webhooks are currently active using list_webhooks?**
The tool provides a complete list of every configured webhook endpoint and its operational status. This is critical for maintaining reliable, real-time data flow into your workflow.

**If I send a message and it fails using the send_message tool, how do I troubleshoot the error?**
The response will include specific error codes and failure reasons. This helps you quickly figure out if the issue is credential-related or due to recipient deliverability rules.

**How do I find my Avochato API credentials?**
Log in to your account, navigate to **Settings** > **API Access**, and copy your unique Auth ID and Auth Secret.

**Can I send media files via AI?**
Yes! The `send_message` tool accepts a `media_url` parameter, allowing your agent to dispatch high-fidelity MMS content programmatically.

**How do I check active tickets?**
Use the `list_tickets` tool to retrieve your complete directory of active and pending support tickets directly through your agent.