diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json index 052ee8f68..d97bab21e 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 000000000..58ec9a5da --- /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": "plugins@cursor.com" + }, + "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 000000000..8c70ef4b5 --- /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 000000000..ca2bba771 --- /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 000000000..c5228bd1a --- /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 000000000..8726b73eb 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 000000000..008d0fdc8 --- /dev/null +++ b/third_party/beehiiv/mcp.json @@ -0,0 +1,8 @@ +{ + "mcpServers": { + "beehiiv": { + "type": "http", + "url": "https://mcp.beehiiv.com/mcp" + } + } +}