Beehiiv MCP. Manage your entire newsletter growth lifecycle from chat.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
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.
What your AI agents can do
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 aggregated, high-level stats on post performance and overall account health.
View, list, or explicitly register new subscribers to your publications.
Pull the raw HTML payload for a specific historical newsletter post or publication metadata.
Explore existing internal audience segments and conditional email logic chains.
Pull lists of all active publications, posts, or automation flows running in your account.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 Compatible Gemini Waiting for input…
Beehiiv: 10 Tools for Newsletter Ops
Use these tools to programmatically list segments, fetch post statistics, create subscriptions, or retrieve content metadata.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Beehiiv on Vinkius019d755acreate subscription
Adds a new email address directly to your subscriber list.
019d755aget post
Fetches the complete HTML content of one specific published newsletter post.
019d755aget post stats
Retrieves summarized performance statistics for a chosen post.
019d755aget publication
Gets core metadata about a specific Beehiiv publication account.
019d755aget subscription
Retrieves the exact current details of a single subscriber's record.
019d755alist automations
Lists all native conditional email journeys and automations set up in your account.
019d755alist posts
Pulls a list of identifiers for all newsletters that have been published.
019d755alist publications
Lists every active Beehiiv publication you manage.
019d755alist segments
Displays a list of specific internal audience segments defined in your account.
019d755alist subscriptions
Lists all active subscribers, allowing you to check who is on the roster.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Beehiiv, then connect any of our 4,800+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,800+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Beehiiv. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
The Pain Point: Switching Tabs for Basic Metrics
Today, if you need to know the open rate for last month's post or check how many subscribers are in your 'VIP' segment, you have to log into Beehiiv. Then you click through dashboards, run reports, and copy-paste numbers into a spreadsheet. It’s slow, it requires multiple logins, and frankly, it wastes time.
With this MCP, you skip the UI entirely. You talk directly to your agent, telling it exactly what data point you need—whether that's running `get_post_stats` or checking the status of a segment using `list_segments`. Your AI client handles all the messy API calls behind the scenes. You just get the number you asked for.
Control your audience and content with the Beehiiv MCP
Instead of relying on manual sign-ups or waiting for a form submission to populate data, you can use `create_subscription` to instantly add new leads from an external system. Furthermore, if you need to review which conditional rules are active, running `list_automations` gives you the full picture.
What's different now is that your entire newsletter workflow moves into code. You're not just looking at reports; you're using data points like subscriber lists and post metadata—retrieved via tools like `list_subscriptions` and `get_post`—to power other parts of your application.
What you can do with this MCP connector
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.
019d755a-4380-7375-8122-eb9318c11abc 
How Beehiiv MCP Works
- 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.
The bottom line is you get programmatic access to Beehiiv's entire backend data set, right where you’re already coding.
Who Is Beehiiv MCP For?
This MCP is for the Growth Engineer who gets paid to automate manual workflows. It's perfect for content writers who need instant performance metrics without leaving their drafting tool, or marketing leads who audit campaign health before launch.
Programmatically script subscription pipelines and troubleshoot API endpoints on the fly.
Pull open rate metrics or read historical post structures while drafting a new newsletter edition.
Audit behavioral conditions and track segment isolation safely through quick, targeted queries.
What Changes When You Connect
- Stop clicking through dashboards. You can use
get_post_statsto 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_subscriptiontool lets you register new users with one simple command. - Audit campaign logic safely. Use
list_automationsandlist_segmentsto 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_postretrieves that exact payload for archival or analysis. - Understand your whole setup. Running
list_publicationsgives you an immediate overview of every unique publication linked to your account structure.
Real-World 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.
The Tradeoffs
Trying to fetch everything in one call
Asking the agent, 'Give me all my stats and list my subs.' This is too vague and forces the agent to guess which metrics or segments you mean.
→
Break it down. First, run list_publications to narrow the scope. Then, if you want performance data, call get_post_stats. If you need a roster check, use list_subscriptions.
Assuming content is visible without ID
Asking for 'the last post' and receiving an error because the API needs a specific identifier instead of a descriptive phrase.
→
Always start by calling list_posts to get a list of IDs, then pass one of those concrete identifiers to get_post or get_post_stats.
Forgetting the audience structure
Running analytics on posts without first confirming which segments are active. You might be looking at data from an outdated or irrelevant list.
→
Always run list_segments to confirm your current audience topology before interpreting any performance numbers.
When It Fits, When It Doesn't
Use this MCP if you need to treat Beehiiv like a database—meaning, you are performing programmatic audits, integrating data into external reports (like Looker or internal dashboards), or running custom logic on subscriber lists. You're focused on data flow and process automation. Don't use it if your goal is simply visual content curation; for that, the native Beehiiv editor is better. Also, if you just need to see a basic list of all posts without checking their metrics, list_posts is faster than calling get_post_stats on every single item.
Common Questions About Beehiiv MCP
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.
Multi-server workflows that include Beehiiv MCP
Grow Agency Newsletters Using MCP Servers
Your agency manages email marketing on Zoho Campaigns and newsletter growth on Beehiiv for 6 clients , but subscriber overlap, engagement comparison and cross-platform growth are invisible because nobody compares the two systems
MCP Recipe for Content Distribution Automation
You publish a blog post in Webflow and then spend 45 minutes manually reformatting it for your newsletter, copying stats into a spreadsheet, and wondering why your best content never reaches your subscribers
MCP Servers That Track Newsletter Conversions
Your newsletter has 12,000 subscribers and your product has 2,400 users but you have no idea how many of those users came from the newsletter , marketing says it is working and product says prove it
Sync Newsletter Subscribers to CRM Using MCP
Newsletter published, engaged readers tagged in CRM, growth dashboard updated , your newsletter becomes a sales channel
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.