Skip to content

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.json
index 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.md
index 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 structure
diff --git a/third_party/ahrefs/.cursor-plugin/plugin.json b/third_party/ahrefs/.cursor-plugin/plugin.json
new file mode 100644
index 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.md
new file mode 100644
index 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/LICENSE
new file mode 100644
index 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.md
new file mode 100644
index 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
+
+MIT
diff --git a/third_party/ahrefs/assets/logo.png b/third_party/ahrefs/assets/logo.png
new file mode 100644
index 00000000..0b18006b
Binary files /dev/null and b/third_party/ahrefs/assets/logo.png differ
diff --git a/third_party/ahrefs/mcp.json b/third_party/ahrefs/mcp.json
new file mode 100644
index 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"
+ }
+ }
+}