# MCP SEO Ranking > AI-powered SEO platform. Audit websites, track rankings, analyze competitors, monitor backlinks, and execute complete SEO blueprints through MCP tools or web dashboard. ## Documentation - [API Documentation](/api-docs): Complete REST API reference and endpoint documentation - [Blueprint Guide](/blueprint-guide): Step-by-step SEO execution framework ## MCP Tools - [seo_get_project_status](/api/mcp): Get the overall SEO project status including keyword count, average position, and blueprint progress for a domain - [seo_get_rankings](/api/mcp): Get current keyword rankings for a domain. Returns position, URL, and last check date for each tracked keyword. - [seo_get_keywords](/api/mcp): Get all tracked keywords for a domain with volume, difficulty, and current position. Use to list the portfolio before... - [seo_get_blueprint_progress](/api/mcp): Get SEO blueprint execution progress by phase (31-step checklist across 6 phases). Returns total/completed counts plu... - [seo_get_audit_results](/api/mcp): Get on-page SEO audit results for a specific URL, checking title, description, H1, images, and schema markup - [seo_check_ranking](/api/mcp): Check the current Google ranking position for a keyword and domain using DataForSEO SERP API - [seo_suggest_keywords](/api/mcp): Get keyword suggestions based on a seed keyword using DataForSEO. Returns related keywords with volume and difficulty. - [seo_analyze_serp](/api/mcp): Analyze the top 10 Google SERP results for a keyword. Shows competitors ranking for that term. - [seo_get_competitors](/api/mcp): Get tracked competitor domains with threat assessment. Use as the first step in competitive analysis before running g... - [seo_get_backlinks](/api/mcp): Get acquired backlinks plus Link Chest outreach opportunities (1,201 curated targets across 60 categories). Use when ... - [seo_get_content_calendar](/api/mcp): Get editorial content calendar items filtered optionally by status (planned, writing, review, published). Use for con... - [seo_get_geo_visibility](/api/mcp): Get GEO monitoring checks — visibility in AI-powered search engines (Google AI Overviews, Perplexity, ChatGPT). Reads... - [seo_check_backlink_profile](/api/mcp): Check the backlink profile summary for a domain using DataForSEO — total backlinks, referring domains, dofollow/nofol... - [seo_get_competitor_analysis](/api/mcp): [DEPRECATED — use seo_competitor_deep_analysis] Get head-to-head competitor comparison — shows our keywords and avail... - [seo_add_content_item](/api/mcp): Add a content item to the editorial calendar with title, target keyword, type, and priority - [seo_add_keyword](/api/mcp): Add a keyword to a domain's tracked portfolio. Persists to the keywords table (visible in /keywords and rank tracker)... - [seo_remove_keyword](/api/mcp): Remove a tracked keyword from a domain's portfolio (keywords table). Does not delete historical rankings rows. - [seo_complete_blueprint_step](/api/mcp): Mark a blueprint step as completed for a project, persisted server-side in `project_steps`. Steps are identified by p... - [seo_run_sitemap_check](/api/mcp): Check and validate an XML sitemap — count URLs, check validity, find last modified date - [seo_run_robots_check](/api/mcp): Fetch and analyze a domain's robots.txt — extract rules, user-agents, and sitemap references - [seo_generate_schema](/api/mcp): Generate JSON-LD structured data markup. Supports Article, FAQ, and Organization types. - [seo_generate_featured_image](/api/mcp): Generate AI featured image for blog post via Gemini Nano Banana 2 (gemini-3.1-flash-image-preview). Uploads PNG to Su... - [seo_generate_content_brief](/api/mcp): Generate a data-driven content brief for a keyword. Includes suggested title, headings outline, related keywords, com... - [seo_get_alerts](/api/mcp): Get active SEO alerts: unread count, ranking drops, and growth opportunities auto-derived from rank-check deltas. Use... - [seo_detect_cannibalization](/api/mcp): Analyze ranking data for keyword cannibalization — detects when multiple pages from the same domain compete for the s... - [seo_detect_content_decay](/api/mcp): Find declining rankings by comparing current positions against historical data. Identifies content that may need refr... - [seo_classify_keyword_intent](/api/mcp): Classify keyword search intent into informational, commercial, transactional, or navigational categories based on lin... - [seo_get_anchor_analysis](/api/mcp): Get anchor text distribution analysis for the current backlink profile — classifies anchors as exact, partial, brande... - [seo_check_page_speed](/api/mcp): Check page speed metrics for a URL — response time, HTML size, compression status, and resource hints - [seo_get_onpage_score](/api/mcp): Get a concise on-page SEO score pointer for a URL (lightweight). For detailed checklist + SERP preview + scoring, red... - [seo_get_serp_features](/api/mcp): Get SERP feature data for a keyword — featured snippets, People Also Ask, local packs, AI Overviews, knowledge graphs... - [seo_get_keyword_gaps](/api/mcp): Get competitive keyword gap analysis — keywords competitors rank for but you don't, plus overlap matrix and link inte... - [seo_export_report](/api/mcp): Export a comprehensive SEO executive report (rankings, audit, health score, recommendations) as Markdown. Use at end ... - [seo_full_site_audit](/api/mcp): Run a comprehensive site audit combining ranking check, on-page audit, page speed, backlink profile, and blueprint pr... - [seo_keyword_research_workflow](/api/mcp): Complete keyword research workflow: suggest keywords from seed, classify intent, and check for cannibalization risks - [seo_competitor_deep_analysis](/api/mcp): Deep competitor analysis combining competitor data, keyword gaps, and SERP analysis for head-to-head comparison - [seo_content_planning_workflow](/api/mcp): Content planning workflow: gather keywords, calendar status, blueprint progress, and generate a content brief for the... - [seo_health_check_workflow](/api/mcp): Comprehensive health check: project status, rankings, alerts, page speed, sitemap, and robots.txt in a single dashboa... - [seo_geo_visibility_workflow](/api/mcp): End-to-end GEO audit: fetch AI-engine visibility (AI Inclusion Rate + Share of Model), flag engines scoring <70, prob... - [seo_check_conversion_setup](/api/mcp): Audit conversion tracking setup — verify GA4/GTM installation, UTM parameters on outbound links, cookie consent, prod... - [seo_get_decision_traces](/api/mcp): Query decision traces — the structured reasoning behind SEO recommendations. Filter by type, status, date range. Retu... - [seo_update_trace_status](/api/mcp): Update the lifecycle status of a decision trace — mark as 'acted' (recommendation followed), 'dismissed' (intentional... - [seo_search_knowledge](/api/mcp): Semantic search in knowledge chunks. Finds relevant SEO knowledge from past briefs and manual additions using Gemini ... - [seo_add_knowledge_chunk](/api/mcp): Add a knowledge chunk manually. Use for custom insights, FAQ items, or curated content that should be searchable. Gen... - [seo_extract_chunks_from_brief](/api/mcp): Manually trigger chunk extraction from a content brief. Normally automatic via seo_generate_content_brief, but this t... - [seo_check_ai_citations](/api/mcp): Query recent AI citations for a specific query or project. Returns citations with is_target flag indicating when your... - [seo_add_tracked_query](/api/mcp): Register a search query for recurring AI citation tracking. The query is checked in specified engines on the given fr... - [seo_list_ai_citations](/api/mcp): List AI citations with cursor pagination. Use to analyze citation patterns, detect changes, and identify new mentions... - [seo_create_experiment](/api/mcp): Create a new SEO A/B test for title or meta description. Starts in draft status. Requires at least 2 variants (contro... - [seo_activate_experiment](/api/mcp): Activate an experiment. Pushes to Vercel Edge Config for edge-level variant routing. Requires VERCEL_API_TOKEN for sy... - [seo_get_experiment_results](/api/mcp): Get aggregated daily results for an experiment (impressions, clicks, CTR per variant). Returns winner heuristic if en... - [seo_list_experiments](/api/mcp): List SEO A/B experiments in the project with filters by status. - [tasks_get_ready](/api/mcp): List READY pending tasks · workspace-scoped · filter priority/task_type/url_id · paginate. Agents poll this to discov... - [tasks_claim](/api/mcp): ATOMIC claim a READY task · transitions status READY → IN_PROGRESS · returns 409 Conflict if another session already ... - [tasks_get_full_spec](/api/mcp): Full task spec including current_state · target_state · acceptance_criteria · dependencies · artifacts · progress_log... - [tasks_post_progress](/api/mcp): Append a progress_log row to a task · captures agent_session_id + timestamp + type (progress/milestone/error/blocker/... - [tasks_submit_artifact](/api/mcp): Submit an artifact (screenshot/file/diff/code/url) attached to a task · INSERT into task_artifacts · denormalized cac... - [tasks_request_help](/api/mcp): Mark task BLOCKED with reason markdown + blocker_type · status IN_PROGRESS → BLOCKED · captures forensic trail in pro... - [tasks_propose_subtasks](/api/mcp): Create child PROPOSED tasks under parent task · INSERT pending_tasks rows + task_dependencies (relation_type=subtask_... - [tasks_query_url_metrics](/api/mcp): Full url_pages record (10 dimensions A-J · same shape as urls_get_metrics_history but single-shot · workspace-scoped). - [tasks_verify_done](/api/mcp): Trigger M2.5.A verification engine for the task · returns PASS/FAIL/PARTIAL + reasons + evidence · auto-transitions p... - [tasks_mark_done](/api/mcp): Transition IN_PROGRESS → DONE · captures actual_effort_min + verification_method + completed_at · 403 if claimed by o... - [tasks_release](/api/mcp): Release a claim · IN_PROGRESS → READY · clears assigned_to_agent_session_id · 403 if not the claiming session. - [pillars_list](/api/mcp): List SEO pillars workspace-scoped · ownership chain user_id+project_id. - [pillars_get](/api/mcp): Single pillar with topic_clusters + URL count under it. - [urls_get_metrics_history](/api/mcp): Longitudinal URL metrics: indexing_history + keyword_rankings + lighthouse_runs joined · last N days (default 90). - [keywords_get_rankings](/api/mcp): Current keyword ranking snapshots · filter url_id OR keyword · sorted checked_at desc. - [agents_heartbeat](/api/mcp): Heartbeat · UPDATE mcp_agent_sessions.last_heartbeat_at = NOW() · returns session status. Cron worker marks disconnec... ## Pages - [Dashboard](/dashboard): SEO overview and key metrics - [Site Audit](/audit): Technical SEO health analysis - [Keywords](/keywords): Keyword research and tracking - [Backlinks](/backlinks): Backlink profile monitoring - [Competitors](/competitors): Competitor analysis and benchmarking - [Blueprint](/blueprint): SEO execution roadmap - [GEO Visibility](/geo): Geographic search visibility - [Rank Tracker](/rank-tracker): Daily ranking monitoring - [Content Calendar](/calendar): SEO content planning - [Alerts](/alerts): SEO alerts and notifications - [Reports](/report): Custom SEO reports - [Lighthouse](/lighthouse): Performance and Core Web Vitals ## API Endpoints - [Speed Analysis](/api/tools/speed): Page speed and performance metrics - [Robots Check](/api/tools/robots): Robots.txt validation and analysis - [Sitemap Check](/api/tools/sitemap): XML sitemap validation - [Internal Links](/api/tools/internal-links): Internal link structure analysis - [Schema Validate](/api/tools/schema-validate): Structured data validation - [Conversion Audit](/api/tools/conversion-audit): Conversion optimization analysis ## Optional - [Settings](/settings): Account and project configuration - [Bookmarks](/bookmarks): Saved audits and reports - [Activity](/activity): Recent actions and history