# Drip MCP

> Drip MCP Server manages your entire subscriber lifecycle. Use your AI agent to list contacts, update custom fields, apply tags, and record custom events in Drip. You can also list and fetch metrics from all your campaigns and workflows. It lets you automate complex marketing tasks without touching the Drip UI.

## Overview
- **Category:** growth-engine
- **Price:** Free
- **Tags:** drip, email, marketing automation, ai-agents, mcp

## Description

You can run your AI agent right against Drip, giving you total control over your subscriber base and campaigns. Forget clicking through menus and copy-pasting data. You just tell your agent what you need, and it executes complex marketing tasks—from slapping a single tag on a user to kicking off an event that triggers a whole workflow. 

**Manage Subscriber Profiles:**

Your agent lets you fetch all the data for any subscriber using their ID or email. You can also create a new contact or update an existing one, supplying custom fields or tags in the process. If you need to clean house, you can delete a subscriber entirely. You'll also find tools to list every available tag and custom field in your account. For immediate removal from all email communications, you can use `unsubscribe_subscriber`. 

**Audit and List Account Assets:**

Need to see what assets you're working with? Your agent can list every available tag using `list_tags`, pull every custom field identifier with `list_custom_fields`, and list every active and inactive workflow using `list_workflows`. It'll also list every single Single-Email Campaign (broadcast) with `list_broadcasts` and give you a complete list of all multi-step Email Series Campaigns (workflows) via `list_campaigns`. 

**Full Subscriber Census:**

Want to see who's in your book? Your agent pulls a complete list of every known contact using `list_subscribers`. Beyond that, you can use `fetch_subscriber` to grab all the details for one user. 

**Tracking Custom User Activity:**

When a subscriber does something specific, you can log a custom event for them using `record_event`, and you can pass extra properties along with the event data. This action immediately kicks off any Drip workflows you've set up. 

**Control Campaign Flow:**

Your agent lets you check the metrics for all your single-email campaigns (broadcasts) and list all your multi-step email series (workflows). You can also list all the workflows using `list_workflows` and get a rundown of all the campaigns using `list_campaigns`. You've got the power to automate complex marketing tasks without ever touching the Drip user interface.

## Tools

### apply_tag
Adds a specified tag to a single subscriber's profile.

### create_or_update_subscriber
Adds a new contact or updates an existing one using email, custom fields, or tags.

### delete_subscriber
Permanently removes a subscriber from the Drip account.

### fetch_subscriber
Retrieves all data for one subscriber using their ID or email address.

### list_broadcasts
Lists all Single-Email Campaigns (broadcasts) configured in Drip.

### list_campaigns
Lists all multi-step Email Series Campaigns (workflows) in Drip.

### list_custom_fields
Retrieves a list of all custom field identifiers available in your Drip account.

### list_subscribers
Fetches a complete list of every known contact in your Drip account.

### list_tags
Lists every available tag used within the Drip account.

### list_workflows
Retrieves a list of all active and inactive workflows in Drip.

### record_event
Logs a custom event for a subscriber, allowing you to pass extra properties with the event data.

### unsubscribe_subscriber
Removes a subscriber from all email communications immediately.

## Prompt Examples

**Prompt:** 
```
Create a new Drip subscriber with the email 'leads@example.com' and tag them as 'VIP'.
```

**Response:** 
```
The subscriber 'leads@example.com' has been successfully created and tagged as 'VIP'.
```

**Prompt:** 
```
List all active workflows in my Drip account.
```

**Response:** 
```
Here are the workflows currently available in your account: ...
```

**Prompt:** 
```
Record a custom event called 'Signed Up' for user 'john@doe.com' in Drip.
```

**Response:** 
```
The custom event 'Signed Up' has been recorded for 'john@doe.com' in Drip.
```

## Capabilities

### Manage Subscriber Profiles
Fetch, create, or modify individual subscriber records, including assigning tags and custom attributes.

### Track Custom User Activity
Record specific, custom events for any subscriber, immediately triggering defined Drip workflows.

### Audit and List Account Assets
Pull lists of all available tags, custom fields, workflows, and broadcast campaigns for reference.

### Full Subscriber Census
Retrieve a complete list of every known contact in the Drip account, or fetch a single subscriber by ID or email.

### Control Campaign Flow
List and retrieve metrics for both single-email campaigns (broadcasts) and multi-step email series (workflows).

## Use Cases

### A user views a pricing page and needs to be flagged.
The goal is to immediately flag a user as 'High Intent'. Instead of going into the Drip UI to manually apply the tag, the agent runs: 1) `fetch_subscriber` to get the user's ID, 2) `apply_tag` to add 'High Intent', and 3) `record_event` to log 'Pricing Page View'. This ensures the user starts the correct, high-value workflow immediately.

### You need to generate a report on all active campaigns.
Instead of clicking through the Campaigns tab and manually opening every workflow, you ask the agent to run `list_campaigns`. It returns all workflows, allowing you to immediately see which series are active or need updating. You can then follow up by asking the agent to list all associated metrics.

### A developer needs to clean up old, inactive contacts.
A developer runs the agent to first `list_subscribers` to get a list of all contacts. They filter this list for inactive accounts, then use `delete_subscriber` on the identified IDs. This keeps the Drip database clean and prevents sending emails to bad addresses.

### The sales team needs to know which users are missing key data points.
The team asks the agent to `list_custom_fields` to see what data is tracked. They then use `list_subscribers` and `fetch_subscriber` to check specific user records, making sure every key field, like 'Industry' or 'Company Size', has been populated before the next campaign run.

## Benefits

- Stop manual tag updates. Use `apply_tag` or `create_or_update_subscriber` to manage hundreds of user tags and attributes with a single agent prompt.
- Track real-time behavior. When a user completes a specific action, use `record_event` to log it immediately, triggering complex workflows without manual intervention.
- Audit everything fast. Need to know what tags or fields exist? Use `list_tags` or `list_custom_fields` to pull all structural metadata instantly.
- Manage campaigns programmatically. Use `list_broadcasts` and `list_campaigns` to get a quick inventory of every single email series and broadcast running.
- Get full user visibility. Use `list_subscribers` to pull a full census of your contact list, or `fetch_subscriber` for deep-dive data on one person.
- Execute complex flows easily. You can combine tools—like fetching a list of users (`list_subscribers`), then updating them (`create_or_update_subscriber`), and finally logging an event (`record_event`)—all in one chat session.

## How It Works

The bottom line is, your AI agent handles the Drip API calls for you, turning complex marketing operations into simple chat commands.

1. Sign up for Drip and find your API Token and Account ID.
2. Enter those credentials into the MCP Server to authenticate the connection.
3. Chat with your AI agent. Tell it the task—for example, 'Update the tag for john@doe.com to 'High Priority' and record an event called 'Demo Started'.'

## Frequently Asked Questions

**How do I use the `record_event` tool with custom properties?**
You pass the properties as key-value pairs in your prompt. For example, 'Record event 'Demo Started' for john@doe.com with property 'Product' set to 'Enterprise'.'. The agent logs the event and passes the extra data to Drip.

**Can I list all the custom tags I can use in Drip?**
Yes, use the `list_tags` tool. It pulls every available tag from the account, which is necessary before you try to use `apply_tag` on a user.

**Is `delete_subscriber` permanent?**
Yes, `delete_subscriber` is irreversible. You should always fetch the subscriber's data first using `fetch_subscriber` to ensure you don't lose history before deleting them.

**What is the difference between `list_campaigns` and `list_workflows`?**
Use `list_campaigns` to see single, standalone email blasts (broadcasts). Use `list_workflows` to see the multi-step, automated email series that run over time.

**How do I use `create_or_update_subscriber` when I only have a custom field identifier?**
You must pass both the email address and the custom field identifier. The agent handles the merge logic, ensuring the record updates correctly. This prevents partial data writes.

**If I run `fetch_subscriber` with an invalid ID or email, what happens?**
The agent returns a specific error message detailing the invalid input. You can then use `list_subscribers` to check for correct IDs before retrying the fetch.

**What is the best way to list all available custom fields using `list_custom_fields`?**
Running `list_custom_fields` provides all identifiers. You should reference these identifiers when using `create_or_update_subscriber` to ensure your data maps correctly.

**Does `delete_subscriber` require me to know the subscriber's unique ID?**
No, you can typically pass the subscriber's email address. The agent uses the email to locate and permanently remove the account.

**Can the AI Agent send email broadcasts automatically?**
No, the agent can only read existing broadcasts and campaigns, and add subscribers or trigger events that might lead to emails being sent by Drip's rules.

**Does it support Drip custom fields and tags?**
Yes! You can list available custom fields and apply multiple tags or custom properties to any subscriber.

**Can I remove a subscriber from Drip entirely using the agent?**
Yes, you can instruct the agent to delete a subscriber completely, or simply unsubscribe them from all mailings.