MCP / ChatGPT

Connect ChatGPT to Ranks Hawk

Ask ChatGPT to pull your competitor data directly via a custom connector.

This uses ChatGPT's Developer Mode, which requires a Plus, Pro, Business, Enterprise, or Education plan and is still labeled beta by OpenAI — menu names and steps may shift as it evolves.

  1. 1

    Enable Developer Mode

    Settings → Connectors → Advanced settings → toggle Developer mode on, and accept the warning about custom connectors running third-party code.

  2. 2

    Create the connector

    In Connectors, click Create and fill in:

    Name: Ranks Hawk

    MCP Server URL:

    https://www.rankshawk.com/api/mcp

    Set Authentication to OAuth, then save.

  3. 3

    Authenticate

    A consent popup opens. Sign in with your Ranks Hawk account and approve.

  4. 4

    Use it

    In a chat, enable the Ranks Hawk connector from the tools menu, then ask — e.g. "What content gaps do I have against my 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

I don’t see a Developer Mode toggle

It requires a Plus, Pro, Business, Enterprise, or Education plan, and OpenAI is still rolling it out — availability and exact menu wording can vary by account.

Why the extra security warning?

ChatGPT flags custom connectors because they run third-party code on your behalf. The Ranks Hawk connector is read-only and scoped to your own account.

The connector isn’t showing up in chat

Enable it from the tools/plugins menu (usually the paperclip or "+" icon) in the conversation before asking your question — adding a connector doesn’t turn it on by default.

Using a different tool? See all supported clients.