Read-only · MCP

MCP Server

Connect your AI assistant (Claude Desktop, Claude Code, or any MCP client) to your own rank-tracking data and opportunity reports. Read-only, scoped to your account.

Endpoint

https://websiterankingchecker.com/mcp

Transport: Streamable HTTP (JSON-RPC 2.0 over POST). Authentication: OAuth 2.1 (one-click, recommended) or a bearer token in the Authorization header.

Connect from Claude (one-click)

Claude supports this server as a custom connector with full OAuth sign-in, so no token handling is needed:

  1. In Claude (web or desktop), open Settings → Connectors → Add custom connector.
  2. Paste https://websiterankingchecker.com/mcp as the URL and click Add, then Connect.
  3. A Website Ranking Checker window opens: log in with your Keywords Everywhere API key if asked, review the read-only access summary, and click Approve.

Claude Code works the same way without a token: run the command below, then use /mcp inside Claude Code to authenticate in your browser.

claude mcp add --transport http website-ranking-checker https://websiterankingchecker.com/mcp
Access is read-only, scoped to your account, and independent of your Keywords Everywhere API key. These tools read cached data only and never spend your KE credits. Disconnect any time in Settings → MCP Access. (Custom connectors require a paid Claude plan.)

Alternative: personal access token

For clients without OAuth support, or if you prefer a static credential:

  1. Open Settings → MCP Access in Website Ranking Checker.
  2. Click Generate token and copy it. It is shown only once, and can be revoked any time from the same screen.
  3. Add the server with the token as a Bearer header:
claude mcp add --transport http website-ranking-checker \
  https://websiterankingchecker.com/mcp \
  --header "Authorization: Bearer wrc_mcp_YOUR_TOKEN"

Other clients (generic config):

{
  "mcpServers": {
    "website-ranking-checker": {
      "type": "http",
      "url": "https://websiterankingchecker.com/mcp",
      "headers": { "Authorization": "Bearer wrc_mcp_YOUR_TOKEN" }
    }
  }
}

Available tools

list_domains

List the Google Search Console domains on your account, each with latest-day totals (keywords, impressions, clicks, average position). Start here to get domain ids for the other tools.

Parameters: none

get_dashboard

Account or per-domain overview: current vs previous-period stats (avg position, clicks, impressions), counts of improved/dropped/unchanged keywords, the biggest ranking movers, opportunity-report counts, and the Search Score series.

Parameters: domain_id, country, device_id, movers_period

list_tracked_keywords

List your tracked keywords with best position across domains, 1d/7d/30d position change, clicks, impressions, Keywords Everywhere volume/CPC/value, landing page, and domain. Paginated and sortable.

Parameters: domain_id, country, device_id, search, sort, order, limit, offset

get_keyword_history

Daily position history (and current per-domain rankings) for one tracked keyword. Use a keyword_id from list_tracked_keywords.

Parameters: keyword_id, domain_id, country, device_id, days, start_date, end_date

list_opportunities

Counts for all 9 opportunity reports (AI-style queries, CTR optimization, content decay, quick wins, cannibalization, dead pages, rising keywords, device ranking gap, device cannibalization). Use this to see which reports have findings, then get_opportunity_report for the rows.

Parameters: domain_id, country, device_id

get_opportunity_report

Rows for one opportunity report. Reports: questions (long conversational AI-style queries, 10+ words, grouped by intent: 1=learn, 2=compare, 3=act), ctr_optimization (top-10 keywords below expected CTR), content_decay (pages losing clicks), quick_wins (page-2 keywords near page 1), cannibalization (keywords split across pages), dead_pages (pages that lost all clicks), rising_keywords (gaining position), device_ranking_gap and device_cannibalization (desktop vs mobile differences).

Parameters: report, domain_id, country, device_id, sort, order, limit, offset, search

Example prompts

Once connected, just ask in plain language, your client picks the right tools and can chain them. A few to start:

Prioritized audit: “Pull my dashboard, check which opportunity reports have the most findings, then show my top quick wins and any keyword cannibalization. Give me the 3 highest-impact things to fix first and why.”
Quick wins: “Show my top 20 page-2 keywords that are close to page 1, and which pages rank for them.”
What’s at risk: “What are my biggest ranking drops in the last 7 days, and how many impressions are at risk?”
Keyword history: “How has my ranking for a specific keyword changed over the last 90 days?”
CTR gaps: “Which of my top-10 keywords get far fewer clicks than their position should earn?”
Mobile vs desktop: “Find keywords where my mobile ranking lags desktop, and which pages are involved.”

Notes

  • All tools are read-only and return only data from your own account.
  • Country scope defaults to global (all countries); device defaults to all devices.
  • Start with list_domains to get domain ids, then get_dashboard or list_opportunities for an overview.