---
name: whywontai-scan-and-fix
description: Use the Why Won't AI MCP server to scan a site the way search and AI crawlers see it, read the issues, and fix them in the codebase. Use when a user asks to scan their site, check AI visibility, or fix SEO, AEO and GEO issues with whywontai.
---

# Why Won't AI scan and fix

## Setup
- MCP server URL: `https://mcp.whywontai.com/`
- `check_robots` and `check_agent_listings` work without sign-in. The other tools use the user's whywontai.com account through OAuth.
- Claude Code: `claude mcp add --transport http whywontai https://mcp.whywontai.com/`
- Cursor and VS Code: add the URL as a remote MCP server in the editor's MCP settings. See whywontai.com/integrations for the exact steps.

## Tools
- `check_robots`: read robots.txt rules for AI and search crawlers.
- `scan_site`: start a full scan. It returns a `scan_id`. A scan takes 1 to 5 minutes and counts against the plan quota.
- `get_scan`: status and summary. Pass `wait_seconds` (up to 25) and call again until the status is complete.
- `list_issues`: issues, most severe first. Filter by `min_severity` or `category`.
- `get_internal_links`, `get_long_questions`, `get_page_two`, `get_index_status`, `get_bing_ai_citations`: data that needs Search Console or Bing connected.

## Workflow
1. Ask for the site URL if the user did not give it.
2. Run `check_robots` first. If a wanted crawler is blocked, report it before the full scan.
3. Run `scan_site`, then `get_scan` with `wait_seconds: 25` until complete.
4. Run `list_issues` with `min_severity: "high"`. Group issues by category.
5. For each issue, open the matching files in the repo and fix it. Use the related skill: client-side-rendering-fix, ai-crawler-robots-txt, title-tags, meta-descriptions, canonical-tags, organization-schema, internal-linking.
6. Show the user a diff per fix. Do not deploy without the user's approval.
7. After deploy, run `scan_site` again and compare the score and the issue count.

## Output
Score before and after, a table of issues fixed (issue, page, file changed), and the issues left with a reason.
