--- title: Ahrefs remote MCP connector slug: agent-platform/docs/ahrefs-remote-mcp-connector createdAt: 2026-11-12T11:55:19.393Z --- The Ahrefs remote Model Context Protocol (MCP) connector in Mark (Optimizely Agent Platform) brings your Ahrefs search engine optimization (SEO) data into Mark. Use [Mark chat](docId\:dtNBEttEGVvkhNkwNypLM), [agents](docId\:w7MSVijPnuFqu4nXDo_bq), and [workflows](docId:2HD0fUsIsfdek516VtN9l) to analyze organic and paid traffic, rankings, backlinks, keywords, and AI search visibility from natural-language requests. :::hint{type="info"} **Note** Ahrefs manages the Ahrefs remote MCP. See the [Ahrefs MCP documentation](https://docs.ahrefs.com/en/mcp/docs/introduction) for available tools and data. ::: First, a [Mark administrator](docId\:pe0pbUJveWrG8ewvZWDRE) must [connect the Ahrefs remote MCP to Mark](docId:88r1zg1hFHC_efdqd_2tZ). After the administrator adds the MCP server, individual Mark [users](docId\:L0Ntt9JQmG6fQIJK_Y7C7) and [agent builders](docId\:HOJ_6dibwNf8Qz7WMIDie) log in to Ahrefs to access their data from Mark. Administrators only need to add the Ahrefs remote MCP once. ## Use cases The following use cases show how you can use Ahrefs connector tools in Mark to track AI search visibility, find keyword opportunities, diagnose traffic drops, prioritize tests, and build link targets. ### Report on AI search visibility every week **Goal** – Find out whether your brand appears when buyers ask AI assistants for vendor shortlists. **Weekly AI search visibility report** – Use the AI search tools to pull your share of voice and mentions against named competitors. The cited pages and cited domains results show which URLs the assistants quote, and the AI responses results show the questions where competitors appear and you do not. Mark then runs a content score on your weakest pages to check how easy they are for AI to read and quote. You get a weekly report with your share-of-voice trend, the gap questions, and the three to five pages to fix first. Example prompt: *Compare our AI share of voice with Adobe and Contentful in ChatGPT and AI Overviews this month. List the questions where we're missing and the competitor pages getting cited.* ### Turn a keyword gap into a content brief **Goal** – Target keywords that competitors already win, instead of guessing at topics. **Keyword gap analysis** – Mark finds your organic competitors and compares their keywords with yours. It sizes each gap by search volume, keyword difficulty, and traffic potential, checks who ranks now, and lists the topics a winning page must cover. Mark then writes the brief directly into a Content Marketing Platform (CMP) task with the target keyword, outline, required topics, and the pages to beat. You get a ranked list of opportunities and ready-to-assign briefs in CMP. Example prompt: *Find 10 keywords our top 3 competitors rank top-5 for that we don't rank for at all. Difficulty under 40. Create CMP briefs for the top 3.* ### Find the cause of an organic traffic drop **Goal** – Explain why organic sessions fell, not only that they fell. **Traffic drop investigation** – When Google Analytics 4 (GA4) flags an organic drop, Mark compares the two periods in Ahrefs to see which pages lost traffic, which keywords lost position, and how the overall keyword trend moved. It checks who took the top spots for those keywords and whether you lost backlinks or have new broken ones. This helps you separate a real anomaly from a known cause, such as an algorithm update or a competitor launch. This use case fits into the GA4 anomaly job of the Marketing Analyst Virtual Teammate. You get a root-cause section in the anomaly report with the affected pages, the lost keywords, the competitor that gained, and suggested fixes. Example prompt: *Organic sessions fell 18% week over week. Which pages and keywords lost ground, and who replaced us?* ### Choose which pages to A/B test **Goal** – Run conversion tests on pages with enough valuable traffic to reach a result quickly. **Test backlog** – The top pages report estimates how much organic traffic each page gets and what that traffic would cost in ads. Mark combines this with GA4 conversion rates to find pages with a lot of valuable traffic but weak conversion. Competitors' paid landing pages add ideas for messaging. Mark then writes test ideas, scores them with the Optimizely win-probability scoring, and checks how long each test needs to run. You get a ranked test backlog tied to traffic value, ready to build in Optimizely Web Experimentation. Example prompt: *Find our 5 pages with the most organic traffic value but conversion below the site average. Suggest and score 3 test ideas for each.* ### Build a link building and PR target list **Goal** – Replace gut feel and manual research with a prioritized outreach list. **Outreach list** – Mark finds broken links that point at your site, which are quick wins to fix with redirects. It lists the sites that link to several competitors but not to you, and compares Domain Rating and referring domains across competitors in one pass. It also adds the third-party sites that AI assistants cite most in your category, because coverage there improves both search and AI visibility. Mark adds the outreach list to CMP tasks or Slack. You get a prioritized outreach list with a reason for each target. Example prompt: *Find broken links pointing at us, plus sites linking to 2 or more of our competitors but not us. Rank them by Domain Rating and send the top 25 to #seo.* ## Connect the Ahrefs remote MCP to Mark The first person to connect a third-party service to Mark should be an administrator of that service. Administrator access installs the complete set of tools, so Mark adds every available tool. If a non-administrator connects the service first, Mark installs only the tools that account can access. ### Add Ahrefs connection As a Mark administrator, complete the following steps: 1. Go to **Connectors** in Mark. 2. (Optional) Enter *Ahrefs* in the search bar to filter the connectors list. 3. Click **Connect** on the **Ahrefs** tile. ![Ahrefs tile on the Connectors tab with a Connect button](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/IHHztlbd1GnDJx5v1820Z_ahref-s-connect.png) 4. Log in to Ahrefs. 5. On the **Choose your workspace** screen, select the Ahrefs workspace to connect. ![Ahrefs Choose your workspace screen listing a workspace and a Use another account link](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/jAvYE7oyWUf7Quw7VR_Wn_ahref-s-access.png) 6. On the **Allow access to your workspace** screen, review the request, and then click **Allow**. ![Ahrefs Allow access to your workspace screen with Allow and Cancel buttons](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/ir0zIZIiOjK7ztf6ZIYjd_ahref-s-access-2.png) A confirmation message displays, and you can close the pop-up window. ### Configure Mark tools After [adding the Ahrefs connection](docId:88r1zg1hFHC_efdqd_2tZ), Mark prompts you to select which tools to enable and optionally customize their display names. As a Mark administrator, complete the following steps: 1. Deselect any tools you do not want to add to Mark. 2. (Optional) Update any tool's display name. ![Connect Remote MCP Provider dialog listing Ahrefs tools to enable, with a Finish button](https://api.archbee.com/api/optimize/BrbvVORKJ5iIeSMZye5kI/ZkH6c3O6k0ls23axukjWG_connector-tools-finish.png) 3. Click **Finish**. The Ahrefs tile displays **Connect** on the **Connectors** tab for Mark users to authenticate with their personal accounts. To update the available tools or names, see [Update tools](docId:88r1zg1hFHC_efdqd_2tZ). ## Authenticate with Ahrefs Each Mark user and agent builder logs in to Ahrefs individually to access their data from Mark. User-level authentication ensures you access only the data your Ahrefs account is authorized to view. Before you begin, confirm that a Mark administrator has connected the Ahrefs remote MCP to Mark. Until an administrator connects it, the Ahrefs tile displays **Contact admin** instead of **Connect** and you cannot select it. To authenticate, complete the following steps in Mark: 1. Go to **Connectors**. 2. (Optional) Enter *Ahrefs* in the search bar to filter the connectors list. 3. Click **Connect** on the **Ahrefs** tile. 4. Log in to Ahrefs. After you log in, the Ahrefs connector tools are available in [Mark chat](docId\:dtNBEttEGVvkhNkwNypLM), [agents](docId\:w7MSVijPnuFqu4nXDo_bq), and [workflows](docId:2HD0fUsIsfdek516VtN9l). ## Ahrefs connector tools The Ahrefs remote MCP provides more than 100 tools, and the available tools depend on which tools your administrator enabled. For the full list of tools, see the [Ahrefs MCP documentation](https://docs.ahrefs.com/en/mcp/docs/introduction). The Ahrefs connector tools are grouped into the following categories: - **Site Explorer** – Read site metrics, top pages, organic keywords, organic competitors, keyword history, and paid pages. Use these tools to review organic and paid traffic and rankings, find organic competitors, and compare before-and-after results. - **Backlinks** – Read all backlinks, referring domains, broken backlinks, anchors, and pages by backlinks. Use these tools to review your link profile, see which sites link to you, find broken links worth fixing, and check anchor text. - **Keywords Explorer** – Read keyword overviews, matching and related terms, volume history, search engine results page (SERP) overviews, and content helper topics. Use these tools to check search volume, difficulty, and traffic potential, see who ranks now, and find the topics a page needs to cover. - **Brand Radar (AI search)** – Read share of voice, mentions, citations, cited pages, cited domains, and AI responses. Use these tools to see how often ChatGPT, Perplexity, and Google's AI answers mention or cite you compared with competitors. - **Rank Tracker and Search Console** – Read the rank tracker overview, competitor stats, and Google Search Console keywords, and manage projects and keywords. Use these tools to review tracked rankings, share of voice, and Search Console queries, and to create projects and add keywords. - **Site Audit and batch analysis** – Read Site Audit projects and run batch analysis. Use these tools to check technical site health and compare metrics for many domains side by side. Ahrefs also provides its own charts and tables, so Mark can return results as visuals. ## Update tools To rename, add, or remove tools, a Mark administrator must delete the Ahrefs tools registry and re-add it. Complete the following steps: 1. Follow the steps in [Delete a tool registry](docId\:SXjD3qqg-0gS2g4KajfyO). 2. [Add Ahrefs connection](docId:88r1zg1hFHC_efdqd_2tZ). 3. [Configure Mark tools](docId:88r1zg1hFHC_efdqd_2tZ). :::hint{type="info"} **Note** If you use Opti ID, administrators can turn off generative AI in the Opti ID Admin Center. See [Turn generative AI off across Optimizely applications](docId\:X5U0kKD2azV5cIdNqwGNj). :::