How to Use the Beehiiv MCP in Windsurf

Q: How does Windsurf use the Beehiiv MCP Server to add subscribers?

Cascade calls createsubscription directly when it detects new sign-ups in your local Windsurf database. It handles the Beehiiv API call in the background and reports the result in your chat.

Q: Can I automate Beehiiv post drafts in Windsurf using this integration?

Cascade uses listposts and getpost to read your existing Beehiiv content. It then helps you write and format new drafts in Windsurf that match your publication's style.

Q: Does Windsurf support multi-step newsletter analysis with Beehiiv?

Cascade chains listpublications with getpoststats to compile a full Beehiiv performance report. You set the goal in Windsurf, and the agent runs the sequence to generate the local markdown file.

Q: How do I set up this Beehiiv tool in my Windsurf editor?

Open your mcpconfig.json file in your Windsurf directory. Add the MCP Server under the mcpServers block to let Cascade auto-discover your Beehiiv tools.

Run your Beehiiv newsletter growth loops autonomously inside Windsurf with Cascade executing multi-step subscriber and post updates.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Beehiiv MCP to Windsurf

Create your Vinkius account to connect Beehiiv to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Beehiiv with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate subscriber syncs in Windsurf

The `create_subscription` tool adds new readers to your database directly through Windsurf's Cascade interface. Cascade reads your local lead generation files, maps the fields, and runs this tool in sequence so you don't have to keep manually updating your Beehiiv audience list. You can command Cascade to audit your active Beehiiv readers using this MCP Server. It uses `list_subscriptions` and `get_subscription` to cross-reference your database and flag inactive accounts in your Windsurf workspace. That's how you keep your list clean.

Track newsletter metrics directly in Cascade

The `get_post_stats` tool pulls real-time performance metrics for your sent Beehiiv campaigns directly into your Windsurf workspace. Cascade grabs these Beehiiv performance numbers, writes them to your local markdown reports, and highlights which newsletter topics got the highest open rates. Chaining this with `list_posts` lets you compare recent Beehiiv performance. It builds a local performance trend chart in Windsurf without requiring you to manually export CSVs from your web dashboard.

Audit active publications and segments

The `list_publications` tool identifies your active Beehiiv channels so Cascade knows exactly where to push updates. This MCP Server lets your Windsurf agent inspect your Beehiiv setup to ensure your local drafts align with the target channel's settings. Cascade uses `list_segments` to find specific Beehiiv reader groups for targeted campaigns. By checking those segments against local Windsurf project data, you can plan your next send based on real-time audience breakdowns.

Setup guide

Set up Beehiiv MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Beehiiv MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Beehiiv payment history." If connected, Cascade will call the Beehiiv tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "beehiiv-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Beehiiv. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Beehiiv now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Beehiiv MCP in Windsurf

Cascade calls `create_subscription` directly when it detects new sign-ups in your local Windsurf database. It handles the Beehiiv API call in the background and reports the result in your chat.

Cascade uses `list_posts` and `get_post` to read your existing Beehiiv content. It then helps you write and format new drafts in Windsurf that match your publication's style.

Cascade chains `list_publications` with `get_post_stats` to compile a full Beehiiv performance report. You set the goal in Windsurf, and the agent runs the sequence to generate the local markdown file.

Open your `mcp_config.json` file in your Windsurf directory. Add the MCP Server under the `mcpServers` block to let Cascade auto-discover your Beehiiv tools.

Your Beehiiv subscriber emails and publication stats never touch third-party databases. This MCP integration runs in a secure, isolated sandbox on Vinkius, keeping your Windsurf workspace completely private.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript