> ## Documentation Index
> Fetch the complete documentation index at: https://dev.ranked.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 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                                                    |
| **Reports**       | Generate shareable SEO report links                                                                                            |
| **Heatmaps**      | View local SEO ranking heatmap data                                                                                            |

## Available tools

### Read tools (10)

| 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                                       |

### Write tools (8)

| Tool                      | Description                                    |
| ------------------------- | ---------------------------------------------- |
| `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                         |