Skip to main content

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.

Install the Ranked AI skill

Install our documentation skill so your AI tools have full context on the Ranked AI API:

Install the Ranked AI skill for AI-assisted development.

CursorOpen in Cursor

ChatGPT

  1. Open ChatGPT Settings > Connected Apps
  2. Search for Ranked and click Connect
  3. Sign in with your Ranked AI account to authorize access
  4. Start asking about your SEO data in any ChatGPT conversation

Example prompts

How are my keyword rankings doing this month?
What's my AI visibility across all models?
Show me my latest audit results

Claude Desktop

Add to your Claude Desktop MCP config file (~/Library/Application Support/Claude/claude_desktop_config.json on Mac):
{
  "mcpServers": {
    "ranked-ai": {
      "url": "https://app.ranked.ai/api/mcp/sse"
    }
  }
}
You’ll be prompted to authorize on first use.

Cursor

  1. Open Cursor Settings > MCP
  2. Add a new MCP server with URL: https://app.ranked.ai/api/mcp/sse
  3. Authenticate when prompted

Authentication

The MCP integration uses OAuth 2.0 with authorization code flow. When you first connect, you’ll be redirected to sign in with your Ranked AI account. Access tokens are automatically refreshed.
  • Access tokens expire after 24 hours
  • Refresh tokens last 30 days
  • Scope: read:projects (read access to all project data)
The MCP integration has read and write access to your project data. Write actions (like approving content) show a confirmation prompt before executing.