Skip to main content
Glama
io.github.epolat/rankjot-mcp

io.github.epolat/rankjot-mcp

by epolat

RankJot MCP server

Real Google rankings as a tool for AI assistants. Ask Claude (or any MCP client) "where does example.com rank for best running shoes in the UK?" and it makes a live lookup instead of guessing.

What it does

One tool:

check_rank(domain, keyword, country="us") returns

  • position: the domain's 1-based Google organic position, or null if it isn't in the results checked

  • url: which of the domain's pages ranks

  • results: the top 10 organic results (position, domain, url, title), so the assistant can answer "who's above me?" without another call

  • quota: lookups used and remaining this month

Positions are organic results only (ads, maps and answer boxes aren't counted), for the Google market you pass as country.

Related MCP server: mcp-seo-serp

Setup

1. Get an API key. Sign in at rankjot.com, open Account → API access → Generate key. Free accounts include 25 lookups a month; the API plan ($20/mo) includes 5,000.

2. Add the server to your client. It runs with uvx, so there's nothing to install by hand.

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "rankjot": {
      "command": "uvx",
      "args": ["rankjot-mcp"],
      "env": { "RANKJOT_API_KEY": "rjk_your_key_here" }
    }
  }
}

Any other client that launches stdio servers takes the same command, uvx rankjot-mcp, with RANKJOT_API_KEY in its environment.

Prefer pip? pip install rankjot-mcp, then use rankjot-mcp as the command.

3. Restart the client and ask a ranking question.

Errors

Failures come back as a normal result with an error field, so the assistant can tell you what happened instead of retrying blindly:

error

Meaning

config

RANKJOT_API_KEY isn't set

unauthorized

The key is wrong or was revoked

api_trial_limit

This month's included lookups are used up

quota_exceeded / rate_limited

Monthly quota used, or too many calls per minute

provider_error / network

The lookup couldn't be made; try again

Every call spends one lookup. Models are happy to call tools in loops, so if you ask about many keywords at once, say how many lookups it may use.

Privacy

The domain, keyword and country you check are sent to rankjot.com to perform the lookup. See the privacy policy.

License

MIT

Available Tools

1 tool
check_rankA

Check where a domain ranks on Google for a keyword.

Args: domain: the site to look up, e.g. "example.com" (scheme/www/path ignored). keyword: the search query to rank for. country: ISO country code for the Google market (default "us"), e.g. "gb", "de". Rankings differ by country, so pass the market the user cares about.

Returns a dict with the 1-based position (null if the domain isn't in the results checked), the ranking url, the top-10 organic results, and the remaining quota. Failures come back as a dict with an error field.

Inputs: domain (required), keyword (required), country.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.6/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only a single tool, there is no possibility of overlap or confusion about which tool to invoke. The tool's purpose is well-defined and unambiguous.

    Naming Consistency5/5

    The tool name 'check_rank' uses a clear verb_noun snake_case convention. Although there is no comparison set, the naming is internally consistent and predictable.

    Tool Count4/5

    The server is narrowly scoped to a single rank-checking operation, so one tool is serviceable. However, related features like batch ranking checks or quota status would strengthen the server, making the count slightly thin.

    Completeness4/5

    The tool covers the core 'check rank' operation completely and returns relevant data. The lack of batch operations, historical tracking, or multi-keyword support leaves a notable gap for a rank-checking service.

    Maintenance

    ActivitySlowing
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      D
      maintenance
      Connects AI assistants to SE Ranking's SEO and project management APIs to enable natural language queries for keyword research, backlink analysis, and technical audits. It supports comprehensive tasks including competitive analysis, domain traffic tracking, and AI search visibility monitoring.
      100
      1
      Apache 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to retrieve Google organic search results via DataForSEO for SEO and SERP analysis.
      297 npm
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI assistants to search Google SERPs, track rankings across locations, run Lighthouse SEO audits, find broken internal links, analyze backlinks, and get keyword volume data through a hosted service.
      15
      16 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Live Google search for AI agents: organic results with positions by country, language and device, plus People also ask questions and related searches; a domain's current rank for a keyword; the open markets with their default languages. Every search is fresh, usually 2–3 seconds per page. New accounts get 100 free searches.
      10
      3
      303 npm
      1
      MIT