# Purge the WordPress cache with Kimi Code

> Purging the WordPress cache with Kimi Code means asking Moonshot AI's terminal agent to clear the xSpeed cache on the site you just deployed, through the xspeedhub entry in its mcp.json.

Page: https://xspeedcache.com/agent/kimi/purge-cache/
Last updated: October 2026

Kimi Code is open in the theme repository when the stale page shows up. You ran the deploy from the same terminal, the live product pages still load the old layout, and you type the site and what changed. Kimi Code calls list_sites if you have several sites, picks a purge type from the files it just edited, and calls mcp__xspeedhub__purge_cache. Each call and its result print in the session, so the report lands right under the deploy output.

The report is the plugin's own: purge type, site, how many entries were cleared, and for a purge of type all the object cache and a connected Cloudflare edge. Because Kimi Code read the diff, it can say why assets is enough for a stylesheet edit or why a template change needs page. The sign-in happened once, with /mcp-config login xspeedhub, so later sessions call the Hub without a browser. If the entry lives in the repository's .kimi-code/mcp.json, it overrides your home config for that project, which is one way to keep the Hub only where you work on WordPress.

Kimi Code starts in Always Ask mode, where an MCP call that matches no permission rule asks for approval, and Approve for this session allows the same kind of call until the session ends. That prompt is the check on a purge, because xSpeed Hub has no confirmation step of its own and runs the write as soon as your connection allows it. Add allow rules for mcp__xspeedhub__get_* and mcp__xspeedhub__list_* under [[permission.rules]] in config.toml and keep purge_cache on the prompt. For a purge across every site the Hub also tells Kimi Code to confirm once, which is guidance to the model, not a lock.

## Set up Kimi Code once

### 1. Put 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.

### 2. Add xSpeed Hub to mcp.json

Put this in ~/.kimi-code/mcp.json to use the Hub in every project, or in .kimi-code/mcp.json inside one repository, where it overrides a user entry of the same name. You can also run /mcp-config and let Kimi Code add it. A server added while a session is open joins only the next session.

File: `~/.kimi-code/mcp.json`

```json
{
  "mcpServers": {
    "xspeedhub": {
      "url": "https://app.xspeedcache.com/xspeed/mcp"
    }
  }
}
```

### 3. Sign in with /mcp-config login

Start a new session with kimi, run this and approve access on the xSpeed Hub page that opens in your browser. There is no token to paste. Then run /mcp to check that xspeedhub is connected.

```
/mcp-config login xspeedhub
/mcp
```

Full setup: https://xspeedcache.com/agent/kimi/

### 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. In Kimi Code's default Always Ask mode, an MCP call that matches no permission rule asks for approval, and Approve for this session allows the same kind of call until the session ends. Permanent rules go in [[permission.rules]] in config.toml: allow mcp__xspeedhub__get_* and mcp__xspeedhub__list_* to let the reads run, and leave the write tools on the prompt. Ask When Needed mode, from /yolo, approves MCP calls automatically, and Never Ask, from /auto, approves everything. xSpeed Hub has no confirmation step of its own, so in either of those modes a purge or a settings change runs as soon as your connection allows writes. To remove writes altogether, list the read tools in the entry's enabledTools, or use a connection token with Read-only everywhere on.

## Prompts

- I just deployed the new product template to shop. Use xSpeed Hub to purge the page cache there and report what was cleared.
- With xSpeed Hub, purge only the assets cache on blog after this CSS change and tell me how many files went.
- Use xSpeed Hub to purge every site in my workspace and list any that failed. Confirm with me once first.

## Example session

```
You: Deployed the new product template to shop. Use xSpeed Hub to clear the stale pages.
  → list_sites [read-only]: 3 sites: shop, blog, docs
Agent: The diff touches a template, not CSS, so the stored HTML is what is stale. Purge the page cache on shop? Kimi Code will ask you to approve the call.
You: Approve.
  → purge_cache(site: shop, type: page) [changes site]: 389 cached pages cleared
Agent: Done, 389 pages cleared on shop; assets and the object cache were left alone. I can start the preloader next.
```

## How it works

1. **Find the site**: The agent calls list_sites when you have more than one site, then matches the name you used to a site handle. If the name could mean two sites, the Hub tells it to ask you rather than guess.
2. **Pick the purge type**: purge_cache takes a type: all, page, assets, object or rest. all clears the page cache, the object cache and, when they are connected, the Cloudflare edge and CDN. After a theme or CSS change, assets is enough; after a content edit, page; after a deploy, all.
3. **Purge**: The call runs straight away on that site once your connection allows writes. For every site at once the agent passes site: "all", and the Hub runs the sites one after another with a one-second pause.
4. **Clear only the edge if that is all you need**: purge_cloudflare empties the Cloudflare edge cache on its own, without touching the copies on your server. A page or assets purge does not reach Cloudflare; a purge of type all does when Cloudflare is connected.
5. **Warm it again**: start_preloader rebuilds the cache in the background so the first visitors after the purge are not the ones paying for it.

## Reference

| | |
| --- | --- |
| Tool | purge_cache (write) |
| Purge types | all, page, assets, object, rest |
| What all covers | Page cache, object cache, plus the Cloudflare edge and CDN when connected |
| Every site at once | site: "all" or a list of handles, one result per site |
| Fan-out pacing | Sites run one after another with a 1 second pause |
| Edge only | purge_cloudflare, a separate write tool |
| Re-warm | start_preloader after the purge |
| Read-only access | purge_cache is refused on a connection token with Read-only everywhere on, and for a Viewer sign-in |
| Confirmation | None on the Hub; your client's prompt is the gate |

## Rules

- Name the site. With several sites, an unclear name should make the agent ask, and the Hub tells it to.
- A purge of every site is one call with site: "all". The Hub tells the agent to confirm it with you once before it runs.
- Purge the narrowest type that fixes the problem, then warm the cache, so visitors do not all hit uncached pages at once.
- A fan-out result is reported per site. Treat some sites failing as a partial result, not a failure of the whole call.

## Good to know with Kimi Code

/yolo switches Kimi Code to Ask When Needed, which approves MCP calls automatically, and /auto switches it to Never Ask, which approves everything. In either mode a purge, and a purge of every site, runs without a prompt. Approve for this session has a smaller version of the same effect: approve one purge with it and the next purge in that session goes straight through. If a project should never purge from the terminal, list only the read tools in the entry's enabledTools, or put purge_cache in disabledTools, so the model is never offered it. A connection token with Read-only everywhere on, sent through bearerTokenEnvVar, is the harder limit, because the Hub then refuses every write whatever mode Kimi Code is in.

## More prompts for this job

They work in any client connected to xSpeed Hub.

- Use xSpeed Hub to purge the page cache on blog.
- I just changed the theme CSS on shop. Use xSpeed Hub to purge only the assets cache there.
- With xSpeed Hub, purge every site in my workspace and tell me which ones failed.
- Use xSpeed Hub to purge shop, then purge its Cloudflare edge cache too.
- With xSpeed Hub, purge the docs site and start the preloader so it is warm again.
- Using xSpeed Hub, what purge type should I use after updating a plugin that changes the checkout page?

## Frequently asked questions

### Can Kimi Code purge my WordPress cache after a deploy?

Yes. Add xSpeed Hub to mcp.json, sign in with /mcp-config login xspeedhub, and ask in the same session to purge the site you deployed. Kimi Code calls purge_cache with the type that fits and prints what was cleared.

### Does Kimi Code ask before a purge?

In the default Always Ask mode it asks before an MCP call that no permission rule allows. Ask When Needed, from /yolo, and Never Ask, from /auto, approve MCP calls automatically, and xSpeed Hub has no confirmation step of its own, so in those modes a purge runs at once.

### What is the difference between the purge types?

all clears every cache xSpeed manages for the site, including a connected Cloudflare zone or CDN. page clears the stored HTML pages, assets clears minified and combined CSS and JavaScript, object clears the Redis or Memcached object cache, and rest clears cached REST API responses.

### Does purging xSpeed also clear Cloudflare?

A purge of type all does, when the site has Cloudflare connected in xSpeed: it clears the page cache, the object cache and the Cloudflare edge, and reports each one. A page, assets or rest purge stays on your server. purge_cloudflare clears only the edge.

### Can I purge all of my sites with one prompt?

Yes. The agent passes site: "all" to purge_cache and the Hub purges every site in the workspace one after another, returning a result per site. The Hub tells the agent to confirm a write across every site with you once before it runs it.

### Will a purge slow my site down?

The next request to each purged page builds it fresh, which is slower than a cached hit. Starting the preloader right after the purge rebuilds the cache in the background so visitors mostly land on warm pages.

## Purge the cache with other agents

[Claude Code](https://xspeedcache.com/agent/claude-code/purge-cache/) · [Claude](https://xspeedcache.com/agent/claude/purge-cache/) · [Claude Cowork](https://xspeedcache.com/agent/claude-cowork/purge-cache/) · [ChatGPT](https://xspeedcache.com/agent/chatgpt/purge-cache/) · [Codex](https://xspeedcache.com/agent/codex/purge-cache/) · [Cursor](https://xspeedcache.com/agent/cursor/purge-cache/) · [GitHub Copilot in VS Code](https://xspeedcache.com/agent/github-copilot/purge-cache/) · [Windsurf](https://xspeedcache.com/agent/windsurf/purge-cache/) · [Gemini CLI](https://xspeedcache.com/agent/gemini-cli/purge-cache/) · [Antigravity](https://xspeedcache.com/agent/antigravity/purge-cache/) · [Zed](https://xspeedcache.com/agent/zed/purge-cache/) · [Kiro](https://xspeedcache.com/agent/kiro/purge-cache/) · [OpenCode](https://xspeedcache.com/agent/opencode/purge-cache/) · [OpenClaw](https://xspeedcache.com/agent/openclaw/purge-cache/) · [Hermes Agent](https://xspeedcache.com/agent/hermes-agent/purge-cache/) · [Grok Build](https://xspeedcache.com/agent/grok-build/purge-cache/) · [ChatGPT dots](https://xspeedcache.com/agent/chatgpt-dots/purge-cache/) · [Grok](https://xspeedcache.com/agent/grok/purge-cache/) · [Grok Bot](https://xspeedcache.com/agent/grok-bot/purge-cache/) · [Muse](https://xspeedcache.com/agent/muse/purge-cache/) · [Manus](https://xspeedcache.com/agent/manus/purge-cache/) · [Paperclip](https://xspeedcache.com/agent/paperclip/purge-cache/) · [NanoClaw](https://xspeedcache.com/agent/nanoclaw/purge-cache/)

## More with Kimi Code

- [Find out why WordPress pages are not cached with Kimi Code](https://xspeedcache.com/agent/kimi/troubleshoot-cache/)
- [Scan a website for speed problems with Kimi Code](https://xspeedcache.com/agent/kimi/speed-scan/)
- [Run and track PageSpeed tests with Kimi Code](https://xspeedcache.com/agent/kimi/pagespeed-tests/)
- [Raise a WordPress site's PageSpeed score with Kimi Code](https://xspeedcache.com/agent/kimi/optimize-site/)
- [Tune WordPress cache settings with Kimi Code](https://xspeedcache.com/agent/kimi/cache-settings/)
- [Warm the WordPress cache with Kimi Code](https://xspeedcache.com/agent/kimi/preload-cache/)
- [Set up the Redis object cache with Kimi Code](https://xspeedcache.com/agent/kimi/object-cache/)
- [Manage Cloudflare caching with Kimi Code](https://xspeedcache.com/agent/kimi/cloudflare/)
- [Manage every WordPress site at once with Kimi Code](https://xspeedcache.com/agent/kimi/fleet/)

## Documentation

- How to enable Page Cache: https://xspeedcache.com/docs/page-cache/
- How to warm your cache ahead of visitors: https://xspeedcache.com/docs/preloader/
- Managing your fleet with xSpeed Hub: https://xspeedcache.com/docs/managing-your-fleet-with-xspeed-hub/