MCP / VS Code
Ask GitHub Copilot Chat to pull your competitor data directly — no copy-pasting between tabs.
Requires VS Code 1.101+ and the GitHub Copilot Chat extension.
Add the server
Command Palette → MCP: Add Server → HTTP → paste the URL below, or add it to .vscode/mcp.json directly:
{
"servers": {
"rankshawk": {
"type": "http",
"url": "https://www.rankshawk.com/api/mcp"
}
}
}Authenticate
Click the Auth CodeLens above the server entry in mcp.json — or it prompts automatically the first time Copilot calls a tool. Sign in with your Ranks Hawk account and approve.
Use it
Toggle Agent mode next to the Copilot Chat input, then ask — e.g. "Find me a content gap against my competitors."
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.
Nothing happens when I click "Add to VS Code"
Requires VS Code 1.101 or later with the GitHub Copilot Chat extension installed. Use the manual mcp.json setup below if the deeplink doesn’t work.
Tools aren’t showing up in chat
MCP tools only work in Copilot Chat’s Agent mode — toggle it from the mode picker next to the chat input.
How do I re-authenticate?
Open the mcp.json file, find the "rankshawk" entry, and click the Auth CodeLens above it.
Using a different tool? See all supported clients.