Cursor plugin specification and official plugins
TypeScript
Add Ahrefs third-party MCP plugin
Cursor Agent81b2a304a711
diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.jsonindex 4e600436..9e2959b8 100644--- a/.cursor-plugin/marketplace.json+++ b/.cursor-plugin/marketplace.json@@ -207,6 +207,11 @@"name": "semrush","source": "third_party/semrush","description": "Research keywords, backlinks, traffic, and competitors."+ },+ {+ "name": "ahrefs",+ "source": "third_party/ahrefs",+ "description": "Research keywords, backlinks, rankings, and site health."}]}diff --git a/README.md b/README.mdindex 175cf96c..acc4c91d 100644--- a/README.md+++ b/README.md@@ -46,6 +46,7 @@ Official Cursor plugins for popular developer tools, frameworks, and SaaS produc| `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. |+| `ahrefs` | [Ahrefs](third_party/ahrefs/) | Cursor | Integrations | Research keywords, backlinks, rankings, and site health. |Author values match each plugin’s `plugin.json` `author.name` (Cursor lists `[email protected]` in the manifest).## Repository structurediff --git a/third_party/ahrefs/.cursor-plugin/plugin.json b/third_party/ahrefs/.cursor-plugin/plugin.jsonnew file mode 100644index 00000000..9be3b2a4--- /dev/null+++ b/third_party/ahrefs/.cursor-plugin/plugin.json@@ -0,0 +1,34 @@+{+ "name": "ahrefs",+ "displayName": "Ahrefs",+ "version": "1.0.0",+ "minClientVersions": {+ "cursor": "3.13.0"+ },+ "description": "Research keywords, backlinks, rankings, and site health.",+ "author": {+ "name": "Cursor",+ "email": "[email protected]"+ },+ "homepage": "https://docs.ahrefs.com/mcp/docs/introduction",+ "repository": "https://github.com/cursor/plugins",+ "license": "MIT",+ "logo": "assets/logo.png",+ "keywords": [+ "ahrefs",+ "seo",+ "backlinks",+ "keywords",+ "rank-tracking",+ "site-audit",+ "mcp"+ ],+ "category": "integrations",+ "tags": [+ "ahrefs",+ "seo",+ "mcp",+ "backlinks"+ ],+ "mcpServers": "./mcp.json"+}diff --git a/third_party/ahrefs/CHANGELOG.md b/third_party/ahrefs/CHANGELOG.mdnew file mode 100644index 00000000..8c7bfe04--- /dev/null+++ b/third_party/ahrefs/CHANGELOG.md@@ -0,0 +1,9 @@+# Changelog++All notable changes to this plugin will be documented here.++## 1.0.0 — initial release++- Added the `ahrefs` MCP server pointing at `https://api.ahrefs.com/mcp/mcp`.+- Auth uses OAuth — no API key or client ID to configure.+- Logo: Ahrefs's official mark, from the `ahrefs` GitHub organization.diff --git a/third_party/ahrefs/LICENSE b/third_party/ahrefs/LICENSEnew file mode 100644index 00000000..ca2bba77--- /dev/null+++ b/third_party/ahrefs/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/ahrefs/README.md b/third_party/ahrefs/README.mdnew file mode 100644index 00000000..725ece79--- /dev/null+++ b/third_party/ahrefs/README.md@@ -0,0 +1,61 @@+# Ahrefs++Cursor plugin that connects agents to [Ahrefs](https://ahrefs.com) through Ahrefs's official remote [Model Context Protocol](https://modelcontextprotocol.io/) server.++Query live Ahrefs SEO data — backlinks, keyword metrics, rank tracking, and site audits — from the signed-in Ahrefs account.++## Install++1. Open **Cursor Settings → Plugins**.+2. Search for **Ahrefs**.+3. Click **Install**, then complete the Ahrefs sign-in prompt.++Or run `/add-plugin ahrefs` in chat.++## MCP++```json+{+ "mcpServers": {+ "ahrefs": {+ "type": "http",+ "url": "https://api.ahrefs.com/mcp/mcp"+ }+ }+}+```++Auth is OAuth. Cursor prompts for Ahrefs sign-in when the plugin connects, and the consent screen mints an MCP-scoped key on the Ahrefs side. Leave any OAuth client ID and secret blank.++## Before you connect++You need a paid Ahrefs plan (Lite or higher). MCP calls consume the plan's Integration API units, and the row cap per response scales with the tier — 100 on Lite, 250 on Standard, 500 on Advanced, unlimited on Enterprise.++## What agents can do++| Category | Capabilities |+| --- | --- |+| Site Explorer | Backlink profiles, referring domains, organic traffic, and top pages |+| Keywords Explorer | Keyword metrics, matching terms, and SERP overviews |+| Rank Tracker | Tracked keyword positions and visibility over time |+| Site Audit | Crawl results and technical SEO issues |++The hosted runtime is the source of truth for tool names and schemas.++## Notes++- Tool calls run as the Ahrefs user who authorizes the connection and consume that account's API units.+- Ahrefs MCP keys and API v3 keys are separate and not interchangeable. The OAuth consent screen creates the MCP-scoped key for you; you can also mint one under **Account Settings → API Keys → Generate MCP key** and send it as an `Authorization` header instead of using OAuth.+- The `@ahrefs/mcp` npm package is Ahrefs' old local server. Ahrefs has archived it and recommends against using it — this plugin uses the hosted server instead.++## Docs++- Ahrefs MCP introduction: https://docs.ahrefs.com/mcp/docs/introduction+- Connection settings (Copilot Studio): https://docs.ahrefs.com/mcp/docs/copilot-studio+- Server URL: https://api.ahrefs.com/mcp/mcp++Logo is Ahrefs's official mark, from the `ahrefs` GitHub organization.++## License++MITdiff --git a/third_party/ahrefs/assets/logo.png b/third_party/ahrefs/assets/logo.pngnew file mode 100644index 00000000..0b18006bBinary files /dev/null and b/third_party/ahrefs/assets/logo.png differdiff --git a/third_party/ahrefs/mcp.json b/third_party/ahrefs/mcp.jsonnew file mode 100644index 00000000..523e392b--- /dev/null+++ b/third_party/ahrefs/mcp.json@@ -0,0 +1,8 @@+{+ "mcpServers": {+ "ahrefs": {+ "type": "http",+ "url": "https://api.ahrefs.com/mcp/mcp"+ }+ }+}