Skip to content
MCP server

getdr

Look up Ahrefs Domain Rating for domains or URLs through a getdr backend

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, self-hosted, macOS
Runs
Locally
Version
0.2.1
Listing updated
2 days ago

About getdr

getdr is an open-source MCP server for marketing and seo. It runs locally on your machine and is started by your AI client.

This is a thin front for the getdr command-line tool. It makes no Ahrefs requests itself: each call goes either to a getdr server on your network or to the getdr binary on your PATH, and either way returns the same JSON records.

Ahrefs publishes a free Domain Rating endpoint that costs no API units, but each request still needs a free Ahrefs API key. getdr keeps results in a local SQLite cache, so repeat lookups cost no request, and running getdr serve lets one machine hold the key and cache for scripts and agents across a network. Targets are normalised: a URL is reduced to its host, www is dropped and duplicates are removed.

The record for each target holds the DR value, the formula version (dr3 or dr4), a check timestamp and whether it came from cache. A null DR means Ahrefs has no data.

Install

Run in a terminal

claude mcp add getdr-mcp --env GETDR_SERVE_TOKEN='<GETDR_SERVE_TOKEN>' -- npx -y getdr-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "getdr-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "getdr-mcp"
      ],
      "env": {
        "GETDR_SERVE_TOKEN": "<GETDR_SERVE_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "getdr-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "getdr-mcp"
      ],
      "env": {
        "GETDR_SERVE_TOKEN": "<GETDR_SERVE_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "getdr-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "getdr-mcp"
      ],
      "env": {
        "GETDR_SERVE_TOKEN": "<GETDR_SERVE_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "getdr-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "getdr-mcp"
      ],
      "env": {
        "GETDR_SERVE_TOKEN": "<GETDR_SERVE_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "getdr-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "getdr-mcp"
      ],
      "env": {
        "GETDR_SERVE_TOKEN": "<GETDR_SERVE_TOKEN>"
      }
    }
  }
}

Configuration

  • GETDR_APIURL of a getdr server (getdr serve). When unset, the getdr binary on PATH is used.
  • GETDR_SERVE_TOKENBearer token for the getdr server, if it requires one.

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

get_dr
Ahrefs Domain Rating (0-100) for domains or URLs, via getdr by Index Pages.

What it does

Single get_dr tool
One tool takes a list of domains or URLs and returns one record per target.
Two backends
Uses a getdr server through GETDR_API, or the getdr binary on PATH.
Formula choice
Selects dr3 or dr4; the values are not comparable between versions.
Cache control
A fresh flag skips the cache and fetches again.
Structured output
Returns a JSON array and structuredContent on newer MCP clients.

Good for

  • Check domain authority for a list of link prospects
  • Compare a competitor's DR with your own inside a chat
  • Share one Ahrefs key across a team through a getdr server
  • Track how a domain's rating has moved since the last check

Pricing

Open source

Free and open source (MIT); requires a free Ahrefs API key

Prices change. Check index-pages.com before you buy.

getdr FAQ

Do I need an Ahrefs account?

Yes, a free Ahrefs account and API key; the DR endpoint costs no API units.

What does it need to run?

Node.js 18 or later, plus either the getdr binary or a getdr server.

What happens with an invalid target?

The record carries an invalid target error, and DR is null when Ahrefs has no data.

How long can a call take?

Calls time out after 120 seconds.

Is getdr free?

Yes. getdr is open source, so you can use and self-host it for free.

How do I add getdr to Claude Code?

Run this command in your terminal: claude mcp add getdr-mcp --env GETDR_SERVE_TOKEN='<GETDR_SERVE_TOKEN>' -- npx -y getdr-mcp

What are the best alternatives to getdr?

The closest alternatives to getdr are Google Ads + Meta Ads + SEO/GEO MCP, Calven, MCP, Red Center Studio free tools and ASOScan.

Alternatives to getdr

  1. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  2. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  3. MCP

    MCP server

    MCP server for planning, scheduling and measuring social and ad campaigns with approvals

    • Remote
    • Freemium
    • Marketing and SEO
  4. Free website checks for AI readiness, DNS dependencies, domain health and Bubble errors

    • 5 tools
    • Remote
    • Free
    • Marketing and SEO
  5. ASOScan

    MCP server

    ASO data for your own iOS and Android apps: rankings, keywords, reviews, scores

    • Remote
    • Free trial
    • Marketing and SEO
  6. PostBaton

    MCP server

    Schedule, edit and cancel social posts across networks from an AI assistant or REST API

    Not checked yet
    • Remote
    • Freemium
    • Marketing and SEO