# Moz — how to use (mcp.ai)

Connect your Moz account and use 12 tools for marketing automation straight from your AI agent. Connect with your own API key. Moz is an SEO software suite providing keyword research, site audits, rank tracking, and competitive insights to boost organic search visibility.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_moz?ms=1787293440000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `moz_fetch_metadata_index`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/moz`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/moz/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/moz/fetch/metadata/index` — Tool to fetch current index metadata from Moz via JSON-RPC. Returns an index ID that changes when the data in the index is updated. Use when you need to track index updates or verify the current index
  - body: { request_id?: string }
- `POST https://api.mcp.ai/api/moz/fetch/site/metrics` — Tool to fetch site metrics from Moz including Domain Authority, Page Authority, Spam Score, and link counts. Use when you need SEO metrics for a domain or specific URL. Returns comprehensive link and 
  - body: { request_id?: string, site_query: object }
- `POST https://api.mcp.ai/api/moz/get/global/top/root/domains` — Tool to get the top 500 root domains across the entire web index sorted by Domain Authority. Returns the highest authority domains globally with Domain Authority, Spam Score, and linking domains count
  - body: { limit?: integer, next_token?: string }
- `POST https://api.mcp.ai/api/moz/get/usage/data` — Tool to get API usage data including the number of rows consumed. Use when you need to track API usage for a specific time range or the current billing period.
  - body: { end?: string, start?: string }
- `POST https://api.mcp.ai/api/moz/global/top/pages` — Tool to fetch global top pages from Moz. Use when you need a paginated list of highest authority pages.
  - body: { limit?: integer, next_token?: string }
- `POST https://api.mcp.ai/api/moz/index/metadata` — Tool to fetch link index metadata from Moz. Use when you need the current index ID (which changes when the index updates) and the dates of Spam Score model updates. Use after authenticating with Moz A
- `POST https://api.mcp.ai/api/moz/link/status` — Tool to check if source URLs link to a target URL. Use when you need to verify inbound links from multiple sources to a target.
  - body: { target: string, sources: string[], source_scope?: string, target_scope?: string }
- `POST https://api.mcp.ai/api/moz/list/global/top/domains` — Tool to get the top ranking domains globally based on Domain Authority. Use when you need the highest authority domains in the entire Moz index.
  - body: { limit?: integer }
- `POST https://api.mcp.ai/api/moz/list/global/top/pages` — Tool to fetch global top ranking pages from Moz using JSON-RPC API. Use when you need to retrieve the highest Page Authority pages in the entire Moz index.
  - body: { limit?: integer, offset?: integer }
- `POST https://api.mcp.ai/api/moz/lookup/quota` — Tool to lookup API quota information including remaining rows, quota limits, and usage across different quota types. Use when you need to check current quota status without consuming quota.
  - body: { path: string }
- `POST https://api.mcp.ai/api/moz/post/top/pages` — Tool to fetch the top pages on a target domain from Moz. Top pages are identified as pages with the most external links. Use when you need a list of high-authority pages on a specific domain or subdom
  - body: { sort?: string, limit?: integer, scope?: string, filter?: string, target: string, next_token?: string, daily_history_deltas?: string[], daily_history_values?: string[], monthly_history_deltas?: string[], monthly_history_values?: string[] }
- `POST https://api.mcp.ai/api/moz/usage/data` — Tool to fetch API usage and quota details from Moz. Use when you need to monitor current plan, quota usage, and rate limits.
  - body: { target?: string, resource?: string, timeframe?: string, probe_endpoint?: string }

## Example prompts
- "What can I do in Moz?"
- "Show me a summary of my Moz account"

## More
- Page: https://mcp.ai/moz
- Agent spec (llms.txt): https://mcp.ai/moz/llms.txt
- Postman collection: https://mcp.ai/moz/postman.json