# Freshmarketer MCP for AI Agents AI Agent Connect

> Freshmarketer. Connect your Freshmarketer account to your AI agent to automate marketing operations, manage mailing lists, and trigger email journeys. It lets your agent handle contact database updates and transactional emails directly through your chat interface.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_JxhFxpC4C9lEQhaX0zV4yYvFufIJ4KdaWIj3RRPC/ai-agent-connect
- **Tags:** email-marketing, marketing-campaigns, lead-nurturing, customer-segmentation, event-tracking

## Description

Managing a marketing database usually involves jumping between tabs, filtering lists, and manually triggering emails for individual customers. With this Connector, you can just tell your AI agent what needs to happen. You can have it pull up a specific mailing list, update contact details, or create a new segment for a campaign while you're still in your main workspace. If a customer hits a certain milestone, your agent can post a custom event to their timeline to kick off the right automation journey. It handles the heavy lifting of syncing data and keeping your audience organized. Because Vinkius makes it easy to manage these connections, you can jump from high-level strategy to specific execution in one conversation. You get a way to keep your marketing operations moving without the constant context switching. Instead of digging through a dashboard to find why a journey didn't fire, you can ask your agent to check the status of your active journeys or see the last few events posted to a contact. It turns a multi-step manual process into a single line of text. You get more time to think about your strategy while the agent handles the repetitive data management. You can quickly check if your API is healthy, list your contacts, or send a follow-up email without ever leaving your current application. It's about getting things done without the friction of a traditional dashboard.

## Tools

### check_account_status
Verify that your API connection is active and healthy. Use this to ensure your agent has the correct permissions.

### create_mailing_list
Create a new mailing list for a specific campaign or audience segment. This helps you organize your target groups quickly.

### list_mailing_lists
Get a full list of every mailing list you currently have. This helps you manage multiple segments at once.

### get_contact_details
Pull specific metadata for a contact to see their current status. This is useful for checking lead progression.

### list_contacts
View a list of all marketing contacts in your database. Use this to get a bird's eye view of your audience.

### list_custom_events
See all the configured events available for your automation. This helps you understand what triggers are available.

### list_journeys
View all active and paused marketing journeys in your account. This keeps your automation status front and center.

### post_custom_event
Trigger a specific event on a contact's timeline to start a flow. This is the primary way to move users through journeys.

### send_transactional_email
Send a specific transactional email to a contact immediately. Use this for high-priority, 1-to-1 communications.

### upsert_contact
Create a new contact or update an existing one in a single step. This keeps your database clean and accurate.

## Prompt Examples

**Prompt:** 
```
Who is on the 'Beta Testers' mailing list?
```

**Response:** 
```
Checking your mailing lists... I found 12 people on the 'Beta Testers' list:

| Name | Email | Status |
| :--- | :--- | :--- |
| **John Doe** | john@example.com | Active |
| **Jane Smith** | jane@example.com | Pending |
| **Bob Jones** | bob@example.com | Active |

Would you like me to pull the full profiles for any of these contacts?
```

**Prompt:** 
```
Is the 'Welcome Journey' currently active?
```

**Response:** 
```
I've checked your marketing journeys. Here is the current status:

*   **Welcome Journey**: ✅ Active
*   **Abandoned Cart**: ⏸️ Paused
*   **Re-engagement Flow**: ✅ Active

Everything looks good for the welcome flow.
```

**Prompt:** 
```
Trigger the 'Order Confirmed' email for user_123@example.com.
```

**Response:** 
```
Sent! The transactional 'Order Confirmed' email has been dispatched to **user_123@example.com**. I've also logged this event to their timeline.
```

## Capabilities

### Create mailing lists
Generate new audience segments for specific marketing campaigns.

### Retrieve contact metadata
Pull detailed profiles for individual marketing contacts.

### Update contact records
Create new entries or update existing contact info instantly.

### View marketing journeys
Monitor the status of all active and paused automation flows.

### Trigger transactional emails
Send specific emails to individual contacts from the chat.

### Post custom events
Log events on contact timelines to trigger automated actions.

## Use Cases

### Onboarding a new user
A user signs up. Ask the agent to create_mailing_list for the new batch and then post_custom_event to start their onboarding flow.

### Handling a refund request
A customer asks for a refund. Use send_transactional_email to send a confirmation immediately without searching for their profile.

### Checking segment health
Need to see if the VIP list is full. Use list_mailing_lists and ask the agent to summarize the current count for you.

### Updating lead info
A lead changes their phone number. Tell your agent to update the record so the rest of the marketing automation remains accurate.

## Benefits

- Stop manual data entry by using upsert_contact to keep your database clean instantly.
- Get instant answers on audience size by using list_mailing_lists without leaving your chat.
- Trigger immediate follow-ups with send_transactional_email for high-priority leads.
- Monitor your automation health by viewing all active journeys with list_journeys.
- Automate complex flows by using post_custom_event to move users through different stages.
- Verify contact data on the fly with get_contact_details to ensure your emails hit the right inbox.

## How It Works

The bottom line is you get a conversational interface for your entire marketing automation suite.

1. Subscribe to the Freshmarketer MCP on the Vinkius Marketplace.
2. Enter your Freshmarketer Domain prefix and API Key from your Admin Settings.
3. Ask your agent to manage your lists, contacts, or email journeys.

## Frequently Asked Questions

**Can I use the Freshmarketer MCP to manage my mailing lists?**
Yes. You can ask your agent to create new lists, view your existing mailing lists, and check audience details without leaving your chat.

**How does the Freshmarketer MCP handle email automation?**
It connects your agent to your marketing journeys. You can check journey statuses or trigger specific transactional emails to individual contacts.

**Can my AI agent update contact information using Freshmarketer MCP?**
Yes. Your agent can create new contact records or update existing metadata, which helps keep your marketing database accurate in real time.

**Does the Freshmarketer MCP support transactional emails?**
Yes. You can trigger specific transactional emails immediately for individual contacts through a simple natural language command.

**How do I use Freshmarketer MCP to trigger custom events?**
You can ask your agent to post a custom event to a specific contact's timeline. This is the best way to trigger automated flows based on user actions.

**Can I view my marketing journeys with Freshmarketer MCP?**
Yes. Your agent can pull a list of all your active and paused marketing journeys so you can monitor your automation status at a glance.

**How do I get an API Key for Freshmarketer?**
Log in to your Freshmarketer account, go to Settings (gear icon), and select API Settings to generate or view your API Key.

**What is my 'Domain prefix'?**
Your domain prefix is the first part of your Freshmarketer URL (e.g. if your URL is 'acme.freshmarketer.com', the prefix is 'acme').

**Can I send a one-off transactional email through the agent?**
Yes, use the 'send_transactional_email' tool and provide the recipient's email and the Campaign ID configured in your account.

**How do I trigger an automation journey via chat?**
Use the 'post_custom_event' tool to log an event for a specific contact. If a journey is configured to start on that event, it will trigger automatically.