MCP Overview
Connect Ranked AI to ChatGPT, Claude, Cursor, and other AI tools
What is MCP?
The Model Context Protocol (MCP) lets AI tools like ChatGPT, Claude, and Cursor interact with your Ranked AI data directly. Ask questions about your SEO performance in natural language.
Capabilities
| Category | What you can do |
|---|---|
| Keywords | View positions across Desktop, Mobile, AI Mode, and Maps with position changes over 7d, 30d, 60d, 90d, 180d, 365d, or all time |
| AI Visibility | Check brand visibility across 6 AI models with per-model mention rates and citation counts |
| Audits | Get audit results with issue counts by severity. Run new audits |
| Backlinks | View referring domains, new/lost tracking, dofollow/nofollow breakdown |
| Content | Browse content calendar, approve articles, request revisions, submit topics |
| Traffic | Google Search Console impressions, clicks, and top queries; Google Analytics sessions, users, and channels |
| Reports | Generate shareable SEO report links |
| Heatmaps | View local SEO ranking heatmap data |
Available tools
Read tools (11)
| Tool | Description |
|---|---|
ranked_get_project_overview | List all projects or get detailed metrics for one project |
ranked_get_keyword_rankings | Keyword positions with per-device changes and net change |
ranked_get_ai_visibility | Brand visibility across ChatGPT, Claude, Gemini, Perplexity, Grok, Meta Llama |
ranked_get_audit_summary | Latest audit issue counts scoped to most recent audit |
ranked_get_audit_details | Affected URLs for a specific audit issue |
ranked_get_backlink_summary | Backlink profile with dofollow/nofollow counts |
ranked_get_content_calendar | Content items filtered by status with scheduling info |
ranked_get_heatmaps | Local SEO ranking and competition heatmaps |
ranked_get_sitemap_indexing | Sitemap URLs and Google indexing status |
ranked_get_search_console_metrics | Google Search Console impressions, clicks, CTR, and top queries over any window |
ranked_get_analytics_metrics | Google Analytics sessions, users, page views, and channel breakdown over any window |
Write tools (11)
| Tool | Description |
|---|---|
ranked_create_software_project | Create a self-serve SEO Software project from a website URL |
ranked_add_keywords | Add keywords to track in search results |
ranked_remove_keywords | Remove tracked keywords by ID |
ranked_add_prompts | Add AI visibility prompts for brand monitoring |
ranked_request_topic | Submit a content topic request |
ranked_approve_content | Approve content for publishing |
ranked_request_revision | Request a content revision with notes |
ranked_generate_report | Create a shareable SEO report link |
ranked_run_audit | Start a new site audit |
ranked_update_content_preferences | Update the project's content writing preferences |
ranked_update_publishing_preferences | Update the project's publishing preferences |
This page is also available as markdown for AI agents, and the whole reference as an OpenAPI spec. Questions? Developer support.