# Dripcel MCP

> Dripcel manages WhatsApp automation directly through your AI agent. Use this MCP to monitor all connected instances, check message delivery statuses, audit account limits, and track contact history across multiple accounts.

## Overview
- **Category:** communication-messaging
- **Price:** Free
- **Tags:** whatsapp-automation, messaging-api, customer-engagement, contact-management, bulk-messaging

## Description

This connection lets you treat your entire WhatsApp operation like a chat window with an expert assistant. You manage everything from instance health to individual customer conversations without ever leaving your AI client. Need to know if the sales team's WhatsApp link is up? Or maybe you just got 10 new contacts and need to check their history before sending out a campaign? Your agent handles it. It pulls connection status, lists all active instances, tracks who talked to whom last, and even lets you send messages right from the conversation thread. When you connect Dripcel via Vinkius, your AI client gets access to this full spectrum of WhatsApp intelligence, letting you audit message logs or check if you've hit an API limit—all through plain language commands.

## Tools

### get_dripcel_account_metadata
Retrieves overall metadata, including the current operational limits for your Dripcel account.

### get_whatsapp_connection_status
Confirms whether a specified WhatsApp connection is currently authenticated and online.

### get_instance_details
Fetches specific settings and detailed information about one designated WhatsApp instance.

### quick_instance_health_audit
Generates a high-level summary of the connection state and activity across all your WhatsApp instances.

### list_instance_contacts
Lists all contacts that have been registered or identified within an active WhatsApp instance.

### list_whatsapp_instances
Provides a list of every configured WhatsApp connection available in your Dripcel account.

### list_whatsapp_messages
Retrieves the most recent messages that were either sent or received by a specific instance.

### list_whatsapp_templates
Lists all available message templates configured for use with an instance.

### search_instance_contacts
Searches for specific contacts within an instance using either a keyword or phone number.

### send_whatsapp_message
Sends a simple text message to a target number via a chosen WhatsApp connection.

## Prompt Examples

**Prompt:** 
```
List all active WhatsApp instances.
```

**Response:** 
```
I've found 3 active instances, including 'Main Office' (Connected) and 'Sales Team' (Connected). Would you like to see the connection status for the third instance?
```

**Prompt:** 
```
Send message 'Your order is ready' to '+1 555-0123' via instance 'main_inst'.
```

**Response:** 
```
I've successfully sent the message 'Your order is ready' to +1 555-0123. The message ID is 'DRIP-MSG-7788'. Should I check the delivery status for you in a moment?
```

**Prompt:** 
```
Check the connection health for instance 'sales_inst'.
```

**Response:** 
```
Instance 'sales_inst' is currently 'Connected' and authenticated. Battery level is at 85% and signal strength is strong. Should I list the most recent messages for this instance?
```

## Capabilities

### Check Instance Health
Determine the connection status and detailed settings for any configured WhatsApp account.

### Audit Account Limits
Retrieve metadata about your Dripcel usage, including current API limits and overall account health.

### View Message History
List recent messages sent or received by a specific WhatsApp instance for auditing purposes.

### Manage Contacts
List, search, and identify contacts associated with an instance using phone numbers or keywords.

### Automate Messaging
Send a text message to a specific phone number through any designated WhatsApp connection.

## Use Cases

### Post-Campaign Review
A marketing lead needs to know how many people received the final reminder message. They ask their agent, and it uses `list_whatsapp_messages` and checks the delivery statuses across all relevant instances.

### Pre-Outreach Validation
A sales rep is about to cold-contact a lead but needs context. The agent runs `search_instance_contacts` first, pulling up all past interactions so the rep can personalize the message before using `send_whatsapp_message`.

### System Downtime Check
The IT admin notices a sudden drop in messages. The agent runs `quick_instance_health_audit`, immediately pointing to the single instance that has disconnected, allowing for rapid fix and minimizing service downtime.

### Operational Planning
A team needs to scale up messaging but isn't sure of their capacity. They run `get_dripcel_account_metadata` first to confirm they have room in the quota before building out new automation workflows.

## Benefits

- Checks instance health instantly. Instead of logging into multiple dashboards, you can use `get_whatsapp_connection_status` to confirm if a specific account is online and ready for work.
- Tracks contact history efficiently. Use `list_instance_contacts` or `search_instance_contacts` to pull up every recorded interaction with a customer before sending an outreach message.
- Manages compliance and volume. You can use `get_dripcel_account_metadata` to keep tabs on your API limits, making sure you don't accidentally run over quota during peak campaigns.
- Audits messaging activity easily. The tool lets you see the full picture with `list_whatsapp_messages`, giving you a clear record of what was sent and when it was delivered.
- Keeps everything centralized. By calling `quick_instance_health_audit`, your agent gives you an immediate, high-level view of all connections without having to check each one individually.

## How It Works

The bottom line is your AI client translates complex API calls into simple conversation commands for managing WhatsApp traffic.

1. Connect the Dripcel MCP to your AI client and authorize it using your API credentials.
2. Tell your agent exactly what you need, for example: 'List all active WhatsApp instances' or 'Search contacts in instance X'.
3. Your agent executes the required tool call and presents you with structured data—like connection status, contact lists, or message logs.

## Frequently Asked Questions

**How do I check if my WhatsApp instances are connected using get_whatsapp_connection_status?**
You simply ask your agent to run `get_whatsapp_connection_status` on the instance name. It immediately tells you if that specific connection is authenticated, giving you a simple yes or no answer.

**Can I use list_instance_contacts to find a contact's history?**
No, `list_instance_contacts` only gives you the registered contacts. For interaction history, you need to run `list_whatsapp_messages` on that specific instance.

**What is the difference between list_instance_contacts and search_instance_contacts?**
Listing (`list_instance_contacts`) shows every contact available. Searching (`search_instance_contacts`) lets you narrow down that list using a keyword or phone number, making it much faster.

**Does Dripcel MCP let me send messages automatically?**
Yes. You can trigger sends by running `send_whatsapp_message`, letting your agent handle the formatting and delivery through a specified instance.

**How do I check my usage limits or quota using get_dripcel_account_metadata?**
It retrieves your current account quotas and API restrictions. You'll see detailed metadata, including message send limits and remaining call counts for the month.

**What specific configuration details does get_instance_details provide about a WhatsApp instance?**
It fetches the unique identifiers and core setup parameters for that single instance. This confirms if all necessary connection settings are correctly applied to your workflow.

**How can I use list_whatsapp_templates to view available message formats?**
It lists every approved template configured for a specific instance. This lets you confirm which predefined messaging types you're allowed to send, ensuring both compliance and consistency.

**What data points are included when I run list_whatsapp_messages?**
The tool provides a comprehensive log including timestamps, sender IDs, and the actual message content. This gives you granular data points for auditing specific conversations.

**How do I get a Dripcel API Key?**
Log in to your Dripcel dashboard, navigate to your account or profile settings, and you can generate or retrieve your unique API Key from there. API access is available on professional plans.

**Can the agent send custom text messages?**
Yes, you can use the send_whatsapp_message tool to send plain text messages to any recipient number through your connected Dripcel instance.

**Does the integration show real-time instance health?**
Yes, you can use the get_whatsapp_connection_status or quick_instance_health_audit tools to see if your instances are currently connected and authenticated with WhatsApp.