beehiiv_create_ postCreate post.
Look up a subscriber by email, tag them and add them to a list or automation, build a segment, draft a post and email yourself a test, then compare opens and clicks across recent issues.
PopMCPbeehiiv
Every beehiiv API v2 operation, pinned to the publication you connect, with a new post saved as a draft unless the AI publishes or schedules it.
beehiiv_create_ postCreate post.
beehiiv_create_ subscriptionCreate subscription.
beehiiv_get_ postGet post.
beehiiv_get_ posts_ aggregate_ statsGet aggregate stats.
beehiiv_get_ subscriptionGet subscription by ID.
beehiiv_get_ subscription_ by_ emailGet subscription by email.
beehiiv_list_ postsList posts.
beehiiv_list_ subscriptionsList subscriptions.
beehiiv_send_ post_ test_ emailSend test email.
beehiiv_update_ postUpdate post.
beehiiv_update_ subscriptionUpdate subscription by ID.
beehiiv_update_ subscription_ by_ emailUpdate subscription by email.
beehiiv_create_ segmentCreate segment.
beehiiv_list_ segment_ membersList segment subscribers.
beehiiv_list_ segmentsList segments.
beehiiv_bulk_ update_ subscriptionsUpdate subscriptions.
beehiiv_create_ custom_ fieldCreate custom field.
beehiiv_list_ custom_ fieldsList custom fields.
beehiiv_add_ newsletter_ list_ subscriptionCreate newsletter list subscription.
beehiiv_create_ webhookCreate a webhook.
beehiiv_list_ newsletter_ listsList newsletter lists.
beehiiv_list_ tiersList tiers.
beehiiv_list_ webhooksList webhooks.
beehiiv_add_ subscription_ to_ automationAdd subscription to an automation.
beehiiv_identify_ workspaceIdentify workspace.
beehiiv_list_ automationsList automations.
beehiiv_list_ pollsList polls.
beehiiv_get_ publicationGet publication.
beehiiv_list_ publicationsList publications.
beehiiv_add_ subscription_ tagsAdd subscription tag.
beehiiv_bulk_ create_ subscriptionsBulk create subscription.
beehiiv_get_ engagementsGet publication engagements.
beehiiv_get_ referral_ programGet referral program.
beehiiv_delete_ postDelete post.
beehiiv_delete_ subscriptionDelete subscription.
beehiiv_get_ podcastGet podcast.
beehiiv_get_ podcast_ episodeGet podcast episode.
beehiiv_get_ podcast_ private_ feedGet private feed.
beehiiv_get_ podcast_ private_ feed_ by_ emailGet private feed by email.
beehiiv_get_ post_ preview_ urlGenerate post preview URL.
beehiiv_list_ podcast_ episodesList podcast episodes.
beehiiv_list_ podcastsList podcasts.
beehiiv_send_ podcast_ private_ feed_ emailSend private feed email.
beehiiv_send_ podcast_ private_ feed_ email_ by_ emailSend private feed email by email.
beehiiv_update_ subscription_ putUpdate subscription by ID.
beehiiv_delete_ segmentDelete segment.
beehiiv_get_ segmentGet segment.
beehiiv_list_ segment_ subscriber_ idsList segment subscriber IDs.
beehiiv_recalculate_ segmentRecalculate segment.
beehiiv_bulk_ update_ subscription_ statusUpdate subscriptions' status.
beehiiv_bulk_ update_ subscription_ status_ putUpdate subscriptions' status.
beehiiv_bulk_ update_ subscriptions_ putUpdate subscriptions.
beehiiv_delete_ custom_ fieldDelete custom field.
beehiiv_get_ bulk_ subscription_ updateGet subscription update.
beehiiv_get_ custom_ fieldGet custom field.
beehiiv_list_ bulk_ subscription_ updatesList subscription updates.
beehiiv_update_ custom_ fieldUpdate custom field.
beehiiv_update_ custom_ field_ putUpdate custom field.
beehiiv_create_ newsletter_ listCreate newsletter list.
beehiiv_create_ tierCreate a tier.
beehiiv_delete_ newsletter_ listDelete newsletter list.
beehiiv_delete_ webhookDelete a webhook subscription from a publication.
beehiiv_get_ newsletter_ listGet newsletter list.
beehiiv_get_ newsletter_ list_ subscriptionGet newsletter list subscription.
beehiiv_get_ tierGet tier.
beehiiv_get_ webhookGet webhook.
beehiiv_list_ newsletter_ list_ subscriptionsList newsletter list subscriptions.
beehiiv_update_ newsletter_ listUpdate newsletter list.
beehiiv_update_ newsletter_ list_ subscriptionUpdate newsletter list subscription.
beehiiv_update_ newsletter_ list_ subscription_ by_ subscription_ idUpdate newsletter list subscription by subscription ID.
beehiiv_update_ tierUpdate a tier.
beehiiv_update_ tier_ putUpdate a tier.
beehiiv_update_ webhookUpdate webhook.
beehiiv_accept_ ad_ offerAccept ad offer.
beehiiv_create_ data_ deletion_ requestCreate data deletion request.
beehiiv_create_ post_ templateCreate post template.
beehiiv_create_ subscription_ exportCreate subscription export.
beehiiv_find_ publications_ by_ subscription_ emailGet publications by subscription email.
beehiiv_get_ account_ ad_ network_ report_ summaryGet account ad network report summary.
beehiiv_get_ ad_ network_ report_ summaryGet ad network report summary.
beehiiv_get_ automationGet automation.
beehiiv_get_ automation_ journeyGet automation journey.
beehiiv_get_ data_ deletion_ requestGet data deletion request.
beehiiv_get_ pollGet poll.
beehiiv_get_ post_ templateGet post template.
beehiiv_get_ subscription_ exportGet subscription export.
beehiiv_get_ workspace_ permissionsGet workspace permissions.
beehiiv_list_ ad_ network_ reportsGet ad network reports.
beehiiv_list_ ad_ offer_ advertisementsGet ad offer advertisements.
beehiiv_list_ ad_ offersGet ad offers.
beehiiv_list_ automation_ emailsList automation emails.
beehiiv_list_ automation_ journeysList automation journeys.
beehiiv_list_ data_ deletion_ requestsList data deletion requests.
beehiiv_list_ poll_ responsesList poll responses.
beehiiv_list_ post_ templatesGet post templates.
beehiiv_list_ subscription_ exportsList subscription exports.
beehiiv_get_ authorGet author.
beehiiv_get_ complimentary_ accessGet complimentary access.
beehiiv_get_ condition_ setGet condition set.
beehiiv_list_ authorsList authors.
beehiiv_list_ complimentary_ accessList complimentary access.
beehiiv_list_ condition_ setsList condition sets.
beehiiv_identify_ userIdentify user.
beehiiv_list_ advertisement_ opportunitiesGet advertisement opportunities.
Credentials off one beehiiv screen, then an endpoint your client signs into. Nothing to deploy, and nothing to install.
In beehiiv, open Settings, then Workspace Settings, then API, and create a key (Owner or Admin only; it is shown once). Paste it into the API key field, then pick the publications to connect and the PopMCP workspace each one goes into.
••••••••••••3f7aupdate_post with status confirmed publishes or schedules the email, create_subscription can send a welcome email and bulk tools change many subscribers, all the moment the AI calls them. Tick beehiiv on the PopMCP consent screen only for clients that need it.
Drop the PopMCP URL into Claude, ChatGPT, Codex or any other supported client. It signs in through PopMCP with OAuth, so your beehiiv credential never leaves the server.
app.popmcp.com/mcpAsk for something harmless before the agent changes anything. Writes run as soon as it calls them, so confirm it reads the right account first.
Find ada@northwind.co, tag her vip and add her to the Pro Tips newsletter list
beehiiv_get_subscription_by_emailok
Then just ask for the work
“Find ada@northwind.co, tag her vip and add her to the Pro Tips newsletter list”
“Which of last month's posts had the best click rate, and what were the totals across all of them”
“Turn these notes into next Tuesday's issue as a draft, then send a test to me”
“Make a segment of everyone whose Plan field is Pro and show me who is in it”
One hosted endpoint, registered once per client. The same tools and the same permissions, whichever window the request comes from.
Add the PopMCP URL under Settings → Connectors and the tools appear in every chat.
The same endpoint, registered in the browser. Nothing to install on the machine you are working from.
Register PopMCP as a custom connector, then let ChatGPT read and update the account.
Wire the endpoint into Codex or the Codex CLI when a task needs live business context, not a fixture.
Register the remote MCP server in OpenCode's config for terminal-first and scripted agent runs.
Add PopMCP as an MCP server in Z.ai's desktop app and work the account from the same window.
FAQ
What teams ask before putting beehiiv behind an AI client.
One beehiiv workspace API key. Create it in beehiiv under Settings, then Workspace Settings, then API, with Create New API Key; you need to be a workspace Owner or Admin, and beehiiv shows the key only once. It never expires and needs no OAuth app. PopMCP checks it by listing the publications it reaches, stores it encrypted and sends it from the server as a Bearer token, so your AI client never sees it.
Yes, one per PopMCP workspace. After you paste the key, PopMCP lists every publication it can reach (the whole beehiiv workspace, or only the ones the key is restricted to), and you pick which to connect and the PopMCP workspace each one goes into. Each connection is pinned to its publication, so the AI never passes a publication id and cannot reach one mapped to another workspace. Add more later with Add publications in My MCP.
No, not unless it marks the post confirmed. A post created without a status is published and emailed by beehiiv at once, so PopMCP saves every create_post as a draft unless the AI passes a status, or as confirmed when it sets scheduled_at, which schedules it. The tool description tells the AI to send confirmed only when you asked to publish or schedule. send_post_test_email mails a test to the addresses you name, and creating or updating posts needs a beehiiv Max or Enterprise plan.
Yes. delete_subscription erases the subscriber and all their data and stops billing a premium subscriber, so it is left out of the default tools and the AI is steered to update_subscription with unsubscribe set to true, which can be undone. delete_post archives a sent or scheduled post and only deletes a draft outright. create_data_deletion_request is workspace-wide and redacts the subscriber from every publication after a 14-day delay.
Yes. get_publication with stats expanded returns active free and premium subscriber counts, average open and click rates and total sent. list_posts with stats adds opens and clicks per post, get_posts_aggregate_stats totals them across matching posts with the top 1,000 clicked URLs, and get_engagements breaks email engagement down by day, week or month over up to 31 days. For large publications, beehiiv serves the totals from an hourly cache.
32 in total. 26 are beehiiv webhook events: new, confirmed and deleted subscribers, upgrades to paid and downgrades to free, paused and resumed subscriptions, paid tiers added, removed, paused or resumed, posts sent, scheduled or updated, newsletter list joins, leaves, pauses and resumes, survey responses, and podcast episode and private feed changes. Change detection adds new segments, custom fields, newsletter lists, automations, polls and paid tiers.
No. PopMCP hosts it and gives you a Streamable HTTP MCP URL. There is nothing to deploy, no callback URL to register, and no infrastructure to keep running or patch.
Any client that supports a remote Streamable HTTP MCP server: Claude Desktop, Claude Web, ChatGPT custom connectors, Codex and the Codex CLI, OpenCode and Z.ai's ZCode, as well as editors such as Cursor, Windsurf and Zed. Your client signs in to PopMCP with OAuth; the provider credential never leaves the server.
Loading 104 tool definitions into every conversation burns context before the work starts. PopMCP loads a curated 33-tool set covering the everyday workflows and keeps the rest searchable, so your AI pulls a specialist tool only when a task needs it. Every tool stays searchable, and on Scale the owner can load the full catalog for a teammate's connection.
A tool is something your AI calls, and there are 104 here. A trigger is something PopMCP watches for you: 32 beehiiv events that can start work on the PopMCP side. Triggers never enter your AI client's context, and none of them ask you to paste a callback URL into beehiiv.
Launch a hosted MCP endpoint for beehiiv, keep tool access under control, and start testing real workflow prompts right away.