{"description":"GoCrawl Cloud Model Context Protocol (MCP) Server","endpoint":"/api/mcp","name":"gocrawl-cloud-mcp","protocolVersion":"2024-11-05","tools":[{"name":"query_crawl_issues","description":"Query technical SEO defects, indexability blockers, and architecture risks filtered by severity, category, or minimum ImpactScore.","inputSchema":{"properties":{"category":{"description":"Filter by SEO dimension.","enum":"indexability,canonicals,links,metadata,schema,performance","type":"string"},"crawl_id":{"description":"The target crawl job identifier.","type":"string"},"limit":{"description":"Maximum number of issues to return (default 50).","type":"integer"},"min_impact":{"description":"Minimum impact score threshold (0.0 to 100.0).","type":"number"},"severity":{"description":"Filter by issue severity rank.","enum":"critical,warning,info","type":"string"}},"required":["crawl_id"],"type":"object"}},{"name":"get_url_audit_details","description":"Retrieve detailed SEO metrics for a specific URL, including status code, canonical tags, LinkScore, inlink count, and all triggered issues.","inputSchema":{"properties":{"crawl_id":{"description":"The target crawl job identifier.","type":"string"},"url":{"description":"The normalized or raw URL to inspect.","type":"string"}},"required":["crawl_id","url"],"type":"object"}},{"name":"get_site_graph_summary","description":"Get high-level site crawl KPIs: total URLs, status distributions, PageRank link score breakdown, orphan page count, and duration.","inputSchema":{"properties":{"crawl_id":{"description":"The target crawl job identifier.","type":"string"}},"required":["crawl_id"],"type":"object"}},{"name":"check_llm_bot_parity","description":"Execute live multi-agent parity audit for a URL comparing Googlebot, GPTBot, ClaudeBot, and PerplexityBot for WAF blocks or cloaking.","inputSchema":{"properties":{"url":{"description":"The URL to probe with multiple search and AI bot user-agents.","type":"string"}},"required":["url"],"type":"object"}},{"name":"audit_llms_txt","description":"Discover and lint /llms.txt and /llms-full.txt files on a target domain according to the llms.txt standard.","inputSchema":{"properties":{"base_url":{"description":"The root domain/origin to inspect (e.g. https://example.com).","type":"string"}},"required":["base_url"],"type":"object"}},{"name":"list_crawls","description":"List all saved crawl sessions in the local GoCrawl database with crawl_id, seed URL, total URLs, and timestamps.","inputSchema":{"properties":{"limit":{"description":"Maximum number of historical crawls to return.","type":"integer"}},"type":"object"}},{"name":"start_crawl","description":"Execute a full technical SEO \u0026 architecture crawl of a target seed_url, run PageRank \u0026 Corpus Triage, and return the crawl_id, summary KPIs, and top critical blockers.","inputSchema":{"properties":{"concurrency":{"description":"Number of concurrent workers (default 20).","type":"integer"},"max_urls":{"description":"Maximum URLs to crawl (default 500, max 10000).","type":"integer"},"seed_url":{"description":"The target website URL to crawl.","type":"string"}},"required":["seed_url"],"type":"object"}},{"name":"compare_crawls","description":"Compare two crawl sessions (baseline_crawl_id vs current_crawl_id) to detect status code regressions, indexability drops, title/H1 changes, and LinkScore losses.","inputSchema":{"properties":{"baseline_crawl_id":{"description":"The baseline/older crawl ID.","type":"string"},"current_crawl_id":{"description":"The current/newer crawl ID to evaluate regressions against.","type":"string"}},"required":["baseline_crawl_id","current_crawl_id"],"type":"object"}},{"name":"audit_js_hydration","description":"Fetch static server HTML and render client-hydrated DOM in headless Chromium to detect client-injected links or JS-mutated titles/canonicals.","inputSchema":{"properties":{"url":{"description":"The target webpage URL to test for JS hydration diffs.","type":"string"}},"required":["url"],"type":"object"}},{"name":"get_site_scorecard","description":"Compute the 6-dimension site health scorecard (Indexability, Architecture, Metadata, Performance, Schema, AI/GEO) with letter grade (A+ to F), points lost, and quickest wins.","inputSchema":{"properties":{"crawl_id":{"description":"The target crawl job identifier.","type":"string"}},"required":["crawl_id"],"type":"object"}},{"name":"get_llm_fix_pack","description":"Generate a structured, deduplicated LLM Fix Context Pack with grep search hints, component route patterns, and code snippets for autonomous repo repairs.","inputSchema":{"properties":{"crawl_id":{"description":"The target crawl job identifier.","type":"string"}},"required":["crawl_id"],"type":"object"}},{"name":"verify_fixes_loop","description":"Reconcile a baseline crawl against a follow-up verification crawl to prove what was fixed (RESOLVED, PARTIAL, OPEN, NEW_REGRESSION) and generate executive metrics.","inputSchema":{"properties":{"baseline_crawl_id":{"description":"The initial crawl ID containing the defects.","type":"string"},"current_crawl_id":{"description":"The follow-up verification crawl ID to prove fixes.","type":"string"}},"required":["baseline_crawl_id","current_crawl_id"],"type":"object"}},{"name":"generate_ai_grounding_pack","description":"Generate the 3-file AI Search Grounding Pack (/llms.txt index, /llms-full.txt deep markdown digest, and /docs/ai/product-overview.html semantic grounding document) from a crawl session.","inputSchema":{"properties":{"crawl_id":{"description":"The target crawl job identifier.","type":"string"}},"required":["crawl_id"],"type":"object"}},{"name":"run_ai_visibility_probe","description":"Run the AI Brand Visibility \u0026 Citation Share-of-Voice Probe across 5 buyer-intent prompts (supports Vercel AI Gateway keys or zero-key simulation).","inputSchema":{"properties":{"brand_name":{"description":"Optional explicit brand name override.","type":"string"},"category":{"description":"Optional product category override.","type":"string"},"competitor":{"description":"Optional primary competitor name.","type":"string"},"crawl_id":{"description":"The target crawl job identifier.","type":"string"}},"required":["crawl_id"],"type":"object"}},{"name":"map_migration_redirects","description":"Synthesize 301 redirect mappings between an old production crawl and a new staging/redesign crawl using Exact Path, Content Hash, SimHash, and Slug Jaccard matching.","inputSchema":{"properties":{"new_crawl_id":{"description":"The new staging/redesigned crawl ID.","type":"string"},"old_crawl_id":{"description":"The baseline/old production crawl ID.","type":"string"}},"required":["old_crawl_id","new_crawl_id"],"type":"object"}},{"name":"get_keyword_alignment","description":"Analyze 1-, 2-, and 3-word N-gram semantic keyword alignment across Title, H1, H2, Meta Description, and URL slug for a crawled page.","inputSchema":{"properties":{"crawl_id":{"description":"The target crawl job identifier.","type":"string"},"url":{"description":"The URL of the page to analyze.","type":"string"}},"required":["crawl_id","url"],"type":"object"}}],"version":"1.0.0"}