# SEO MCP Documentation

- [SEO MCP Documentation](/docs): Learn how to connect an AI agent to real SEO crawl data, run evidence-based audits, and build safe technical SEO workflows with SEO MCP.
- Getting Started
  - [Get Started with SEO MCP](/docs/getting-started): Connect SEO MCP, authorize your account, and run your first evidence-based technical SEO analysis with an AI agent.
  - [Connect an AI Client to SEO MCP](/docs/getting-started/connect-your-client): Add the SEO MCP remote server endpoint to a compatible AI client and verify the connection with a safe read-only request.
  - [SEO MCP Authentication and Access](/docs/getting-started/authentication): Understand how SEO MCP uses OAuth, PKCE, scoped tokens, project authorization, and explicit confirmation to protect member data.
  - [Run Your First SEO Audit with SEO MCP](/docs/getting-started/first-seo-audit): Follow a practical SEO MCP workflow that finds high-impact technical SEO issues and verifies every recommendation against crawl records.
- SEO Workflows
  - [Technical SEO Audit Workflow](/docs/workflows/technical-seo-audit): Use SEO MCP to run a structured technical SEO audit across crawlability, indexing signals, metadata, content structure, links, images, and performance.
  - [Find and Fix Broken Links](/docs/workflows/broken-links): Find broken internal and external links with SEO MCP, trace their source pages, and create a prioritized repair plan.
  - [Image SEO Audit Workflow](/docs/workflows/image-seo): Use SEO MCP to find large, broken, or poorly described images and trace each asset back to the pages where it appears.
  - [Core Web Vitals Review](/docs/workflows/core-web-vitals): Review Core Web Vitals with SEO MCP, identify weak page groups, and connect experience signals to actionable page and template work.
  - [Compare SEO Crawls](/docs/workflows/compare-crawls): Compare two SEO crawls with SEO MCP to identify technical improvements, regressions, and release-related changes.
  - [Find SEO Quick Wins](/docs/workflows/quick-wins): Use SEO MCP quick-win signals as a starting point, then verify impact and effort before building an SEO action plan.
- SEO MCP Tools
  - [SEO MCP Tools Reference](/docs/tools): Explore all 23 SEO MCP tools for account context, projects, crawls, pages, links, images, uptime, and Core Web Vitals.
  - [Project and Account Tools](/docs/tools/projects): Use SEO MCP account and project tools to discover accessible sites, review project context, compare projects, and manage settings safely.
  - [Crawl Tools](/docs/tools/crawls): Use SEO MCP crawl tools to list runs, check status, review summaries, compare datasets, and start crawls only when explicitly requested.
  - [Page Data Tools and Filters](/docs/tools/pages): Query SEO page records with structured filters for status, metadata, headings, canonicals, depth, response performance, links, images, and structured data.
  - [Link and Image Tools](/docs/tools/links-and-images): Query link and image records with SEO MCP, then trace important destinations and assets back to their source pages.
  - [Uptime and Core Web Vitals Tools](/docs/tools/health-and-web-vitals): Review uptime summaries and Core Web Vitals records with SEO MCP while keeping measurement scope and diagnostic limits clear.
- Practical Guides
  - [SEO MCP Prompt Library](/docs/guides/prompt-library): Copy practical SEO MCP prompts for technical audits, broken links, image SEO, crawl comparisons, Core Web Vitals, and safe project workflows.
  - [Responsible SEO Automation](/docs/guides/responsible-automation): Build safe SEO MCP automations with read-only defaults, explicit confirmation, bounded queries, reproducible evidence, and human review.
  - [Audit Content for Search and AI Answers](/docs/guides/content-and-ai-search-audits): Use SEO MCP technical evidence to audit whether content is crawlable, internally discoverable, machine-readable, and supported by clear page signals.
- [SEO MCP Security and Permissions](/docs/security-and-permissions): Learn how SEO MCP limits access with OAuth, scoped tokens, project authorization, rate limits, bounded filters, and explicit confirmation.
- [SEO MCP Troubleshooting](/docs/troubleshooting): Diagnose SEO MCP connection, authorization, project access, crawl selection, filter validation, rate-limit, and incomplete-data problems.