MCP / Cursor

Connect Cursor to Ranks Hawk

Ask Cursor's agent to pull your competitor data directly — no copy-pasting between tabs.

Add to Cursor

Manual setup

  1. 1

    Add the server

    Open Cursor Settings → MCP → Add new MCP server, or edit ~/.cursor/mcp.json directly:

    { "mcpServers": { "rankshawk": { "url": "https://www.rankshawk.com/api/mcp" } } }
  2. 2

    Authenticate

    Cursor detects that the server requires OAuth and opens a browser consent screen. Sign in with your Ranks Hawk account and approve — Cursor stores the resulting credentials for you.

  3. 3

    Use it

    In Chat or Composer, ask — e.g. "Any content gaps between me and my tracked competitors?"

What it can do

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.

Common questions

The one-click install didn’t open Cursor

Make sure Cursor is installed and has been opened at least once, then click the button again — or use the manual mcp.json setup below.

Where do I find installed MCP servers in Cursor?

Cursor Settings → MCP. You’ll see "rankshawk" listed with its connection status and an option to re-authenticate.

Does this work in Composer and Chat?

Yes — once connected, the tools are available to Cursor’s agent in both Chat and Composer.

Using a different tool? See all supported clients.