# Beehiiv MCP Integration

> Crear, monetizar, crecer—una plataforma de boletines creada por personas que hacen boletines.

## Overview

| Property | Value |
|----------|-------|
| Category | Marketing & Ads |
| Type | PIPEDREAM |
| Tools | 12 |
| URL | https://jelou.ai/pt-br/marketplace/beehiiv |

## Available Tools (12)

### Add Subscriber

Create a new subscriber for a publication. Use **List Custom Fields** to discover available custom field names before passing `customFields`. Use **Get Publication Info** to get the publication ID. Set `reactivateExisting: true` to re-subscribe someone who previously unsubscribed. [See the documentation](https://developers.beehiiv.com/api-reference/subscriptions/create)

### Create Post

Create a new post (newsletter draft). Pass HTML content in the `content` parameter. The post is created as a draft by default — set `status: "confirmed"` to publish immediately. Use content tags to categorize the post. Use **Get Publication Info** to get the publication ID. [See the documentation](https://developers.beehiiv.com/api-reference/posts/create)

### Crear Suscriptor

Crea un nuevo suscriptor. [Ver la documentación](https://www.beehiiv.com/developers/docs)

### Get Post Analytics

Get aggregated analytics across all posts — open rates, click rates, unsubscribes, etc. Filter by audience (free/premium), platform (web/email), or content tags. Returns metrics: recipients, delivered, opens, unique_opens, open_rate, clicks, unique_clicks, click_rate, unsubscribes, spam_reports. Use **List Posts** to see individual post details. Use **Get Publication Info** to get the publication ID. [See the documentation](https://developers.beehiiv.com/api-reference/posts/aggregate-stats)

### Get Publication Info

Get details about the current beehiiv publication, including name, URL, and subscriber stats. **Call this first** to get the `publicationId` needed by all other tools. If you have multiple publications, pass the `publicationId` — otherwise the first publication is returned. Returns the publication name, description, URL, creation date, and subscriber count. [See the documentation](https://developers.beehiiv.com/api-reference/publications/index)

### Get Subscriber

Get full details for a single subscriber by ID or email. Use `expand` to include stats (open/click rates), custom field values, or referral data. Either `subscriptionId` or `email` must be provided. Use **Search Subscribers** to find subscriber IDs. Use **Get Publication Info** to get the publication ID. [See the documentation](https://developers.beehiiv.com/api-reference/subscriptions/get-by-id)

### Listar todas las publicaciones

Obtén una lista de todas tus publicaciones. [Ver la documentación](https://www.beehiiv.com/developers/docs)

### List Custom Fields

Schema discovery — list all custom fields defined for subscribers in a publication. Use this before **Create Subscriber** or **Update Subscriber** to know what custom fields are available and their expected types. Use **Get Publication Info** to get the publication ID. [See the documentation](https://developers.beehiiv.com/api-reference/custom-fields/index)

### List Posts

List posts (newsletter issues) for a publication. Filter by status, audience, platform, or content tags. Returns post titles, dates, status, and URLs. Use **Get Publication Info** to get the publication ID. Use **Get Post Analytics** for aggregate performance metrics across posts. [See the documentation](https://developers.beehiiv.com/api-reference/posts/index)

### List Segments

List subscriber segments for a publication. Segments are pre-defined subscriber groups (dynamic rules, static lists, or manual selections). Use this for discovery — to understand how subscribers are organized. Use **Get Publication Info** to get the publication ID. [See the documentation](https://developers.beehiiv.com/api-reference/segments/index)

### Search Subscribers

Search and filter subscribers for a publication. Use `email` for exact email lookup, or combine `status` and `tier` filters to narrow results. Use **Get Publication Info** to get the publication ID. For full details on a single subscriber (with stats, custom fields, referrals), use **Get Subscriber** instead. Use **List Custom Fields** to discover available custom field names. [See the documentation](https://developers.beehiiv.com/api-reference/subscriptions/index)

### Update Subscriber

Update an existing subscriber's fields or unsubscribe them. Use **Search Subscribers** or **Get Subscriber** to find the subscription ID first. Use **List Custom Fields** to discover available custom field names. Set `unsubscribe: true` to unsubscribe the subscriber. Use **Get Publication Info** to get the publication ID. [See the documentation](https://developers.beehiiv.com/api-reference/subscriptions/put)

## Supported Channels

This integration works with:
- WhatsApp Business API
- Facebook Messenger
- Instagram Direct Messages
- Web Chat Widget

## AI Assistants Compatible

- ChatGPT (via MCP)
- Claude (via MCP)
- Gemini (via MCP)
- Custom AI Agents

## Quick Start

1. Sign up at https://apps.jelou.ai/signup
2. Navigate to Marketplace and add Beehiiv
3. Authenticate your Beehiiv account
4. Configure your messaging channels (WhatsApp, Facebook, etc.)
5. Copy the MCP server URL to your AI assistant

## Example Use Cases

- Automate customer inquiries using Beehiiv data
- Send notifications via WhatsApp when Beehiiv events occur
- Query Beehiiv data directly from ChatGPT or Claude
- Build AI agents that interact with Beehiiv

## Resources

- [All Integrations](https://jelou.ai/pt-br/marketplace)
- [Full Documentation](https://jelou.ai/llms-full.txt)
- [API Docs](https://docs.jelou.ai)
- [Help Center](https://help.jelou.ai)