# Iterable MCP

> Iterable MCP connects your AI agent directly to Iterable's marketing data. Use this to manage cross-channel campaigns, pull detailed user profiles, check contact list segmentation, and analyze performance metrics for any outreach effort.

## Overview
- **Category:** growth-engine
- **Price:** Free
- **Tags:** marketing-automation, customer-lifecycle, email-marketing, campaign-management, user-segmentation

## Description

You can use this MCP to have your AI client handle complex tasks across all your customer communication channels. Instead of logging into multiple dashboards, you ask your agent for specific insights—like the current status of a campaign or the activity history of a single user. It pulls data on everything from message templates and available contact lists to full performance metrics.

This capability is huge for growth teams needing an immediate understanding of audience health. Whether you need to know which channels are active, list all running workflows, or simply retrieve details for a specific subscriber, this MCP makes that data instantly accessible. Connecting Iterable through Vinkius gives your agent access to thousands of specialized tools, making it the single place you need to run complex marketing logic against real-world customer data.

## Tools

### get_campaign
Retrieves the setup details for a specific marketing campaign, including its audience targeting and schedule.

### get_campaign_metrics
Pulls performance metrics for a given campaign to report on ROI and track engagement data.

### get_user
Retrieves detailed profile information and activity history for an individual subscriber by their email address.

### list_campaigns
Lists all active marketing campaigns, allowing you to identify specific campaign IDs or check status.

### list_channels
Provides a list of supported communication channels (like Marketing or Transactional) used in outreach.

### list_lists
Lists all defined contact lists, which helps you identify specific user segments for targeted messages.

### list_message_types
Lists all message types used in your account (e.g., 'Welcome Email' or 'Newsletter') for auditing categorization.

### list_templates
Retrieves a list of available message templates, useful for reviewing content assets before running a campaign.

### list_webhooks
Lists all configured webhooks, letting you audit system integrations and data exports.

### list_workflows
Lists all automated marketing workflows, helping you monitor trigger-based logic or scheduled campaigns.

## Prompt Examples

**Prompt:** 
```
List all active marketing campaigns in my Iterable account.
```

**Response:** 
```
I'll fetch the list of your active campaigns from Iterable.
```

**Prompt:** 
```
Show me the details for user 'customer@example.com'.
```

**Response:** 
```
I'll retrieve the profile and activity history for that user from Iterable.
```

**Prompt:** 
```
Check the metrics for campaign ID '123'.
```

**Response:** 
```
I'll look up the performance metrics and engagement data for that specific campaign.
```

## Capabilities

### Get Campaign Details
Retrieves setup information for a specific campaign, including its audience targeting and scheduling rules.

### Analyze Performance Metrics
Pulls key data points on a campaign's performance to measure marketing return and engagement levels.

### Fetch User Profiles
Retrieves comprehensive details and activity history for any individual subscriber using their email address.

### List Audience Segments
Lists all defined contact lists, helping you identify groups ready for targeted outreach.

### Audit Communication Paths
Provides a list of available communication channels and message templates to understand your full scope of reach.

## Use Cases

### Auditing an Outreach Failure
A marketer needs to know if a campaign targeting 'VIP Customers' actually ran. They ask the agent to check the metrics and status. The agent uses `list_campaigns` first, confirms the ID, then runs `get_campaign_metrics`, and reports back that the campaign failed because the target list was empty.

### Onboarding a New User Segment
A growth analyst discovers a new segment of users who signed up via a specific source. They ask to verify this group's details. The agent uses `list_lists` to confirm the list name, and then runs `get_user` against several emails to check data consistency.

### Reviewing Content Dependencies
A copywriter needs to know what content assets are available for a new product launch. They ask the agent to review all templates. The agent uses `list_templates` and `list_message_types`, providing an immediate, categorized inventory of usable message formats.

### Debugging Automation Logic
An ops engineer notices a workflow isn't triggering correctly. They ask the agent to check all automated systems. The agent uses `list_workflows` and cross-references it with `get_campaign` details to pinpoint which automation step is failing.

## Benefits

- You don't have to manually check multiple dashboards for campaign status. Use `list_campaigns` or `get_campaign` to instantly confirm if an outreach effort is running correctly, letting your agent do the checking.
- Need to know *why* a campaign underperformed? Instead of digging through raw data sheets, run `get_campaign_metrics`. Your agent pulls the performance report and tells you exactly where engagement dropped off.
- Segmenting users used to mean exporting lists and cleaning them up. Now, your agent uses `list_lists` and then targets specific groups for outreach without manual list management.
- Checking an individual subscriber's status is faster than ever. Use `get_user` to pull a full profile history immediately, giving you deep intelligence on that single contact's activity.
- You can audit your content assets easily. By calling `list_templates`, your agent shows you every available message template and its category, saving time when drafting new campaigns.

## How It Works

The bottom line is you never have to jump between Iterable’s dashboards again; your agent handles all the data retrieval and reporting for you.

1. Tell your AI client the marketing data you need, for instance, 'Show me the performance metrics for Q3's welcome series.'
2. The agent uses this MCP to call specific tools, such as `list_campaigns` first to find the campaign ID, and then `get_campaign_metrics` using that ID.
3. You get a clear, formatted summary of the results—the raw metrics, user profiles, or list names—all delivered directly in your conversation.

## Frequently Asked Questions

**How do I check if a campaign is currently running using Iterable MCP?**
You can use `list_campaigns` to see all existing campaigns and their statuses. If you need deep details on a specific one, run `get_campaign`, which provides the scheduling settings and targeting rules.

**What is the best way to check user activity history with Iterable MCP?**
The most direct method is using `get_user` by providing the customer's email. This tool retrieves the full profile and activity history, giving you a complete picture of their engagement.

**Can I find out what message templates are available in my account?**
Yes, run `list_templates`. This tool lists every content asset defined in your account. It's useful for auditing which messages you can use across different campaigns.

**How do I find out if a segment of users is ready for outreach?**
Use `list_lists` to see all the available contact lists. This confirms your segmentation groups are defined, allowing you to target them accurately in a campaign.

**Does Iterable MCP help with calculating marketing ROI?**
Yes, running `get_campaign_metrics` pulls performance data essential for reporting on marketing return. This gives you the numbers needed to assess success or failure.