mcpField
R
RankJot

RankJot

Local
github.com/epolatBusiness & Marketing0Updated 6w ago
Repository

About RankJot

RankJot is an MCP server for AI assistants and users who need live Google organic rankings by domain, keyword, and country. Each lookup also returns the top 10 results and remaining monthly quota.

Key features

  1. 01Look up a domain's organic position
  2. 02Select a Google market by country
  3. 03Return the top 10 organic results
  4. 04Show monthly lookup quota

Use cases

  1. 01Check a domain's ranking for a target keyword
  2. 02See which domains rank above a site
  3. 03Compare rankings across Google country markets

MCP support

Exposes the `check_rank(domain, keyword, country="us")` tool to MCP clients. It runs as a stdio server through `uvx` or an installed `rankjot-mcp` command and requires a `RANKJOT_API_KEY`.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "epolat-rankjot": {
      "command": "uvx",
      "args": [
        "rankjot-mcp"
      ],
      "env": {
        "RANKJOT_API_KEY": "<RANKJOT_API_KEY>"
      }
    }
  }
}
Run commanduvx rankjot-mcp
Environment variables to set
RANKJOT_API_KEYSecretYour RankJot API key (rjk_...). Free accounts include 25 lookups a month: https://rankjot.com/account

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypirankjot-mcp0.1.0

Tools

1

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
domainstringYes
countrystringNo
keywordstringYes

Details

From the project README

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.

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:

errorMeaning
configRANKJOT_API_KEY isn't set
unauthorizedThe key is wrong or was revoked
api_trial_limitThis month's included lookups are used up
quota_exceeded / rate_limitedMonthly quota used, or too many calls per minute
provider_error / networkThe 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.

Links

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.