# SEO MCP Documentation

- [SEO MCP Documentation](/docs): Connect an AI agent to Screpy SEO data, then investigate crawls, rankings, AI visibility, and technical SEO with checkable evidence.
- 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
  - [SEO MCP Workflows](/docs/workflows): Choose an SEO MCP workflow for technical audits, broken links, crawl changes, Rank Tracker, AI Visibility, and page experience.
  - [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): Check SEO MCP opportunities from crawl, search, and connected traffic data, then verify the evidence before planning work.
  - [Analyze Keyword Ranking Changes with SEO MCP](/docs/workflows/rank-tracker-analysis): Investigate stored Rank Tracker positions by keyword, market, device, URL, and analysis date without mistaking them for live SERPs.
  - [Investigate AI Visibility with SEO MCP](/docs/workflows/ai-visibility-investigation): Trace stored AI Visibility trends to prompts, answers, brand mentions, citations, and source pages.
- SEO MCP Tools
  - [SEO MCP Tools Reference](/docs/tools): Find SEO MCP tools for projects, crawls, pages, links, images, Rank Tracker, AI Visibility, 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.
  - [Rank Tracker MCP Tools](/docs/tools/rank-tracker): Read stored keyword positions, markets, devices, analysis history, and segments with Screpy Rank Tracker MCP tools.
  - [AI Visibility MCP Tools](/docs/tools/ai-visibility): Inspect stored AI Visibility prompts, answers, brand mentions, citations, and sources through Screpy MCP.
- Practical Guides
  - [SEO MCP Guides](/docs/guides): Learn how to use SEO MCP responsibly, write verifiable prompts, audit content for search and AI answers, and choose MCP or an API.
  - [SEO MCP Prompt Library](/docs/guides/prompt-library): Use task-specific SEO MCP prompts for crawls, links, images, rankings, AI visibility, 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 vs REST API: Which Fits Your Workflow?](/docs/guides/mcp-vs-seo-api): Choose Screpy SEO MCP for conversational investigation or the Screpy REST API for deterministic integrations and scheduled application workflows.
- [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.