Rank tracker MCP server for Claude Code and Cursor

KeyRank's MCP server is a read-only SEO MCP server for rank tracking: it lets Claude Code, Cursor and other AI assistants read the positions, SERPs and AI Overview citations KeyRank stores for your keywords, so you can ask about your rankings in plain language. It answers from the checks KeyRank already stored, not from a live Google search.

By Serhii Hromov, the developer who built KeyRank. Last updated 13 November 2026.

What kind of SEO MCP server this is

Most SEO MCP servers run live lookups, such as keyword research, backlink data and site audits, and often bill per call. KeyRank's is narrower. It reads the history KeyRank already stored for the keywords you track: positions and ranking URLs from each check, the stored SERP, AI Overview citations and your notes. That makes it good at questions about change over time:

What moved this week, and which keywords crossed into or out of the top 10.
When Google switched the ranking URL for a keyword from one of your pages to another.
When an AI Overview stopped citing you on a keyword you still rank for.

It can't do keyword research, backlinks or site audits, and it only knows the keywords you track. Use it next to a research tool and Search Console, not instead of them.

Set up in two minutes

Create a key in Settings → Developer access. You can have up to 5 keys. Each key is shown once, so copy it before you close the dialog, and you can revoke it at any time.

Add the server to your client. The endpoint is https://api.key-rank.com/mcp (streamable HTTP), with your key in an Authorization: Bearer header. Replace YOUR_KEY with your key.

Claude Code

Run in your terminal.

claude mcp add --transport http keyrank https://api.key-rank.com/mcp --header "Authorization: Bearer YOUR_KEY"

Cursor

Add to ~/.cursor/mcp.json.

{
  "mcpServers": {
    "keyrank": {
      "url": "https://api.key-rank.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_KEY"
      }
    }
  }
}

VS Code

Add to .vscode/mcp.json in your workspace.

{
  "servers": {
    "keyrank": {
      "type": "http",
      "url": "https://api.key-rank.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_KEY"
      }
    }
  }
}

Codex CLI

Add to ~/.codex/config.toml, then set KEYRANK_API_KEY to your key in your shell.

[mcp_servers.keyrank]
url = "https://api.key-rank.com/mcp"
bearer_token_env_var = "KEYRANK_API_KEY"

Gemini CLI

Run in your terminal.

gemini mcp add --transport http --scope user --header "Authorization: Bearer YOUR_KEY" keyrank https://api.key-rank.com/mcp

What your assistant can do

The server has nine read tools. You don't call them yourself: ask a question and the assistant picks the tools it needs.

Rankings

list_projects: Your projects, so the assistant knows which site you mean.; Try: “Which projects do I track in KeyRank?”
get_rankings: Current position, ranking URL and 7-day and 30-day change for every keyword, or the daily history.; Try: “Show my keywords ranking 11 to 20 and how they moved over 30 days.”
get_movers: What changed: gained, lost, entered, dropped out, crossed the top 3 or top 10, and URL switching.; Try: “Which keywords dropped out of the top 10 this week?”
get_summary: Totals for top 3, 10, 30 and 100, visibility and estimated clicks, compared with the previous week.; Try: “Summarise this week against last week for my main project.”

Pages and SERPs

get_page: Which of your URLs rank, and for which keywords.; Try: “Which keywords does my /pricing page rank for?”
get_serp: The stored results for one keyword.; Try: “Who ranks above me for "automatic gate opener"?”
get_competitors: Competitor domains in your tracked results over the last 7 days.; Try: “Which domains show up most often on my keywords?”

AI Overviews and notes

get_ai_overview: Whether Google showed an AI Overview for your keywords, and which sites it cited. Competitor citations are on paid plans.; Try: “Where do I rank in the top 10 but the AI Overview doesn't cite me?”
get_notes: Your dated notes, so changes can be read next to what you did.; Try: “Did rankings move after the title change I noted last month?”

Claude Code for SEO: questions it can answer from your rank data

Claude doesn't know where your pages rank. Connected to KeyRank in Claude Code, it can read your stored positions, SERPs and AI Overview citations, then compare weeks, group keywords by page or point to the ones worth working on. The numbers come from KeyRank's checks, so check anything you act on in the KeyRank dashboard or Search Console.

“Compare my top 10 count with last week and list the keywords behind the change.”
“Find keywords where Google switched my ranking URL this month, and tell me which pages compete with each other.”
“For keywords where I rank 4 to 10, show who ranks above me and whether an AI Overview cites them.”
“Read my notes from last month and tell me which keywords moved within a week of each one.”

What it can't do

No live Google checks. Every answer comes from the checks KeyRank already stored. The assistant can't run a new search or refresh a position.
Read-only. API keys can read your projects. They can't add keywords, change projects or touch billing.
The free plan stores weekly checks down to the top 30, and that is what the assistant sees on a free account. Paid plans store daily checks down to the top 100.
No clients that require OAuth yet, so ChatGPT can't connect. Clients that accept a bearer header for a remote HTTP server work.

Limits

Each account has a weekly allowance that refills continuously. Most calls cost 1 to 3 units; large reads cost more on bigger projects. Every response tells the assistant how much is left. Normal use does not reach it. You can see your own remaining allowance in Settings → Developer access.

MCP server fair-use limits by plan
Plan	Units a week	Requests a minute
Free	100	20
Starter	1,000	60
Growth	2,500	60
Pro	5,000	60
Business	10,000	60

Privacy and security

A key reads only the projects of the account that created it.
Revoke a key at any time in Settings → Developer access.
Keys are stored hashed. KeyRank shows a key once, when you create it, and can't show it again.

Questions & answers

What is a rank tracker MCP server?

An MCP server that gives an AI assistant read access to a rank tracker's data, so it can answer questions about your keyword positions, ranking URLs and search results. KeyRank's serves the checks it stored for the keywords you track.

Is there a free SEO MCP server?

KeyRank's MCP server is included on the free plan: 25 keywords, checked weekly down to the top 30, with no credit card. The assistant reads the same stored checks the free dashboard shows.

Does the assistant search Google live?

No. KeyRank's MCP server answers from the checks KeyRank already stored for your keywords: daily on paid plans, weekly on the free plan. Positions, SERPs and AI Overview citations are as of the latest stored check.

Which AI assistants can connect?

Clients that accept a bearer header for a remote HTTP MCP server: Claude Code, Cursor, VS Code, Codex CLI and Gemini CLI. Clients that require OAuth, such as ChatGPT, are not supported yet.

Does it work with ChatGPT?

Not yet. ChatGPT connects to remote MCP servers through OAuth, and KeyRank's server accepts only an API key in a bearer header for now.

Is the MCP server on the free plan?

Yes, on every plan. On a free account the assistant sees what the free plan stores: weekly checks down to the top 30. Paid plans store daily checks down to the top 100, and add AI Overview competitor citations.

Can the assistant change my projects?

No. API keys are read-only. The assistant can read your projects, rankings, SERPs, AI Overviews and notes, and nothing else.

Will I run into the limit?

Normal use does not reach it. Each account has a weekly allowance that refills continuously and grows with the plan, and every response tells the assistant how much is left.

Ask your assistant about your rankings.

Start free with 25 keywords, then create a key in Settings → Developer access.

Start free Create a key