What Can It Do?
- Publish and manage posts automatically
- Add and update subscribers with tags and custom fields
- Retrieve segments and tiers for targeted campaigns
- Sync newsletter data with other tools for reporting
Where to Use It
In Agents (Recommended)
Add Beehiiv as a tool to any agent. The agent can then interact with your publication conversationally, choosing the right actions based on context. To add an MCP tool to your agent:- Open your agent’s configuration
- Click Add tools → Connect an app with MCP
- Search for the integration and select it
- Authenticate with your account
In Workflows (Via Agent Node)
For automated pipelines, use an Agent Node with Beehiiv tools. This gives you the flexibility of an agent within a deterministic workflow.As a Custom MCP Node
You can also create a standalone MCP node for a specific action. This generates a reusable node that performs one task, useful when you need the same operation repeatedly in workflows.- Go to your node library and search for the integration
- Click Create a node with AI
- Describe the specific action you want (e.g., “List the 10 most recent posts”)
- Test the node and save it for reuse
Custom MCP nodes are single-purpose by design. For tasks that require multiple steps or dynamic decision-making, use an agent instead.
Available Tools
| Tool | Description |
|---|---|
| List Automations | List automations in a publication |
| Create/List Custom Fields | Manage custom fields |
| Create Post | Create a new post |
| List Posts | Retrieve posts from a publication |
| Get Post | Get a single post |
| Delete Post | Archive or delete a post |
| List Segments | List segments for a publication |
| Get Segment | Get segment details |
| List Segment Subscribers | List subscribers in a segment |
| Create Subscription | Add a new subscriber |
| List Subscriptions | List subscriptions |
| Get/Update/Delete Subscription | Manage subscriptions |
| Add Subscription Tag | Tag a subscription |
| List/Create Tiers | Manage publication tiers |
Example Prompts
Use these with your agent or in the Agent Node: Create a post:Troubleshooting
| Issue | Solution |
|---|---|
| Agent not finding the right data | Use specific publication names or IDs |
| Action not completing | Check that you’ve authenticated with your Beehiiv API key |
| Unexpected results | The agent may chain multiple tools (e.g., finding a subscriber first, then updating). Review the agent’s reasoning to understand its approach. |
| Tool not available | Verify the tool is enabled in your agent’s MCP configuration |
Need Help?
- Agents documentation for setup and best practices
- Agent Node guide for workflow integration
- Gumloop Community for questions and examples
- Contact [email protected] for assistance
Use this integration directly in Claude or Cursor. Connect remotely via the Beehiiv MCP server using your Gumloop credentials.