umbrella

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 Settings → Public API
• 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.

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:

"List my WP Umbrella projects" "Which of my sites have plugin updates pending?" "Update SeoPress on project 123 using the safe-update workflow."

Or use a slash command:

Command	What it does
/umbrella:sites	Quick list of all your sites
/umbrella:sites down	Only sites currently down
/umbrella:sites updates	Only sites with pending plugin updates
/umbrella:sites vulns	Only sites with known vulnerabilities
/umbrella:sites <name>	Search a site by name
/umbrella:health	Fleet-wide health snapshot (totals)

Claude reads the relevant workflow, calls the right API endpoints with your token, and reports back.

Run commands faster (optional)