# MRPLN MCP

> MRPLN connects your AI client directly to WhatsApp, SMS, and Email channels, giving you a unified control panel for customer engagement. This server lets your agent manage entire marketing funnels—from listing all contacts (`list_customers`) to sending targeted messages using pre-approved templates (`send_whatsapp_message`). It also tracks performance metrics by calling `get_tactic_performance`, so you know exactly what's working and where to spend your time. Stop switching between platforms; manage it all from one chat window.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** whatsapp-api, sms-marketing, email-automation, customer-database, omnichannel-messaging

## Description

Listen up. If you're sick of jumping between a CRM, a mailing platform, and Meta Business Suite just to run a campaign, this is the deal. The MRPLN server connects your AI client directly to WhatsApp, SMS, and Email channels. It gives your agent one unified spot to handle every single thing related to customer engagement—from building out your contact list to tracking exactly which messages actually convert into sales. You're managing an entire marketing funnel right from the chat window.

**Managing Your Customer Database**
You can keep your lead data rock solid using a few key tools. Need to find someone? Use `get_customer` and throw in their identifier, and you get all their specific details pulled into your agent's memory. If you spot a new lead or need to add fresh info to an existing client, just fire off `create_customer`. And if that contact moved or changed their job title, don't worry; you can update them with `update_customer`. You never gotta guess who's in the system either; run `list_customers` and it spits out every single contact and lead currently sitting in your database. It’s how you make sure no one falls through the cracks.

**Sending Messages Everywhere, The Right Way**
When it comes to outreach, this server gives you three channels: SMS, Email, and WhatsApp. You can send a quick text blast using `send_sms_message` straight to any phone number. For standard communication, use `send_email_message`; the agent handles sending messages to one or more addresses you specify. But for WhatsApp, it’s different. Because Meta is strict, you gotta use structured templates, and that's what `send_whatsapp_message` does. Before you even send a message, though, you need to check your playbook with `list_waba_templates`. That tool shows you every pre-approved WhatsApp template you can legally use, keeping your brand consistent from start to finish.

**Tracking Campaign Performance and Tactics**
You gotta know what’s working, period. You can't just send messages and hope for the best. To check how well any specific marketing effort performed, run `get_tactic_performance`. That pulls real analytics on your campaign success rate. Before you even start a new push, use `list_tactics` to get a full inventory of all available campaigns or tactics in the system. This keeps you organized so you know exactly what tools are ready for deployment.

It's simple: Your AI client calls the right tool—like listing contacts with `list_customers`, sending out a blast using `send_whatsapp_message`, or checking metrics via `get_tactic_performance`. The server runs the action, gathers the clean results, and hands it all back to your agent. You don't switch apps; you just manage everything from one spot.

## Tools

### create_customer
Adds a brand-new customer or lead to your database.

### get_customer
Pulls specific details for one existing customer based on their identifier.

### get_tactic_performance
Retrieves analytics showing how well a particular marketing tactic performed.

### list_customers
Lists all contacts and leads currently in your system database.

### list_tactics
Shows an inventory of all available marketing campaigns or tactics.

### list_waba_templates
Retrieves a list of pre-approved WhatsApp message templates you can use.

### send_email_message
Sends a standard email communication to one or more specified addresses.

### send_sms_message
Dispatches an immediate text message (SMS) to a target phone number.

### send_whatsapp_message
Sends a structured, template-based WhatsApp message using Meta's API.

### update_customer
Changes or adds new information to an existing customer record.

## Prompt Examples

**Prompt:** 
```
List all customers in my MRPLN account.
```

**Response:** 
```
I've retrieved your customer list. You have 45 registered leads, including 'John Smith' and 'Maria Garcia'. Would you like to see the details for a specific customer?
```

**Prompt:** 
```
Send a WhatsApp message to +123456789 using the 'welcome_template'.
```

**Response:** 
```
WhatsApp message sent successfully to +123456789! I used the 'welcome_template' as requested.
```

**Prompt:** 
```
Show me the performance of the 'Winter Sale' tactic.
```

**Response:** 
```
The 'Winter Sale' tactic has achieved a 15% conversion rate so far, with 200 messages sent and 30 conversions recorded. Would you like to see a channel breakdown?
```

## Capabilities

### Manage Customer Records
You can create, read, update, and list customer and lead accounts using tools like `create_customer`, `get_customer`, and `list_customers`.

### Send Multi-Channel Messages
The agent sends messages via WhatsApp (`send_whatsapp_message`), SMS (`send_sms_message`), or Email (`send_email_message`) using specific recipient data.

### Monitor Campaign Performance
You get analytics on marketing efforts by running `get_tactic_performance` and listing available campaigns with `list_tactics`.

### Control Messaging Templates
The system lists approved WhatsApp templates (`list_waba_templates`) ensuring every message follows your brand guidelines before sending.

## Use Cases

### Handling Abandoned Carts
A customer leaves items in their cart. The agent first calls `get_customer` to pull the user's phone number and email. It then uses `send_whatsapp_message` with a discount code template, followed by scheduling an automated follow-up via `send_email_message`. The problem is solved, and the entire sequence is logged.

### Post-Event Follow-Up
The sales team just ran a webinar. They ask the agent to find all attendees who haven't bought anything yet by calling `list_customers`. The agent then uses `send_sms_message` with a direct link and tracks that outreach using `update_customer`.

### Analyzing Campaign Failures
A campaign underperformed. Instead of manually pulling reports, the agent is told to run `get_tactic_performance` for 'Q1 Outreach'. It returns a low conversion rate and identifies which channel (SMS vs Email) was weakest, telling you exactly where to pivot.

### Onboarding New Leads
A new lead comes in from a paid ad. You immediately instruct the agent to `create_customer` with their details, and then trigger an initial welcome message using `send_whatsapp_message`. This gets them engaged instantly.

## Benefits

- **Centralized Data:** Instead of juggling spreadsheets, use `list_customers` to pull your entire contact list into the agent. Then, you can run targeted campaigns without manual data export/import steps.
- **Compliance-First Messaging:** You never send a message blind. By calling `list_waba_templates`, you ensure every WhatsApp conversation uses an approved template, keeping you within Meta’s rules and maintaining brand trust.
- **Instant Performance Feedback:** Need to know if the 'Summer Sale' campaign is working? Use `get_tactic_performance`. The agent delivers the conversion rate and message count instantly, letting you pivot your strategy in real time.
- **Complete Customer Lifecycle Tracking:** When a customer signs up, use `create_customer` first. Later, when they need support, use `update_customer` to log that interaction against their profile—everything is connected.
- **True Omnichannel Reach:** You can execute a sequence: Use `list_customers`, then send an immediate SMS (`send_sms_message`), and if no reply comes, schedule a follow-up email (`send_email_message`) automatically.

## How It Works

The bottom line is: you tell your agent what communication goal you have, and it handles fetching the contacts, checking templates, and sending the message across all required channels.

1. Your agent identifies the need (e.g., 'I need to send a follow-up SMS to all leads in California').
2. The agent calls `list_customers` first, filtering the list down to the specific group of people needed.
3. Finally, the agent uses the collected data and invokes `send_sms_message`, passing the filtered contact information directly.

## Frequently Asked Questions

**How do I check campaign results using get_tactic_performance in MRPLN?**
You simply tell your agent to run `get_tactic_performance` and provide the name of the tactic. It returns metrics like conversion rates, messages sent, and total conversions without you leaving the chat.

**Can I list all contacts using list_customers?**
Yes, running `list_customers` pulls your entire database of leads and customers into the conversation. This is the first step before you can run any mass communication campaign.

**What tools are needed to send a WhatsApp message?**
You must use `send_whatsapp_message`. Before that, it’s smart to call `list_waba_templates` so your agent knows which approved templates you can use for the specific message.

**How do I update a customer's details using MRPLN?**
You run `update_customer`, specifying the existing customer ID and providing the new data (like a new phone number or email). This keeps your database current without needing to manually edit records.

**Is there a tool to see what kind of messages I can send?**
Yes, `list_tactics` lets you see all the marketing campaigns available. For messaging types, you'll use `send_sms_message`, `send_email_message`, or `send_whatsapp_message` depending on your goal.

**What setup details do I need before using the `create_customer` tool?**
You must connect your MRPLN API key first. The server needs this key to authenticate your account and ensure your agent has permission to write or read customer data.

**When should I use `send_sms_message` instead of sending an email?**
Use SMS for time-sensitive alerts or short confirmations. Email is better suited for detailed reports, attachments, or lengthy communication flows. WhatsApp works best for personal, conversational follow-ups.

**If I exceed the messaging limit when using `send_whatsapp_message`, how does the system handle it?**
The server handles rate limiting automatically. If you hit a cap, your agent will return an error code and tell you exactly when you can try sending messages again.

**How do I get my MRPLN API Key?**
Log in to your MRPLN dashboard at app.mrpln.com, go to **Settings** > **API Keys**, and generate a new key for your integration.

**Can I send free-form WhatsApp messages?**
WhatsApp Business API primarily requires approved templates for business-initiated conversations. Free-form text is available only within a 24-hour service window after a user message.

**Which channels are supported for messaging?**
MRPLN currently supports WhatsApp Business API, SMS, and Email messaging through this MCP server.