feat(third_party): add beehiiv plugin - #435
Merged
Merged
Conversation
Adds a marketplace plugin for beehiiv's hosted MCP server (https://mcp.beehiiv.com/mcp) so agents can draft and edit posts, manage subscriber tags and segments, build automations, and review newsletter performance. Auth is OAuth with PKCE and dynamic client registration on mcp.beehiiv.com; DCR was verified to accept every Cursor and Grok redirect set. Tracks Linear PGT-4589.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What this adds
A marketplace plugin for beehiiv, the newsletter platform, pointing at beehiiv's official hosted MCP server (
https://mcp.beehiiv.com/mcp, Streamable HTTP). Tracks Linear PGT-4589.Why now: 59 Grok Bot users hand-added
mcp.beehiiv.comas a custom MCP server in the last 30 days. beehiiv is part of a creator-tooling cluster (Buffer, Metricool, Kit, vidIQ) that neither ChatGPT nor Claude covers with a first-party connector.Tools (category-level): beehiiv does not publish a tool list for the MCP and does not version it (tools are added continuously and discovered at connect time), so the README documents capabilities by the categories in beehiiv's own docs — content and posts, audience and subscribers, growth, monetization, automations, podcasts, website, analytics, assets/guest authors/RSS — and states that the hosted runtime is the source of truth for tool names and schemas. Notable limits from the docs, called out in the README: publishing, scheduling, and sending posts and activating automations are not available via MCP (app only); free plans are read-only, write actions need a paid plan.
Files:
third_party/beehiiv/{.cursor-plugin/plugin.json, mcp.json, README.md, CHANGELOG.md, LICENSE, assets/logo.png}plus one appended entry in.cursor-plugin/marketplace.json.Auth verification
initializeagainsthttps://mcp.beehiiv.com/mcpreturns 401 with aWWW-Authenticateheader carrying aresource_metadatapointer (protected resource metadata).https://mcp.beehiiv.com; it advertises PKCE and dynamic client registration.grokbot://mcp/oauth/callback+https://www.cursor.com/bot/mcp/oauth/callback) and grok.com — no vendor allowlist work needed.What to review
plugin.jsonkeeps the eToro / TinyFish shape (same field set,minClientVersions.cursor3.13.0,category: integrations,mcpServers: ./mcp.json).https://beehiiv-marketing-images.s3.amazonaws.com/Redesign2023/favicon.png, 999×999), centered on a white 192×192 tile with 16px padding.node scripts/validate-plugins.mjsprintsAll plugins validated successfully.;plugin.jsonandmcp.jsonparse cleanly.marketplace.json, so expect a trivial array-tail conflict when merging these in sequence.Out of scope
Note
Low Risk
Additive third-party plugin and marketplace listing only; no changes to core app logic, though connected agents can perform live workspace writes per beehiiv OAuth permissions.
Overview
Adds a new beehiiv marketplace integration that wires Cursor to beehiiv’s hosted MCP at
https://mcp.beehiiv.com/mcp(HTTP MCP + OAuth/PKCE, no API keys in config).The change is mostly new
third_party/beehiivpackaging—plugin.json,mcp.json, README (capabilities, plan limits, and safety notes), changelog, license, and logo—and a new beehiiv entry appended to.cursor-plugin/marketplace.json.Reviewed by Cursor Bugbot for commit 2dac565. Bugbot is set up for automated code reviews on this repo. Configure here.