Connectors · Marketing & media

beehiiv MCP server for AI agents.

actionlake is an MCP gateway: one remote MCP server that connects Claude and other MCP clients to beehiiv and the rest of your systems. It gives your agent 142 beehiiv actions (81 reads, 51 writes and 10 that wait for a confirmation) and holds the beehiiv credential itself, so the agent never does. It paces beehiiv's limits and records every call.

Connect beehiiv free See pricing

100,000 free calls a month. No card, no email, no password: press Start a free sandbox on the next screen and keep the key it shows you.

claude mcp add --transport http actionlake https://connect.actionlake.com/mcp

142actionsin one signed file
81readlook, never change
51writecreate and update
10wait for a yesdestructive, confirmed first

Set up

Connect beehiiv in three steps.

01
Add actionlake to Claude.
Run the command once in Claude Code; its consent page can create a free sandbox: 100,000 calls a month, no card. In the Claude app, add a custom connector with the URL below and paste your key on the consent page. Creating a new sandbox from the Claude app is not yet tested by us.
https://connect.actionlake.com/mcp
02
Connect beehiiv.
Bearer token. No consent screen: your agent can connect it for you, but the key then passes through your chat. To keep it out of the model's context, paste it in the console instead. actionlake stores what you paste write-only, sealed under your tenant's key.
- api_keybeehiiv API key
```
account { op: "connections.requirements", service: "beehiiv" }
# free: exactly what to paste, and what is found for you
```

Make the first call. Check before a write.

Ask in plain words; Claude picks the action. Before anything changes, check validates the call and prices it, for free.

do    { action: "beehiiv.publications.list" }# list publications oauth scope: publications:read · read · 1 upstream callcheck { action: "beehiiv.segments.create", input: { … } }# free: inputs, permissions, cost and confirmations, nothing sent

beehiiv at a glance

Sign-in: Bearer token. No consent screen: your agent can connect it for you, but the key then passes through your chat. To keep it out of the model's context, paste it in the console instead.
You provide: api_key
Limits we pace to: 30 calls a minute, per connection
API covered: Beehiiv API v2 (OpenAPI 1.0.0)api.beehiiv.com
Built from: beehiiv's documentation, read 23 October 2026developers.beehiiv.com developers.beehiiv.com
Service file: Version 1.0.0, signed (Ed25519)
Cached reads: 81 of 81 reads, for up to 5 minutes; a write clears what it affects
Shared entities: 3, so ask can line beehiiv up with your other systems
Data: Processed and stored in Sydney, Australia. No US region yet

Capabilities

What an AI agent can do in beehiiv.

142 actions in 38 areas. Every one carries its effect, so a key can allow the reads and hold the rest.

81readlook, never change
51writecreate and update
10destructivewait for a confirmation

Podcasts
8
6 read · 2 write · 0 destructive
List podcasts OAuth Scope: podcasts:read · List podcast episodes OAuth Scope: podcasts:read · Get podcast OAuth Scope: podcasts:read · Get podcast episode OAuth Scope: podcasts:read
Posts
8
4 read · 3 write · 1 destructive
List posts OAuth Scope: posts:read · Get aggregate stats OAuth Scope: posts:read · Get post OAuth Scope: posts:read · Generate post preview URL OAuth Scope: posts:read
Subscriptions
8
3 read · 4 write · 1 destructive
List subscriptions OAuth Scope: subscriptions:read · Get subscription by ID OAuth Scope: subscriptions:read · Update subscription by ID OAuth Scope: subscriptions:write · Get subscription by email OAuth Scope: subscriptions:read
Newsletter list subscriptions
7
3 read · 4 write · 0 destructive
List newsletter list subscriptions OAuth Scope: newsletter_lists:read · Get newsletter list subscription OAuth Scope: newsletter_lists:read · Get newsletter list subscriber import OAuth Scope: newsletter_lists:read · Create newsletter list subscription OAuth Scope: newsletter_lists:write
Paid recommendation offers
7
2 read · 5 write · 0 destructive
List paid recommendations offers OAuth Scope: posts:read · Get a paid recommendations offer OAuth Scope: posts:read · Create a paid recommendations offer OAuth Scope: posts:write · Archive a paid recommendations offer OAuth Scope: posts:write
Segments
7
4 read · 2 write · 1 destructive
List segments OAuth Scope: segments:read · Get segment OAuth Scope: segments:read · Create segment · Delete segment OAuth Scope: segments:write
Bulk subscription updates
6
2 read · 4 write · 0 destructive
List subscription updates OAuth Scope: subscriptions:read · Get subscription update OAuth Scope: subscriptions:read · Update subscriptions OAuth Scope: subscriptions:write · Update subscriptions' status OAuth Scope: subscriptions:write
Custom fields
6
2 read · 3 write · 1 destructive
List custom fields OAuth Scope: custom_fields:read · Get custom field OAuth Scope: custom_fields:read · Create custom field OAuth Scope: custom_fields:write · Update custom field OAuth Scope: custom_fields:write

30 more areas · 85 actions

Post templates 6
Publication fields 6
Newsletter lists 5
Paid recommendation partnerships 5
Tiers 5
Webhooks 5
Paid recommendation applications 4
Ad network offers 3
Ad network reports 3
Automation journeys 3
Automations 3
Data deletion requests 3
Exports 3
Paid recommendation invites 3
Polls 3
Workspaces 3
Authors 2
Complimentary access 2
Condition sets 2
Paid recommendation auto accept settings 2
Paid recommendation reports 2
Publication duplicates 2
Publications 2
Subscription tags 2
Advertisement opportunities 1
Bulk subscriptions 1
Engagements 1
Paid recommendation wallet 1
Referral program 1
Users 1

Top actions

The beehiiv API, shaped for agents.

The ids your agent types, what each does, and the one name it shares with other systems. 22 of beehiiv's 23 action names are shared with at least one other connector, so an agent learns them once.

Action	What it does	Effect	Same name in
`beehiiv.publications.list`List publications OAuth Scope: publications:read	List publications OAuth Scope: publications:read.	read	`comm.audience.list`26 connectors
`beehiiv.subscriptions.list`List subscriptions OAuth Scope: subscriptions:read	List subscriptions OAuth Scope: subscriptions:read.	read	`comm.audience_member.list`23 connectors
`beehiiv.segments.list`List segments OAuth Scope: segments:read	List segments OAuth Scope: segments:read.	read	`comm.audience_segment.list`22 connectors
`beehiiv.publications.get`Get publication OAuth Scope: publications:read	Get publication OAuth Scope: publications:read.	read	`comm.audience.get`22 connectors
`beehiiv.subscriptions.get`Get subscription by ID OAuth Scope: subscriptions:read	Get subscription by ID OAuth Scope: subscriptions:read.	read	`comm.audience_member.get`17 connectors
`beehiiv.segments.get`Get segment OAuth Scope: segments:read	Get segment OAuth Scope: segments:read.	read	`comm.audience_segment.get`16 connectors
`beehiiv.post_templates.list`Get post templates OAuth Scope: posts:read	Get post templates OAuth Scope: posts:read.	read	`comm.email_template.list`40 connectors
`beehiiv.users.identify`Identify user OAuth Scope: identify:read	Identify user OAuth Scope: identify:read.	read	`identity.current_user.get`307 connectors
`beehiiv.segments.create`Create segment	Create segment.	write	`comm.audience_segment.create`16 connectors
`beehiiv.subscriptions.update`Update subscription by ID OAuth Scope: subscriptions:write	Update subscription by ID OAuth Scope: subscriptions:write.	write	`comm.audience_member.update`15 connectors
`beehiiv.segments.delete`Delete segment OAuth Scope: segments:write	Delete segment OAuth Scope: segments:write.	destructive	`comm.audience_segment.delete`15 connectors
`beehiiv.post_templates.create`Create post template OAuth Scope: posts:write	Create post template OAuth Scope: posts:write.	write	`comm.email_template.create`34 connectors

Try it

Prompts to paste into Claude.

Each one names the beehiiv actions it will call, so you know what it reads and what it changes before you send it.

Readread
List publications OAuth Scope: publications:read in beehiiv and tell me what stands out.
callsbeehiiv.publications.list
Writewrite
Create segment in beehiiv. Show me exactly what you will send before you save it.
callsbeehiiv.segments.create

Governance for beehiiv

Destructive actions wait for a yes.

10 beehiiv actions are destructive. These are all of them:

Delete segment OAuth Scope: segments:writebeehiiv.segments.delete
Delete custom field OAuth Scope: custom_fields:writebeehiiv.custom_fields.delete
Delete newsletter list OAuth Scope: newsletter_lists:writebeehiiv.newsletter_lists.delete
Delete post OAuth Scope: posts:writebeehiiv.posts.delete
Delete a webhook OAuth Scope: webhooks:writebeehiiv.webhooks.delete
Delete subscription OAuth Scope: subscriptions:writebeehiiv.subscriptions.delete
Remove subscription tag OAuth Scope: subscriptions:writebeehiiv.subscription_tags.delete
Create data deletion request OAuth Scope: data_deletion:writebeehiiv.data_deletion_requests.create
Withdraw a paid recommendations invite OAuth Scope: posts:writebeehiiv.paid_recommendation_invites.delete
End paid recommendation partnership OAuth Scope: posts:writebeehiiv.paid_recommendation_partnerships.end

A destructive action runs only with confirm: true. Under the human policy the agent cannot confirm for itself: the run stops until a named person approves, in the console or from a signed link in an email. The cap on a key is refused before the call is sent, never after.

dobeehiiv.segments.deleteconfirm_policy: human

Delete segment OAuth Scope: segments:write?

intent: the user asked me to delete segment OAuth Scope: segments:write

run suspended · waiting for a named person · key beehiiv-agent cannot confirm itself

In the console, or from an emailed signed link.

a key for this connector

account {  op: "keys.create", name: "beehiiv-agent",  allowed_actions: ["beehiiv.*"], cap_calls: 2000,  confirm_policy: "human_for_writes",  approval_rules: [    { match: "beehiiv.segments.delete", approver: "[email protected]" },    { match: "beehiiv.custom_fields.delete", approver: "[email protected]" },    { match: "beehiiv.newsletter_lists.delete", approver: "[email protected]" }  ]}

Illustrative. Scoped to beehiiv only, capped at 2,000 upstream calls, every write confirmed, and the destructive ones approved by a named person.

Cost

What beehiiv costs on actionlake.

Every beehiiv action is one upstream call, the only thing actionlake bills. Searching, check, cost, account and any call beehiiv refused with 401, 403, 429 or a 5xx are free. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000.

1upstream call per actionall 142 beehiiv actions
142actions pageeach page of a long list is one call
81reads can be cacheda cache hit costs nothing
100,000calls a month, freepaid plans from US$49 a month for 250,000

See pricing

Action index

Every beehiiv action.

142 actions by area: the id your agent calls, what it does, and its effect.

Podcasts8

beehiiv.podcasts.getGet podcast OAuth Scope: podcasts:readread
beehiiv.podcasts.get_episodeGet podcast episode OAuth Scope: podcasts:readread
beehiiv.podcasts.get_private_feedGet private feed OAuth Scope: podcasts:readread
beehiiv.podcasts.get_private_feed_by_emailGet private feed by email OAuth Scope: podcasts:readread
beehiiv.podcasts.listList podcasts OAuth Scope: podcasts:readread
beehiiv.podcasts.list_episodesList podcast episodes OAuth Scope: podcasts:readread
beehiiv.podcasts.send_private_feed_emailSend private feed email OAuth Scope: podcasts:writewrite
beehiiv.podcasts.send_private_feed_email_by_emailSend private feed email by email OAuth Scope: podcasts:writewrite

Posts8

beehiiv.posts.aggregate_statsGet aggregate stats OAuth Scope: posts:readread
beehiiv.posts.createCreate post OAuth Scope: posts:writewrite
beehiiv.posts.deleteDelete post OAuth Scope: posts:writedestructive
beehiiv.posts.getGet post OAuth Scope: posts:readread
beehiiv.posts.listList posts OAuth Scope: posts:readread
beehiiv.posts.previewGenerate post preview URL OAuth Scope: posts:readread
beehiiv.posts.test_sendSend test email OAuth Scope: postswrite
beehiiv.posts.updateUpdate post OAuth Scope: posts:writewrite

Subscriptions8

beehiiv.subscriptions.createCreate subscription OAuth Scope: subscriptions:writewrite
beehiiv.subscriptions.deleteDelete subscription OAuth Scope: subscriptions:writedestructive
beehiiv.subscriptions.getGet subscription by ID OAuth Scope: subscriptions:readread
beehiiv.subscriptions.get_by_emailGet subscription by email OAuth Scope: subscriptions:readread
beehiiv.subscriptions.listList subscriptions OAuth Scope: subscriptions:readread
beehiiv.subscriptions.replaceUpdate subscription by ID OAuth Scope: subscriptions:writewrite
beehiiv.subscriptions.replace_by_emailUpdate subscription by email OAuth Scope: subscriptions:writewrite
beehiiv.subscriptions.updateUpdate subscription by ID OAuth Scope: subscriptions:writewrite

Newsletter list subscriptions7

beehiiv.newsletter_list_subscriptions.createCreate newsletter list subscription OAuth Scope: newsletter_lists:writewrite
beehiiv.newsletter_list_subscriptions.create_importCreate newsletter list subscriber import OAuth Scope: newsletter_lists:writewrite
beehiiv.newsletter_list_subscriptions.getGet newsletter list subscription OAuth Scope: newsletter_lists:readread
beehiiv.newsletter_list_subscriptions.get_importGet newsletter list subscriber import OAuth Scope: newsletter_lists:readread
beehiiv.newsletter_list_subscriptions.listList newsletter list subscriptions OAuth Scope: newsletter_lists:readread
beehiiv.newsletter_list_subscriptions.updateUpdate newsletter list subscription OAuth Scope: newsletter_lists:writewrite
beehiiv.newsletter_list_subscriptions.update_by_subscription_idUpdate newsletter list subscription by subscription ID OAuth Scope: newsletter_lists:writewrite

Paid recommendation offers7

beehiiv.paid_recommendation_offers.archiveArchive a paid recommendations offer OAuth Scope: posts:writewrite
beehiiv.paid_recommendation_offers.createCreate a paid recommendations offer OAuth Scope: posts:writewrite
beehiiv.paid_recommendation_offers.getGet a paid recommendations offer OAuth Scope: posts:readread
beehiiv.paid_recommendation_offers.listList paid recommendations offers OAuth Scope: posts:readread
beehiiv.paid_recommendation_offers.pausePause a paid recommendations offer OAuth Scope: posts:writewrite
beehiiv.paid_recommendation_offers.resumeResume a paid recommendations offer OAuth Scope: posts:writewrite
beehiiv.paid_recommendation_offers.updateUpdate a paid recommendations offer OAuth Scope: posts:writewrite

Segments7

beehiiv.segments.createCreate segmentwrite
beehiiv.segments.deleteDelete segment OAuth Scope: segments:writedestructive
beehiiv.segments.getGet segment OAuth Scope: segments:readread
beehiiv.segments.listList segments OAuth Scope: segments:readread
beehiiv.segments.list_membersList segment subscribers OAuth Scope: segments:readread
beehiiv.segments.list_resultsList segment subscriber IDs OAuth Scope: segments:readread
beehiiv.segments.recalculateRecalculate segment OAuth Scope: segments:writewrite

Bulk subscription updates6

beehiiv.bulk_subscription_updates.getGet subscription update OAuth Scope: subscriptions:readread
beehiiv.bulk_subscription_updates.listList subscription updates OAuth Scope: subscriptions:readread
beehiiv.bulk_subscription_updates.replace_fieldsUpdate subscriptions OAuth Scope: subscriptions:writewrite
beehiiv.bulk_subscription_updates.replace_statusUpdate subscriptions' status OAuth Scope: subscriptions:writewrite
beehiiv.bulk_subscription_updates.update_fieldsUpdate subscriptions OAuth Scope: subscriptions:writewrite
beehiiv.bulk_subscription_updates.update_statusUpdate subscriptions' status OAuth Scope: subscriptions:writewrite

Custom fields6

beehiiv.custom_fields.createCreate custom field OAuth Scope: custom_fields:writewrite
beehiiv.custom_fields.deleteDelete custom field OAuth Scope: custom_fields:writedestructive
beehiiv.custom_fields.getGet custom field OAuth Scope: custom_fields:readread
beehiiv.custom_fields.listList custom fields OAuth Scope: custom_fields:readread
beehiiv.custom_fields.replaceUpdate custom field OAuth Scope: custom_fields:writewrite
beehiiv.custom_fields.updateUpdate custom field OAuth Scope: custom_fields:writewrite

Post templates6

beehiiv.post_templates.createCreate post template OAuth Scope: posts:writewrite
beehiiv.post_templates.create_workspaceCreate workspace post template OAuth Scope: posts:writewrite
beehiiv.post_templates.getGet post template OAuth Scope: posts:readread
beehiiv.post_templates.get_workspaceGet workspace post template OAuth Scope: posts:readread
beehiiv.post_templates.listGet post templates OAuth Scope: posts:readread
beehiiv.post_templates.list_workspaceList workspace post templates OAuth Scope: posts:readread

Publication fields6

beehiiv.publication_fields.createCreate publication field OAuth Scope: publication_fields:writewrite
beehiiv.publication_fields.getGet publication field OAuth Scope: publication_fields:readread
beehiiv.publication_fields.listList publication fields OAuth Scope: publication_fields:readread
beehiiv.publication_fields.list_valuesList publication field values OAuth Scope: publication_fields:readread
beehiiv.publication_fields.updateUpdate publication field OAuth Scope: publication_fields:writewrite
beehiiv.publication_fields.update_valuesAssign publication field values OAuth Scope: publication_fields:writewrite

Newsletter lists5

beehiiv.newsletter_lists.createCreate newsletter list OAuth Scope: newsletter_lists:writewrite
beehiiv.newsletter_lists.deleteDelete newsletter list OAuth Scope: newsletter_lists:writedestructive
beehiiv.newsletter_lists.getGet newsletter list OAuth Scope: newsletter_lists:readread
beehiiv.newsletter_lists.listList newsletter lists OAuth Scope: newsletter_lists:readread
beehiiv.newsletter_lists.updateUpdate newsletter list OAuth Scope: newsletter_lists:writewrite

Paid recommendation partnerships5

beehiiv.paid_recommendation_partnerships.endEnd paid recommendation partnership OAuth Scope: posts:writedestructive
beehiiv.paid_recommendation_partnerships.getGet paid recommendation partnership OAuth Scope: posts:readread
beehiiv.paid_recommendation_partnerships.listList paid recommendation partnerships OAuth Scope: posts:readread
beehiiv.paid_recommendation_partnerships.pausePause paid recommendation partnership OAuth Scope: posts:writewrite
beehiiv.paid_recommendation_partnerships.resumeResume paid recommendation partnership OAuth Scope: posts:writewrite

Tiers5

beehiiv.tiers.createCreate a tier OAuth Scope: tiers:writewrite
beehiiv.tiers.getGet tier OAuth Scope: tiers:readread
beehiiv.tiers.listList tiers OAuth Scope: tiers:readread
beehiiv.tiers.replaceUpdate a tier OAuth Scope: tiers:writewrite
beehiiv.tiers.updateUpdate a tier OAuth Scope: tiers:writewrite

Webhooks5

beehiiv.webhooks.createCreate a webhook OAuth Scope: webhooks:writewrite
beehiiv.webhooks.deleteDelete a webhook OAuth Scope: webhooks:writedestructive
beehiiv.webhooks.getGet webhook OAuth Scope: webhooks:readread
beehiiv.webhooks.listList webhooks OAuth Scope: webhooks:readread
beehiiv.webhooks.updateUpdate webhook OAuth Scope: webhooks:writewrite

Paid recommendation applications4

beehiiv.paid_recommendation_applications.acceptAccept paid recommendation application OAuth Scope: posts:writewrite
beehiiv.paid_recommendation_applications.getGet paid recommendation application OAuth Scope: posts:readread
beehiiv.paid_recommendation_applications.listList paid recommendation applications OAuth Scope: posts:readread
beehiiv.paid_recommendation_applications.rejectReject paid recommendation application OAuth Scope: posts:writewrite

Ad network offers3

beehiiv.ad_network_offers.advertisementsGet ad offer advertisements OAuth Scope: posts:readread
beehiiv.ad_network_offers.createAccept ad offer OAuth Scope: posts:writewrite
beehiiv.ad_network_offers.listGet ad offers OAuth Scope: posts:readread

Ad network reports3

beehiiv.ad_network_reports.account_summaryGet account ad network report summary OAuth Scope: posts:readread
beehiiv.ad_network_reports.listGet ad network reports OAuth Scope: posts:readread
beehiiv.ad_network_reports.summaryGet ad network report summary OAuth Scope: posts:readread

Automation journeys3

beehiiv.automation_journeys.createAdd subscription to an automation OAuth Scope: automations:writewrite
beehiiv.automation_journeys.getGet automation journey OAuth Scope: automations:readread
beehiiv.automation_journeys.listList automation journeys OAuth Scope: automations:readread

Automations3

beehiiv.automations.getGet automation OAuth Scope: automations:readread
beehiiv.automations.listList automations OAuth Scope: automations:readread
beehiiv.automations.list_emailsList automation emailsread

Data deletion requests3

beehiiv.data_deletion_requests.createCreate data deletion request OAuth Scope: data_deletion:writedestructive
beehiiv.data_deletion_requests.getGet data deletion request OAuth Scope: data_deletion:readread
beehiiv.data_deletion_requests.listList data deletion requests OAuth Scope: data_deletion:readread

Exports3

beehiiv.exports.createCreate subscription export OAuth Scope: subscriptions:writewrite
beehiiv.exports.getGet subscription export OAuth Scope: subscriptions:readread
beehiiv.exports.listList subscription exports OAuth Scope: subscriptions:readread

Paid recommendation invites3

beehiiv.paid_recommendation_invites.createSend a paid recommendations invite OAuth Scope: posts:writewrite
beehiiv.paid_recommendation_invites.deleteWithdraw a paid recommendations invite OAuth Scope: posts:writedestructive
beehiiv.paid_recommendation_invites.listList paid recommendations invites OAuth Scope: posts:readread

Polls3

beehiiv.polls.getGet poll OAuth Scope: polls:readread
beehiiv.polls.listList polls OAuth Scope: polls:readread
beehiiv.polls.list_responsesList poll responses OAuth Scope: polls:readread

Workspaces3

beehiiv.workspaces.identifyIdentify workspace OAuth Scope: identify:readread
beehiiv.workspaces.permissionsGet workspace permissions OAuth Scope: identify:readread
beehiiv.workspaces.publications_by_subscription_emailGet publications by subscription email OAuth Scope: publications:readread

Authors2

beehiiv.authors.getGet authorread
beehiiv.authors.listList authorsread

Complimentary access2

beehiiv.complimentary_access.getGet complimentary access OAuth Scope: complimentary_access:readread
beehiiv.complimentary_access.listList complimentary access OAuth Scope: complimentary_access:readread

Condition sets2

beehiiv.condition_sets.getGet condition set OAuth Scope: condition_sets:readread
beehiiv.condition_sets.listList condition sets OAuth Scope: condition_sets:readread

Paid recommendation auto accept settings2

beehiiv.paid_recommendation_auto_accept_settings.getGet paid recommendations auto-accept settings OAuth Scope: posts:readread
beehiiv.paid_recommendation_auto_accept_settings.updateUpdate paid recommendations auto-accept settings OAuth Scope: posts:writewrite

Paid recommendation reports2

beehiiv.paid_recommendation_reports.getGet paid recommendation partner report OAuth Scope: posts:readread
beehiiv.paid_recommendation_reports.listList paid recommendation partner reports OAuth Scope: posts:readread

Publication duplicates2

beehiiv.publication_duplicates.createCreate publication duplicate OAuth Scope: publications:writewrite
beehiiv.publication_duplicates.getGet publication duplicate OAuth Scope: publications:readread

Publications2

beehiiv.publications.getGet publication OAuth Scope: publications:readread
beehiiv.publications.listList publications OAuth Scope: publications:readread

Subscription tags2

beehiiv.subscription_tags.createAdd subscription tag OAuth Scope: subscriptions:writewrite
beehiiv.subscription_tags.deleteRemove subscription tag OAuth Scope: subscriptions:writedestructive

Advertisement opportunities1

beehiiv.advertisement_opportunities.listGet advertisement opportunities OAuth Scope: posts:readread

Bulk subscriptions1

beehiiv.bulk_subscriptions.createBulk create subscription OAuth Scope: subscriptions:writewrite

Engagements1

beehiiv.engagements.listGet publication engagements OAuth Scope: publications:readread

Paid recommendation wallet1

beehiiv.paid_recommendation_wallet.getGet paid recommendations wallet OAuth Scope: posts:readread

Referral program1

beehiiv.referral_program.listGet referral program OAuth Scope: referral_program:readread

Users1

beehiiv.users.identifyIdentify user OAuth Scope: identify:readread

Questions

The beehiiv MCP server, answered.

Is there a beehiiv MCP server for Claude?

Yes. actionlake is an MCP gateway: a remote MCP server that gives Claude, or another MCP client, 142 beehiiv actions across podcasts, posts, subscriptions and newsletter list subscriptions, through the same eight tools it uses for every other connector. actionlake is independent; it is not made or endorsed by beehiiv.

What do I need to connect beehiiv?

Beehiiv API key. The free call account { op: "connections.requirements", service: "beehiiv" } lists exactly what to paste.

Can an AI agent delete or change things in beehiiv?

Only if its key allows it, and only with an explicit confirmation. 10 beehiiv actions are destructive, including delete segment OAuth Scope: segments:write, delete custom field OAuth Scope: custom_fields:write and delete newsletter list OAuth Scope: newsletter_lists:write. Each runs only with confirm: true. Under the human confirm policy, or an approval rule on the key, the run waits until a named person approves it.

Will an AI agent use up my beehiiv API limit?

actionlake paces every call to the limits in the beehiiv service file: 30 calls a minute per connection. Repeated reads are answered from cache (81 beehiiv actions can be), which never reaches beehiiv.

What does a beehiiv action cost?

One upstream call, the only unit actionlake bills. A list that pages bills one call per page (142 beehiiv actions page). Cache hits, searches, dry runs and calls beehiiv refused with 401, 403, 429 or a 5xx are free. The Free plan includes 100,000 calls a month with no card. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000.

Which beehiiv API does it cover?

The beehiiv API v2 (OpenAPI 1.0.0) at api.beehiiv.com. It is built from beehiiv's documentation as read on 23 October 2026. 142 actions in 38 areas, each one in the signed service file (version 1.0.0).

Does actionlake keep my beehiiv data, and where?

actionlake processes and stores data in Sydney, Australia; there is no US region yet. Reads may be cached for up to 5 minutes, and a write clears the reads it affects. Each run's request and response is kept, sealed, for your plan's trace window: 1 day on Free, 3 days on Starter, 7 days on Pro, 14 days on Team, 30 days on Business and 30 days on Enterprise. Your beehiiv credential is sealed under your tenant's key, never logged and never returned. Your traffic is not used to train models.

Which AI clients can use it?

Claude Code, tested by us end to end, and the Claude app as a custom connector, tested by us with an existing key. Other MCP clients that support remote servers over Streamable HTTP (MCP revisions 2025-06-18 and 2025-11-25) and OAuth dynamic client registration, or a bearer header, should connect the same way; we have not tested them. Or plain REST, under the same action names.

Give your agent beehiiv today.

Connect beehiiv free See pricing

Start free - 100,000 calls/month, no card. No signup. Hard caps on every key. Cached answers are free.

beehiiv MCP server for AI agents.

Connect beehiiv in three steps.

Add actionlake to Claude.

Connect beehiiv.

Make the first call. Check before a write.

What an AI agent can do in beehiiv.

Podcasts

Posts

Subscriptions

Newsletter list subscriptions

Paid recommendation offers

Segments

Bulk subscription updates

Custom fields