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. Includes topic-pod clustering.
find_content_opportunity
Money Pages: competitor pages ranking for many keyword variants (positions 1-25) — one page to write, with both potential and real estimated traffic.
scan_url
Paste any page URL and get back every keyword it ranks for, cross-referenced against your own rankings. Live, billed, rate-limited.
get_content_brief
Synthesizes a content brief (outline, entities, PAA, dominant format) from a find_keyword_opportunity result's own fields — no new lookup.
find_own_opportunity
Low-hanging fruit: keywords you already rank for on page 1-3, independent of any competitor gap.
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.
find_content_decay
Your own pages whose weekly clicks have genuinely fallen off from their peak — sustained decline, not a noisy week.
list_decisions
Every decision logged from a Keyword Opportunities card, and whether it worked once checked against Search Console.
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.