Cursor plugin specification and official plugins
TypeScript
Add Semrush third-party MCP plugin
Cursor Agente69c6a4ae67b
diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.jsonindex 361a80a2..4e600436 100644--- a/.cursor-plugin/marketplace.json+++ b/.cursor-plugin/marketplace.json@@ -202,6 +202,11 @@"name": "jotform","source": "third_party/jotform","description": "Create and edit forms, then read submissions."+ },+ {+ "name": "semrush",+ "source": "third_party/semrush",+ "description": "Research keywords, backlinks, traffic, and competitors."}]}diff --git a/README.md b/README.mdindex 45e4f1a1..175cf96c 100644--- a/README.md+++ b/README.md@@ -45,6 +45,7 @@ Official Cursor plugins for popular developer tools, frameworks, and SaaS produc| `brevo` | [Brevo](third_party/brevo/) | Cursor | Integrations | Manage contacts, email and SMS campaigns, and CRM deals. || `typeform` | [Typeform](third_party/typeform/) | Cursor | Integrations | Build forms, analyze responses, and manage contacts. || `jotform` | [Jotform](third_party/jotform/) | Cursor | Integrations | Create and edit forms, then read submissions. |+| `semrush` | [Semrush](third_party/semrush/) | Cursor | Integrations | Research keywords, backlinks, traffic, and competitors. |Author values match each plugin’s `plugin.json` `author.name` (Cursor lists `[email protected]` in the manifest).## Repository structurediff --git a/third_party/semrush/.cursor-plugin/plugin.json b/third_party/semrush/.cursor-plugin/plugin.jsonnew file mode 100644index 00000000..dc65454c--- /dev/null+++ b/third_party/semrush/.cursor-plugin/plugin.json@@ -0,0 +1,34 @@+{+ "name": "semrush",+ "displayName": "Semrush",+ "version": "1.0.0",+ "minClientVersions": {+ "cursor": "3.13.0"+ },+ "description": "Research keywords, backlinks, traffic, and competitors.",+ "author": {+ "name": "Cursor",+ "email": "[email protected]"+ },+ "homepage": "https://developer.semrush.com/api/v4/introduction/semrush-mcp/",+ "repository": "https://github.com/cursor/plugins",+ "license": "MIT",+ "logo": "assets/logo.png",+ "keywords": [+ "semrush",+ "seo",+ "keywords",+ "backlinks",+ "competitive-intelligence",+ "marketing",+ "mcp"+ ],+ "category": "integrations",+ "tags": [+ "semrush",+ "seo",+ "mcp",+ "marketing"+ ],+ "mcpServers": "./mcp.json"+}diff --git a/third_party/semrush/CHANGELOG.md b/third_party/semrush/CHANGELOG.mdnew file mode 100644index 00000000..440caeb1--- /dev/null+++ b/third_party/semrush/CHANGELOG.md@@ -0,0 +1,9 @@+# Changelog++All notable changes to this plugin will be documented here.++## 1.0.0 — initial release++- Added the `semrush` MCP server pointing at `https://mcp.semrush.com/v2/mcp`.+- Auth uses OAuth — no API key or client ID to configure.+- Logo: Semrush's official mark, from the `semrush` GitHub organization.diff --git a/third_party/semrush/LICENSE b/third_party/semrush/LICENSEnew file mode 100644index 00000000..ca2bba77--- /dev/null+++ b/third_party/semrush/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/semrush/README.md b/third_party/semrush/README.mdnew file mode 100644index 00000000..a02b45c5--- /dev/null+++ b/third_party/semrush/README.md@@ -0,0 +1,62 @@+# Semrush++Cursor plugin that connects agents to [Semrush](https://www.semrush.com) through Semrush's official remote [Model Context Protocol](https://modelcontextprotocol.io/) server.++Pull Semrush keyword, backlink, traffic, and competitive-intelligence data into the editor without leaving your work.++## Install++1. Open **Cursor Settings → Plugins**.+2. Search for **Semrush**.+3. Click **Install**, then complete the Semrush sign-in prompt.++Or run `/add-plugin semrush` in chat.++## MCP++```json+{+ "mcpServers": {+ "semrush": {+ "type": "http",+ "url": "https://mcp.semrush.com/v2/mcp"+ }+ }+}+```++Auth is OAuth 2.1 and the client registers itself, so Cursor just prompts for Semrush sign-in when the plugin connects — there is no client ID to configure.++## Before you connect++You need a Semrush plan that includes API units. MCP calls draw down the same API unit balance as the REST APIs, and Trends data additionally depends on your Trends subscription level.++## What agents can do++| Category | Capabilities |+| --- | --- |+| Keywords | Keyword overview, difficulty, related terms, and search volume by database |+| Domains | Domain overview, organic and paid competitors, and traffic estimates |+| Backlinks | Backlink profiles, referring domains, and anchor analysis |+| Trends | Traffic and market data, gated by your Trends subscription level |+| Projects | Read-only access to Projects API v3 |++The hosted runtime is the source of truth for tool names and schemas.++## Notes++- Access is read-only — the server does not write back to Semrush.+- Streamable HTTP is the only supported transport.+- Every call consumes API units from the account's balance, so prefer specific queries over broad crawls.+- `https://mcp.semrush.com/v1/mcp` is a stale URL that still circulates on aggregator sites. The current endpoint is `/v2/mcp`.++## Docs++- Semrush MCP: https://developer.semrush.com/api/v4/introduction/semrush-mcp/+- Server URL: https://mcp.semrush.com/v2/mcp++Logo is Semrush's official mark, from the `semrush` GitHub organization.++## License++MITdiff --git a/third_party/semrush/assets/logo.png b/third_party/semrush/assets/logo.pngnew file mode 100644index 00000000..705d823cBinary files /dev/null and b/third_party/semrush/assets/logo.png differdiff --git a/third_party/semrush/mcp.json b/third_party/semrush/mcp.jsonnew file mode 100644index 00000000..9b82586b--- /dev/null+++ b/third_party/semrush/mcp.json@@ -0,0 +1,8 @@+{+ "mcpServers": {+ "semrush": {+ "type": "http",+ "url": "https://mcp.semrush.com/v2/mcp"+ }+ }+}