# emfluence Marketing MCP MCP

> emfluence Marketing MCP connects your AI agent directly to emfluence's automation tools. You can manage entire email campaigns, track contact group memberships, pull individual subscriber history, and check real-time performance metrics—all from a simple chat conversation.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** multi-channel-marketing, email-campaigns, subscriber-management, marketing-analytics, automation-workflows, lead-nurturing

## Description

Forget logging into the marketing platform just to find out why that last campaign flopped. This MCP puts your whole emfluence workspace right where you work. You can now talk to your AI agent about audience health and email results, and it handles the API calls for you. Need to know how many people are in the 'VIP' group? Just ask. Want to see if a specific newsletter had good open rates? It pulls the data instantly. Whether you’re checking basic subscriber counts or needing deep performance stats, your agent figures it out. It makes running marketing operations feel like just another conversation. You connect this MCP through Vinkius and suddenly you have access to emfluence's entire suite of tools, letting you manage contacts and campaigns without ever leaving your AI client.

## Tools

### get_emfluence_account_metadata
Retrieves general data and settings for your entire emfluence account setup.

### get_email_performance_stats
Provides performance numbers—like opens, clicks, and bounces—for a chosen marketing email.

### get_contact_profile
Retrieves a person's full profile, including their activity history.

### get_email_details
Pulls the specific settings and content for any marketing email you want to review.

### get_group_details
Shows specific details, including counts, for a particular contact group or segment.

### quick_marketing_volume_audit
Pulls a high-level summary showing general email and group activity across the board.

### list_contact_target_groups
Lists every single target group (or 'list') configured in your emfluence account.

### list_marketing_contacts
Shows a complete list of every contact registered within your organization's database.

### list_marketing_emails
Provides an overview and list of all marketing emails saved in your emfluence account.

### search_contacts_by_email
Searches your contact records using just an individual's email address.

## Prompt Examples

**Prompt:** 
```
List all my contact target groups.
```

**Response:** 
```
I've found 4 groups, including 'VIP Customers' (1,250 members) and 'Lead Gen List' (3,400 members). Would you like to see the detailed settings for VIP Customers?
```

**Prompt:** 
```
Show me the performance stats for email ID 12345.
```

**Response:** 
```
Email ID 12345 ('March Newsletter') has been sent to 3,400 recipients. Performance: 850 opens (25%), 240 clicks (7.1%), and 15 bounces. Status is 'Sent'. Should I check the click breakdown?
```

**Prompt:** 
```
Search for contact 'alex@example.com'.
```

**Response:** 
```
Alex is a member of the 'Lead Gen' group and is currently 'Active'. Their last recorded activity was a click on March 15th. Should I pull their full custom field history?
```

## Capabilities

### Check contact details
Pull the full profile and activity history for any specific person in your database.

### List email content
Retrieve detailed settings, subject lines, and actual content for all marketing emails you've built.

### Monitor campaign results
Get performance metrics like opens, clicks, and bounces for specific campaigns in real time.

### Audit account settings
Retrieve high-level metadata and general operational settings for your emfluence account.

### View audience groups
Get detailed counts, settings, and membership lists for any contact group or segment.

### Find all target groups
See a list of every single contact group (or 'list') configured in your account.

## Use Cases

### The campaign failed, but why?
A Campaign Manager needs to know if a poor open rate was due to low engagement or just an invalid list. They ask their agent to check the stats for the last email ID 12345 using `get_email_performance_stats`, immediately seeing that clicks were high but opens were low, pointing them toward a subject line issue.

### I need to segment this list urgently.
The Ops Analyst needs to know the size of all potential groups before a new product launch. They use `list_contact_target_groups` first, then drill down with `get_group_details` for the top three lists, ensuring they don't miss any segments.

### Did this contact actually exist?
A Sales team member gets an email address and needs to know if the person is active. They use `search_contacts_by_email` with the provided address, instantly confirming the contact's status and group membership.

### I need a quick health check.
The Marketing Director wants a high-level view of organizational health without running multiple reports. They simply ask for an audit using `quick_marketing_volume_audit`, getting a fast summary of group volumes and email activity.

## Benefits

- Check open rates and group sizes quickly. You can use `get_group_details` or `list_contact_target_groups` to confirm the exact size of any segment before sending a blast, which prevents wasted effort.
- Monitor campaign results with precision using `get_email_performance_stats`. Instead of guessing, your agent tells you exactly how many opens and clicks a specific email got.
- Audit everything easily. The `quick_marketing_volume_audit` tool gives you an immediate summary of group activity without having to dig through multiple dashboards.
- Know who's in the database. You can run `list_marketing_emails` or use `get_email_details` to review content and settings for any campaign, no matter how old it is.
- Deep dive on people. Need background info? Use `get_contact_profile` to see a person's full history and activity record, helping you personalize the next outreach.

## How It Works

The bottom line is: you talk to your AI client like you're talking to an ops person, and it gets the numbers back for you without any manual steps.

1. Connect the emfluence integration to your AI client using an API key.
2. Ask your agent a question, like 'Show me the open rates for the last newsletter.'
3. The MCP runs the necessary tool calls and sends you a plain English summary with all the data points.

## Frequently Asked Questions

**How do I check a specific contact's history using get_contact_profile?**
You just tell your agent which person to check. It runs `get_contact_profile` and hands you the full record, including their last activity and custom field values.

**Do I need to use list_marketing_emails to see campaign content?**
No, if you want the deep dive on a specific email's settings or subject line, just ask for `get_email_details`. That tool is more direct than listing them all.

**What is the easiest way to find a contact?**
Use `search_contacts_by_email` right away. It's the fastest way to pinpoint a person by their email address, saving you from having to browse huge lists.

**Can I get an overall overview using quick_marketing_volume_audit?**
Yes. `quick_marketing_volume_audit` gives you the high-level numbers on group activity and email volumes instantly, letting you gauge organizational health without needing deep metrics.

**If I run get_group_details for a non-existent group ID, what happens?**
The MCP will return an error message specifying that the Group ID wasn't found. You can use this error to confirm your target list is correct or to suggest checking all available groups first using `list_contact_target_groups`.

**How do I restrict the metrics when calling get_email_performance_stats?**
You pass a specific list of desired metrics, like 'open' and 'click', directly in the request payload. This prevents unnecessary data retrieval and speeds up your agent's ability to analyze only the numbers you care about.

**What kind of setup information can I get using get_emfluence_account_metadata?**
This tool retrieves core account parameters, including API version details and billing status. It lets your agent confirm the connection's operational scope before running any complex or high-volume campaigns.

**Does list_marketing_emails support filtering by date range?**
Yes, you can pass filters for 'date_range' or specific content statuses. This narrows the results immediately, letting your agent process only draft emails from last quarter, for example.

**How do I get an emfluence API Key?**
Log in to your emfluence account, navigate to **Settings > API**, and you can generate or retrieve your unique API Key from there. Ensure the key has the necessary permissions for your marketing resources.

**Can the agent send new marketing emails?**
This integration currently focuses on listing and auditing emails, groups, and contacts. Creating or sending new marketing campaigns should be managed via the emfluence platform dashboard.

**Does the integration show bounce rates?**
Yes, you can use the get_email_performance_stats tool to retrieve specific bounce metrics along with open and click rates for any email.