Ranks Hawk MCP
Connect Ranks Hawk to Claude, Cursor, Windsurf, VS Code, ChatGPT, or any other MCP-compatible agent, and ask it things like "find me a content gap against my competitors" or "what backlink opportunities do I have this week?" — it reads your account directly.
One server, every client. This isn't a separate integration per AI tool — it's a single OAuth-protected MCP server that any MCP-compatible agent can connect to. Pick your client below.
Claude
Claude Code, Claude Desktop, Claude.ai
Cursor
One-click install or manual mcp.json
Windsurf
Cascade’s MCP plugin panel
VS Code
GitHub Copilot Chat, Agent mode
ChatGPT
Developer Mode custom connectors
Five read-only tools, all scoped to your own account:
find_keyword_opportunity
Keywords worth targeting: ones you don't rank for at all, ones a competitor ranks weakly for (#4-15), or both at once.
find_content_opportunity
Competitor pages ranking for many keyword variants (positions 1-25) — one page to write, with both potential and real estimated traffic.
get_keyword_overlap
Keywords bucketed by how many tracked competitors rank for them — ALL, 2 of 3, 1 of 3, etc.
find_backlink_opportunity
Dead competitor pages worth reclaiming, or sites linking to them but not to you.
find_ai_mention
Questions where AI assistants cite a competitor instead of you.
find_new_page
New pages detected in a competitor's sitemap since the last daily check.
get_rank_change
Keyword position movements since the last check — competitor moves, rank drops, and your own site's movement.
list_competitors
Your tracked competitor domains.
get_account_summary
Your domain, plan, and last analysis run time.
The server speaks standard Streamable HTTP with OAuth 2.0 (RFC 9728 protected-resource discovery, via Clerk). Point any MCP-compatible client at:
https://www.rankshawk.com/api/mcpNo API key or static token — the client discovers the authorization server automatically and opens a browser consent screen on first connect.
What is MCP?
The Model Context Protocol is an open standard that lets AI agents call tools on external services. Ranks Hawk runs a remote, OAuth-protected MCP server — no local install, no API key to copy.
Is my data safe?
Every tool is read-only and scoped to your own Ranks Hawk account. Nothing is ever written back, and access is revocable at any time from your connected-apps settings.
Do I need a specific plan?
MCP access is available on every Ranks Hawk plan that includes the underlying data (competitors, content gaps, backlinks, AI mentions).
My client isn’t listed — will it still work?
Any MCP client that supports remote Streamable HTTP servers with OAuth should work with the endpoint below, even if we don’t have a dedicated walkthrough for it yet.
Prefer scripting it yourself instead? See API Access in your dashboard for the REST API.