Skip to content

Cursor plugin specification and official plugins

TypeScript

feat(third_party): add beehiiv plugin

Minu Palaniappan2dac565540e4
diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json
index 052ee8f6..d97bab21 100644
--- a/.cursor-plugin/marketplace.json
+++ b/.cursor-plugin/marketplace.json
@@ -467,6 +467,11 @@
"name": "tinyfish",
"source": "third_party/tinyfish",
"description": "Browse and automate the web with TinyFish: run multi-step web automations, search the web, extract clean page content, and drive remote stealth browser sessions."
+ },
+ {
+ "name": "beehiiv",
+ "source": "third_party/beehiiv",
+ "description": "Run your beehiiv newsletter from chat: draft and edit posts, organize subscribers with tags, custom fields, and segments, build automations, and review publication, post, and website performance."
}
]
}
diff --git a/third_party/beehiiv/.cursor-plugin/plugin.json b/third_party/beehiiv/.cursor-plugin/plugin.json
new file mode 100644
index 00000000..58ec9a5d
--- /dev/null
+++ b/third_party/beehiiv/.cursor-plugin/plugin.json
@@ -0,0 +1,36 @@
+{
+ "name": "beehiiv",
+ "displayName": "beehiiv",
+ "version": "1.0.0",
+ "minClientVersions": {
+ "cursor": "3.13.0"
+ },
+ "description": "Run your beehiiv newsletter from chat: draft and edit posts, organize subscribers with tags, custom fields, and segments, build automations, and review publication, post, and website performance.",
+ "author": {
+ "name": "Cursor",
+ "email": "[email protected]"
+ },
+ "homepage": "https://www.beehiiv.com/support/article/39255979546263-getting-started-with-the-beehiiv-mcp",
+ "repository": "https://github.com/cursor/plugins",
+ "license": "MIT",
+ "logo": "assets/logo.png",
+ "keywords": [
+ "beehiiv",
+ "newsletter",
+ "email marketing",
+ "subscribers",
+ "segments",
+ "posts",
+ "automations",
+ "creator",
+ "mcp"
+ ],
+ "category": "integrations",
+ "tags": [
+ "beehiiv",
+ "newsletter",
+ "email",
+ "mcp"
+ ],
+ "mcpServers": "./mcp.json"
+}
diff --git a/third_party/beehiiv/CHANGELOG.md b/third_party/beehiiv/CHANGELOG.md
new file mode 100644
index 00000000..8c70ef4b
--- /dev/null
+++ b/third_party/beehiiv/CHANGELOG.md
@@ -0,0 +1,9 @@
+# Changelog
+
+All notable changes to this plugin will be documented here.
+
+## 1.0.0 — initial release
+
+- Added the `beehiiv` MCP server pointing at beehiiv's hosted Streamable HTTP endpoint (`https://mcp.beehiiv.com/mcp`).
+- Auth uses OAuth with beehiiv user login (PKCE, dynamic client registration on `mcp.beehiiv.com`) — no API key or client ID to configure. Registration was verified to accept every Cursor redirect set, including Grok Bot mobile.
+- Logo: beehiiv's official hive mark, from the app icon published on beehiiv.com, on a 192×192 tile.
diff --git a/third_party/beehiiv/LICENSE b/third_party/beehiiv/LICENSE
new file mode 100644
index 00000000..ca2bba77
--- /dev/null
+++ b/third_party/beehiiv/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cursor
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/third_party/beehiiv/README.md b/third_party/beehiiv/README.md
new file mode 100644
index 00000000..c5228bd1
--- /dev/null
+++ b/third_party/beehiiv/README.md
@@ -0,0 +1,68 @@
+# beehiiv
+
+Cursor plugin that connects agents to [beehiiv](https://www.beehiiv.com) through beehiiv's official remote [Model Context Protocol](https://modelcontextprotocol.io/) server.
+
+Draft and edit newsletter posts in your own voice, organize subscribers with tags, custom fields, and segments, build automation workflows, and pull publication, post, podcast, and website performance into chat.
+
+## Install
+
+1. Open **Cursor Settings → Plugins**.
+2. Search for **beehiiv**.
+3. Click **Install**, then complete the beehiiv sign-in prompt.
+
+Or run `/add-plugin beehiiv` in chat.
+
+## MCP
+
+```json
+{
+ "mcpServers": {
+ "beehiiv": {
+ "type": "http",
+ "url": "https://mcp.beehiiv.com/mcp"
+ }
+ }
+}
+```
+
+Auth is OAuth. Cursor prompts for beehiiv sign-in when the plugin connects — there is no client ID or API key to configure. Each user signs in with their own beehiiv account, and the connection inherits that user's workspace role and permissions.
+
+## Before you connect
+
+You need a beehiiv account ([sign up](https://www.beehiiv.com)). The MCP is available on every plan: free plans get read-only access, and write actions — creating and editing posts, managing segments, building automations — require a [paid beehiiv plan](https://www.beehiiv.com/pricing). Each connection is tied to one workspace; to work across several workspaces, add the server again with a distinct query string such as `https://mcp.beehiiv.com/mcp?account=2` and sign each one into a different account.
+
+## What agents can do
+
+| Category | Capabilities |
+| --- | --- |
+| Content and posts | Create and edit post drafts, manage post templates and content tags, and read past posts and their content to match tone and structure |
+| Audience and subscribers | Look up subscribers and their engagement, create and manage subscriber tags and custom fields, build segments and condition sets, and set up surveys and polls |
+| Growth and acquisition | Manage signup flows, subscribe forms and form themes, and view, discover, and manage recommendations |
+| Monetization | View ad network opportunities and offers and direct sponsorship agreements (read-only), manage paid products and tiers, and view paywalls |
+| Automations | Build and configure automation workflows and the emails inside them |
+| Podcasts | View show and episode data, episode stats, and transcripts |
+| Website | Edit page metadata such as SEO titles and descriptions, manage redirects, and view website analytics |
+| Analytics | Publication, post, and website performance: subscriber growth, opens, clicks, deliveries, and traffic breakdowns |
+| Other | Upload and manage image assets, manage guest authors, and manage external RSS feeds |
+
+The hosted runtime is the source of truth for tool names and schemas.
+
+## Notes
+
+- Write actions change your live workspace: editing a draft, tagging subscribers, saving a segment, or changing a product tier takes effect immediately for your real audience. Confirm what the agent is about to change before it runs.
+- Publishing, scheduling, and sending posts are not available through the MCP and must be done in the beehiiv app; the agent can prepare a draft but cannot send it. Automations built via the MCP likewise stay inactive until you activate them in the app.
+- beehiiv evolves MCP tools continuously and does not version them. If new tools do not appear, disconnect and reconnect the plugin.
+
+## Docs
+
+- Getting started with the beehiiv MCP: https://www.beehiiv.com/support/article/39255979546263-getting-started-with-the-beehiiv-mcp
+- What you can do with the beehiiv MCP: https://www.beehiiv.com/support/article/41262491804439-what-you-can-do-with-the-beehiiv-mcp
+- MCP overview: https://www.beehiiv.com/features/mcp
+- API reference: https://developers.beehiiv.com
+- Server URL: https://mcp.beehiiv.com/mcp
+
+Logo is beehiiv's official mark.
+
+## License
+
+MIT
diff --git a/third_party/beehiiv/assets/logo.png b/third_party/beehiiv/assets/logo.png
new file mode 100644
index 00000000..8726b73e
Binary files /dev/null and b/third_party/beehiiv/assets/logo.png differ
diff --git a/third_party/beehiiv/mcp.json b/third_party/beehiiv/mcp.json
new file mode 100644
index 00000000..008d0fdc
--- /dev/null
+++ b/third_party/beehiiv/mcp.json
@@ -0,0 +1,8 @@
+{
+ "mcpServers": {
+ "beehiiv": {
+ "type": "http",
+ "url": "https://mcp.beehiiv.com/mcp"
+ }
+ }
+}