xSpeed Cache is officially live! Get 50% OFF during Launch Week — Lifetime starts at just $79Lifetime from $79 — 50% OFF, Launch Week! See Plans →

See Plans →
Features
xSpeed Hub Pricing Docs Blog Scan
Appearance
Get Plugin

Warm the WordPress cache with Grok Bot

Warming the WordPress cache with Grok Bot means asking one of your named Bots to start the xSpeed preloader through the xspeedhub plugin and to keep reading the crawl from its cloud computer after you close the laptop.

list_sitesget_cache_statusget_settingsupdate_settingsstart_preloaderget_preloader_statusstop_preloader

Last updated: October 2026

Example session · Grok Bot

You: Use @xspeedhub (xSpeed Hub) to warm shop tonight. I just published the new product pages.

get_preloader_status(site: shop) read-only
→ idle, no run in progress

Grok Bot: No crawl is running on shop, so a start queues the whole sitemap. This needs your approval.

You: Allow once.

start_preloader(site: shop) changes site
→ Queued 344 URLs from the sitemap; pages are fetched in the background

get_preloader_status(site: shop) read-only
→ Finished, 344 of 344 URLs processed; 14 answered HTTP 403

Grok Bot: Morning report: 330 of 344 pages on shop are warm. 14 answered 403, which usually means a firewall rule is blocking the warmer by its user-agent, xSpeed-Warmer/1.0. Allow it on the server and I will start the crawl again.

01

How Grok Bot handles this

A crawl takes longer than a chat, and a Bot is still at work after you leave. You publish a batch of product pages late in the day, attach @xspeedhub and ask the Bot to warm shop and tell you in the morning how it went. It calls start_preloader, and the plugin on the site queues the sitemap and fetches the pages in the background. Before it reports, the Bot reads get_preloader_status for the processed count, the last URL and any errors.

The plugin was added once from chat as a custom remote HTTPS MCP server and is account-wide, so any of your Bots can warm a site with it. If the crawl stalls with pages answering 403 or 406, the status message names the warmer's user-agent, xSpeed-Warmer/1.0, which a server firewall rule needs to allow, and the Bot can pass that on to whoever runs the server. If the module is off, the Bot can propose turning it on with update_settings, and stop_preloader is there if the crawl slows the site; pages already warmed stay cached.

Grok Bot offers Allow once, Always allow or Deny when an action needs approval. Always allow saves a rule, so later starts stop asking. Auto-review rules under Settings, General, Auto-review can force Ask first or allow matching actions, and Ask first wins when both match. xSpeed Hub has no confirmation step of its own, and it calls the preloader low-risk, asking the agent to confirm only when the site is unclear or the call covers every site. Add Ask first rules for start_preloader, stop_preloader and update_settings, so each one waits for your Allow once.

02

Set up Grok Bot once

Already connected? Skip to the prompts. Alternatives and troubleshooting are on the Grok Bot guide.

1Put your sites in xSpeed Hub

Sign in at app.xspeedcache.com with Google or email; the Hub is free and has no site cap. Then connect each WordPress site from its own dashboard: click Connect Hub in the xSpeed Cache top bar, then Connect via xSpeed Hub. Each site needs the free xSpeed Cache plugin.

2Ask your Bot to add xSpeed Hub

In a chat with your Bot, ask it to add a custom remote HTTPS MCP server with this URL. xAI says a plugin you add from your own chat is personal and account-wide, so every Bot on your account can use it. When the browser opens, approve access on the xSpeed Hub page.

Text
Add a custom remote HTTPS MCP server called xspeedhub with the URL https://app.xspeedcache.com/xspeed/mcp and sign me in.

3Attach it and ask a first question

Type @ in a chat to attach the xspeedhub plugin to the task, then ask something that names xSpeed Hub. A list of your sites means the connection works.

Text
Use @xspeedhub (xSpeed Hub) to list my sites and tell me which ones have page caching turned off.
1 / 3

Full Grok Bot setup, sign-in options and FAQ

Before you send a prompt that changes something

Reads change nothing on your sites, though contact_support emails xSpeed support. Writes run once your connection allows them, so your client's approval prompt and a read-only connection (the token's Read-only everywhere switch, or a Viewer sign-in) are the gates that matter. When an action needs approval, Grok Bot offers Allow once, Always allow or Deny. Always allow saves a rule, so the same kind of call no longer stops for you. Auto-review rules under Settings, General, Auto-review can force Ask first or allow matching actions automatically, and Ask first wins when both match. xSpeed Hub has no confirmation step of its own, so a Hub write tool you always allow runs as soon as your connection allows writes. Add Ask first rules for purge_cache, update_settings, toggle_cache, optimize_site and the other write tools. For read-only access, sign in as a Viewer member of the workspace.

03

What do I ask?

Three prompts written for Grok Bot. More for this job are below.

Prompt for Grok Bot
Use @xspeedhub (xSpeed Hub) to start the preloader on shop and report the processed count in the morning.
Prompt for Grok Bot
With xSpeed Hub, read the preloader status on every site and list any crawl that shows 403 or 406 errors.
Prompt for Grok Bot
Use xSpeed Hub to stop the preloader on blog. It is slowing the server during the import.
04

What happens, step by step

The first visitor to an uncached page pays for building it. The preloader fixes that by visiting your pages first. Through xSpeed Hub an agent can start the crawl on one site or on every site in a workspace, watch how far it has got, and stop it. The crawl runs inside WordPress in the background; the agent only starts it, reads its progress and stops it.

01

Check the cache and the preloader

get_cache_status tells the agent whether page caching is on, because there is nothing to fill when it is off. get_preloader_status shows whether a crawl is already running, so the agent does not start a second one.

02

Make sure the preloader is switched on

The preloader module is off on a fresh install, and the site refuses start_preloader until it is on. The agent can read the module with get_settings and, if you agree, switch it on with update_settings on the preloader module. The Hub tells the agent to briefly confirm intent before an update_settings call, but that is guidance to the agent, not a lock.

03

Start the crawl

start_preloader makes the site read its sitemap, follow any nested sitemap indexes, drop URLs that your cache exclusion rules skip, and queue the rest. The call returns once the queue is built; the pages are then fetched in the background, a few per run. For every site at once the agent passes site: "all", and the Hub starts the sites one after another with a one-second pause.

04

Watch the progress

get_preloader_status reports whether a crawl is running, how many URLs it has processed out of the total, the last URL it visited and the most recent errors. It works on one site at a time, so for several sites the agent calls it once per site.

05

Read what failed

A page that answers 403 or 406 usually means a server firewall is blocking the warmer by its user-agent, not that the page is broken. The status message names the user-agent to allow. A crawl that queues no URLs is reported as an error with the reason, not as a success.

06

Stop it if the server struggles

stop_preloader ends a running crawl. It is safe mid-run: pages already warmed stay cached. The agent can stop one site or every site in the workspace.

05

Reference

Start and stopstart_preloader and stop_preloader (write)
Progressget_preloader_status (read): running or not, processed out of total, last URL, recent errors
What gets crawledThe sitemap (the WordPress one at /wp-sitemap.xml unless you set another), nested indexes followed, excluded URLs skipped
NeedsThe preloader module switched on (it is off by default) and page caching on
Pages per run5 by default, 1 to 50, set in the preloader module
Schedule settingmanual, hourly, daily or weekly, set in the preloader module
Every site at oncestart_preloader and stop_preloader accept site: "all"; get_preloader_status does not
Fan-out pacingSites start one after another with a 1 second pause, one result per site
Warmer user-agentxSpeed-Warmer/1.0, the string a firewall rule would need to allow
StoppingSafe mid-run; warmed pages stay cached
Read-only accessA Viewer member's sign-in, or the connection token with Read-only everywhere on: start_preloader and stop_preloader are refused; get_preloader_status works. An OAuth sign-in by anyone else gets the scopes the client asks for.
ConfirmationNone on the Hub; your client's prompt is the gate
06

Rules worth keeping

  • Warm after a purge, not instead of one. The Hub tells the agent that starting the preloader after a purge saves the next visitor from paying for the rebuild.
  • A crawl requests every page in the sitemap, so it adds load to the origin. Start with one site, and on a small host keep Pages per run low or stop the crawl if the site slows.
  • start_preloader and stop_preloader are write tools. The Hub calls the preloader low-risk and only asks the agent to confirm when the target site is unclear or the call covers every site, so your client's approval prompt and read-only access (a Viewer sign-in, or the connection token with Read-only everywhere on) are the gates that matter.
  • A fan-out only starts the crawls. Check each site with get_preloader_status afterwards, and treat some sites failing to start as a partial result, not a failure of the whole call.

Good to know with Grok Bot

A routine is a good fit for reading a crawl and a poor fit for starting one. Routines run on the Bot's cloud computer on a schedule with nobody to answer an approval, and xAI notes that a Test run performs real work, including calls to connected tools, so testing a routine that starts the preloader starts a real crawl. The preloader module has its own Schedule setting in WordPress, manual, hourly, daily or weekly, which handles routine warming without an agent, so keep the Bot's routine to a morning report from get_preloader_status on each site. The Hub's Read-only everywhere switch belongs to the connection token, which this OAuth plugin does not send; a sign-in as a Viewer member is the read-only option. On a team plan, a Cursor connector policy can block the plugin, which shows as Disabled by team admin.

07

More prompts for this job

They work in any client connected to xSpeed Hub.

Prompt
Use xSpeed Hub to start the preloader on shop and tell me how many URLs it queued.
Prompt
Using xSpeed Hub, how far through its crawl is blog? Show processed against total and any errors.
Prompt
With xSpeed Hub, purge the cache on docs, then warm it again.
Prompt
Use xSpeed Hub to start the preloader on every site in my workspace and tell me which ones refused.
Prompt
Use xSpeed Hub to stop the preloader on shop. It is slowing the server down.
Prompt
The preloader on shop says it is disabled. Use xSpeed Hub to turn the module on, then start the crawl.
Prompt
Using xSpeed Hub, which of my sites has no running crawl and a low hit ratio?
08

Frequently asked questions

It can start the crawl and read its progress later, because the Bot works on a cloud computer that keeps running. The crawl itself runs inside WordPress on your site; the Bot calls start_preloader and get_preloader_status through xSpeed Hub.

A 403 or 406 during a crawl usually means a server firewall is blocking the warmer by its user-agent, xSpeed-Warmer/1.0. Allow that user-agent in the server rule and ask the Bot to start the crawl again.

The preloader module is off by default on a new install, and the site refuses to start a crawl until it is on. The agent can switch it on with update_settings on the preloader module, or you can turn it on in the xSpeed Cache panel in wp-admin. Page caching also has to be on, because the crawl exists to fill that cache.

It reads the site's sitemap, which is the WordPress one at /wp-sitemap.xml unless you set a different sitemap URL, follows nested sitemap indexes and skips any URL your cache exclusion rules leave out. If the sitemap cannot be read, the site falls back to a list built from its own content and says so. If nothing at all is queued, the call reports an error with the reason.

Yes. The agent passes site: "all" to start_preloader and the Hub starts the crawl on every site in the workspace one after another, returning a result per site. The Hub tells the agent to confirm that with you once first. The call only starts the crawls, so progress is read afterwards with get_preloader_status, one site at a time.

A crawl fetches your own pages, a few per run, so it adds load while it runs. The Pages per run setting controls how many, from 1 to 50 with a default of 5. If a site struggles, stop_preloader ends the crawl and the pages already warmed stay cached.

Those codes are what bad-bot firewall rules usually answer with, and they mean the warmer was judged by its user-agent, not that the page is missing. The warmer identifies itself as xSpeed-Warmer/1.0. Allow that user-agent in the server rule, or change it with the xspeed_preloader_user_agent filter, and run the crawl again.

The preloader has its own Schedule setting in WordPress: manual, hourly, daily or weekly. An agent can change it with update_settings. The Hub itself has no scheduler for agent prompts, so a prompt only runs when you send it or when your AI client runs it on a timer.

09

Keep going

Warm the cache with other agents

More with Grok Bot

Documentation

From the blog

Warm the cache, from Grok Bot.

xSpeed Hub is free and has no site cap. Connect your sites once and ask from the agent you already use.