MCP Tools

The server exposes 19 tools. Each maps to a REST API endpoint and behaves identically — same validation, same permissions, same responses. Conventions used below:

• domainId is the domain’s UUID from list_domains.
• Windows are a rolling period ("7d", "30d", "90d", "365d") or an explicit startDate/endDate (YYYY-MM-DD, UTC).
• Tools marked write require a key with the write scope and the owner or manager role on the domain.

​

Analytics tools (read)

​

list_domains

Lists every domain the account can access — owned and shared — with each domain’s UUID and your role. Takes no arguments. Agents should call this first; most other tools need the UUID.

​

get_crawl_summary

Daily crawler-visit rollups: totals per domain and per bot (Googlebot, GPTBot, …) with verification tiers and bot intents. Equivalent to Export Crawl Analytics.

​

get_page_analytics

Per-path crawl counts for one domain — which pages bots visit and how often. Equivalent to Export Page Analytics.

​

get_ai_referrals

Daily counts of human visits referred by AI assistants (ChatGPT, Perplexity, …). Equivalent to Export AI Referrals.

​

export_crawl_logs

Raw per-request crawl log events for one domain: timestamp, path, bot, verification verdict, what was served, and status. Equivalent to Export Crawl Logs.

​

get_bot_definitions

The bot taxonomy used in analytics responses: operators, bot IDs, categories, intents, and the published definitions version. Equivalent to Bot Definitions.

​

Cache rule tools

Cache rules set how often pages matching a path pattern are re-rendered in the background. Rule creation requires Pro or above on the domain owner’s plan; the number of rules and the fastest allowed refresh depend on the plan.

​

list_cache_rules (read)

Returns the rules plus the plan’s rule limit and minFreshHours — the fastest refresh cadence the plan allows.

​

create_cache_rule (write)

Matching priority is derived from pattern specificity automatically (the most specific pattern wins); it can’t be set by hand.

​

update_cache_rule (write)

Same fields as create, all optional; plus ruleId (required). Only the fields you pass change.

​

delete_cache_rule (write)

Takes domainId and ruleId. Matching pages fall back to the domain’s default freshness.

​

Blocked path tools

Blocked paths are excluded from prerendering, with optional per-path robots directives.

​

list_blocked_paths (read)

​

create_blocked_path (write)

​

update_blocked_path (write)

Same fields as create, all optional; plus blockedPathId (required).

​

delete_blocked_path (write)

Takes domainId and blockedPathId. Matching pages become eligible for prerendering again.

​

Routing rule tools

Redirects and proxies on your live domain — these affect real visitor traffic, not just bots. The tools mirror the routing rules endpoints, including source path patterns and target rules.

​

list_routing_rules (read)

​

create_routing_rule (write)

​

update_routing_rule (write)

Same fields as create, all optional; plus ruleId (required).

​

delete_routing_rule (write)

Takes domainId and ruleId. Traffic matching sourcePath stops being redirected or proxied immediately.

​

Actions

​

purge_cache (write)

Re-renders one page or an entire site right now, spending the account’s render budget. Equivalent to Purge Cache. Note this tool takes the hostname, not a UUID.