SiteAgent for Aura

SiteAgent turns every WordPress site into one an AI agent can safely operate — update, maintain, audit, and fix. Once the site is connected to Aura and its approval key is provisioned, mutating actions are gated behind human approval and recorded in a full audit trail; safe batch updates and block edits are snapshotted so they can be rolled back. It’s the on-site half of Aura, the governed control room agencies use to run whole fleets of client sites alongside their servers, CDN, and DNS.

Plugin and core updates are the riskiest thing you do on a live client site. SiteAgent makes them safer: safe batch updates run behind health checks and roll back automatically if the site breaks, and every plugin in that path is zip-snapshotted first. With Aura’s approval key in place, an agent can’t silently push a change — mutating actions wait for a human to approve them. Think of it as the undo button for AI on your clients‘ sites.

Install this plugin on any WordPress site to connect it to Aura — no SSH, no wp-admin juggling, no manual logins.

What You Can Do

• Monitor site health — See WordPress version, PHP version, installed plugins & themes, database info, and disk usage in real time.
• Update plugins, themes & core remotely — Push updates to any connected site from the Aura dashboard, no wp-admin login.
• Safe batch updates with auto-rollback — Run chunked updates with health checks; if an update breaks the site, the plugin restores the previous version automatically.
• Per-plugin rollback — Every update is zip-snapshotted first; restore any plugin to its last good state on demand.
• Bulk translation & database upgrades — Update all language packs and run WordPress database migrations remotely.
• One-click connect (magic link) — Connect a site to Aura straight from wp-admin — no manual token copy/paste.
• AI-agent ready (21 MCP tools) — Exposes machine-readable, JSON-schema tools for AI-driven management, including SEO/accessibility/performance/broken-link auditors, on-site SEO-meta read/write (Rank Math, Yoast, SEOPress), and Gutenberg block read/edit. Read tools run on demand; mutating tools are approval-gated through Aura, and every call is audited.
• Zero frontend impact — The plugin only registers REST API endpoints. No scripts, no styles, no database queries on visitor-facing page loads.

How It Works

After activation, click Connect to Aura on the Settings → SiteAgent page for a one-click magic-link connection, or copy the Site Token shown once and paste it into your Aura dashboard manually. From that point, Aura communicates with your site over a signed, authenticated REST API to pull health data and push updates.

Security

Defence-in-depth protects every request:

1. WordPress Application Password — Standard WordPress auth with capability checks (manage_options / update_*). Only authorized administrators can trigger actions.
2. Hashed Site Token — A per-site token sent via the X-Aura-Token header. Only a SHA-256 hash is stored (never the raw token), compared timing-safely. Tokens from older versions migrate to a hash automatically.
3. Brute-force throttling — Repeated bad-token attempts from an IP are blocked.
4. Signed magic-link connect — The onboarding callback is HMAC-signed with a one-time secret and timestamp, so the token exchange can’t be hijacked or replayed.
5. IP / Domain allowlist (optional) — Restrict API access to your Aura instance, with Cloudflare and reverse-proxy header support.

You can rotate the token anytime from Settings → SiteAgent → Regenerate Token.

REST API Endpoints

Core endpoints under /wp-json/aura/v1/:

• GET /status — Full site health report
• GET /updates — Check available updates (core, plugins, themes, translations)
• POST /update/core / /update/plugin / /update/theme / /update/translations — Apply updates
• POST /update/database — Run WordPress database upgrades
• POST /connect — Magic-link token exchange (public, HMAC-signed, 10-minute expiry)

Version 2 endpoints under /wp-json/aura/v2/:

• GET /health — HTTP, PHP fatal, white-screen and DB connectivity checks
• POST /update/batch — Chunked batch updates with auto-rollback on health failure
• POST /rollback/{plugin} — Restore a plugin from its most recent backup

MCP tools under /wp-json/aura/mcp/:

• POST /tools/list / POST /tools/execute — Enumerate and run AI-agent tools
• GET /context — Full site context for AI decision-making

AI Agent Tools (MCP)

SiteAgent ships 21 built-in tools for AI agents. Read tools return information and run on demand; write tools change the site and are queued for human approval through Aura — an agent can never silently mutate a production site.

Read tools:

• get_site_context — WordPress/PHP/theme/plugin/disk/performance snapshot with detected issues
• get_database_info — Database size, largest tables, autoloaded-options weight, expired transients
• scan_security — Scored security posture (file-edit lockdown, debug exposure, SSL, default admin/prefix, open registration, PHP version)
• scan_seo — SEO posture (search-engine visibility, permalinks, XML sitemap, site title) plus a sampled content audit (thin content, missing excerpts/featured images)
• scan_a11y — Accessibility audit over sampled content (images missing alt text, non-descriptive link text, heading structure, document language)
• perf_check — Performance posture (persistent object cache, OPcache, page-cache plugin, PHP version, autoload weight, active plugin count, memory limit)
• scan_broken_links — Link triage over a content sample with no outbound HTTP (empty/anchor-only links, dev/staging hosts, unresolved internal links)
• list_users — Users with roles and post counts, administrators flagged (never returns secrets)
• check_health — Live health gate: HTTP status, PHP fatals, white-screen, database connectivity
• scan_error_log — Tails and severity-groups the error log, surfacing recent fatals
• check_vulnerabilities — Plugins/themes checked against the WordPress.org vulnerability database
• get_seo_meta — Read a post/page’s SEO title, description, and focus keyword from the active SEO plugin (Rank Math, Yoast, or SEOPress)
• list_page_blocks — Read a page’s Gutenberg block structure (block names, attributes, nesting)

Write tools (approval-gated):

• update_plugin_safely — Backup, update, health-check, auto-rollback on failure
• clear_caches — Flush object/opcode caches and detected page-cache plugins
• cleanup_transients — Remove expired transients to reduce autoload bloat
• cleanup_orphaned_assets — Find and remove unused media (dry-run by default)
• backup_plugins — Zip-snapshot one or all active plugins as a rollback safety net
• set_seo_meta — Write a post/page’s SEO title / description / focus keyword on the active SEO plugin (Rank Math, Yoast, or SEOPress) — on-site, so it works even when a WAF blocks the plugin’s own REST endpoint
• update_page_block — Update a Gutenberg block’s content or attributes (snapshot-first, reversible)
• create_page_from_blocks — Create a new page from a Gutenberg block spec (draft-first)

Tools are classified by verb so the Aura Fleet gateway applies the right risk and approval policy automatically.

Pro: the SiteAgent Power Pack

Everything above is free and ships in this plugin. Agencies that need an agent to fix a site — not just report on it — can add the SiteAgent Power Pack, a separate companion plugin that registers higher-capability tools through this plugin’s own tool registry.

It is not included in this download and is not distributed on WordPress.org — the tools it adds execute code, so they don’t belong in a hosted repository. It comes with the Aura Agency and Studio plans, or as SiteAgent Pro.

What it adds:

• read_file — read a text file from inside wp-content (jailed; refuses wp-config.php).
• db_query — a single read-only SQL statement (SELECT / SHOW / EXPLAIN), row-capped.
• write_file — write a file inside wp-content, snapshot-first so it can be rolled back.
• run_wp_cli — run an allowlisted WP-CLI command, with no shell and no metacharacters.
• execute_php — run a PHP snippet against the full WordPress API.

These are governed harder than anything in the free set, deliberately:

1. Off until you arm them. The write and code tools do nothing until the site owner sets an explicit constant in wp-config.php for each one. Installing the Power Pack alone enables no writes and no code execution.
2. Human approval, cryptographically enforced. Once the site holds Aura’s approval key (provisioned when you connect the site), each of these calls requires a single-use, signed grant bound to that exact tool and its exact parameters — one only the Aura dashboard can mint, after a human approves the action. A leaked Site Token cannot run them. (Until a site has that key, the gate is dormant — so connect the site from Aura before arming anything.)
3. Reversible where it can be. File writes are snapshotted first, so there’s a previous state to restore.

The safety model is governance, not a sandbox: execute_php is powerful by design. The controls are the constant you set, the human who approves the call, and the audit trail — not a promise that arbitrary code is safe.

Learn more at my-aura.app/siteagent.

About Aura

Aura is a full-stack operations dashboard by Digitizer that brings servers, applications, DNS zones, and CDN pull zones from Cloudways, Hostinger VPS, Cloudflare, and Bunny.net into a single unified interface.

SiteAgent extends that reach into every WordPress installation — so you can manage your entire infrastructure, including WordPress sites, from one place.

Free to Use

The plugin is completely free and open source (GPLv2+). You need a free or paid Aura account to connect your sites. Sign up at my-aura.app.

Links

• Aura Dashboard
• Documentation
• GitHub Repository
• Digitizer