--- title: "beehiiv MCP server for AI agents - actionlake" description: "Give Claude 142 beehiiv actions through one MCP server: podcasts, posts, subscriptions. Your agent never holds the credential. 100,000 calls a month free." canonical: https://actionlake.com/connectors/beehiiv updated: 2026-10-23 --- 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](https://actionlake.com/console?start=sandbox) [See pricing](https://actionlake.com/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` the first call ``` do { action: "beehiiv.publications.list", intent: "check which beehiiv account is connected" } # List publications OAuth Scope: publications:read · read · 1 upstream call ``` - 142 actions in one signed file - 81 read look, never change - 51 write create and update - 10 wait for a yes destructive, confirmed first Set up ## Connect beehiiv in three steps. 1. 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` 2. 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_key` beehiiv API key ``` account { op: "connections.requirements", service: "beehiiv" } # free: exactly what to paste, and what is found for you ``` 3. 03 ### 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 call check { 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 2026[developers.beehiiv.com](https://developers.beehiiv.com/openapi/api-reference.json) [developers.beehiiv.com](https://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. - **81** read look, never change - **51** write create and update - **10** destructive wait for a confirmation 1. ### 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 2. ### 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 3. ### 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 4. ### 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 5. ### 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 6. ### 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 7. ### 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 8. ### 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. 1. Read read List publications OAuth Scope: publications:read in beehiiv and tell me what stands out. calls `beehiiv.publications.list` 2. Write write Create segment in beehiiv. Show me exactly what you will send before you save it. calls `beehiiv.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:write `beehiiv.segments.delete` - Delete custom field OAuth Scope: custom_fields:write `beehiiv.custom_fields.delete` - Delete newsletter list OAuth Scope: newsletter_lists:write `beehiiv.newsletter_lists.delete` - Delete post OAuth Scope: posts:write `beehiiv.posts.delete` - Delete a webhook OAuth Scope: webhooks:write `beehiiv.webhooks.delete` - Delete subscription OAuth Scope: subscriptions:write `beehiiv.subscriptions.delete` - Remove subscription tag OAuth Scope: subscriptions:write `beehiiv.subscription_tags.delete` - Create data deletion request OAuth Scope: data_deletion:write `beehiiv.data_deletion_requests.create` - Withdraw a paid recommendations invite OAuth Scope: posts:write `beehiiv.paid_recommendation_invites.delete` - End paid recommendation partnership OAuth Scope: posts:write `beehiiv.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. do beehiiv.segments.delete confirm_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: "lead@example.com" }, { match: "beehiiv.custom_fields.delete", approver: "lead@example.com" }, { match: "beehiiv.newsletter_lists.delete", approver: "lead@example.com" } ] } ``` 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. - 1 upstream call per action all 142 beehiiv actions - 142 actions page each page of a long list is one call - 81 reads can be cached a cache hit costs nothing - 100,000 calls a month, free paid plans from US$49 a month for 250,000 [See pricing](https://actionlake.com/pricing) Action index ## Every beehiiv action. 142 actions by area: the id your agent calls, what it does, and its effect. **Podcasts 8** - `beehiiv.podcasts.get` Get podcast OAuth Scope: podcasts:read read - `beehiiv.podcasts.get_episode` Get podcast episode OAuth Scope: podcasts:read read - `beehiiv.podcasts.get_private_feed` Get private feed OAuth Scope: podcasts:read read - `beehiiv.podcasts.get_private_feed_by_email` Get private feed by email OAuth Scope: podcasts:read read - `beehiiv.podcasts.list` List podcasts OAuth Scope: podcasts:read read - `beehiiv.podcasts.list_episodes` List podcast episodes OAuth Scope: podcasts:read read - `beehiiv.podcasts.send_private_feed_email` Send private feed email OAuth Scope: podcasts:write write - `beehiiv.podcasts.send_private_feed_email_by_email` Send private feed email by email OAuth Scope: podcasts:write write **Posts 8** - `beehiiv.posts.aggregate_stats` Get aggregate stats OAuth Scope: posts:read read - `beehiiv.posts.create` Create post OAuth Scope: posts:write write - `beehiiv.posts.delete` Delete post OAuth Scope: posts:write destructive - `beehiiv.posts.get` Get post OAuth Scope: posts:read read - `beehiiv.posts.list` List posts OAuth Scope: posts:read read - `beehiiv.posts.preview` Generate post preview URL OAuth Scope: posts:read read - `beehiiv.posts.test_send` Send test email OAuth Scope: posts write - `beehiiv.posts.update` Update post OAuth Scope: posts:write write **Subscriptions 8** - `beehiiv.subscriptions.create` Create subscription OAuth Scope: subscriptions:write write - `beehiiv.subscriptions.delete` Delete subscription OAuth Scope: subscriptions:write destructive - `beehiiv.subscriptions.get` Get subscription by ID OAuth Scope: subscriptions:read read - `beehiiv.subscriptions.get_by_email` Get subscription by email OAuth Scope: subscriptions:read read - `beehiiv.subscriptions.list` List subscriptions OAuth Scope: subscriptions:read read - `beehiiv.subscriptions.replace` Update subscription by ID OAuth Scope: subscriptions:write write - `beehiiv.subscriptions.replace_by_email` Update subscription by email OAuth Scope: subscriptions:write write - `beehiiv.subscriptions.update` Update subscription by ID OAuth Scope: subscriptions:write write **Newsletter list subscriptions 7** - `beehiiv.newsletter_list_subscriptions.create` Create newsletter list subscription OAuth Scope: newsletter_lists:write write - `beehiiv.newsletter_list_subscriptions.create_import` Create newsletter list subscriber import OAuth Scope: newsletter_lists:write write - `beehiiv.newsletter_list_subscriptions.get` Get newsletter list subscription OAuth Scope: newsletter_lists:read read - `beehiiv.newsletter_list_subscriptions.get_import` Get newsletter list subscriber import OAuth Scope: newsletter_lists:read read - `beehiiv.newsletter_list_subscriptions.list` List newsletter list subscriptions OAuth Scope: newsletter_lists:read read - `beehiiv.newsletter_list_subscriptions.update` Update newsletter list subscription OAuth Scope: newsletter_lists:write write - `beehiiv.newsletter_list_subscriptions.update_by_subscription_id` Update newsletter list subscription by subscription ID OAuth Scope: newsletter_lists:write write **Paid recommendation offers 7** - `beehiiv.paid_recommendation_offers.archive` Archive a paid recommendations offer OAuth Scope: posts:write write - `beehiiv.paid_recommendation_offers.create` Create a paid recommendations offer OAuth Scope: posts:write write - `beehiiv.paid_recommendation_offers.get` Get a paid recommendations offer OAuth Scope: posts:read read - `beehiiv.paid_recommendation_offers.list` List paid recommendations offers OAuth Scope: posts:read read - `beehiiv.paid_recommendation_offers.pause` Pause a paid recommendations offer OAuth Scope: posts:write write - `beehiiv.paid_recommendation_offers.resume` Resume a paid recommendations offer OAuth Scope: posts:write write - `beehiiv.paid_recommendation_offers.update` Update a paid recommendations offer OAuth Scope: posts:write write **Segments 7** - `beehiiv.segments.create` Create segment write - `beehiiv.segments.delete` Delete segment OAuth Scope: segments:write destructive - `beehiiv.segments.get` Get segment OAuth Scope: segments:read read - `beehiiv.segments.list` List segments OAuth Scope: segments:read read - `beehiiv.segments.list_members` List segment subscribers OAuth Scope: segments:read read - `beehiiv.segments.list_results` List segment subscriber IDs OAuth Scope: segments:read read - `beehiiv.segments.recalculate` Recalculate segment OAuth Scope: segments:write write **Bulk subscription updates 6** - `beehiiv.bulk_subscription_updates.get` Get subscription update OAuth Scope: subscriptions:read read - `beehiiv.bulk_subscription_updates.list` List subscription updates OAuth Scope: subscriptions:read read - `beehiiv.bulk_subscription_updates.replace_fields` Update subscriptions OAuth Scope: subscriptions:write write - `beehiiv.bulk_subscription_updates.replace_status` Update subscriptions' status OAuth Scope: subscriptions:write write - `beehiiv.bulk_subscription_updates.update_fields` Update subscriptions OAuth Scope: subscriptions:write write - `beehiiv.bulk_subscription_updates.update_status` Update subscriptions' status OAuth Scope: subscriptions:write write **Custom fields 6** - `beehiiv.custom_fields.create` Create custom field OAuth Scope: custom_fields:write write - `beehiiv.custom_fields.delete` Delete custom field OAuth Scope: custom_fields:write destructive - `beehiiv.custom_fields.get` Get custom field OAuth Scope: custom_fields:read read - `beehiiv.custom_fields.list` List custom fields OAuth Scope: custom_fields:read read - `beehiiv.custom_fields.replace` Update custom field OAuth Scope: custom_fields:write write - `beehiiv.custom_fields.update` Update custom field OAuth Scope: custom_fields:write write **Post templates 6** - `beehiiv.post_templates.create` Create post template OAuth Scope: posts:write write - `beehiiv.post_templates.create_workspace` Create workspace post template OAuth Scope: posts:write write - `beehiiv.post_templates.get` Get post template OAuth Scope: posts:read read - `beehiiv.post_templates.get_workspace` Get workspace post template OAuth Scope: posts:read read - `beehiiv.post_templates.list` Get post templates OAuth Scope: posts:read read - `beehiiv.post_templates.list_workspace` List workspace post templates OAuth Scope: posts:read read **Publication fields 6** - `beehiiv.publication_fields.create` Create publication field OAuth Scope: publication_fields:write write - `beehiiv.publication_fields.get` Get publication field OAuth Scope: publication_fields:read read - `beehiiv.publication_fields.list` List publication fields OAuth Scope: publication_fields:read read - `beehiiv.publication_fields.list_values` List publication field values OAuth Scope: publication_fields:read read - `beehiiv.publication_fields.update` Update publication field OAuth Scope: publication_fields:write write - `beehiiv.publication_fields.update_values` Assign publication field values OAuth Scope: publication_fields:write write **Newsletter lists 5** - `beehiiv.newsletter_lists.create` Create newsletter list OAuth Scope: newsletter_lists:write write - `beehiiv.newsletter_lists.delete` Delete newsletter list OAuth Scope: newsletter_lists:write destructive - `beehiiv.newsletter_lists.get` Get newsletter list OAuth Scope: newsletter_lists:read read - `beehiiv.newsletter_lists.list` List newsletter lists OAuth Scope: newsletter_lists:read read - `beehiiv.newsletter_lists.update` Update newsletter list OAuth Scope: newsletter_lists:write write **Paid recommendation partnerships 5** - `beehiiv.paid_recommendation_partnerships.end` End paid recommendation partnership OAuth Scope: posts:write destructive - `beehiiv.paid_recommendation_partnerships.get` Get paid recommendation partnership OAuth Scope: posts:read read - `beehiiv.paid_recommendation_partnerships.list` List paid recommendation partnerships OAuth Scope: posts:read read - `beehiiv.paid_recommendation_partnerships.pause` Pause paid recommendation partnership OAuth Scope: posts:write write - `beehiiv.paid_recommendation_partnerships.resume` Resume paid recommendation partnership OAuth Scope: posts:write write **Tiers 5** - `beehiiv.tiers.create` Create a tier OAuth Scope: tiers:write write - `beehiiv.tiers.get` Get tier OAuth Scope: tiers:read read - `beehiiv.tiers.list` List tiers OAuth Scope: tiers:read read - `beehiiv.tiers.replace` Update a tier OAuth Scope: tiers:write write - `beehiiv.tiers.update` Update a tier OAuth Scope: tiers:write write **Webhooks 5** - `beehiiv.webhooks.create` Create a webhook OAuth Scope: webhooks:write write - `beehiiv.webhooks.delete` Delete a webhook OAuth Scope: webhooks:write destructive - `beehiiv.webhooks.get` Get webhook OAuth Scope: webhooks:read read - `beehiiv.webhooks.list` List webhooks OAuth Scope: webhooks:read read - `beehiiv.webhooks.update` Update webhook OAuth Scope: webhooks:write write **Paid recommendation applications 4** - `beehiiv.paid_recommendation_applications.accept` Accept paid recommendation application OAuth Scope: posts:write write - `beehiiv.paid_recommendation_applications.get` Get paid recommendation application OAuth Scope: posts:read read - `beehiiv.paid_recommendation_applications.list` List paid recommendation applications OAuth Scope: posts:read read - `beehiiv.paid_recommendation_applications.reject` Reject paid recommendation application OAuth Scope: posts:write write **Ad network offers 3** - `beehiiv.ad_network_offers.advertisements` Get ad offer advertisements OAuth Scope: posts:read read - `beehiiv.ad_network_offers.create` Accept ad offer OAuth Scope: posts:write write - `beehiiv.ad_network_offers.list` Get ad offers OAuth Scope: posts:read read **Ad network reports 3** - `beehiiv.ad_network_reports.account_summary` Get account ad network report summary OAuth Scope: posts:read read - `beehiiv.ad_network_reports.list` Get ad network reports OAuth Scope: posts:read read - `beehiiv.ad_network_reports.summary` Get ad network report summary OAuth Scope: posts:read read **Automation journeys 3** - `beehiiv.automation_journeys.create` Add subscription to an automation OAuth Scope: automations:write write - `beehiiv.automation_journeys.get` Get automation journey OAuth Scope: automations:read read - `beehiiv.automation_journeys.list` List automation journeys OAuth Scope: automations:read read **Automations 3** - `beehiiv.automations.get` Get automation OAuth Scope: automations:read read - `beehiiv.automations.list` List automations OAuth Scope: automations:read read - `beehiiv.automations.list_emails` List automation emails read **Data deletion requests 3** - `beehiiv.data_deletion_requests.create` Create data deletion request OAuth Scope: data_deletion:write destructive - `beehiiv.data_deletion_requests.get` Get data deletion request OAuth Scope: data_deletion:read read - `beehiiv.data_deletion_requests.list` List data deletion requests OAuth Scope: data_deletion:read read **Exports 3** - `beehiiv.exports.create` Create subscription export OAuth Scope: subscriptions:write write - `beehiiv.exports.get` Get subscription export OAuth Scope: subscriptions:read read - `beehiiv.exports.list` List subscription exports OAuth Scope: subscriptions:read read **Paid recommendation invites 3** - `beehiiv.paid_recommendation_invites.create` Send a paid recommendations invite OAuth Scope: posts:write write - `beehiiv.paid_recommendation_invites.delete` Withdraw a paid recommendations invite OAuth Scope: posts:write destructive - `beehiiv.paid_recommendation_invites.list` List paid recommendations invites OAuth Scope: posts:read read **Polls 3** - `beehiiv.polls.get` Get poll OAuth Scope: polls:read read - `beehiiv.polls.list` List polls OAuth Scope: polls:read read - `beehiiv.polls.list_responses` List poll responses OAuth Scope: polls:read read **Workspaces 3** - `beehiiv.workspaces.identify` Identify workspace OAuth Scope: identify:read read - `beehiiv.workspaces.permissions` Get workspace permissions OAuth Scope: identify:read read - `beehiiv.workspaces.publications_by_subscription_email` Get publications by subscription email OAuth Scope: publications:read read **Authors 2** - `beehiiv.authors.get` Get author read - `beehiiv.authors.list` List authors read **Complimentary access 2** - `beehiiv.complimentary_access.get` Get complimentary access OAuth Scope: complimentary_access:read read - `beehiiv.complimentary_access.list` List complimentary access OAuth Scope: complimentary_access:read read **Condition sets 2** - `beehiiv.condition_sets.get` Get condition set OAuth Scope: condition_sets:read read - `beehiiv.condition_sets.list` List condition sets OAuth Scope: condition_sets:read read **Paid recommendation auto accept settings 2** - `beehiiv.paid_recommendation_auto_accept_settings.get` Get paid recommendations auto-accept settings OAuth Scope: posts:read read - `beehiiv.paid_recommendation_auto_accept_settings.update` Update paid recommendations auto-accept settings OAuth Scope: posts:write write **Paid recommendation reports 2** - `beehiiv.paid_recommendation_reports.get` Get paid recommendation partner report OAuth Scope: posts:read read - `beehiiv.paid_recommendation_reports.list` List paid recommendation partner reports OAuth Scope: posts:read read **Publication duplicates 2** - `beehiiv.publication_duplicates.create` Create publication duplicate OAuth Scope: publications:write write - `beehiiv.publication_duplicates.get` Get publication duplicate OAuth Scope: publications:read read **Publications 2** - `beehiiv.publications.get` Get publication OAuth Scope: publications:read read - `beehiiv.publications.list` List publications OAuth Scope: publications:read read **Subscription tags 2** - `beehiiv.subscription_tags.create` Add subscription tag OAuth Scope: subscriptions:write write - `beehiiv.subscription_tags.delete` Remove subscription tag OAuth Scope: subscriptions:write destructive **Advertisement opportunities 1** - `beehiiv.advertisement_opportunities.list` Get advertisement opportunities OAuth Scope: posts:read read **Bulk subscriptions 1** - `beehiiv.bulk_subscriptions.create` Bulk create subscription OAuth Scope: subscriptions:write write **Engagements 1** - `beehiiv.engagements.list` Get publication engagements OAuth Scope: publications:read read **Paid recommendation wallet 1** - `beehiiv.paid_recommendation_wallet.get` Get paid recommendations wallet OAuth Scope: posts:read read **Referral program 1** - `beehiiv.referral_program.list` Get referral program OAuth Scope: referral_program:read read **Users 1** - `beehiiv.users.identify` Identify user OAuth Scope: identify:read read 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. ## More connectors like beehiiv Shares the most action names with - [Kit 10](https://actionlake.com/connectors/kit) - [Circle 6](https://actionlake.com/connectors/circle) - [Qualtrics XM 5](https://actionlake.com/connectors/qualtrics-xm) - [LinkedIn Marketing API 4](https://actionlake.com/connectors/linkedin-marketing-api) - [Luma 4](https://actionlake.com/connectors/luma) - [Cvent 4](https://actionlake.com/connectors/cvent) Joins with, on shared entities - [Dotdigital 3](https://actionlake.com/connectors/dotdigital) - [GetResponse 3](https://actionlake.com/connectors/getresponse) - [MailerLite 3](https://actionlake.com/connectors/mailerlite) - [Elastic Email 3](https://actionlake.com/connectors/elastic-email) - [Klaviyo 2](https://actionlake.com/connectors/klaviyo) - [Twilio SendGrid 2](https://actionlake.com/connectors/twilio-sendgrid) Browse - [All Marketing & media connectors](https://actionlake.com/connectors/category/marketing-and-media) - [All connectors](https://actionlake.com/connectors) - [How actionlake compares](https://actionlake.com/compare) actionlake is independent. It is not made or endorsed by beehiiv; the name is the vendor's own. Counts are from the beehiiv service file, version 1.0.0. ## Give your agent beehiiv today. [Connect beehiiv free](https://actionlake.com/console?start=sandbox) [See pricing](https://actionlake.com/pricing) Start free - 100,000 calls/month, no card. No signup. Hard caps on every key. Cached answers are free. --- Source: https://actionlake.com/connectors/beehiiv More: https://actionlake.com/llms.txt