Beehiiv MCP Server

A Model Context Protocol (MCP) server for Beehiiv analytics, providing read-only access to publications, posts, and segments data.

Features

Publications

• List all publications

• Get detailed publication information

Posts

• List posts with filtering options (status, audience, platform, etc.)

• Get detailed post information with optional content expansion

• Get aggregate statistics for all posts in a publication

Segments

• List all segments for a publication

• Get detailed segment information

Setup

1. Install dependencies:

2. Set your API key as an environment variable:

3. Update the MCP configuration file (mcp_config.json) with your API key and correct path to the server script.

Usage

As MCP Server

The server can be used with any MCP-compatible client. Update your MCP client configuration to include:

Testing

Run the test script to verify API connectivity:

Available Tools

• list_publications - List all accessible publications

• get_publication_details - Get detailed publication information

• list_posts - List posts with various filters

• get_post_details - Get detailed post information

• get_posts_summary_stats - Get aggregate post statistics

• list_segments - List publication segments

• get_segment_details - Get detailed segment information

API Key

Get your API key from the beehiiv developer portal.

API Documentation

• Publications API

• Posts API

• Segments API