WP Umbrella — the WordPress AI agent
You're looking at the first AI agent built for WordPress agencies, powered by WP Umbrella infrastructure.
WP Umbrella is the monitoring and maintenance platform trusted by WordPress professionals to manage their clients' sites — uptime, updates, backups, performance, and security, all in one place. This plugin connects Claude directly to that infrastructure through the WP Umbrella Public API, so you can run your entire maintenance workflow by talking instead of clicking.
We have a 2 weeks free trial without credit card so you can get started if you are not a client already.
Who this is for
WordPress agencies and maintenance professionals managing 10 to 200+ client sites. If you spend hours each week clicking through update screens, this turns that work into a short conversation.
What you can do
- Get a fleet overview in one sentence. "Which sites are down?", "Which have updates pending?", "Which have known security issues?"
- Run safe plugin updates. Claude uses the WP Umbrella safe-update workflow: back up, update, check the site is healthy, roll back if anything fails.
- Review vulnerabilities across all sites. Surface known CVEs, sorted by severity.
- Stay in control. Reading and checking runs freely. Anything that changes a site waits for your explicit confirmation.
How does it work?
umbrella is a zero-dependency Claude Code plugin: just markdown + the official OpenAPI spec. Claude loads it as context, then calls the WP Umbrella API directly with curl on your behalf — no server to install, no binary to run.
You ────────► Claude ────────► public-api.wp-umbrella.com
"update plugins" (reads umbrella, (your Bearer token,
constructs curl) your projects)
Requirements
- A WP Umbrella account with the Public API feature enabled
- A Public API token — generate one in your dashboard under Profile → Public API (for developers)
⚠️ This is not the same as your dashboard↔plugin connection key (the key that links a WordPress site to WP Umbrella). The Public API token is an account-level developer token; reaching for the connection key here won't work and is a security footgun.
- Claude Code installed (macOS, Linux, or Windows) — https://claude.com/claude-code
Install
Inside Claude Code, run:
/plugin marketplace add wp-umbrella/umbrella-skill
/plugin install umbrella@wp-umbrella
That's it. /plugin update umbrella@wp-umbrella keeps you on the latest release.
SSH-less machines: if the install fails with [email protected]: Permission denied (publickey), the installer is cloning over SSH on a machine without a GitHub SSH key. Tell git to use HTTPS instead, then re-run the install:
git config --global url."https://github.com/".insteadOf "[email protected]:"
Manual install (for development or testing)
If you want to hack on the plugin itself:
git clone https://github.com/wp-umbrella/umbrella-skill.git
claude --plugin-dir ./umbrella-skill
Other AI agents (Cursor, Windsurf, ChatGPT, …)
Coming soon. The skill content under skills/umbrella/ is pure markdown + OpenAPI and works with any agent that can execute shell commands — a generic install guide for other agents is on the way.
Set up your token
Two simple options depending on how you installed umbrella.
If you used /plugin install umbrella@wp-umbrella (recommended)
Nothing extra to do. Claude Code prompted you for the token at install time and stored it in your OS keychain (macOS Keychain, Windows Credential Manager, Linux Secret Service). umbrella reads it automatically on every call.
If you prefer a file-based setup (or use another AI agent)
Save the token to ~/.umbrella/token. Three commands — replace PASTE_YOUR_TOKEN_HERE with your actual token:
mkdir -p ~/.umbrella
echo "PASTE_YOUR_TOKEN_HERE" > ~/.umbrella/token
chmod 600 ~/.umbrella/token
CI / ephemeral shells can export WP_UMBRELLA_TOKEN instead. Full guide: src/skills/umbrella/references/auth.md.
Try it
Open Claude Code in any directory and either:
Chat naturally:
