# QuickReply.ai MCP

> QuickReply.ai connects your WhatsApp marketing efforts to any AI agent. Use this server to manage contacts, run broadcasts, and automate customer engagement by sending messages or tracking user actions without leaving your chat window.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** whatsapp-marketing, conversational-commerce, customer-engagement, broadcast-messaging, retention

## Description

Look, forget all that fluff you see online. This isn't another 'workflow solution.' QuickReply.ai connects your chat automation directly to your AI agent so you can run serious WhatsApp campaigns without ever leaving the client window. It handles all the dirty work: managing who gets messages, what those messages even look like, and tracking every single interaction.

**Managing Your Contact List:** You gotta know exactly who's on board before you send a dime of effort. Use `list_contacts` to pull up a full roster of everyone in your QuickReply.ai system. Need more detail? Run `get_contact_details` for any specific user and grab their entire profile metadata. If somebody moves or changes their number, don't sweat it; you can run `update_contact` to modify phone numbers or names on existing records. And if you need a new lead added to the books, just fire off `create_contact`. 

**Segmenting and Structuring Data:** We ain't sending messages blind. You can pull up `list_user_segments` to see all the predefined groups—your 'VIPs,' your 'New Subs,' whatever you call 'segment.' For template prep, run `list_message_templates` to get a full catalog of every approved WhatsApp message format you've got on file, and use `get_template` when you need the specific content details for any one of those templates.

**Sending Messages and Tracking Events:** When it’s time to talk shop, you have two ways to send stuff. You can run `send_whatsapp_message` using plain text straight up, or you can use a pre-approved template with that same function. To keep track of what users are actually doing—like if they clicked a link or viewed a page—you gotta use `track_user_event`. This logs custom user actions and event names so your AI agent knows exactly how people are behaving for future segmentation analysis.

**Running Campaigns and Monitoring Performance:** Running big sends is easy. You can list everything you've ever done with `list_broadcast_campaigns`, which gives you a historical view of past or scheduled marketing efforts. When you wanna know the specifics on one campaign, run `get_broadcast` using the name to pull up all the metrics and details for that specific broadcast. This whole setup lets your agent manage contacts, send messages, and monitor how far those broadcasts got—all in one go.

## Tools

### create_contact
Adds a new contact record directly into your QuickReply.ai account.

### get_broadcast
Retrieves specific metrics and details for a named broadcast campaign.

### get_template
Retrieves the content and details of a specific, pre-approved message template.

### get_contact_details
Fetches detailed profile metadata for a single, specified contact.

### list_broadcast_campaigns
Gets a list of all historical or scheduled broadcast campaigns you've run.

### list_contacts
Retrieves a full list of every contact registered in the QuickReply.ai system.

### list_user_segments
Lists the predefined segments (groups) that your contacts belong to.

### list_message_templates
Provides a catalog of all available, approved WhatsApp message templates for outreach.

### send_whatsapp_message
Sends a WhatsApp message, either as plain text or using a template, to specified recipients.

### track_user_event
Logs a custom user event and action name for later segmentation analysis.

### update_contact
Modifies specific data points, like phone numbers or names, for an existing contact record.

## Prompt Examples

**Prompt:** 
```
List all contacts in QuickReply.ai.
```

**Response:** 
```
I've retrieved your contacts. You have 200 subscribers, including 'John Doe' (+12345) and 'Alice Smith' (+67890).
```

**Prompt:** 
```
Show me all WhatsApp broadcast campaigns from this month with delivery and read rates.
```

**Response:** 
```
7 WhatsApp broadcasts this month. "Product Launch Announcement" reached 4,567 contacts (98.2% delivered, 84% read, 23% clicked). "Flash Sale Alert" sent to 3,200 (97.8% delivered, 79% read, 31% clicked, highest conversion). "Newsletter May" to 5,100 (98.5% delivered, 72% read). "Feedback Request" to 1,800 (97% delivered, 68% read, 45% responded). Total messages: 18,234. Overall read rate: 76%. Opt-out rate: 0.3%.
```

**Prompt:** 
```
Send a personalized WhatsApp template message to all contacts in the VIP Customers segment.
```

**Response:** 
```
Template broadcast sent to VIP Customers segment. Recipients: 234 contacts. Template: "Exclusive VIP Offer" (approved by Meta). Personalization: each message includes the contact's first name and their last purchase category. Delivery: 232 delivered (99.1%), 2 failed (invalid numbers). Read rate after 1 hour: 67% (156 contacts). 12 contacts have already replied. Auto-reply bot activated for incoming responses.
```

## Capabilities

### Manage Contact Records
List contacts, retrieve detailed metadata for a user, or update existing contact information.

### Execute Messaging Campaigns
Send WhatsApp messages, either as plain text or using pre-approved templates, and monitor the results.

### Monitor Outreach Performance
List and get details about past and scheduled broadcast campaigns to track reach and metrics.

### Segment Users
Query available contact segments (like 'VIP Customers') or list all subscribers in the system.

### Track User Behavior
Record custom, specific user actions and events to build out data for future segmentation.

## Use Cases

### Launching a product sale to VIPs
The Marketing Manager needs to hit only their top customers. They ask the agent to first run `list_user_segments` for 'VIP Customers', then use `get_template` to verify the 'Sale Alert' template, and finally execute `send_whatsapp_message` to that segment.

### Investigating a low-performing campaign
A specialist needs to know why Campaign X didn't hit its goal. They ask the agent to use `get_broadcast` for 'Campaign X', which instantly returns delivery rates, read rates, and total messages sent, eliminating manual report downloads.

### Following up on a specific user action
A sales rep needs to follow up with John Doe because he showed interest. They first use `get_contact_details` for John Doe, then run `track_user_event` ('Inquired about product Y'), and finally send a tailored message using `send_whatsapp_message`.

### Cleaning up old contact data
The Ops team finds outdated records. They use `list_contacts` to get the full list, identify contacts needing an address update, and run `update_contact` on those specific users in bulk.

## Benefits

- **Saves time on data gathering:** Instead of manually checking multiple tabs, you can use `list_contacts` or `list_user_segments` to get a structured list of all necessary recipients in one prompt.
- **Ensures message compliance:** Before sending anything, your agent checks the system with `list_message_templates`, making sure you only use pre-approved and compliant WhatsApp templates.
- **Tracks actions automatically:** Use `track_user_event` to log critical customer interactions (like 'Viewed Pricing Page') right into the CRM data stream. This builds better segments for future campaigns.
- **Manages complex outreach:** Don't worry about bulk sending errors. You can run whole campaign reports using `get_broadcast` and analyze performance metrics immediately.
- **Keeps contact records fresh:** If a user changes their phone number, you don't have to manually update it; just call `update_contact` with the new data.

## How It Works

The bottom line is, you tell your AI client what marketing action you need, and it executes the API calls against QuickReply.ai for you.

1. Subscribe to the QuickReply.ai MCP Server.
2. Enter your API Key from your QuickReply.ai dashboard settings into your AI client.
3. Use natural language prompts in Claude, Cursor, or any compatible agent to call tools like `list_contacts` or `send_whatsapp_message`.

## Frequently Asked Questions

**How do I check which templates are allowed for QuickReply.ai MCP Server?**
You use the `list_message_templates` tool. This command pulls a catalog of all pre-approved WhatsApp message templates, ensuring your outreach is compliant before you send anything.

**Can I update a contact's phone number using QuickReply.ai MCP Server?**
Yep, use the `update_contact` tool. This lets you change specific details for an existing user record without needing to manually log into your main dashboard.

**What is the best way to start a campaign with QuickReply.ai MCP Server?**
First, use `list_user_segments` to identify the perfect group of people. Then, check available templates using `get_template`, and finally send the message via `send_whatsapp_message`.

**Does QuickReply.ai MCP Server help me track user actions?**
Absolutely. You call the `track_user_event` tool, which logs a custom action (like 'Clicked Coupon Link') and feeds that data back into your segmentation for later analysis.

**What API key do I use when setting up QuickReply.ai MCP Server?**
You must enter your unique QuickReply.ai API Key from your dashboard settings. This key authenticates your AI client and gives it permission to run all tools, including `list_contacts` and `send_whatsapp_message`.

**How does the get_contact_details tool help me gather deeper information about a user?**
The `get_contact_details` tool retrieves comprehensive profile metadata beyond just name and number. This lets your agent pull specific data points—like segment membership or last interaction date—for better targeting.

**What does the list_user_segments tool help me identify for my marketing efforts?**
The `list_user_segments` tool shows all pre-defined groups you've created within QuickReply.ai. This allows your AI client to target specific cohorts, ensuring messages only go out to relevant customer lists.

**Are there rate limits when using the send_whatsapp_message tool?**
The server manages message volume according to WhatsApp's commercial policy. If you hit a temporary limit, your agent will receive an error code indicating throttling, and you'll need to wait or pace your requests.

**Can I send a WhatsApp message using my AI agent?**
Yes! Use the `send_whatsapp_message` action. Provide the recipient's phone number and your message body or template data.