MCP
Beehiiv
Manage your newsletter right inside Gumloop. The Beehiiv MCP node lets you publish posts, grow your subscriber base, and sync data to the rest of your workflow in just a few clicks.
List Segment Subscribers
Create a Subscription
Update a Subscription
List Tiers
Get a Single Post
A more efficient approach is to split the work:
Control every part of your Beehiiv publication - from posts to tiers - through one MCP-powered node.
What is Beehiiv MCP?
Beehiiv MCP turns plain-English prompts into Beehiiv API calls. Describe the outcome you need, and the node returns clean, structured data ready to flow into the next step of your automation.What Can It Do for You?
- Publish, update, or archive posts automatically
- Add or modify subscribers, tags, and custom fields
- Retrieve segments, tiers, and automations for targeted campaigns
- Pipe Beehiiv data into Google Sheets, Slack, and more for real-time reporting
Available Tools
| Tool | What It Does | Example Use |
|---|---|---|
| List Automations | List automations in a Beehiiv publication | ”List automations for publication ‘Tech Weekly Newsletter’ and return id, name, and status” |
| Create Custom Field | Create a custom field on a Beehiiv publication | ”Create a custom field called ‘company_size’ of type dropdown in publication ‘SaaS Insights’ and return field_id” |
| List Custom Fields | List all custom fields on a Beehiiv publication | ”List custom fields for publication ‘Marketing Digest’ and return name and field_id” |
| Create Post | Create a new post in a Beehiiv publication | ”Create a post titled ‘AI Tools Roundup - March 2024’ with status ‘draft’ in publication ‘Tech Weekly’ and return post_id and url” |
| List Posts | Retrieve posts belonging to a Beehiiv publication | ”List the 10 most recent posts in publication ‘Startup Stories’ and return post_id, title, and status” |
| Get Post | Retrieve a single post | ”Get post titled ‘Year in Review 2024’ from publication ‘Industry Analysis’ and return title, url, and status” |
| Delete Post | Archive or delete a post | ”Archive post ‘Test Email - Please Ignore’ in publication ‘Dev Newsletter’ and confirm success” |
| List Segments | List segments for a publication | ”List segments for publication ‘B2B Marketing’ and return segment_id and name” |
| Get Segment | Get details for one segment | ”Get segment ‘Premium Members’ from publication ‘Finance Daily’ and return name and subscriber_count” |
| List Segment Subscribers | List subscribers in a segment | ”List subscribers in segment ‘VIP Readers’ and return subscriber_id and email” |
| Create Subscription | Add a new subscriber | ”Subscribe sarah.jones@company.com to publication ‘Product Updates’ and return subscription_id and status” |
| List Subscriptions | List subscriptions for a publication | ”List active subscriptions for publication ‘Developer News’ and return email and status” |
| Get Subscription By Email | Retrieve a subscription by email | ”Get subscription for john.smith@example.com in publication ‘Cloud Computing Weekly’ and return subscription_id and tier” |
| Get Subscription | Retrieve a subscription by ID | ”Get subscription for user ‘mike@startup.io’ from publication ‘Founder’s Journey’ and return email, status, and tier” |
| Update Subscription | Update subscription details | ”Update subscription for emma@tech.com to tier ‘Premium’ and return status” |
| Delete Subscription | Remove a subscription | ”Delete subscription for test@testaccount.com from publication ‘Beta Newsletter’ and confirm removal” |
| Add Subscription Tag | Tag a subscription | ”Add tag ‘enterprise_customer’ to subscription for cto@bigcorp.com and return updated_tags” |
| List Tiers | List tiers for a publication | ”List tiers for publication ‘Creator Economy’ and return tier_id, name, and price” |
| Create Tier | Create a new tier | ”Create a tier called ‘Founding Member’ priced at 25 USD/month in publication ‘Indie Hackers Weekly’ and return tier_id” |
How to Use
1
Create Your Beehiiv MCP Node
Go to your node library, search for Beehiiv, and click “Create a node with AI”
2
Add Your Prompt
Drag the Beehiiv MCP node to your canvas and add your prompt in the text box.
3
Test Your Node
Run the node to see the results. If it works as expected, you’re all set! If you run into issues, check the troubleshooting tips below.
4
Save and Reuse
Once your Beehiiv MCP node is working, save it to your library. You can now use this customized node in any workflow.
Example Prompts
With 19 available tools, these examples show common use cases. Feel free to adapt them for your publication. Create a PostStart with a clear, focused action such as “List posts” or “Create subscription”. Once that works smoothly, chain multiple Beehiiv nodes together for advanced automation.
Troubleshooting
If your Beehiiv MCP node isn’t working as expected, try these best practices:Keep Prompts Simple and Specific
- Good: “List posts in publication 987 and return post_id and title”
- Needs Improvement: “List posts, then create a draft post, and finally email me the results”
For best results, give Beehiiv MCP one clear task. Combine multiple nodes to build multi-step workflows.
Match What Beehiiv Can Do
- Good: “Add tag ‘VIP’ to subscription 321”
- Needs Improvement: “Generate an email newsletter design and then post it to Beehiiv”
Beehiiv MCP excels at newsletter data management. Design generation would be outside of the capabilities of this MCP server.
Break Complex Tasks Into Steps
Trying to handle everything in one prompt can cause timeouts and make debugging harder:1
Step 1: Create Segment
Create a segment named “Black Friday USA” in publication 987 and return segment_id
2
Step 2: List Subscriptions
List subscriptions in publication 987 filtered by country = “USA” and return subscription_id
3
Step 3: Add Tags
Add tag “Sale” to the provided
subscription_ids in publication 987 and return updated_tags4
Step 4: Create Post
Create a post titled “Black Friday Deals” with status draft in publication 987 and return post_id
Connect these nodes sequentially in your workflow. For example, pass the
segment_id output from Step 1 to any later steps that need it.Focus on Data Retrieval
Beehiiv MCP is great at getting information from your publication. For analysis or content creation, hand the data off to other nodes. Example:- Good prompt: “Get post 789 and return title and url”
- Needs Improvement: “Get post 789, summarize its content, and generate three tweet ideas”
Use Beehiiv MCP to retrieve the post, then send the content to Ask AI for summarization or idea generation.
Troubleshooting Node Creation
Empty Outputs
Empty Outputs
In the node creation window, click “Request changes” and ask the AI to add debug logs and verify the API response.
Incorrect Results
Incorrect Results
In the node creation window, click “Request changes” and describe what you expected versus what you received.
Errors
Errors
First click “Fix with Gummie”. If multiple attempts fail, simplify your prompt or contact support.
Iterate with Request Changes
Iterate with Request Changes
MCP node creation often requires a few tweaks. Use “Request changes” (in the node creation window) to refine filters, output fields, or pagination.
Need More Help?
- Watch What are MCP Nodes video tutorial
- Check out MCP Best Practices in Gumloop University
- Join the Gumloop Community for support
- View the Beehiiv MCP setup guide for Claude and Cursor
- Contact support at support@gumloop.com