# Beehiiv MCP MCP > Beehiiv MCP automates your entire newsletter publishing stack, letting your AI agent manage publications, track performance metrics, and build out your subscriber base directly from chat. Instead of logging into Beehiiv's dashboard, you can use this connector to fetch historical posts, check open rates for a specific campaign, or register new subscribers—all without leaving your IDE. ## Overview - **Category:** growth-engine - **Price:** Free - **Tags:** newsletter-platform, audience-growth, subscriber-management, email-analytics, content-distribution ## Description Managing an email newsletter shouldn't require jumping between ten different tabs and dashboards just to pull basic numbers. This MCP connects your AI agent directly into Beehiiv, letting it operate your entire growth engine. You can ask your agent to analyze the open rate of last month’s posts or check if certain segments are behaving as expected. It reads everything from audience lists to post content payloads. Because this connector lives within Vinkius, you don't have to worry about complex authentication flows; you just connect once and get access to all the tools needed for writing, analytics, and growing your audience. You tell your AI client exactly what data you need—whether it’s listing active segments or checking a subscriber's full history—and it handles the rest. ## Tools ### create_subscription Adds a new email address directly to your subscriber list. ### get_post Fetches the complete HTML content of one specific published newsletter post. ### get_post_stats Retrieves summarized performance statistics for a chosen post. ### get_publication Gets core metadata about a specific Beehiiv publication account. ### get_subscription Retrieves the exact current details of a single subscriber's record. ### list_automations Lists all native conditional email journeys and automations set up in your account. ### list_posts Pulls a list of identifiers for all newsletters that have been published. ### list_publications Lists every active Beehiiv publication you manage. ### list_segments Displays a list of specific internal audience segments defined in your account. ### list_subscriptions Lists all active subscribers, allowing you to check who is on the roster. ## Prompt Examples **Prompt:** ``` List my recent newsletter publications and ID formats. ``` **Response:** ``` I found 1 active publication linked: 'Tech Growth Daily' under ID 'pub_1234abcd-xxxx'. It's natively configured pointing to origin parameters tracking the domain effectively. ``` **Prompt:** ``` Check overall open and click stats for my account. ``` **Response:** ``` Here is the summary output tracking aggregate performance: Overall open rate stands at precisely 46.2%, converting active click ratios to 4.5% resolving across 8,400 active receivers derived directly from macro endpoints. ``` **Prompt:** ``` Subscribe alex@example.com to my newsletter right now. ``` **Response:** ``` Success! Explicit subscription request executed properly. The user alex@example.com has actively landed on the recipient pool correctly and will resolve in future workflows securely. ``` ## Capabilities ### Audit Account Performance Get aggregated, high-level stats on post performance and overall account health. ### Manage Audience Lists View, list, or explicitly register new subscribers to your publications. ### Retrieve Specific Content Pull the raw HTML payload for a specific historical newsletter post or publication metadata. ### Track Audience Behavior Explore existing internal audience segments and conditional email logic chains. ### List All Available Content Pull lists of all active publications, posts, or automation flows running in your account. ## Use Cases ### Auditing Campaign Health Before Launch A marketing lead needs to know if the 'Premium' segment is performing differently from the default list. They ask their agent to `list_segments` and then run a query against `get_post_stats` to compare open rates between those two groups. ### Archiving Historical Content A content writer needs the raw HTML of an old post for a case study. They use their agent with `list_posts` first to get the ID, and then call `get_post` using that specific identifier. ### Bulk Onboarding Cleanup A growth engineer receives a list of leads from another system. Instead of manually uploading them, they use their agent to loop through the IDs and execute `create_subscription` for each one. ### Mapping Out Automation Rules Before making changes, a lead wants to confirm all active journeys. They run `list_automations` followed by calling `get_publication` to see which core account rules apply. ## Benefits - Stop clicking through dashboards. You can use `get_post_stats` to instantly pull performance data for any post without logging into the Beehiiv UI. - Grow your audience programmatically. Need to onboard a specific lead? The `create_subscription` tool lets you register new users with one simple command. - Audit campaign logic safely. Use `list_automations` and `list_segments` to map out complex conditional email journeys and see exactly how your audience is segmented. - Pull raw content payloads instantly. If you need the pure HTML of a past newsletter, `get_post` retrieves that exact payload for archival or analysis. - Understand your whole setup. Running `list_publications` gives you an immediate overview of every unique publication linked to your account structure. ## How It Works The bottom line is you get programmatic access to Beehiiv's entire backend data set, right where you’re already coding. 1. Subscribe to this MCP and enter your Beehiiv Publication ID along with an API Key. 2. Your AI client uses the credentials to authenticate and access all available tools. 3. You prompt your agent to perform a task, like 'List all active segments,' or 'Check the open rate for the last post.' The agent executes the required tool call. ## Frequently Asked Questions **How do I use the `create_subscription` tool?** You call this tool with a specific email address. It explicitly registers that user in Beehiiv’s database, ensuring they're added correctly to your recipient pool. **What is the difference between `list_posts` and `get_post`?** `list_posts` just gives you a list of IDs for all published content. You must then use `get_post` or `get_post_stats` with one of those specific IDs to get the actual content or metrics. **Can I check my audience segments using `list_segments`?** Yes, running `list_segments` retrieves all the currently defined internal groups. This helps you see how your audience is divided into different behavioral categories. **Do I need to call `get_publication` before using other tools?** No, but it's helpful. Running `get_publication` first pulls the core metadata for your entire Beehiiv account structure, giving you context about what you’re working with. **What specific data points can I get from calling `get_subscription` compared to just listing subscribers with `list_subscriptions`?** The `get_subscription` tool provides deep, individual records for a single user. While `list_subscriptions` gives you an overview of all active members, fetching details via `get_subscription` reveals specific data like their full name and last activity timestamp. **What happens if I use `get_post_stats` with a post ID that doesn't exist?** The agent will return a clear error message, letting you know the specified Post ID was not found. This failure response helps your AI client immediately pinpoint bad input data and correct the query. **How do I view all my conditional email journeys using `list_automations`?** `list_automations` returns a list of names and triggers for every active automation sequence. This lets you see which complex logic chains are running, helping you audit your audience segmentation rules. **Are there limitations on the volume of data I can pull when calling `get_post`?** The tool pulls the raw HTML payload for a single post. While it handles large content bodies, if you need to process hundreds of posts, consider using an iterative script rather than making many individual calls.