mcp_install_theme_zip
Installs a WordPress theme from a ZIP using a public URL or a local file, with optional activation and guarded replacement of the active theme.
Instructions
Install a theme from a ZIP, either a public URL (url, must end in .zip) or a local file (file_path, absolute path to a .zip, max 64 MB). Give exactly one of them. file_path uploads the file from this machine, so it works for private or locally built themes; it needs cvrt-mcp-endpoints >= 1.20.0 on the site. Replacing the ACTIVE theme additionally needs replace_active: true (replaces the live theme; a theme with broken PHP takes the site down). url keeps working on older versions, but has no GitHub token support: private release assets cannot be installed that way.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"site": "<site>"
},
"name": "mcp_install_theme_zip"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | URL to the theme ZIP file (must end in .zip). Not together with file_path. | |
| site | Yes | Site id (see list_sites) | |
| activate | No | Switch to the theme after install (default false) | |
| file_path | No | Absolute local path to a theme .zip to upload (max 64 MB). Not together with url. | |
| overwrite | No | Replace the theme folder if it already exists (default true). The ACTIVE theme is only replaced when replace_active is also true. | |
| replace_active | No | Allow replacing the ACTIVE theme (default false; without it the site answers 409 active_theme). Replaces the live theme: a theme with broken PHP takes the site down. cvrt-mcp-endpoints >= 1.20.0. |