A Model Context Protocol (MCP) server that provides access to the comprehensive Moz API for SEO data and analysis. This server enables Claude and other MCP clients to access Moz's extensive SEO toolkit including keyword research, site metrics, link analysis, and competitive intelligence.

This MCP server provides access to all major Moz API endpoints, organized into the following categories:

• moz_global_top_domains - Get the global top-ranking domains across the internet
• moz_global_top_pages - Get the global top-ranking pages across the internet

• moz_keyword_search_intent - Analyze search intent for keywords
• moz_keyword_suggestions - Get related keyword suggestions
• moz_keyword_difficulty - Get keyword difficulty scores (1-100)
• moz_keyword_opportunity - Get keyword opportunity/CTR data
• moz_keyword_priority - Get keyword priority scores
• moz_keyword_volume - Get keyword search volume data

• moz_site_brand_authority - Get Brand Authority scores for domains
• moz_site_metrics - Get comprehensive site metrics (DA, PA, links, etc.)
• moz_site_metrics_multiple - Get metrics for multiple sites at once
• moz_site_ranking_keywords - Get keywords a site ranks for
• moz_site_ranking_keywords_count - Count how many keywords a site ranks for

• moz_url_metrics - Get URL metrics including Domain Authority, Page Authority
• moz_links - Get inbound links to URLs, subdomains, or domains
• moz_anchor_text - Get anchor text analysis
• moz_top_pages - Get top pages for domains
• moz_linking_domains - Get domains linking to targets

• moz_quota - Check API quota and usage limits
• moz_usage_data - Get detailed API usage statistics

1. Clone this repository:

git clone <repository-url>
cd moz-mcp

2. Install dependencies:

npm install

3. Build the project:

npm run build

You need Moz API credentials to use this server. Get them from the Moz API Dashboard:

1. Sign up for a Moz account at https://moz.com/
2. Go to the Moz API section
3. Generate your API token or get your Access ID/Secret Key

The server supports both authentication methods:

For API Token:

export MOZ_API_TOKEN="your_api_token_here"

For Access ID/Secret Key (base64 encoded):

export MOZ_API_TOKEN="base64_encoded_credentials"

Add the server to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "moz": {
      "command": "node",
      "args": ["/path/to/moz-mcp/dist/index.js"],
      "env": {
        "MOZ_API_TOKEN": "your_token_here"
      }
    }
  }
}

Once configured, restart Claude Desktop and you can use Moz tools in your conversations:

"What's the keyword difficulty for 'digital marketing'?"
"Get keyword suggestions for 'SEO tools'"
"What's the search volume for 'content marketing'?"

"Get site metrics for example.com"
"What's the Brand Authority of moz.com?"
"Show me the top ranking keywords for hubspot.com"

"Get the top global domains"
"Show me who links to competitor.com"
"What are the top pages on example.com?"

"Get inbound links to example.com"
"Show me anchor text analysis for this URL"
"Find linking domains to competitor.com"

Based on the official Moz API Documentation, this server implements the following JSON-RPC 2.0 methods:

Start the development server:

npm run dev

Build for production:

npm run build
npm start

The server automatically detects your credential format:

• API Token: Standard x-moz-token header authentication
• Access ID/Secret Key: HMAC-SHA1 signature authentication with base64-encoded credentials

The Moz API uses a tiered pricing model with row-based quota. Different methods consume different amounts of quota. See the Moz API pricing page for details.

The server provides comprehensive error handling and logging:

• Validates required parameters
• Handles network errors gracefully
• Provides detailed error messages
• Logs API request failures for debugging

MIT License - see LICENSE file for details.