# Beehiiv MCP for AI Agents AI Agent Connect > Beehiiv MCP lets your AI agent handle newsletter tasks like managing subscribers, pulling analytics, and organizing posts. It connects your Beehiiv account directly to your agent so you can manage your audience growth without switching tabs between your editor and your dashboard. ## Overview - **Category:** growth-engine - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_1pl2hlVLw3rvt8i0u7J3pCS6GkC36ovXVrSZpjwP/ai-agent-connect - **Tags:** newsletter-platform, audience-growth, subscriber-management, email-analytics, content-distribution ## Description Imagine you're deep in a coding session or drafting a new content piece and you need to know how your last newsletter performed or check if a specific subscriber joined your list. Instead of jumping out of your IDE or editor to log into another dashboard, you just ask your agent. This Connector bridges that gap by giving your agent a direct line to your Beehiiv account. You can have your agent pull raw HTML from past posts, check your open rates, or even register new subscribers on the fly. It handles the heavy lifting of navigating publication topology and audience segments so you can stay focused on the actual writing and growth strategy. Because Vinkius makes it easy to manage multiple connections, you can keep your entire growth engine running in the background while you work. It's about getting the data you need exactly when you need it, without the friction of manual data entry or constant tab switching. You get a direct way to control your newsletter growth from your existing AI workspace. ## Tools ### list_publications View all your active Beehiiv publications in one list. Use this to see every newsletter you manage. ### get_subscription Get the exact details for a single subscriber. This is useful for verifying specific user data. ### get_publication Pull specific metadata for a single publication. This helps you see the exact settings for a specific brand. ### list_subscriptions See a list of your active subscribers. Use this to browse your audience without leaving your workspace. ### create_subscription Register a new subscriber to your list immediately. This lets your agent handle signups for you. ### list_posts See a list of all newsletters you've published. Use this to browse your full content history. ### get_post Retrieve the full content of a specific newsletter post. This is great for pulling HTML templates. ### get_post_stats Get the total open and click rates for a specific post. Use this to see what content actually resonates. ### list_segments Browse your internal audience segments. This helps you understand how your audience is grouped. ### list_automations See all your native conditional email journeys. Use this to audit your growth logic and email flows. ## Prompt Examples **Prompt:** ``` What was the open rate for my last three newsletters? ``` **Response:** ``` Here is the performance summary for your recent publications: | Publication Title | Open Rate | Click Rate | | :--- | :--- | :--- | | Weekly Tech Update | **46.2%** | 4.5% | | Growth Tactics | **42.8%** | 3.9% | | Tool Spotlight | **48.1%** | 5.2% | Your engagement is holding steady across all three editions. ``` **Prompt:** ``` List my active audience segments. ``` **Response:** ``` I found the following active segments in your Beehiiv account: * **Early Birds**: Subscribers who joined in the first 30 days. * **VIPs**: High-engagement users with over 50% open rates. * **Enterprise**: Users associated with corporate domains. * **Churn Risk**: Users who haven't opened an email in 60 days. ``` **Prompt:** ``` Register a new subscriber for alex@example.com. ``` **Response:** ``` Success! I've registered **alex@example.com** to your publication list. They are now added to your recipient pool and will receive future updates. ``` ## Capabilities ### Register new subscribers Add new users to your mailing list with a single command from your AI client. ### Pull raw newsletter HTML Retrieve the full content of past posts to use as templates for new content. ### Check open and click rates Get aggregated performance stats for any specific post in your publication. ### Browse audience segments View your internal audience groups to understand your subscriber breakdown. ### List email automations See all your native conditional email journeys and logic chains at once. ### Fetch publication metadata Get specific details about your various publications and their settings. ## Use Cases ### Verifying UTM acquisition params A growth engineer needs to check if a specific user joined via a specific link. They ask the agent to use get_subscription to verify the data. ### Reference old content structures A writer wants to see the HTML of a post from last year to match the style. They use get_post to copy the structure into a new draft. ### Auditing newsletter performance A marketing lead needs to see the open rate of the last three emails. They ask the agent to run get_post_stats for those specific IDs. ### Mapping automation logic A creator wants to see what automation triggers are active. They use list_automations to audit their current email journeys. ## Benefits - Stop switching tabs by using list_subscriptions to check your audience without leaving your editor. - Keep your content consistent by pulling old newsletter structures with get_post to use as references. - Monitor your growth in real-time using get_post_stats to see what's actually resonating with your readers. - Organize your audience faster by exploring different groups with list_segments to see your subscriber breakdown. - Manage your growth logic without clicking through menus by viewing list_automations to audit your flows. - Scale your signups by having your agent handle create_subscription requests automatically for new leads. ## How It Works The bottom line is you get a direct way to control your newsletter growth from your existing AI workspace. 1. Subscribe to the Beehiiv MCP on the Vinkius platform. 2. Enter your Beehiiv Publication ID and API Key into your AI client settings. 3. Ask your agent to fetch stats, manage subscribers, or pull content directly. ## Frequently Asked Questions **Can I use the Beehiiv MCP to see my subscriber list?** Yes, it lets your agent pull your active subscriber data so you can check your audience size and details without logging in. **How do I manage my newsletter posts with this?** You can ask your agent to list all your past publications or pull the specific content of any post to use as a reference. **Can this help with my newsletter analytics?** Absolutely. Your agent can fetch aggregated performance stats like open and click rates for any specific post you choose. **Can I use it to see my email automations?** Yes, it lets you see all your native conditional email journeys so you can audit your growth logic quickly. **Is the Beehiiv MCP good for growth engineers?** It's built for it. You can use it to troubleshoot programmatic endpoints and manage subscriber registrations via your AI client. **Can my agent register new people for me?** Yes, it can explicitly register new subscribers to your list using a single command. **Can my AI instantly add a new user email to a Beehiiv segment?** Yes! The `create_subscription` endpoint natively pushes explicit subscriber payload strings confirming opt-ins organically inside the newsletter workflow without touching native browser forms. **Will I be able to see exactly who clicked and opened my last post?** The agent can read macroscopic analytics via `get_post_stats` (broad open rates) or isolate users with `get_subscription`, but isolating granular mass clicking lists per individual post requires distinct specialized deep-dive pagination routines currently supported strictly at fundamental account-tiers. **Can the agent write and automatically publish the newsletter draft?** No. The integration currently lists historical posts and retrieves specific delivered payloads as HTML (`get_post`). Native automation dictates safe draft creation remain manual to prevent unintentional spam emissions to thousands of active readers.