# Beehiiv MCP for AI Agents MCP

> Beehiiv MCP connects your AI agent directly to your entire newsletter growth engine. You can manage publications, audit subscriber lists, pull real-time performance metrics, and even register new users—all from a single chat window or IDE.

## Overview
- **Category:** growth-engine
- **Price:** Free
- **Tags:** newsletter-platform, audience-growth, subscriber-management, email-analytics, content-distribution

## Description

This MCP lets you operate the full lifecycle of your paid newsletter publishing platform without ever switching tabs. Instead of logging into Beehiiv to check open rates, run through segments, or manually add subscribers, you talk to your agent and it executes those actions against your live account data.

Your AI client reads everything: from historical post structures and pure HTML content payloads to deep audience analytics. Need to see which segments are active or how conditional email logic chains are set up? You can ask for that, too. It's about keeping your workflow contained. The entire catalog of available services is managed by Vinkius, so you connect once from any compatible client and get access to everything Beehiiv has to offer.

## Tools

### list_publications
Retrieves a list of all active publications linked to your Beehiiv account.

### get_publication
Fetches specific metadata for a single, identified Beehiiv publication.

### list_subscriptions
Provides an overview list of all currently active subscribers in your account.

### get_subscription
Retrieves detailed, specific information about one subscriber's account status.

### create_subscription
Registers a new individual subscriber into your audience list using an explicit command.

### list_posts
Lists all newsletter posts that have been natively published on the platform.

### get_post
Retrieves the complete, raw content payload (HTML) for a specified post.

### get_post_stats
Calculates and returns aggregated performance statistics for any given published post.

### list_segments
Shows a list of internal audience segments you have defined within Beehiiv.

### list_automations
Lists your native conditional email journey paths and automated workflows.

## Prompt Examples

**Prompt:** 
```
What were the open rates for last week’s newsletter?
```

**Response:** 
```
**Analytics Summary: Week of 2026-06-17**

*   **Overall Open Rate:** 48.5% (Up from 46.2%) 
*   **Average Click Rate:** 5.1% 
*   **Total Receivers Tracked:** 9,820

The performance shows a strong rebound this week. The highest engagement came from the 'AI Tools' segment. I recommend checking how that group was targeted.
```

**Prompt:** 
```
I need to add five new paying subscribers. Can you do that?
```

**Response:** 
```
**Subscription Status Update**
Success! Five explicit subscription requests were processed.

| Email Address | Status | Notes |
| :--- | :--- | :--- |
| user1@test.com | Active | Added successfully |
| user2@test.com | Active | New subscriber registered |
| user3@test.com | Active | Will receive next blast |
| user4@test.com | Active | Confirmed in the pool |
| user5@test.com | Active | Ready for automation sequence |

All five users are now live and tracked.
```

**Prompt:** 
```
List all my current content publications.
```

**Response:** 
```
**Beehiiv Publication Directory**
Here are the active publication IDs currently linked to your account:

1. **Tech Growth Daily:** `pub_a3c4d5e6-xxxx`. (Primary source for most content.)
2. **Developer Insights:** `pub_b7g8h9i0-xxxx`. (Secondary, specialized content stream.)
3. **Beta Testing Notes:** `pub_j1k2l3m4-xxxx`. (New, restricted access publication.)

You can use these IDs to target specific content streams.
```

## Capabilities

### Manage Publications and Posts
List all active publications or pull the full HTML content of historical posts using tools like list_publications, get_publication, and get_post.

### Audit Audience and Subscribers
Review your entire subscriber base by listing specific subscribers, getting detailed account information with get_subscription, or adding new users explicitly via create_subscription. You can also list internal audience segments using list_segments.

### Track Performance Metrics
Pull aggregated post performance stats to understand open and click rates using get_post_stats, giving you a real-time view of account health.

### Understand Audience Logic
Browse the system's conditional email logic chains by listing automations or viewing publication topology to see how your core content structure is mapped out using list_automations and get_publication.

### Retrieve Technical Data
Fetch precise metadata about a publication or retrieve the raw data payloads, including UTM acquisition parameters for subscribers.

## Use Cases

### Investigating a sudden drop in engagement
A marketing lead notices click rates dropped last week. They ask their agent to run get_post_stats on the last five issues, immediately seeing which specific post's performance dipped and why.

### Onboarding a new content team member
A content creator needs historical context for an article. They use list_posts to see all previous newsletter titles and get_post to pull the raw HTML payload of a key older edition.

### Building a custom lead capture form
The growth engineer wants to test a new sign-up flow. They use create_subscription directly through their agent's chat, verifying that the user is added correctly to the system pool.

### Auditing complex segmentation rules
A marketing lead needs to know if specific users are caught in an automation loop. They run list_segments and list_automations to map out every active rule and segment boundary.

## Benefits

- Audit your entire audience history instantly. Need to check subscriber details or UTM parameters? Use get_subscription and list_segments instead of navigating multiple dashboards.
- Keep writing code while managing emails. You can pull open rate metrics or read historical post structures using get_post_stats and get_post without leaving your IDE.
- Streamline audience growth efforts. Manually adding users is slow; use create_subscription to register new subscribers with a single command.
- Understand complex campaigns easily. Use list_automations to audit conditional email logic chains, ensuring your audience journeys are set up correctly before launch.
- Quickly check core site health. With list_publications and get_publication, you can verify the correct setup of your entire content structure in minutes.

## How It Works

The bottom line is you get a single, conversational endpoint for every part of your newsletter publishing stack.

1. Subscribe to this MCP and provide your specific Beehiiv Publication ID alongside your API Key.
2. Your AI client authenticates with Vinkius and uses the provided credentials to access all available Beehiiv tools.
3. You issue a natural language command (e.g., 'List my top three segments' or 'Check last month's open rates'), and the agent executes the necessary tool calls to deliver the data.

## Frequently Asked Questions

**How do I manage my newsletter subscribers using the Beehiiv MCP for AI Agents?**
You can list all existing subscribers and even register new ones directly through your agent. This means you don't need to jump between tabs; you just ask your client to perform the subscription action.

**Can I check the performance stats of my Beehiiv newsletter posts?**
Yes, this MCP lets you pull aggregated post performance statistics. You can get a quick summary of open and click rates for any historical or recent publication without leaving your current screen.

**What kind of audience segments can Beehiiv MCP help me audit?**
You can list all internal audience segments defined in your account. This helps you understand exactly how users are grouped and which behavioral conditions apply to different parts of your subscriber pool.

**Does the Beehiiv MCP for AI Agents let me see my content structure?**
Absolutely. You can list all active publications and retrieve their specific metadata, helping you understand how multiple content streams are linked to your core account ID.

**I need help with automation rules in Beehiiv.**
You can use the MCP to list all native conditional email journeys. This allows you to audit complex automation chains and see exactly what triggers specific follow-up emails for your audience.