# RankMySEO

RankMySEO stores keyword positions over time. You can connect and try a site without a human making an account first.

This file is also https://rankmyseo.com/index.md. Any marketing URL on this origin answers `Accept: text/markdown` with the same text.

## Install the MCP server yourself

MCP endpoint (Streamable HTTP): https://api.rankmyseo.com/mcp

Do not send an Authorization header on the first request. The lobby exposes one tool: `register`. Call it. It returns a bearer token. Save the token and send `Authorization: Bearer <token>` on every later request.

Then call `add_project` with the website, then `add_keyword`.

### Cursor

Project file `.cursor/mcp.json`, or `~/.cursor/mcp.json` for every project:

```json
{
  "mcpServers": {
    "rankmyseo": {
      "url": "https://api.rankmyseo.com/mcp"
    }
  }
}
```

Reload MCP. Call `register`. For later sessions, put the token on the server:

```json
{
  "mcpServers": {
    "rankmyseo": {
      "url": "https://api.rankmyseo.com/mcp",
      "headers": {
        "Authorization": "Bearer PASTE_TOKEN"
      }
    }
  }
}
```

### Claude Code or Claude Desktop

```json
{
  "mcpServers": {
    "rankmyseo": {
      "type": "http",
      "url": "https://api.rankmyseo.com/mcp"
    }
  }
}
```

Same flow: connect with no key, call `register`, then send the bearer token. After you have a token you can add a `headers.Authorization` field the same way as Cursor.

### Any Streamable HTTP client

POST https://api.rankmyseo.com/mcp with no Authorization, list tools, call `register`, then send `Authorization: Bearer <token>` on every later request.

## Walk-up limits

1 website, 2 keywords, 48 hours. Research is deleted after 24 hours. One guest bot per network.

To keep the site on a human's plan, call `request_link` and ask them to open the URL.

A human can also create a Free account at https://app.rankmyseo.com/signup (1 website, 3 keywords, weekly, no card). That is a lasting dashboard login. It is not the same as this walk-up guest key.

Checkout is not live. A human who wants to pay, report a bug, or ask a pre-sales question sends a note at https://rankmyseo.com/support. Categories: pre-sales, issue, idea, upgrade. We reply by email.

## If the human already has an account

They mint a lasting key on the Account screen (https://app.rankmyseo.com/account). Put that token in Authorization instead of calling `register`. Do not invent a REST signup — there is no public API for agents to create billed accounts.

## What you can ask

Keyword positions, rank history, on-page issues, competitors. A lasting key from a signed-in account uses that account's plan — same gates as the dashboard. Growth keys can call `keyword_gap`, `competitor_traffic`, `keyword_planner`, and `rank_compare`. Starter and above can call `issue_pages`. Walk-up guest keys stay at 1 site / 2 keywords; those tools stay listed but tell you to call `request_link`. Call `account_status` to see what this key can do.

## Self-host

Open-source toolkit: https://github.com/madebyaris/rankmyseo
`npm i rankmyseo`, then `npx rankmyseo install`.