Ahrefs Universal MCP Server

What is Ahrefs Universal MCP Server about?

It implements an Ahrefs Universal MCP server that exposes Ahrefs's SEO tools and services via a unified, MCP‑compliant API.

How to use Ahrefs Universal MCP Server?

1. Prerequisites: Python 3.11+, install uv (pip install uv).
2. Install dependencies: uv sync.
3. Activate the virtual environment:
   • Linux/macOS: source .venv/bin/activate
   • Windows PowerShell: .venv\Scripts\Activate
4. Start the MCP inspector: mcp dev src/universal_mcp_ahrefs/server.py (note the address/port shown).
5. Install the application: mcp install src/universal_mcp_ahrefs/server.py.
6. Access the service through the displayed endpoint or via the Ahrefs integration on agentr.dev.

Key features of Ahrefs Universal MCP Server

• MCP‑specification compliance for seamless integration with other MCP services.
• Unified API surface covering all Ahrefs tools (see src/universal_mcp_ahrefs/README.md).
• Simple local development workflow with uv and the mcp CLI.
• Clearly defined project structure separating server entry point, application tools, and tests.
• MIT‑licensed, easy to extend or embed in larger workflows.

Use cases of Ahrefs Universal MCP Server

• Automate backlink, keyword, and site‑audit data retrieval for SEO dashboards.
• Integrate Ahrefs data into custom AI agents or analytics pipelines.
• Build internal tools that require consistent Ahrefs API access without handling raw HTTP calls.
• Enable multi‑service orchestration where Ahrefs data is combined with other MCP‑compliant services.

FAQ from the Ahrefs Universal MCP Server

Q: Which Ahrefs API credentials are needed? A: Set your Ahrefs API key in the .env file (e.g., AHREFS_API_KEY=your_key). The server reads it at runtime.

Q: Can I run the server in production? A: Yes, after local testing you can containerize the project or deploy the Python entry point with any WSGI/ASGI server.

Q: Where can I find the list of available tools? A: In src/universal_mcp_ahrefs/README.md and via the MCP inspector UI after starting the server.

Q: Is there a Node.js version? A: The current implementation is Python‑based; you can still interact with it using the mcp CLI from any language.

Q: How do I contribute? A: Fork the repository, make changes, and submit a pull request. Ensure tests pass with pytest.

Ahrefs Universal MCP Server

This repository contains an implementation of an Ahrefs Universal MCP (Model Context Protocol) server. It provides a standardized interface for interacting with Ahrefs's tools and services through a unified API.

The server is built using the Universal MCP framework.

This implementation follows the MCP specification, ensuring compatibility with other MCP-compliant services and tools.

Usage

You can start using Ahrefs directly from agentr.dev. Visit agentr.dev/apps and enable Ahrefs.

If you have not used universal mcp before follow the setup instructions at agentr.dev/quickstart

Available Tools

The full list of available tools is at ./src/universal_mcp_ahrefs/README.md

Local Development

📋 Prerequisites

Ensure you have the following before you begin:

• Python 3.11+ (recommended)
• uv (install globally with pip install uv)

🛠️ Setup Instructions

Follow the steps below to set up your development environment:

1. Sync Project Dependencies

   uv sync
   

   This installs all dependencies from pyproject.toml into a local virtual environment (.venv).

2. Activate the Virtual Environment

   For Linux/macOS:

   source .venv/bin/activate
   

   For Windows (PowerShell):

   .venv\Scripts\Activate
   

3. Start the MCP Inspector

   mcp dev src/universal_mcp_ahrefs/server.py
   

   This will start the MCP inspector. Make note of the address and port shown in the console output.

4. Install the Application

   mcp install src/universal_mcp_ahrefs/server.py
   

📁 Project Structure

.
├── src/
│   └── universal_mcp_ahrefs/
│       ├── __init__.py       # Package initializer
│       ├── server.py            # Server entry point
│       ├── app.py            # Application tools
│       └── README.md         # List of application tools
├── tests/                    # Test suite
├── .env                      # Environment variables for local development
├── pyproject.toml            # Project configuration
└── README.md                 # This file

📄 License

This project is licensed under the MIT License.

---

Generated with MCP CLI — Happy coding! 🚀