Tool reference

The Ranktracker MCP server exposes 14 tools — 13 read-only and one write (run_report). Your client discovers them automatically with tools/list, so you rarely need to write a call by hand; this page is for understanding what's available and what each tool takes.

:::info Generated from the live server The tool list below is generated from the server's own tool definitions — the same metadata your client receives from tools/list — so it never drifts from what the server actually accepts. :::

How a tool call works

Discover the tools:

{ "jsonrpc": "2.0", "id": 1, "method": "tools/list" }

Invoke one with tools/call — arguments is a JSON object matching the tool's schema:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "list_keywords",
    "arguments": { "domain_uuid": "3f2a…", "limit": 20, "tracked": true }
  }
}

The result is a text block — pretty-printed JSON by default, or TOON with ?format=toon:

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [{ "type": "text", "text": "{ …tool data… }" }],
    "isError": false
  }
}

Failures (a bad uuid, an unauthorized object, a run_report on an already-run period) come back with isError: true and a message in the text block, rather than an empty success.

:::tip Everything is keyed by uuid Call list_domains first and pass the returned uuid as domain_uuid to the keyword, competitor, backlink and audit tools. Keyword uuids come from list_keywords; report uuids from list_reports. List tools accept a limit (default 50, max 200; clamped server-side). :::

Tools

list_domainsread-only

List domains (tracked websites) in the account with their uuids. Call this first — the other tools take the returned uuid as domain_uuid. Returns the newest 50 by default; pass host to find a specific one in a large account rather than paging through everything.

Argument	Type	Required	Description
limit	integer		Max domains to return (default 50, max 200)
host	string		Only domains whose host contains this text, e.g. "ranktracker"

get_domainread-only

Fetch one domain by uuid, including monitor limits and configuration.

Argument	Type	Required	Description
domain_uuid	string	✅	Domain uuid from list_domains

list_keywordsread-only

List tracked keywords for a domain with their latest ranking results (ordered best organic position first) and AI Overview visibility (aiOverview is null when the SERP has none; full text via get_keyword_rankings). Returns keyword uuids for use with get_keyword_rankings.

Argument	Type	Required	Description
domain_uuid	string	✅	Domain uuid from list_domains
limit	integer		Max keywords to return (default 50, max 200)
tracked	boolean		Filter by tracked status

get_keyword_rankingsread-only

Ranking history for ONE keyword: daily organic/absolute/local-pack positions, SERP feature ownership over time, and the current AI Overview if present. Dates default to the last month. Call once per keyword.

Argument	Type	Required	Description
domain_uuid	string	✅	Domain uuid from list_domains
keyword_uuid	string	✅	Keyword uuid from list_keywords
start_date	string		YYYY-MM-DD (default: 1 month ago)
end_date	string		YYYY-MM-DD (default: today)

list_competitorsread-only

List the competitor websites configured for a domain.

Argument	Type	Required	Description
domain_uuid	string	✅	Domain uuid from list_domains
limit	integer		Max competitors to return (default 50, max 200)

list_keyword_researchread-only

List existing keyword research sessions (Keyword Finder) in the account. Read-only: this does not start new research.

Argument	Type	Required	Description
limit	integer		Max sessions to return (default 50, max 200)

get_monitor_summaryread-only

Backlink, keyword and website-audit monitor summary for one domain host (e.g. "example.com").

Argument	Type	Required	Description
host	string	✅	Domain host, e.g. "example.com"

list_backlinksread-only

List backlinks for a domain (newest first): source/target URLs, anchor, dofollow, spam score, ranks, first/last seen.

Argument	Type	Required	Description
domain_uuid	string	✅	Domain uuid from list_domains
limit	integer		Max backlinks to return (default 50, max 200)

get_backlink_summaryread-only

Backlink profile trend for a domain (newest first): domain rank, total/new/lost backlinks, referring domains over time.

Argument	Type	Required	Description
domain_uuid	string	✅	Domain uuid from list_domains
limit	integer		Max history snapshots to return (default 30, max 200)

list_reportsread-only

List configured SEO reports in the account with their uuids (for get_report and run_report) and latest run status.

Argument	Type	Required	Description
limit	integer		Max reports to return (default 50, max 200)

get_reportread-only

Fetch one report by uuid: schedule, recipients, latest run (with file url when complete) and recent run history.

Argument	Type	Required	Description
report_uuid	string	✅	Report uuid from list_reports

list_website_auditsread-only

List website audits for a domain (newest first) with status, progress and scores.

Argument	Type	Required	Description
domain_uuid	string	✅	Domain uuid from list_domains
limit	integer		Max audits to return (default 50, max 200)

get_website_auditread-only

Fetch one website audit by uuid: crawl stats, scores, warnings and technical checks (SSL, HTTP/2, sitemap, robots.txt, indexing).

Argument	Type	Required	Description
audit_uuid	string	✅	Audit uuid from list_website_audits

run_reportwrite

Generate a run of an existing report (by uuid from list_reports). Does NOT email anyone and costs no credits; at most one run per report period — if the period already ran, the existing run is reported back as an error message.

Argument	Type	Required	Description
report_uuid	string	✅	Report uuid from list_reports
format	string		Optional output format override (e.g. "pdf")

Next steps

• Overview — MCP-vs-REST, response formats, rate limits.
• Connect a client — token creation and per-client setup.