# Audienceful MCP for AI Agents MCP

> Audienceful connects your email marketing data directly into your workflow. Use your AI agent to manage every aspect of your subscriber base, build complex custom segmentation fields, and trigger automated campaigns without leaving your chat interface.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** newsletter-automation, subscriber-management, audience-segmentation, email-campaigns, custom-fields

## Description

This MCP lets you talk to your audience list like you're talking to a colleague. You stop clicking through dashboards just to segment data or update user profiles. Instead, your AI client handles the heavy lifting by connecting directly to Audienceful.

You can manage your entire subscriber lifecycle—from creating new people records and updating their details to defining surgical custom fields for better targeting. Need to run a campaign? Just ask your agent to manually trigger an automation sequence for specific users or analyze recent send reports, all through natural conversation. When you connect this MCP via Vinkius, you get immediate access to these controls from any compatible client.

This isn't just data retrieval; it’s active marketing management. You can query and analyze performance metrics without ever having to download an export file. It's about getting the job done faster and keeping your focus on content, not clicks.

## Tools

### create_custom_field
Adds a new, specific data point to track on your audience members' profiles.

### create_person
Adds a brand-new contact profile to your audience list, requiring at least an email address.

### delete_custom_field
Removes a custom data field from the available options for your audience.

### delete_person
Permanently and irreversibly removes an individual contact from your audience list. Use with extreme caution.

### get_person
Retrieves all available details for a single person when you know their unique identifier (UID).

### list_custom_fields
Shows every custom data field currently defined in your audience structure.

### list_people
Retrieves a list of all people, allowing you to filter by status or search for specific emails.

### list_send_reports
Lists the most recent performance reports from your email sends.

### trigger_automation
Manually starts a predefined marketing automation sequence for an individual person.

### update_person
Modifies and updates the profile information of an existing contact member.

## Prompt Examples

**Prompt:** 
```
Who are all my subscribers who signed up last week but haven't been assigned a 'Product Interest' field yet?
```

**Response:** 
```
**Audience Scan Complete.**

I found 7 contacts that meet your criteria. They were added since June 10th and lack the required product interest tag.

| Name | Email | Status |
| :--- | :--- | :--- |
| Chris B. | chris@example.com | Active |
| Maya T. | maya@corp.net | Active |
| David R. | david@test.org | Pending |

Would you like me to run a bulk update on these 7 users and assign them the 'Needs Follow Up' tag?
```

**Prompt:** 
```
I need to give all my premium subscribers a special status. Can we create a new custom field for that?
```

**Response:** 
```
*Field Request Processed*

I've successfully created the new custom field: **Premium Status** (type: boolean). This field is now visible on all profile views and can be used immediately in segmentation rules.

Please let me know if you need to add any validation requirements for this new data point.
```

**Prompt:** 
```
Hey, check the performance report for last Tuesday's newsletter send. What were the top three metrics?
```

**Response:** 
```
*📊 Send Report Summary (June 18th)*

The campaign performed well overall! Here are the key takeaways:

*   **Open Rate:** 24% (Up 3 points from last week)
*   **Click-Through Rate:** 6.5% (Highest rate on 'Product X' link)
*   **Unsubscribe Count:** 0.8%

The biggest lift came from the segment matching 'TechCorp'. We should focus more content there.
```

## Capabilities

### Manage Subscriber Profiles
Add new people or retrieve specific person details using their Unique IDs (UID) to keep your contact records accurate.

### Segment and Customize Data Fields
List all existing custom fields, create new ones for better data capture, or delete old fields when they're no longer necessary.

### Automate Campaigns and Workflows
Manually trigger email sequences for individuals, allowing you to guide users through specific onboarding or welcome flows immediately.

### Analyze Campaign Performance
List recent send reports to track the performance of your newsletters and campaigns at a glance.

## Use Cases

### Need to segment users by company size
A marketing manager needs to target only 'Enterprise' clients. Instead of running a complex query and exporting a list, they ask their agent to search for subscribers whose custom field 'Company' matches 'Enterprise', getting an instant list of targets.

### Onboard new leads instantly
A content creator adds 20 new sign-ups from a podcast. Rather than manually updating each profile, they ask their agent to use the `create_person` tool for all 20 and immediately trigger the 'onboarding-welcome' sequence for them.

### Check campaign results without leaving Slack
A team needs a quick performance check on last week's newsletter. They ask their agent to `list_send_reports`, getting summarized metrics and identifying which segment performed best, all in one chat window.

### Clean up outdated user data
A growth engineer identifies a list of inactive users who haven't logged in months. They use the agent to `list_people` by status and then process the bulk deletion using the `delete_person` tool, keeping the audience clean.

## Benefits

- Stop manual exports. You can query and analyze audience growth metrics or campaign performance reports directly via your agent.
- Precision targeting is easier with custom data fields. Use the `list_custom_fields` and `create_custom_field` tools to segment users based on niche criteria.
- Keep user records current instantly. Update an existing person profile using the `update_person` tool, ensuring your communications always hit the right target.
- Automate workflows without leaving your chat. You can use `trigger_automation` to immediately put a new subscriber through their welcome sequence.
- Build and maintain clean data structures by listing all fields with `list_custom_fields` before adding new ones.

## How It Works

The bottom line is, once connected, you use conversational commands instead of clicking through multiple marketing dashboards.

1. Subscribe to this MCP on Vinkius and provide your Audienceful API Key.
2. Connect your preferred AI client (Cursor, Claude, etc.) through the Vinkius platform.
3. Use natural language prompts to tell your agent exactly what you need: 'Find all users with a lead score over 50' or 'Start the onboarding sequence for bob@company.com'.

## Frequently Asked Questions

**How can Audienceful help me update a user's profile data without logging into the platform?**
You can use your AI agent to directly modify a person’s details. You just tell it, 'Update Jane Doe's job title and give her a new lead score.' The system handles the API calls, so you don't have to navigate menus.

**What if I need to segment my audience based on data that isn't available yet?**
You can define the structure first. Use the tool to list all custom fields and then ask your agent to create a new one, like 'Industry Vertical.' Once it exists, you can use it for segmentation immediately.

**Is Audienceful MCP better than just exporting data and using Excel?**
Yes. Exporting is static; the MCP gives you live control. You don't need to download files or write formulas. You simply ask your agent, 'Find me everyone who...,' and get an actionable result instantly.

**Can Audienceful help me track which users I've already contacted?**
Absolutely. You can list all people in your audience or retrieve a specific person by UID to see their full profile history, helping you ensure no one is overlooked during campaigns.

**How do I manage my entire subscriber database using Audienceful MCP?**
You connect the MCP and then use conversational prompts for everything. You can create new people, update old records, segment users with custom fields, and even manually trigger automations.