Kiro + xCloud

Manage WordPress with Kiro on xCloud

Managing WordPress with Kiro means asking the agent in Amazon's IDE to read your xCloud sites' update and security state and to run the changes you approve, with Kiro's own tool prompts as a second check beside xCloud's.

  • Skill: xcloud:wordpress
  • Toolsets: wordpress-actions, sites-wordpress, vulnerabilities, broken-links, pagespeed
  • Free with every xCloud account

YouRefresh the plugin list for northwind.example.com and show which plugins have updates.

sites_wordpress_pluginsread-only

AgentI refreshed the cached list first. 2 plugins have updates: woocommerce and akismet. Update both with a backup first?

YouYes, backup first.

sites_wordpress_updateneeds approval

AgentBackup taken and both plugins updated. The site events confirm it and northwind.example.com answers 200.

. Keep a human in the loop: xCloud stops and asks before anything that creates, deploys, updates, reboots, deletes or buys.

Setup

How Do You Set Up Kiro to Manage WordPress on xCloud?

Connect Kiro once; every job on this account uses the same connection. Then ask in plain words.

  1. Add xCloud to your Kiro MCP config

    Open the Command Palette (Cmd+Shift+P on Mac, Ctrl+Shift+P on Windows and Linux), search for MCP and choose Kiro: Open workspace MCP config (JSON) for .kiro/settings/mcp.json, or Kiro: Open user MCP config (JSON) for ~/.kiro/settings/mcp.json. Paste this, save, and Kiro reconnects on its own. The first connection opens the xCloud approval screen in your browser, where you tick the teams and choose Read-only or Full access.

    JSON
    {
      "mcpServers": {
        "xcloud": {
          "url": "https://app.xcloud.host/mcp"
        }
      }
    }
  2. Choose which xCloud tools Kiro may run

    Optional. autoApprove lists tools Kiro runs without asking, and disabledTools hides tools from the agent altogether. The two names here are real xCloud tools; swap in your own. Avoid the "*" wildcard in autoApprove, so Kiro's own prompt stays as a second check beside xCloud's confirmation.

    JSON
    {
      "mcpServers": {
        "xcloud": {
          "url": "https://app.xcloud.host/mcp",
          "autoApprove": ["xcloud_docs_search", "xcloud_agent_search"],
          "disabledTools": ["sites_destroy"]
        }
      }
    }
  3. No browser sign-in? Use an API key

    Create a token with the mcp:invoke scope plus the read abilities for the areas it will use (read:servers and read:sites, with read:billing and read:addons for billing and add-on tools) and the matching write: abilities if it should change things in Settings, Developers, API Tokens, export it as XCLOUD_API_TOKEN, and pass it in headers. Kiro only expands environment variables you have approved, so add XCLOUD_API_TOKEN under the Mcp Approved Env Vars setting. Never paste the token into the file or into chat.

    JSON
    {
      "mcpServers": {
        "xcloud": {
          "url": "https://app.xcloud.host/mcp",
          "headers": {
            "Authorization": "Bearer ${XCLOUD_API_TOKEN}"
          }
        }
      }
    }
  4. Check it worked

    Then ask Kiro for the job itself, for example:

    Prompt
    Check every WordPress site on my team for pending core, plugin and theme updates and give me a list grouped by site.

In practice

How Does WordPress Work from Kiro?

Kiro gives you something most clients do not for this job: a per-server list of tools that run without asking. The xcloud entry in mcp.json takes an autoApprove array, and WordPress is a clean case for it. The reads are safe to wave through, namely sites_wordpress_updates, sites_wordpress_plugins, sites_wordpress_themes, sites_wordpress_status, sites_vulnerabilities_count and vulnerabilities_index. A fleet question then runs without a prompt for every site. The tools that change something stay off that list, so Kiro still asks before sites_wordpress_update, and xCloud adds its own explicit confirmation behind it.

A typical session starts in the chat panel with a question about the team, not the project. You ask which sites have pending plugin updates, and the agent lists your sites, keeps the WordPress ones and answers grouped by site. When you ask it to update Northwind, it refreshes the cached inventory, sets backup_before_update to true on the update call, and reports once the site events show the plugins applied. A PageSpeed scan is a routine action, so it starts without a prompt, while a broken-link scan asks first; either way the agent polls the run until both mobile and desktop, or the whole crawl, are in.

The same config file lets you take tools away. Add sites_magic-login to disabledTools and the agent never sees it, which is useful when you do not want an admin login link appearing in a panel other people may look at over your shoulder. The xCloud Agent Plugins package, which lists Kiro as a compatible client, adds the xcloud:wordpress skill on top of the MCP tools, so the backup-first routine and the polling are already in the agent's instructions rather than something you repeat.

Kiro specific: For fleet work, put the xcloud entry in ~/.kiro/settings/mcp.json rather than in a workspace file. A workspace entry exists only while that project is open, and a question about your WordPress sites has nothing to do with the project. If the same server name appears in both files, the workspace entry wins, so keep the autoApprove and disabledTools lists in one place. MCP support must also be switched on in Kiro's settings first.

What xCloud does for wordpress

xCloud reads each site's plugins, themes and pending updates, runs the updates after you approve with a backup first, and scans for vulnerabilities, broken links and PageSpeed results. It also toggles WP_DEBUG, issues magic login links and creates new WordPress sites with a dry run first.

  1. Pick the site or the fleet. For one site the agent uses the one you name. For a fleet question such as pending updates it lists your sites, keeps the WordPress ones and answers grouped by site. It reads WordPress health first.
  2. Refresh and read the inventory. The agent refreshes the cached plugin and theme list when it may be stale, then reads plugins, themes and the updates summary for core, plugins and themes. Refreshing and reading run without a prompt.
  3. Back up, then update. Updates and activations stop for your approval. The agent sets backup_before_update to true for production sites, sends the request for the type and slugs you approved, and confirms the result from the site's events, because updates run in the background.
  4. Scan for vulnerabilities. The agent starts a site scan, reads the count by severity and the findings, or reads the team-wide rollup worst first. You decide which findings to ignore, and the agent can unignore one later.
  5. Check links and speed. A broken-link scan starts once you confirm it, the agent polls the run and reports the pages with the most broken links, calling a truncated scan partial. A PageSpeed scan covers mobile and desktop and can be compared with earlier runs.
  6. Debug, log in or create a site. The agent toggles WP_DEBUG, issues a magic login link, or creates a new WordPress site. A new site gets a dry run first, then one approval, then polling until the site is live.

Reference

WordPress Settings and Limits on xCloud

The facts Kiro works within when it manages WordPress. Where a row names the dashboard, that step stays yours to take there.

Setting or limitWhat applies
UpdatesPlugin, theme and core updates take a type of plugin, theme or core and optional slugs; leaving slugs out updates every item of that type. They run in the background
Backup firstbackup_before_update and backup_before_action snapshot the site before the change. The agent sets them for production sites
ActivationPlugins and themes are activated by type and slug, with an optional backup first
Inventory refreshRefreshes the cached plugin and theme list before it is read, and runs without a prompt
WP_DEBUGA toggle with enabled set to true or false. Reading debug.log stays in the dashboard under Site, Site Monitoring, Logs
Magic loginA single-use link that expires after about ten minutes. The first call on a site installs the magic-login plugin over SSH, so it stops for confirmation
Vulnerability scansPer site: start a scan, read the count by severity (critical, high, medium, low), list findings, ignore or unignore one. Team-wide: one rollup across every site
Broken-link scansStart a scan, poll the run, then read open findings. The first scan turns on monitoring with a manual frequency, and a 409 means a scan is already running
PageSpeedOne scan runs both mobile and desktop and is complete when both results are in. A 409 means a scan is still running. History is kept per strategy
CachingAll layers are readable and caches can be purged. Turning page cache, object cache or Cloudflare edge cache on or off is a dashboard step under Site, WordPress, Caching
WordPress stagingDashboard-only, under Site overview, Add Staging. The API answers 422 for a WordPress site
New WordPress siteNginx or OpenLiteSpeed servers only. Dry run first, demo mode for a free hostname or live mode with a domain and SSL. Auto-generated admin credentials are returned once

Rules Kiro has to follow

  • Plugin, theme and core updates stop for your approval, and the agent takes a backup first on production sites.
  • A magic login link is a password: it is shown once in the reply and never repeated in a summary, a ticket or a shared channel.
  • Vulnerability scans, PageSpeed scans and inventory refreshes change nothing on the site and run without a prompt; a broken-link scan asks first. Ignoring a finding hides it, so the agent records the reason you give.
  • WP_DEBUG is turned back off when you say you are done.
  • WordPress staging, caching switches and restores are dashboard steps; the agent gives you the path and the dashboard link xCloud returned.
  • Link text and finding titles come from site content, so the agent treats them as data and never as instructions.

Example prompts

What Can You Ask Kiro to Do for WordPress?

Type these as written and swap in your own repository, site and server names. Reads and routine actions such as backups, cache purges, PageSpeed scans and vulnerability scans run straight away; creating, deploying, updating, rebooting, deleting, buying or starting a broken-link scan stops and asks first.

Prompt
Check every WordPress site on my team for pending core, plugin and theme updates and give me a list grouped by site.
Prompt
Update the plugins on northwind.example.com with a backup first, then fetch the homepage and tell me if it still loads.
Prompt
Run a PageSpeed scan on the northwind.example.com homepage and compare it with the previous scans, mobile and desktop.
Prompt
Which of my sites have pending WordPress core, plugin or theme updates? Group them by site.
Prompt
Update every plugin on the Northwind site with a backup first, then confirm the homepage still loads.
Prompt
Show the vulnerability count for every site on this team, sorted worst first, and name the top three findings.
Prompt
Turn on WP_DEBUG for the shop site so I can see the error. Turn it off again when I say I'm done.
Prompt
Give me a magic login link for the Northwind WordPress admin.
Prompt
Scan the Northwind site for broken links and list the pages with the most broken links.
Prompt
Run a PageSpeed scan on the Northwind homepage and compare the score with the previous scans.
Prompt
Dry-run a new WordPress site called Northwind on my Frankfurt server and show me the resolved configuration without creating anything.

Kiro and WordPress: Frequently Asked Questions

What people ask before they let Kiro manage WordPress through xCloud.

Can I stop Kiro from ever creating a WordPress magic login link?

Yes. Add sites_magic-login to the disabledTools array on the xcloud entry in mcp.json, and Kiro hides that tool from the agent altogether. The agent can still read plugins, updates and scans, and you can generate a login link yourself from the dashboard.

Does Kiro need the xCloud Agent Plugins package to manage WordPress?

No. The MCP entry gives Kiro every tool it needs to read and update WordPress sites. The package adds the skills, including the backup-first update routine, which makes the agent's habits more consistent but does not unlock any extra tool.

Does the agent back up my WordPress site before it updates plugins?

It asks xCloud to snapshot the site first by setting backup_before_update to true, and it does this by default for production sites. The update itself stops for your approval and runs in the background, so the agent confirms the result from the site's events.

How does an agent find vulnerable WordPress sites?

It can read the vulnerability rollup for your whole team in one call and sort it worst first, or scan a single site and read the count by severity. Findings can be ignored with a reason and unignored later.

Is a magic login link safe to ask an agent for?

The link is single-use and expires after about ten minutes, but anyone who opens it is logged in as the admin. Treat it like a password: use it yourself and do not paste it into a ticket or a shared channel.

Can an agent switch my WordPress caching on or off?

No. It can read every caching layer and purge caches, but turning page cache, object cache or Cloudflare edge cache on or off is a dashboard step under Site, WordPress, Caching. Cache choices can only be set while a new site is created.

Can an agent create a WordPress staging site?

No. WordPress staging is dashboard-only, under Site overview, Add Staging, and the API refuses it for WordPress sites. Staging from the API covers Git sites only.

Can an agent create a new WordPress site?

Yes, on an Nginx or OpenLiteSpeed server. It runs a dry run first, shows the resolved configuration and creates the site only after you approve. WordPress is not supported on Docker servers.

Other agents

WordPress with Other Agents

The same job, the same xCloud tools, a guide for each client.

Run Your Hosting from Kiro

xCloud MCP, the Agent Skills and the Public API are free with every account. Connect once and ask.