# Mozscape MCP

> Mozscape connects your AI agent to deep SEO data, letting you audit link profiles, check domain authority, and analyze site metrics using natural language. It fetches Domain Authority (DA), Page Authority (PA), Spam Scores, Brand Authority™, and lists inbound links across multiple URLs or domains instantly.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** seo, backlinks, domain-authority, link-building, competitor-analysis

## Description

You connect your AI agent to Mozscape for deep-dive SEO work. Stop guessing about site health; let your agent run the complex API calls and spit out structured data so you know exactly where you stand on Google's radar.

**Analyzing Core Site Metrics**
When you need basic site stats, you can grab core metrics like Domain Authority (DA), Page Authority (PA), and Spam Scores. Use `fetch_site_metrics` for a single URL check, or if you got a big batch of URLs—up to fifty, specifically—you'll run `fetch_multiple_site_metrics`. You also get the exclusive Brand Authority score with `fetch_brand_authority`, which is key for measuring brand strength. Don’t forget that tracking performance isn’t a one-time thing; you can pull daily or monthly historical records using `fetch_histories` to see how metrics change over time.

**Mapping and Auditing Link Profiles**
If you're doing link audits, this server is what you need. Your agent can list every single inbound link pointing to a target URL via `list_links`. You don't have to look at everything; you can filter those links by the anchor text someone used with `filter_links_by_anchor`, or you can narrow it down by the source domain using `filter_links_by_domain`. Need to know if that link is even alive? Run `fetch_link_status` or use the V2 standard tool, `v2_link_status`, to verify existence. You'll also check for broken links by following known redirects with `v2_final_redirect`.

**Competitive Deep Dives and Link Gaps**
Want to play dirty? Find common backlink sources between multiple competitor sites using `fetch_link_intersect`. This reveals shared authority signals you can exploit. You'll use `list_linking_domains` to get a full roster of every domain linking to your site. To find link opportunities, run `v2_link_intersect`; this identifies sites that link to your rivals but haven't linked to you yet. For tracking competition, check which domains have recently started or stopped linking using `filter_recently_gained_domains` and `filter_recently_lost_domains`. You can also compare metrics across rivals using the V2 API with `v2_url_metrics` and get a list of all common anchor texts used on the web with `list_anchor_text` or `v2_anchor_text`.

**Finding Opportunities and Top Content**
Need to know what’s popular? Run `v2_global_top_pages` to see the 500 most indexed pages across Moz, or check out the top 500 root domains ranked by authority using `v2_global_top_root_domains`. To identify content strengths on your own site, use `v2_top_pages`, which lists the most linked-to pages on a domain. If you're checking bulk metrics using V2 standards, `v2_global_top_pages` and `v2_global_top_root_domains` are your go-tos.

**Usage and Utility Checks**
Your agent can check how much API quota you’ve left with the `lookup_quota` tool. You also get usage data for the current billing period via `v2_usage_data`. When it comes to link analysis, `filter_links_by_anchor` helps narrow down links by specific text definitions, while `list_deduplication_domains` can help you gather a list of all unique domains linking to your target.

## Tools

### fetch_brand_authority
Retrieves the exclusive Brand Authority score for a given website.

### fetch_distributions
Gets detailed link distribution data for a target site.

### fetch_histories
Pulls daily or monthly historical metric records for tracking changes over time.

### fetch_link_intersect
Identifies root domains that are linking to multiple specified targets simultaneously.

### fetch_link_status
Checks the current existence and status of a specific URL link.

### fetch_multiple_site_metrics
Gets key metrics (DA, PA, Spam Score) for up to 50 different URLs in one call.

### fetch_site_metrics
Retrieves the core SEO metrics (DA, PA, Spam Score) for a single specified URL.

### filter_links_by_anchor
Lists links that match a specific anchor text you define.

### filter_links_by_domain
Filters inbound links to show only those originating from a root domain you specify.

### filter_recently_gained_domains
Get recently gained linking root domains

### filter_recently_lost_domains
Identifies root domains that recently stopped linking to your target site (potential link loss).

### list_anchor_text
Provides a normalized list of common anchor texts used across the web.

### list_linking_domains
Gathers a comprehensive list of all domains linking to your site.

### list_links
Gets a full list of every link pointing to a specified target URL.

### lookup_quota
Checks and reports the current usage status of your Moz API V3 quota limits.

### v2_anchor_text
Provides normalized anchor text strings using the V2 API standard.

### v2_final_redirect
Follows known redirects to determine a URL's final, actual destination page.

### v2_global_top_pages
Lists the top 500 most popular pages indexed across the entire Moz database.

### v2_global_top_root_domains
Retrieves the top 500 root domains ranked by overall authority in the Moz index.

### v2_link_intersect
Identifies sites that link to your competitors but don't link to you, highlighting opportunities.

### v2_link_status
Verifies if a specific URL link still exists and is active using V2 standards.

### v2_top_pages
Lists the most linked-to pages on a single domain, identifying content strengths.

### v2_url_metrics
Performs bulk retrieval of SEO metrics for multiple URLs using the V2 API standard.

### v2_usage_data
V2: Get usage data for the current billing period

## Prompt Examples

**Prompt:** 
```
Get SEO metrics for moz.com
```

**Response:** 
```
I've retrieved the metrics for moz.com. It has a Domain Authority of 91, a Page Authority of 78, and a Spam Score of 1%.
```

**Prompt:** 
```
Find sites that link to both apple.com and microsoft.com
```

**Response:** 
```
Using the link intersect tool, I found several high-authority domains linking to both, including techcrunch.com, wired.com, and theverge.com.
```

**Prompt:** 
```
What is the Brand Authority score for nike.com?
```

**Response:** 
```
The Brand Authority™ score for nike.com is 98, indicating an exceptionally strong brand presence in the Moz index.
```

## Capabilities

### Measure Domain Authority
Get core metrics like Domain Authority (DA), Page Authority (PA), and Spam Scores for specific URLs or batches of URLs.

### Audit Link Networks
List all inbound links to a target, filter those links by the text used (anchor) or the source domain that linked to it.

### Compare Competitors
Find common backlink sources between multiple competitor sites using link intersection tools. This reveals shared authority signals.

### Track Performance History
Retrieve metric changes over time, checking daily or monthly historical data for any site.

### Check Link Statuses
Verify if a specific link exists and is currently active, preventing broken link reports from your audit.

## Use Cases

### Vet a potential partner site.
A content writer needs to know if publishing a guest post on `partnerblog.com` is worth the effort. Instead of skimming their homepage, they ask their agent: 'What are the metrics for partnerblog.com?' The agent runs `fetch_site_metrics`, returning the DA and Spam Score in seconds, letting the writer make an informed decision.

### Run a deep competitor backlink analysis.
The SEO engineer wants to know what link sources are valuable. They input three competitors' domains into `fetch_link_intersect`. The agent returns a list of shared, high-authority linking sites—perfect targets for outreach campaigns.

### Determine content pillar strength.
A growth strategist is unsure which pages are performing best. They run the tool `v2_top_pages` on their own domain and immediately see the 10 most linked-to pages, telling them exactly where to focus new content efforts.

### Audit link loss after a site migration.
After moving servers, the team suspects they lost links. They use `filter_recently_lost_domains` to see which domains that used to link to them suddenly cut off their connection, flagging immediate technical debt.

## Benefits

- Identify weak links immediately. Running `fetch_link_status` confirms if a backlink you found is actually live, saving you from broken-link audits.
- Save time running bulk checks. Use `fetch_multiple_site_metrics` to check the DA and PA of up to 50 competitors in one single request, instead of juggling five separate tabs.
- Find competitive gaps. The `v2_link_intersect` tool tells you exactly which high-authority sites link to your rivals but ignore you—a clear action item for PR.
- Measure brand strength. Fetching the Brand Authority™ score (`fetch_brand_authority`) gives you a single, quantifiable metric for how strong your name is in the market.
- Track year-over-year growth. Use `fetch_histories` to look up daily or monthly changes for DA and PA, letting you prove link building ROI with hard numbers.

## How It Works

The bottom line is: your AI client handles all the complex API calls; you just ask for the final insight.

1. First, connect your AI client to the Mozscape server and provide your API token.
2. Next, ask your agent a specific question—for example, 'What are the metrics for these five URLs?'
3. The agent translates that request into multiple tool calls (e.g., `fetch_multiple_site_metrics`), runs them against the Moz API, and returns the structured data to you.

## Frequently Asked Questions

**How do I check metrics for many URLs with fetch_multiple_site_metrics?**
You simply provide the list of up to 50 URLs in your prompt. The agent runs `fetch_multiple_site_metrics` and returns a structured table containing DA, PA, and Spam Score for every site.

**What is the difference between fetch_site_metrics and v2_url_metrics?**
Both get core metrics, but they are different tools. Use `fetch_multiple_site_metrics` or `v2_url_metrics` if you need to check more than one URL at once; otherwise, use the single-shot tool.

**How can I find shared backlink sources with fetch_link_intersect?**
You give the tool a list of target domains (your competitors). The agent runs `fetch_link_intersect` and returns only the root domains that link to all specified targets, which is your primary focus.

**Is fetching history reliable with fetch_histories?**
Yes. This tool allows you to track how metrics change over time (daily or monthly). You can prove growth by looking at historical data points rather than just the current snapshot.

**How do I check my API usage limits with lookup_quota?**
The `lookup_quota` tool shows your current Moz API V3 usage. It's important to run this before large batches of requests. This lets you track remaining credits, so you don't hit rate limits mid-audit.

**If I need links from a specific area, how do I use filter_links_by_domain?**
You must provide the exact root domain name to `filter_links_by_domain`. This tool only pulls links originating from that specified source. It keeps your link list highly targeted and clean.

**What's the best way to start testing with fetch_brand_authority?**
You simply need to pass a valid URL or domain name to `fetch_brand_authority`. The tool returns the Brand Authority™ score instantly, letting you test its function right away. Just remember your API token is required.

**Does v2_final_redirect handle complex redirect chains?**
Yes, `v2_final_redirect` follows all known redirects to pinpoint the true destination URL. This is critical because it tells you where a link *actually* ends up, skipping any intermediary hops.

**How can I check my remaining Moz API credits?**
Use the `lookup_quota` tool. It will return your current API limits and the number of rows consumed in the current billing cycle.

**Can I analyze multiple websites in a single request?**
Yes, you can use the `fetch_multiple_site_metrics` tool to get DA, PA, and Spam Score for up to 50 URLs at once.

**Is it possible to find common backlink sources between competitors?**
Absolutely. Use the `fetch_link_intersect` tool with a list of target domains to identify sites that link to all of them.