Ahrefs MCP | API Key Ahrefs MCP connector for AI agents

Tools your seo agent reaches for on Ahrefs MCP, scoped per user.

CALL ANY TOOL

Get backlinks, organic rankings, keyword ideas, site overviews, and competitor analysis.

ahrefsmcp_doc

Doc

Retrieve full OpenAPI documentation for Ahrefs API v3 and the corresponding MCP tools. Use this tool to get the input schema for any other Ahrefs tool.

Parameters

Name

Type

Required

Description

tool

string

Required

No description.

ahrefsmcp_gsc_pages

Gsc pages

ahrefsmcp_serp_overview

Serp overview

ahrefsmcp_gsc_keywords

Gsc keywords

ahrefsmcp_batch_analysis

Batch analysis

ahrefsmcp_render_scorecard

Render scorecard

ahrefsmcp_management_projects

Management projects

ahrefsmcp_gsc_page_history

Gsc page history

ahrefsmcp_management_locations

Management locations

ahrefsmcp_gsc_pages_history

Gsc pages history

ahrefsmcp_render_data_table

Render data table

ahrefsmcp_site_audit_issues

Site audit issues

ahrefsmcp_public_crawler_ips

Public crawler ips

ahrefsmcp_social_media_posts

Social media posts

ahrefsmcp_gsc_keyword_history

Gsc keyword history

ahrefsmcp_site_audit_projects

Site audit projects

ahrefsmcp_web_analytics_chart

Web analytics chart

ahrefsmcp_social_media_authors

Social media authors

ahrefsmcp_web_analytics_stats

Web analytics stats

ahrefsmcp_gsc_anonymous_queries

Gsc anonymous queries

ahrefsmcp_web_analytics_cities

Web analytics cities

ahrefsmcp_gsc_positions_history

Gsc positions history

ahrefsmcp_rank_tracker_overview

Rank tracker overview

ahrefsmcp_site_explorer_anchors

Site explorer anchors

ahrefsmcp_social_media_channels

Social media channels

ahrefsmcp_site_explorer_metrics

Site explorer metrics

ahrefsmcp_web_analytics_devices

Web analytics devices

ahrefsmcp_gsc_performance_history

Gsc performance history

ahrefsmcp_web_analytics_sources

Web analytics sources

ahrefsmcp_keywords_explorer_overview

Keywords explorer overview

Build your Agent

Drop the toolkit in, point it at the user, and your seo agent can use Ahrefs MCP from the first run.

import { ScalekitClient } from "@scalekit-sdk/node";
import { DynamicStructuredTool } from "@langchain/core/tools";
import { createReactAgent } from "@langchain/langgraph/prebuilt";
import { z } from "zod";

const sk = new ScalekitClient(envUrl, clientId, clientSecret);

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["ahrefsmcp"], toolNames: ["ahrefs_backlinks_get", "ahrefs_keywords_get", "ahrefs_keyword_ideas"] },
  pageSize: 100,
});

const lcTools = tools.map((t) => new DynamicStructuredTool({
  name: t.tool.definition.name,
  description: t.tool.definition.description,
  schema: z.object({}).passthrough(),
  func: async (args) => {
    const { data } = await sk.tools.executeTool({
      toolName: t.tool.definition.name,
      identifier: "user_123",
      params: args,
    });
    return JSON.stringify(data);
  },
}));

const agent = createReactAgent({ llm, tools: lcTools });

import { ScalekitClient } from "@scalekit-sdk/node";
import OpenAI from "openai";

const sk = new ScalekitClient(envUrl, clientId, clientSecret);
const openai = new OpenAI();

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["ahrefsmcp"], toolNames: ["ahrefs_backlinks_get", "ahrefs_keywords_get", "ahrefs_keyword_ideas"] },
  pageSize: 100,
});

const llmTools = tools.map((t) => ({
  type: "function",
  function: {
    name: t.tool.definition.name,
    description: t.tool.definition.description,
    parameters: t.tool.definition.input_schema,
  },
}));

const resp = await openai.responses.create({
  model: "gpt-4o", input: prompt, tools: llmTools,
});

import { ScalekitClient } from "@scalekit-sdk/node";
import Anthropic from "@anthropic-ai/sdk";

const sk = new ScalekitClient(envUrl, clientId, clientSecret);
const anthropic = new Anthropic();

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["ahrefsmcp"], toolNames: ["ahrefs_backlinks_get", "ahrefs_keywords_get", "ahrefs_keyword_ideas"] },
  pageSize: 100,
});

const llmTools = tools.map((t) => ({
  name: t.tool.definition.name,
  description: t.tool.definition.description,
  input_schema: t.tool.definition.input_schema,
}));

const msg = await anthropic.messages.create({
  model: "claude-sonnet-4-6", max_tokens: 1024,
  tools: llmTools,
  messages: [{ role: "user", content: prompt }],
});

import { Agent } from "@google/adk/agents";
import {
  MCPToolset, StreamableHTTPConnectionParams,
} from "@google/adk/tools/mcp";

const toolset = new MCPToolset({
  connectionParams: new StreamableHTTPConnectionParams({
    url: "https://mcp.scalekit.com/ahrefsmcp",
    headers: { Authorization: `Bearer ${userScopedToken}` },
  }),
});

const agent = new Agent({
  name: "agent", model: "gemini-2.0-flash",
  tools: await toolset.getTools(),
});

Try these prompts

Paste any prompt into your agent to start using Ahrefs MCP.

SEO research

Copy the prompt

Copied

Get backlinks for [domain].

Copy the prompt

Copied

List top organic keywords for [domain].

Copy the prompt

Copied

Get keyword ideas for [seed keyword].

Copy the prompt

Copied

Site overview for [domain].

Competitive analysis

Copy the prompt

Copied

Who are the top competitors of [domain]?

Copy the prompt

Copied

Compare DR between [domain A] and [domain B].

Copy the prompt

Copied

Find keyword gaps vs [competitor domain].

Copy the prompt

Copied

Which keywords does [competitor] rank for that we don't?

Opportunities

Copy the prompt

Copied

Keywords ranking 4-10 with KD below 30.

Copy the prompt

Copied

Pages with most backlinks on [domain].

Copy the prompt

Copied

New backlinks gained this month.

Copy the prompt

Copied

Lost backlinks in the last 30 days.

SEE HOW AUTH WORKS

Users authorize Ahrefs MCP once. Their credentials stay vaulted, every call is checked, and every action is logged.

Authorize

Your user connects

Ahrefs MCP

once. We tie it to their identity and the meetings they approved — no shared bot account, no org-wide access

Who:

user ‘A’

when:

Once per user

access:

Limited to user

Store

Their

Ahrefs MCP

token lives in a vault scoped to them. User A's meetings are never reachable by an agent acting for user B, even on the same connection

vault:

encrypted

scope:

per-user

tokens:

auto-refreshed

Resolve

When your agent calls a

Ahrefs MCP

tool, we fetch the right token server-side. It never touches your agent, never appears in the LLM context, never shows up in your logs

speed:

~40ms

check:

before every call

seen by:

nobody

Audit

Every

Ahrefs MCP

tool call is logged — who triggered it, which meeting was fetched, what came back. 90 days of history, tied to the user who authorized it

history:

90 days

export:

SIEM-ready

logged:

every call

Test other agents

Same per-user auth pattern across other seo agents and MCP connectors. Working code, live demos, fork what fits.

GTM and RevOps Teams

Competitive intelligence briefing agent

Scans Gong calls for competitor mentions, matches each one to its Notion battlecard, and DMs every affected rep a single Slack digest per cycle. Every call runs as the PMM who owns the briefing, never a shared bot.

GTM and RevOps Teams

Outbound prospecting agent

Searches Apollo for prospects matching your ICP, scores and ranks them, drafts personalized outreach in Gmail, and logs every send to Google Sheets. Mail goes out as the rep, not from a shared inbox.

GTM and RevOps Teams

Deal intelligence agent

Pulls recent Gong calls, scores deal risk with an LLM, cross-references the record in Attio, and DMs each owner their at-risk deals in Slack. Every read is scoped to that rep's own access.

Support and Ops Teams

Support triage agent

Fetches new Zendesk tickets, classifies them by type and urgency, searches the Notion knowledge base for an answer, and routes what it cannot resolve to Slack. Every call runs on the support agent's own delegated OAuth.

Why Scalekit

Secure your agent's access. Connectors ship in minutes

01.

Shared tokens break per-user analytics

A shared token looks fine in a demo. In production every call looks like a service account. Scalekit resolves the real user credential so attribution, audit, and scope stay accurate.

// shared token
 audit → bot_service_account
 user_filter → broken

 // scalekit
 audit → user_abc
 scope → enforced ✓

02.

Authentication is not authorization

03.

Multi-tenancy is architectural

04.

Ahrefs MCP today. Others tomorrow.

“Our agents act across Salesforce, Gong, Google Drive, and more, on behalf of every customer. Scalekit behind the scenes meant we can keep adding tools without ever rebuilding how credentials or tool calling work.”

Venu Madhav Kattagoni

Head of Engineering / Von

FAQs

Frequently Asked Questions

Does the agent access Ahrefs MCP as the user or as a shared key?

As the user. Each workspace member authorizes once and Scalekit resolves their credential at request time. Audit logs attribute every action to that user, not a shared service account.

Where is the Ahrefs MCP api key stored?

In Scalekit's managed AES-256 token vault, namespaced per tenant. Refresh is automatic. Revocation is a single dashboard action. Tokens never appear in prompts, logs, or LLM context.

Can I limit what the agent is allowed to do in Ahrefs MCP?

Yes. Pass a tool name filter to listScopedTools so the SEO agent only sees the subset you authorize. Pre-API-call scope checks block out-of-policy actions before the request reaches Ahrefs MCP.

What happens when a user revokes Ahrefs MCP access?

The connection is invalidated on the next tool call. Subsequent requests for that user fail closed with a clear error. Other users in the tenant remain unaffected. The event is logged for audit.

Can the agent analyze domains the user hasn't added to their Ahrefs project?

Yes. Ahrefs API access is not limited to tracked projects — the key grants access to Ahrefs' full database. Rate limits and credit usage apply per API key, scoped to the authorizing user's Ahrefs subscription.

On this page

Tool and actions Framework Compatibility Starter Prompt Auth Lifecycle Try Other Agents Why Scalekit