Beehiiv MCP. Manage audience data and newsletter metrics 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 Server manages your entire newsletter growth stack. Use your AI agent to analyze open rates, list historical posts, and find segment details without leaving your IDE.
It handles subscriber registration, pulls full content payloads, and generates account performance overviews. It's your direct chat interface to Beehiiv analytics and audience data.
What your AI agents can do
Create subscription
Registers a new subscriber explicitly by email address.
Get post
Retrieves the full HTML content for a specific published newsletter post.
Get post stats
Gets aggregated performance statistics (open/click rates) for a specific post.
The agent can register new users, list existing subscribers, and fetch specific details about any account.
You can get aggregate stats, including open and click rates, and investigate active internal audience segments.
The agent pulls the full HTML payload of any published newsletter or lists all historical posts.
You can list all active publications and investigate the conditional logic chains (automations) linked to your audience.
You can retrieve the core metadata for your entire account, including segment details and specific post IDs.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Beehiiv MCP Server: 10 Tools for Content and Audience Ops
These tools allow your agent to manage Beehiiv data, including listing segments, retrieving post stats, and handling subscriber actions.
019d755acreate subscription
Registers a new subscriber explicitly by email address.
019d755aget post
Retrieves the full HTML content for a specific published newsletter post.
019d755aget post stats
Gets aggregated performance statistics (open/click rates) for a specific post.
019d755aget publication
Retrieves core metadata for a specific Beehiiv publication.
019d755aget subscription
Fetches detailed information for one specific subscriber account.
019d755alist automations
Lists the native conditional email journeys set up in your account.
019d755alist posts
Lists all newsletter posts that have been natively published.
019d755alist publications
Lists all active Beehiiv publications linked to your account.
019d755alist segments
Lists all specific internal audience segments you've created.
019d755alist subscriptions
Lists all active subscribers currently in your Beehiiv audience.
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,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ 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
What you can do with this MCP connector
Your AI agent uses this server to handle your whole newsletter stack. You can analyze open rates, pull historical posts, and check segment details right from your IDE. It handles signing up new subscribers, pulling full content payloads, and generating performance overviews. It's your direct chat interface to Beehiiv analytics and audience data.
Manage Subscribers
Your agent can sign up new users using create_subscription by email. You can list every active subscriber with list_subscriptions and check the specific details for any single account using get_subscription. Analyze Performance
Run get_post_stats to get combined open and click rates for any specific post. You can also list all your internal audience segments with list_segments. Retrieve Content
Use list_posts to get a list of every published newsletter, and then get_post to pull the full HTML content for any specific post. Audit Publications
list_publications shows you all active Beehiiv publications. You can also see what conditional email journeys are set up with list_automations. Fetch Metadata
list_all_publications gives you the core metadata for your entire account, and you can check details for a specific publication using get_publication.
How Beehiiv MCP Works
- 1 Subscribe to the Beehiiv MCP Server and provide your Beehiiv Publication ID and API Key.
- 2 Your AI client sends a command (e.g.,
list_segments) to the server. - 3 The server executes the command against Beehiiv and returns the resulting data (e.g., a list of segment names) to your client.
The bottom line is, you get to run Beehiiv's internal API calls directly through your AI client's chat window.
Who Is Beehiiv MCP For?
Growth Engineers who need to script custom subscription pipelines on the fly. Content Creators who need to pull open rate metrics or read historical post structures while drafting. Marketing Leads who need to audit behavioral conditions and track segment isolation quickly.
Scripts custom subscription pipelines and troubleshoots active programmatic endpoints using tools like create_subscription.
Reads historical post structures using get_post or checks overall open rate metrics with get_post_stats while drafting a new edition.
Audits audience health by listing specific internal segments (list_segments) or viewing publication metadata (get_publication).
What Changes When You Connect
- Audit audience segments and automations instantly. Use
list_segmentsandlist_automationsto see your audience's behavioral conditions and conditional email logic chains without logging into Beehiiv. - Stop manually copying data points. Use
get_post_statsto pull aggregate performance data—like open and click rates—and integrate those numbers directly into your workflow. - Manage subscribers programmatically. You can use
create_subscriptionto register new users orlist_subscriptionsto check the status of existing contacts, all with one command. - Access raw content payloads. Need the pure HTML of an old newsletter?
get_postretrieves the full content payload, which is useful for archival or content migration. - Audit your publications structure. Use
list_publicationsandget_publicationto understand your core content structure and check metadata links. - Keep context switching out of the way. You can check
list_poststo list all published content and then useget_post_statson a specific ID, keeping your focus on writing code.
Real-World Use Cases
Auditing a new segment strategy
A Marketing Lead wants to see if a new segment ('High-Value Beta Users') is behaving as expected. Instead of clicking through dashboards, they ask their agent to run list_segments to verify the segment name exists. They then use list_subscriptions to pull a list of specific members and run get_subscription on one to check their exact status.
Drafting a post based on metrics
A Content Writer needs to write the next newsletter and wants to reference the performance of the last one. They ask their agent to run get_post_stats on the previous post ID. The agent returns the open rate (46.2%) and click ratio (4.5%), allowing the writer to immediately adjust the next draft's focus.
Onboarding a new lead programmatically
A Growth Engineer needs to build a custom subscription pipeline. They use the agent to run create_subscription for a batch of leads found in a database, bypassing manual form fills. They then use list_automations to verify that the new leads are correctly routed through the proper welcome sequence.
Migrating archived content
A developer needs the full text of a historical newsletter for a migration script. They use the agent to run list_posts to find the correct post ID, and then call get_post to pull the pure HTML payload. This avoids manually downloading and scraping old content.
The Tradeoffs
Fetching stats one post at a time
Listing 50 posts using list_posts and then calling get_post_stats 50 separate times to get the aggregate view count. This is slow and hits rate limits.
→
If you need stats for multiple posts, check the Beehiiv API documentation for batch endpoints. If that's unavailable, focus on getting the core list of IDs first, then process the results in chunks. Always check get_post_stats documentation for batch support.
Assuming data freshness
Running get_post_stats and using the results immediately without checking the last update timestamp. The numbers might be stale.
→
Before trusting the stats, always verify the publication metadata using get_publication. This confirms the entire account's operational status and helps gauge data reliability.
Forgetting the publication ID
Trying to run any command (like list_segments) without first knowing the correct Beehiiv Publication ID, leading to a 404 error.
→
Always start by running list_publications to ensure you have the correct, active ID. Pass that ID into any subsequent call to keep the data stream accurate.
When It Fits, When It Doesn't
Use this if you need to manage Beehiiv data in a chat environment. This server is built for auditing, data retrieval, and small, discrete actions (e.g., 'add this email,' 'what was the open rate for last week?'). It's best for developers and analysts. Don't use this if you need to build a complex, multi-stage workflow that requires state management between tools; you'll have to handle that state logic yourself. If you need to create a whole new post or update the published content, you need a dedicated content editor tool, not just data retrieval. This server is read-heavy and write-light.
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.
Available Capabilities
Dealing with newsletter analytics means jumping between dashboards and spreadsheets.
Today, checking your audience performance means logging into Beehiiv, clicking the analytics tab, then maybe opening a separate sheet to export a segment list. If you want to compare a post's open rate to a segment's growth rate, you're copying and pasting data across three different places.
With the Beehiiv MCP Server, you just ask your agent. You can get the `get_post_stats` for a specific post, and then use `list_segments` to pull the segment name. The data lands in your chat, ready for the next step of your code. No copy/paste needed.
Beehiiv MCP Server: Manage subscriptions, posts & analytics
You don't have to leave your coding environment just to check on your audience. No more switching tabs between your IDE and your ESP. The server lets you run `list_subscriptions` to check audience size and `create_subscription` to add a lead, all from the same terminal window.
It keeps your focus on development. Your agent handles the external API calls, returning structured, clean data right where you're already working. It's a clean pipe from Beehiiv into your workflow.
Common Questions About Beehiiv MCP
How do I use the `get_post_stats` tool with Beehiiv MCP Server? +
You provide the unique Post ID. This tool returns aggregate data, including the overall open rate and click rate, helping you gauge how well the post performed.
Can I list all my active Beehiiv segments using `list_segments`? +
Yes. This tool fetches all specific internal audience segments. You'll get a list of segment names and their IDs, letting you know what groups you're tracking.
What is the difference between `list_posts` and `list_publications`? +
list_posts lists the actual newsletter posts published. list_publications lists the main containers or accounts that host those posts.
How does `create_subscription` work? +
You simply provide the email address. The tool executes an explicit subscription request, adding the user to your Beehiiv recipient pool.
Can I get the full HTML content of a post with `get_post`? +
Yes. get_post retrieves the raw, pure HTML payload of a specific post, which is useful for deep content analysis or migration.
How do I check which subscribers I have using the `list_subscriptions` tool? +
The list_subscriptions tool retrieves specific active subscribers. You'll get a list of their details, allowing you to audit who's currently in your pool.
Can I get metadata for a specific publication using `get_publication`? +
Yes, get_publication fetches the full metadata for a Beehiiv publication. This includes core details and structure information.
What information can I get about automated email chains using `list_automations`? +
list_automations shows your native conditional email journeys. It lets you view the active logic and structure of your audience segments.
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.
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.
More in this category
Iterable
Manage cross-channel marketing campaigns, users, and templates via Iterable API.
SendGrid
Deliver transactional and marketing emails at massive scale with industry-leading deliverability and real-time analytics.
Clearscope
Optimize content via Clearscope — create SEO reports, grade drafts using NLP, perform keyword research, and audit SERP competitors directly from any AI agent.
You might also like
Coassemble
Manage online training and LMS via Coassemble — track courses, monitor enrolments, and manage student groups directly from any AI agent.
Constant Contact Alternative
Manage your email marketing and contacts via Constant Contact — create campaigns, track engagement, and organize lists directly from your AI agent.
Collibra
Enable your AI agent to manage data assets, domains, and communities via the Collibra Data Intelligence API.