[{"_1":2,"_325":-5,"_326":-5},"loaderData",{"_3":4,"_22":23,"_232":233},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":17,"_18":-5,"_19":20,"_21":-5},"attributes",[15],"bot","id",17365307,"membership","referenceId","0199a0f5-80f3-75d9-86a5-0e41e3be6810","userAccount","routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_24":25,"_26":-5,"_27":28,"_29":40,"_148":149,"_230":231},"availableLocales",[],"githubUser","locale",{"_29":30,"_33":37,"_38":39},"mcpServer",{"_31":32,"_33":34,"_35":36},"description","A Model Context Protocol server that connects Claude desktop and other compatible AI assistants to Ahrefs, allowing them to access Ahrefs functionality.","name","Ahrefs MCP Server","readme","> [!NOTE]\n> This repository is for the **local Ahrefs MCP server** which works with API v3 keys only. It **DOES NOT** work with MCP keys. We've also released a **remote Ahrefs MCP server**, which doesn't require local setup and works directly in popular AI tools. \n> \n> Learn more here: [Remote MCP server documentation](https://docs.ahrefs.com/docs/mcp/reference/introduction)\n\n# Ahrefs MCP\nA Model Context Protocol server to connect Claude desktop and other compatible AI assistants to Ahrefs.\n\n## Installation\n`npm` commands need to be executed in a terminal:\n- macOS: open the Terminal from your Applications folder\n- Windows: press Windows + R, type `cmd`, and press Enter\n### Install Node.js and npm\n1. Download Node.js from [nodejs.org](https://nodejs.org/en/download/)\n2. Follow the installation instructions for your operating system\n3. Verify installation by running:\n```sh\nnpm -v\n```\n4. A version number will be printed if installation was successful\n\n#### Windows Users\n- When installing Node.js, use the official installer and make sure the folder is added to PATH when selecting installation options.\n\n### Install Ahrefs MCP Server\n```sh\nnpm install --prefix=~/.global-node-modules @ahrefs/mcp -g\n```\n### Upgrading versions\nIf you've installed our MCP server before, and just want to upgrade, run this command:\n```sh\nnpm install --prefix=~/.global-node-modules @ahrefs/mcp@latest -g\n```\n\n## Configuration\nYou can now add the Ahrefs MCP to your favourite AI assistant app by adding the `ahrefs` part to your app's configuration file:\n```json\n{\n \"mcpServers\": {\n \"ahrefs\": {\n \"command\": \"npx\",\n \"args\": [\n \"--prefix=~/.global-node-modules\",\n \"@ahrefs/mcp\"\n ],\n \"env\": {\n \"API_KEY\": \"YOUR_API_KEY_HERE\"\n }\n }\n }\n}\n```\n\n### Specific for Windows OS\n```json\n{\n \"mcpServers\": {\n \"ahrefs\": {\n \"command\": \"npx\",\n \"args\": [\n \"--prefix=C:\\\\Users\\\\YOUR_USERNAME_HERE\\\\.global-node-modules\\\\node_modules\",\n \"@ahrefs/mcp\"\n ],\n \"env\": {\n \"API_KEY\": \"YOUR_API_KEY_HERE\"\n }\n }\n }\n}\n```\n1. Take note of the double escape backslashes\n2. Take note that the prefix directory is slightly different\n3. Take note of the forward slash for `@ahrefs/mcp`\n4. If you are working with Claude Desktop, run Ctrl-Alt-Del to open Task Manager and kill Claude Desktop. Otherwise, your newly changed config will not be loaded.\n\nTo learn more about creating or controlling API keys, refer to the [official documentation](https://docs.ahrefs.com/docs/api/reference/api-keys-creation-and-management).\n### Where to find the configuration file\n#### Claude Desktop\n1. Download Claude for Desktop\n2. Select `Settings...`\n\n

\n $\"Open$ \n

\n\n3. Click on `Developer` in the left panel, then `Edit Config`\n\n

\n $\"Open$ \n

\n\n4. Paste the configuration [above](#configuration) into the open file\n\n5. Restart the Claude app! If the installation is successful, it should look like this:\n\n

\n $\"ahrefs$ \n

\n\nIf you prefer directly navigating to the file, the paths are:\n- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\nIf there are any issues, please refer to the [official documentation](https://modelcontextprotocol.io/quickstart/user)\n#### Cursor\nCursor supports configurations that are either project-specific or global: the MCP configuration file will be at `.cursor/mcp.json` or `~/.cursor/mcp.json` respectively.\nFor more details, read the [official documentation](docs.cursor.com/context/model-context-protocol).\n\n## Common Installation Issues & Fixes\n\n### 1. Node.js or npm Not Installed / Recognized\n\n**Symptoms:**\n- Running `npm -v` shows an error like `command not found` or `'npm' is not recognized`.\n\n**Fix:**\n- Ensure you've installed Node.js from [nodejs.org](https://nodejs.org/en/download/).\n- Restart your terminal after installation.\n- On **Windows**, make sure the Node.js installer added `npm` to your PATH.\n\n**Platform-Specific Checks:**\n- **Windows:**\n Open Command Prompt (`Win + R → cmd`) and run:\n ```\n node -v\n npm -v\n ```\n- **macOS/Linux:**\n Open Terminal and run:\n ```\n which node && which npm\n ```\nIf it returns nothing, Node.js may not be in your `$PATH`.\n\n---\n\n### 2. Permission Errors During Global Installation\n\n**Symptoms:**\n- Errors like `EACCES: permission denied`, especially on macOS or Linux.\n\n**Fix:**\n- Install using a user-scoped global prefix as shown in the installation guide:\n ```sh\n npm install --prefix=~/.global-node-modules @ahrefs/mcp -g\n ```\n- This avoids requiring elevated privileges (`sudo`).\n\n**Extra Tip:**\nIf you used `sudo` previously and created permission issues, reset folder ownership:\n```sh\nsudo chown -R $(whoami) ~/.global-node-modules\n```\n### 2a. macOS Terminal Permissions\n\n**Symptoms:**\n- Terminal shows \"Operation not permitted\" errors\n- Unable to create folders or files\n- Permission denied messages when running npm commands\n\n**Fix:**\nCheck if Terminal has Full Disk Access:\n - Open System Settings (or System Preferences)\n - Go to Privacy & Security → Full Disk Access\n - Make sure Terminal.app is in the list and checked\n - If not present, click '+', navigate to Applications → Utilities → Terminal.app\n\n**Note:**\nModern macOS versions require explicit permissions for Terminal access. Without proper permissions, npm installations and other file operations may fail silently or with permission errors.\n\n---\n\n### 3. `npx` Cannot Find the Ahrefs MCP Command\n\n**Symptoms:**\n- Error: `Cannot find package '@ahrefs/mcp'`\n\n**Fix:**\nEnsure your config uses the same prefix used during install:\n```json\n\"command\": \"npx\",\n\"args\": [\n \"--prefix=~/.global-node-modules\",\n \"@ahrefs/mcp\"\n]\n```\n\n**Note:**\nDo **not** omit the `--prefix` unless you're installing globally system-wide (not recommended).\n\n---\n\n### 4. Configuration File Not Detected\n\n**Symptoms:**\n- Claude does not list the MCP under “tools”.\n\n**Fix:**\n- Make sure the config file path is correct:\n - **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n - **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n - **Linux:** (Rare, but if applicable) `~/.config/Claude/claude_desktop_config.json`\n- Double-check you pasted the configuration **inside the correct section** and restarted Claude after saving.\n\n---\n\n### 5. API Key Problems\n\n**Symptoms:**\n- MCP fails silently or throws an error about `API_KEY`.\n- Claude responds with a message that it ran into authentication issues.\n\n**Fix:**\nEnsure this line is present in the MCP config:\n```json\n\"env\": {\n \"API_KEY\": \"YOUR_API_KEY_HERE\"\n}\n```\nReplace `YOUR_API_KEY_HERE` with your actual key. Ensure that your API key settings give you the necessary permissions.\n\nFor more help, refer to [Ahrefs API key docs](https://docs.ahrefs.com/docs/api/reference/api-keys-creation-and-management).\n\n---\n\n### 6. Path Expansion Issues\n\n**Symptoms:**\n- Error messages containing `ENOENT` or \"no such file or directory\"\n- npm commands fail with path-related errors\n- `~` or environment variables not being expanded correctly\n\n**Fix:**\nUse absolute paths instead of relying on path expansion:\n\n**Windows:**\n```sh\nC:\\Users\\\\.global-node-modules\n```\nReplace `` with your actual Windows username.\n\n**macOS:**\n```sh\n/Users//.global-node-modules\n```\nReplace `` with your macOS username.\n\n**Linux:**\n```sh\n/home//.global-node-modules\n```\nReplace `` with your Linux username.\n\n**Example Configuration:**\n```json\n{\n \"mcpServers\": {\n \"ahrefs\": {\n \"command\": \"npx\",\n \"args\": [\n \"--prefix=/Users/username/.global-node-modules\", // Replace with your absolute path\n \"@ahrefs/mcp\"\n ],\n \"env\": {\n \"API_KEY\": \"YOUR_API_KEY_HERE\"\n }\n }\n }\n}\n```\n\n**How to Find Your Absolute Path:**\n\n**Windows:**\n1. Open Command Prompt\n2. Type `echo %USERPROFILE%`\n\n**macOS/Linux:**\n1. Open Terminal\n2. Type `echo $HOME`\n\n**Note:**\nUsing absolute paths eliminates issues with path expansion and ensures the configuration works regardless of environment variables or shell configurations.\n\n---\n\n## 🧪 Diagnostic Commands Per Platform\n\n| Issue | Windows Command | macOS/Linux Command |\n|-------|-----------------|---------------------|\n| Check Node version | `node -v && npm -v` | `node -v && npm -v` |\n| Check if MCP is installed | `npm list -g --prefix=%USERPROFILE%\\.global-node-modules @ahrefs/mcp` | `npm list -g --prefix=~/.global-node-modules @ahrefs/mcp`|\n| Clear corrupted install | Delete folder manually | `rm -rf ~/.global-node-modules` |\n\n---\n\n## 📍 Summary of Key Paths\n\n| Purpose | Windows | macOS | Linux |\n|----------|---------|-------|-------|\n| Claude config file | `%APPDATA%\\Claude\\claude_desktop_config.json` | `~/Library/Application Support/Claude/claude_desktop_config.json` | `~/.config/Claude/claude_desktop_config.json` (if applicable) |\n| Global MCP install location | `%USERPROFILE%\\.global-node-modules` | `~/.global-node-modules` | `~/.global-node-modules` |\n\n---\n\n## 📘 Still Having Issues?\n\n- Check the [official MCP documentation](https://modelcontextprotocol.io/quickstart/user)\n- Or reach out to internal support at Ahrefs through your usual engineering support channel.\n\nLet us know what errors you're seeing, along with your OS and the output of:\n```sh\nnpm list -g --prefix=~/.global-node-modules @ahrefs/mcp\n```\n","English","tag","en-US",{"_41":42,"_13":43,"_54":32,"_55":32,"_16":56,"_57":58,"_33":34,"_76":77,"_84":-5,"_85":-5,"_86":87,"_135":136,"_142":-5,"_65":115,"_143":144,"_68":145,"_146":147},"addedAt","2025-07-10T06:03:03.706180Z",[44,45,46,47,48,49,50,51,52,53],"author:official","category:search","category:web-scraping","category:marketing","environment:local","hosting:local-only","language:typescript","security_grade:a","quality_grade:a","license_grade:f","descriptionMarkdown","descriptionPlainText",9046,"integrations",[59,70],{"_60":61,"_31":67,"_68":69},"brand",{"_62":63,"_33":64,"_65":66},"logoSvgPath","M11.998,24c-0.321,0-0.641-0.084-0.922-0.247l-2.936-1.737c-0.438-0.245-0.224-0.332-0.08-0.383 c0.585-0.203,0.703-0.25,1.328-0.604c0.065-0.037,0.151-0.023,0.218,0.017l2.256,1.339c0.082,0.045,0.197,0.045,0.272,0l8.795-5.076 c0.082-0.047,0.134-0.141,0.134-0.238V6.921c0-0.099-0.053-0.192-0.137-0.242l-8.791-5.072c-0.081-0.047-0.189-0.047-0.271,0 L3.075,6.68C2.99,6.729,2.936,6.825,2.936,6.921v10.15c0,0.097,0.054,0.189,0.139,0.235l2.409,1.392 c1.307,0.654,2.108-0.116,2.108-0.89V7.787c0-0.142,0.114-0.253,0.256-0.253h1.115c0.139,0,0.255,0.112,0.255,0.253v10.021 c0,1.745-0.95,2.745-2.604,2.745c-0.508,0-0.909,0-2.026-0.551L2.28,18.675c-0.57-0.329-0.922-0.945-0.922-1.604V6.921 c0-0.659,0.353-1.275,0.922-1.603l8.795-5.082c0.557-0.315,1.296-0.315,1.848,0l8.794,5.082c0.57,0.329,0.924,0.944,0.924,1.603 v10.15c0,0.659-0.354,1.273-0.924,1.604l-8.794,5.078C12.643,23.916,12.324,24,11.998,24z M19.099,13.993 c0-1.9-1.284-2.406-3.987-2.763c-2.731-0.361-3.009-0.548-3.009-1.187c0-0.528,0.235-1.233,2.258-1.233 c1.807,0,2.473,0.389,2.747,1.607c0.024,0.115,0.129,0.199,0.247,0.199h1.141c0.071,0,0.138-0.031,0.186-0.081 c0.048-0.054,0.074-0.123,0.067-0.196c-0.177-2.098-1.571-3.076-4.388-3.076c-2.508,0-4.004,1.058-4.004,2.833 c0,1.925,1.488,2.457,3.895,2.695c2.88,0.282,3.103,0.703,3.103,1.269c0,0.983-0.789,1.402-2.642,1.402 c-2.327,0-2.839-0.584-3.011-1.742c-0.02-0.124-0.126-0.215-0.253-0.215h-1.137c-0.141,0-0.254,0.112-0.254,0.253 c0,1.482,0.806,3.248,4.655,3.248C17.501,17.007,19.099,15.91,19.099,13.993z","Node.js","slug","node-dot-js","Provides runtime environment for the Ahrefs MCP server, enabling connection between AI assistants and Ahrefs SEO platform","uid","7vl6iku7ts",{"_60":71,"_31":74,"_68":75},{"_62":72,"_33":73,"_65":73},"M1.763 0C.786 0 0 .786 0 1.763v20.474C0 23.214.786 24 1.763 24h20.474c.977 0 1.763-.786 1.763-1.763V1.763C24 .786 23.214 0 22.237 0zM5.13 5.323l13.837.019-.009 13.836h-3.464l.01-10.382h-3.456L12.04 19.17H5.113z","npm","Used for installing and managing the Ahrefs MCP server package","53unu9qs52","namespace",{"_78":79,"_65":83},"owner",{"_80":81},"githubAccount",{"_82":83},"login","ahrefs","readmeMarkdown","redditPostExternalId","repository",{"_88":89,"_100":101,"_104":105,"_123":-5,"_124":125,"_126":127,"_131":132},"argumentsJsonSchema",{"_90":91,"_97":98,"_95":99},"properties",{"_92":93},"API_KEY",{"_31":94,"_95":96},"Your Ahrefs API key","type","string","required",[92],"object","githubProject",{"_35":36,"_102":103},"url","https://github.com/ahrefs/ahrefs-mcp-server","githubRepository",{"_106":107,"_108":109,"_110":111,"_16":112,"_113":114,"_33":115,"_78":116,"_118":119,"_120":-5,"_121":122},"defaultBranch","main","fullName","ahrefs/ahrefs-mcp-server","githubTreeId",387235,19356,"language","TypeScript","ahrefs-mcp-server",{"_82":83,"_68":117},"4esklrbeg3","recentStargazers",3,"spdxLicense","stargazers",63,"glamaJson","inspectable",true,"npmPackage",{"_33":128,"_129":130},"@ahrefs/mcp","weeklyDownloads",90,"supportedPlatforms",[133,134],"WINDOWS","MACOS","scores",{"_137":138,"_139":140,"_141":140},"license",0,"quality",100,"security","simpleIcon","toolCount",42,"1cjpaf8j0i","updatedAt","2025-10-01T15:15:54.062571Z","meta",[150,153,155,162,165,167,170,173,176,179,182,184,187,190,192,194,196,198,200],{"_151":152},"title","Ahrefs MCP Server | Glama",{"_154":32,"_33":31},"content",{"_156":157,"_158":159,"_160":161},"href","https://glama.ai/mcp/servers/@ahrefs/ahrefs-mcp-server","rel","canonical","tagName","link",{"_154":34,"_163":164},"property","og:title",{"_154":32,"_163":166},"og:description",{"_154":168,"_163":169},"https://glama.ai/logo.png","og:logo",{"_154":171,"_163":172},"https://glama.ai/mcp/servers/@ahrefs/ahrefs-mcp-server/og-image","og:image",{"_154":174,"_163":175},"630","og:image:height",{"_154":177,"_163":178},"1200","og:image:width",{"_154":180,"_163":181},"website","og:type",{"_154":157,"_163":183},"og:url",{"_154":185,"_163":186},"Glama – MCP Hosting Platform","og:site_name",{"_154":188,"_33":189},"summary_large_image","twitter:card",{"_154":185,"_33":191},"twitter:title",{"_154":32,"_33":193},"twitter:description",{"_154":171,"_33":195},"twitter:image",{"_154":174,"_33":197},"twitter:image:height",{"_154":177,"_33":199},"twitter:image:width",{"_201":202},"script:ld+json",{"_203":204,"_205":206},"@context","http://schema.org","@graph",[207],{"_203":208,"_209":210,"_211":212},"https://schema.org","@type","BreadcrumbList","itemListElement",[213,220,224,227],{"_209":214,"_215":216,"_33":217,"_218":219},"ListItem","item","/","Glama","position",1,{"_209":214,"_215":221,"_33":222,"_218":223},"/mcp","MCP",2,{"_209":214,"_215":225,"_33":226,"_218":119},"/mcp/servers","Servers",{"_209":214,"_215":228,"_33":34,"_218":229},"/mcp/servers/@ahrefs/ahrefs-mcp-server",4,"visitorIsMaintainer",false,"routes/_public/mcp/servers/~namespace/~slug/_pages/_explorer/blob/~commit/~/_route",{"_234":235,"_29":241,"_262":263,"_148":274,"_272":298,"_299":300},"blob",{"_154":236,"_237":238,"_239":240},"{\n \"mcpServers\": {\n \"ahrefs\": {\n \"command\": \"npx\",\n \"args\": [\n \"@ahrefs/mcp\"\n ],\n \"env\": {\n \"API_KEY\": \"YOUR_API_KEY_HERE\"\n }\n }\n }\n}","fileName","mcp.json","size",238,{"_41":42,"_13":242,"_54":32,"_55":32,"_16":56,"_57":243,"_33":34,"_76":248,"_84":-5,"_85":-5,"_86":251,"_135":261,"_142":-5,"_65":115,"_143":144,"_68":145,"_146":147},[44,45,46,47,48,49,50,51,52,53],[244,246],{"_60":245,"_31":67,"_68":69},{"_62":63,"_33":64,"_65":66},{"_60":247,"_31":74,"_68":75},{"_62":72,"_33":73,"_65":73},{"_78":249,"_65":83},{"_80":250},{"_82":83},{"_88":252,"_100":256,"_104":257,"_123":-5,"_124":125,"_126":259,"_131":260},{"_90":253,"_97":255,"_95":99},{"_92":254},{"_31":94,"_95":96},[92],{"_35":36,"_102":103},{"_106":107,"_108":109,"_110":111,"_16":112,"_113":114,"_33":115,"_78":258,"_118":119,"_120":-5,"_121":122},{"_82":83,"_68":117},{"_33":128,"_129":130},[133,134],{"_137":138,"_139":140,"_141":140},"member",{"_264":265,"_268":269,"_270":238,"_110":111,"_271":231,"_272":238,"_273":125,"_239":240,"_95":234},"commit",{"_266":267},"sha","9c8c36d168c1bd8584decdc82173da2448e14a8b","contentStoredObjectPointerId",11100815,"fullPath","indexable","path","safeToDisplayAsText",[275,277,279,281,283,284,285,287,288,289,290,291,292,293,294,295,296,297],{"_151":276},"mcp.json | Ahrefs MCP Server | Glama",{"_154":278,"_33":31},"Enterprise-grade security, privacy, and features like agents, MCP, prompt templates, and more.",{"_156":280,"_158":159,"_160":161},"https://glama.ai/mcp/servers/@ahrefs/ahrefs-mcp-server/blob/9c8c36d168c1bd8584decdc82173da2448e14a8b/",{"_154":282,"_163":164},"mcp.json | Ahrefs MCP Server",{"_154":278,"_163":166},{"_154":168,"_163":169},{"_154":286,"_163":172},"https://glama.ai/generated-images/og?title=mcp.json+%7C+Ahrefs+MCP+Server",{"_154":174,"_163":175},{"_154":177,"_163":178},{"_154":180,"_163":181},{"_154":280,"_163":183},{"_154":185,"_163":186},{"_154":188,"_33":189},{"_154":185,"_33":191},{"_154":278,"_33":193},{"_154":286,"_33":195},{"_154":174,"_33":197},{"_154":177,"_33":199},"","treeMembers",[301,305,308,311,313,316,319,322],{"_264":302,"_270":303,"_272":303,"_95":304},{"_266":267},"images","tree",{"_264":306,"_270":307,"_272":307,"_95":304},{"_266":267},"src",{"_264":309,"_270":310,"_272":310,"_95":234},{"_266":267},".gitignore",{"_264":312,"_270":238,"_272":238,"_95":234},{"_266":267},{"_264":314,"_270":315,"_272":315,"_95":234},{"_266":267},"package.json",{"_264":317,"_270":318,"_272":318,"_95":234},{"_266":267},"package-lock.json",{"_264":320,"_270":321,"_272":321,"_95":234},{"_266":267},"README.md",{"_264":323,"_270":324,"_272":324,"_95":234},{"_266":267},"tsconfig.json","actionData","errors"]

MCP directory API