# Goldnat for WordPress — Admin

Check site health, manage plugins, themes, roles, scheduled tasks, maintenance mode, the error log, database clean-up and privacy requests by asking your AI agent. Same permissions as wp-admin, and a confirmation before anything risky.

- Platform: WordPress
- Edition: paid add-on
- Web page: https://plugins.goldnat.ai/wordpress/wp-admin-ai-connect
- Installation guide: https://plugins.goldnat.ai/wordpress/guide
- Requires: Goldnat for WordPress (https://plugins.goldnat.ai/wordpress/wordpress-plugin.md)

## What it does

- **Same rules as wp-admin** — Every tool checks the same WordPress capability as the matching admin screen and uses WordPress's own administration functions, so your agent can do only what your account could do there.
- **Nothing risky without a yes** — Deleting, switching, erasing and updating need an explicit confirmation. Updates can run as a dry run first, and a site-wide report-only mode turns every update into a report.
- **Every change is logged** — Each action that changes the site is written to an audit log with who asked, what was asked and the outcome. No tool can edit or clear that log.
- **Switch on only what you need** — Tools come in groups you can switch off one by one. Installing, updating and deleting code is off until an administrator turns it on.
- **Your admin screens, in one conversation** — 65 tools: Site Health and system info, plugins, themes, updates, managed options, roles and capabilities, application passwords, scheduled tasks, cache and maintenance mode, the PHP error log, database clean-up and trash, content export and import, personal data requests and the audit log.
- **Guard rails built in** — The agent cannot switch off or delete the plugins it is connected through, cannot delete the active theme, cannot strip the administrator role and cannot remove core scheduled tasks without an explicit force. Privacy requests are processed only after the person confirmed them by e-mail.
- **Works on any WordPress site** — No other plugin is needed beyond the free Goldnat plugin. Content import uses the free WordPress Importer when it is active.

## What you can ask the agent

- "Is my site healthy?" — The agent runs Site Health and sums up what is good, what is recommended and what is critical.
- "Which plugins need an update, and is it safe?" — It lists waiting updates and, with code changes switched on, runs them as a dry run first.
- "Why is the site slow since yesterday?" — It reads the PHP error log, the scheduled tasks and the database clean-up figures and tells you what stands out.
- "Put the site in maintenance mode for five minutes." — It switches maintenance mode on for the time you ask and tells you when it ends.
- "Clean up old revisions and spam comments." — It shows what would be deleted first and deletes only after you confirm.
- "A customer asked for their personal data." — It creates the export request, WordPress e-mails the customer to confirm, and the agent sends the export once they did.

## Install and connect

1. Install the free core plugin first: Goldnat for WordPress (https://plugins.goldnat.ai/wordpress/wordpress-plugin). This plugin runs on top of it.
2. Buy Goldnat for WordPress — Admin at goldnat.ai, download it, and upload it in your WordPress admin panel. Enter the license key you receive.
3. Connect your AI agent: in goldnat.ai (or another compatible agent) add your site address. You are sent to your own WordPress site to log in and approve what the agent may do (read only, or read and write).
4. Ask the agent in plain language. It calls the plugin on your site as you, and shows you the result.
5. Full installation guide with screenshots: https://plugins.goldnat.ai/wordpress/guide

## What the agent can and cannot do

- The agent acts as the WordPress user who connected it. It can never see or change more than that user can.
- You approve the access level when you connect (read only, or read and write), and you can revoke the connection at any time from the plugin page in your admin panel.
- Actions that delete content or cannot be undone ask for an explicit confirmation first.
- Your content stays on your site. The plugin answers the agent's requests directly; it does not copy your site anywhere else.

## Tools

Each tool is called by the agent by name. "write" tools need write access approved at connection.

- `wordpress_admin.createApplicationPassword` (admin) — Create an application password for a user. The password is returned ONCE in this response and cannot be read again; it gives API access with that user's full permissions. Requires confirm=true.
- `wordpress_admin.listApplicationPasswords` (read) — List a user's application passwords: name, creation date, last use and last IP. The passwords themselves are never returned.
- `wordpress_admin.revokeAllApplicationPasswords` (admin) — Revoke all application passwords of a user. Requires confirm=true.
- `wordpress_admin.revokeApplicationPassword` (admin) — Revoke one application password by its uuid. Whatever uses it stops working immediately. Requires confirm=true.
- `wordpress_admin.getAdminAuditLog` (read) — The audit log of admin actions performed through these tools: time, user, tool, arguments (secrets hidden), outcome, and for option changes the old and new value. Newest first. The log cannot be edited or cleared by a tool.
- `wordpress_admin.bulkUpdatePlugins` (admin) — Update all plugins that have an update available, except those listed in except (at most 10 per call). Use dry_run=true to list what would be updated. Requires confirm=true to update.
- `wordpress_admin.deletePlugin` (admin) — Delete an inactive plugin: its files are removed and its uninstall routine runs (plugin data may be deleted). Active plugins must be deactivated first. Requires confirm=true.
- `wordpress_admin.deleteTheme` (admin) — Delete an installed theme's files. The active theme and its parent theme cannot be deleted. Requires confirm=true.
- `wordpress_admin.installPlugin` (admin) — Install a plugin from the WordPress.org directory by its slug (use searchPluginsDirectory to find it). The plugin is installed inactive unless activate=true. This puts new code on the server. Requires confirm=true.
- `wordpress_admin.installTheme` (admin) — Install a theme from the WordPress.org directory by its slug. The theme is installed but not activated (use switchTheme). This puts new code on the server. Requires confirm=true.
- `wordpress_admin.updateCore` (admin) — Update WordPress itself to the version WordPress.org offers for this site. Use dry_run=true to see the target version first. The site is in maintenance mode for a short time while files are replaced; take a backup before a major-version update. Requires confirm=true to update.
- `wordpress_admin.updatePlugin` (admin) — Update one plugin to the latest version WordPress.org offers. Use dry_run=true to see the current and the new version first. Requires confirm=true to update.
- `wordpress_admin.updateTheme` (admin) — Update one theme to the latest version WordPress.org offers. Use dry_run=true to see the versions first. Changes made directly in the theme's files are overwritten. Requires confirm=true to update.
- `wordpress_admin.updateTranslations` (admin) — Install all waiting translation updates. Use dry_run=true to list them first. Requires confirm=true to update.
- `wordpress_admin.getCronSchedules` (read) — List the recurrence schedules registered on the site (hourly, twicedaily, daily, weekly and any added by plugins) with their interval in seconds.
- `wordpress_admin.listCronEvents` (read) — List scheduled WP-Cron events: hook, next run time, recurrence, whether it is overdue and whether it is a WordPress core task.
- `wordpress_admin.runCronEventNow` (admin) — Run a scheduled event immediately, in this request (as WP-Cron would: a recurring event is rescheduled, a one-off event is removed, then its hook fires).
- `wordpress_admin.unscheduleCronEvent` (admin) — Remove one scheduled event. WordPress core tasks (update checks, clean-ups) are refused unless force=true. Requires confirm=true.
- `wordpress_admin.emptyTrash` (admin) — Permanently delete items from the trash: posts (optionally one post type, or only the given post_ids), comments, or both. At most 100 items per call. This cannot be undone. Requires confirm=true.
- `wordpress_admin.getDatabaseCleanupStats` (read) — Count what can be cleaned from the database: post revisions, auto-drafts, trashed posts, spam and trashed comments, and expired transients. Changes nothing.
- `wordpress_admin.getTrashedItems` (read) — List posts (of any post type) and comments that are in the trash, with totals.
- `wordpress_admin.optimizeDatabase` (admin) — Clean the database: delete old post revisions, old auto-drafts, spam comments, trashed comments and expired transients (choose with items). Runs as a dry run that only counts unless dry_run=false AND confirm=true. At most 500 rows per item per call; deleted rows cannot be restored.
- `wordpress_admin.exportContent` (read) — Create a WordPress export (WXR) of the site's content, as Tools › Export does, and return the XML. At most 2 MB: filter by content type, author, date range or status to keep it small (a full-site export of a large site must be done from Tools › Export).
- `wordpress_admin.importContent` (admin) — Import a WordPress export (WXR) using the WordPress Importer plugin: creates posts, pages, terms and comments from the XML (as returned by exportContent, at most 2 MB). Authors in the file are assigned to the connected user; media files referenced by the export are not downloaded. Requires confirm=true.
- `wordpress_admin.getDebugData` (read) — System information as shown in Tools › Site Health › Info (WordPress, server, database, theme, plugins, constants, filesystem permissions). Values WordPress marks as private are left out.
- `wordpress_admin.getDirectorySizes` (read) — Disk usage of the WordPress, uploads, themes and plugins directories and the database size, as calculated by Site Health. Can take several seconds on large sites.
- `wordpress_admin.getSiteHealth` (read) — Run WordPress Site Health's direct tests and return each result (status good / recommended / critical, label, short description) with totals. Slow background tests are listed by name; run one with getSiteHealthTest.
- `wordpress_admin.getSiteHealthTest` (read) — Run one Site Health test by its key (as listed by getSiteHealth), including the slower background tests such as loopback_requests, https_status, background_updates or dotorg_communication.
- `wordpress_admin.clearErrorLog` (admin) — Empty the debug log file. The entries are gone for good. Requires confirm=true.
- `wordpress_admin.getErrorLog` (read) — Read the end of the PHP / WordPress debug log: the last lines (default 100, max 500), optionally only lines containing a text. Only the tail of the file is read, whatever its size. The log may contain paths and data from the site.
- `wordpress_admin.clearCache` (admin) — Flush the WordPress object cache (and the page cache of a caching plugin that hooks into it). Pages are rebuilt on the next visits; the site may be slower for a short while.
- `wordpress_admin.deleteExpiredTransients` (admin) — Delete all expired transients from the database. Safe: expired transients are never used again.
- `wordpress_admin.disableMaintenanceMode` (admin) — Remove a leftover maintenance file (for example after an interrupted update). While maintenance mode is really active this tool cannot be reached; it ends by itself.
- `wordpress_admin.enableMaintenanceMode` (admin) — Put the site into WordPress core maintenance mode ("Briefly unavailable for scheduled maintenance") for a limited time. IMPORTANT: while it is active the WHOLE site answers 503 — including this API, so no tool can be called until it ends by itself. duration_seconds is 10-600 (default 120); WordPress core itself never keeps this mode longer than 10 minutes. Requires confirm=true.
- `wordpress_admin.flushRewriteRules` (admin) — Rebuild the permalink (rewrite) rules — the fix for 404s after adding post types or changing permalink settings. hard=true also rewrites the .htaccess file.
- `wordpress_admin.getMaintenanceStatus` (read) — Whether a maintenance file exists and whether it is stale (left over, no longer in effect).
- `wordpress_admin.listTransients` (read) — List transients (temporary cached values) stored in the database: name, expiry time and whether expired, with totals. Values are not returned. With an external object cache, transients are not stored in the database and the list is empty.
- `wordpress_admin.regenerateThumbnails` (admin) — Rebuild the resized versions (thumbnails) of images from their original files, e.g. after switching theme or changing image sizes. Give up to 20 attachment IDs per call.
- `wordpress_admin.getOption` (read) — Read the current value of one managed option (must be one listed by listAllowedOptions).
- `wordpress_admin.listAllowedOptions` (read) — List the options this plugin is allowed to manage on this site, with the plugin that owns each one, its current value, allowed values and risk level. Only options whose owner plugin is active are listed.
- `wordpress_admin.updateOption` (admin) — Change one managed option (must be one listed by listAllowedOptions). An option with risk "security" weakens a protection of the site: it additionally needs confirm=true and acknowledge_risk=true, and the change is written to the audit log with the old and new value.
- `wordpress_admin.activatePlugin` (admin) — Activate an installed plugin. WordPress loads the plugin in a sandbox first and refuses activation if it causes a fatal error. Requires confirm=true.
- `wordpress_admin.deactivatePlugin` (admin) — Deactivate a plugin. The Goldnat bridge and this plugin cannot be deactivated through a tool (that would cut the agent's own connection). Requires confirm=true.
- `wordpress_admin.getPlugin` (read) — Details of one installed plugin: name, version, author, description, required WordPress / PHP version, active state, available update and auto-update state.
- `wordpress_admin.listPlugins` (read) — List installed plugins with version, active state (and network-active on multisite), whether an update is available and whether auto-update is on.
- `wordpress_admin.searchPluginsDirectory` (read) — Search the WordPress.org plugin directory. Returns slug, name, version, rating, active installs, last update and tested-up-to for each result.
- `wordpress_admin.setPluginAutoUpdate` (admin) — Switch automatic updates on or off for one plugin.
- `wordpress_admin.createPrivacyErasureRequest` (admin) — Create a personal data erasure request for a person. WordPress e-mails them a confirmation link; the erasure can only be processed after they confirm.
- `wordpress_admin.createPrivacyExportRequest` (admin) — Create a personal data export request for a person. WordPress e-mails them a confirmation link; the export can only be processed after they confirm.
- `wordpress_admin.listPrivacyRequests` (read) — List personal data export and erasure requests with their status: pending (waiting for the person's e-mail confirmation), confirmed, failed or completed.
- `wordpress_admin.processPrivacyErasure` (admin) — Erase the personal data of a CONFIRMED erasure request, as the "Erase personal data" action does. Erased data cannot be restored. Refused while the request is not confirmed by the person. Requires confirm=true.
- `wordpress_admin.processPrivacyExport` (admin) — Generate the personal data export file of a CONFIRMED export request and e-mail the download link to the person, as the "Send export link" action does. Refused while the request is not confirmed by the person.
- `wordpress_admin.addCapabilityToRole` (admin) — Grant a capability to a role; every user with that role gets it immediately. High-privilege capabilities require confirm=true.
- `wordpress_admin.createRole` (admin) — Create a new role, optionally starting from the capabilities of an existing role (clone_from) and/or an explicit capability list. Granting high-privilege capabilities (such as manage_options, edit_users or install_plugins) requires confirm=true.
- `wordpress_admin.deleteRole` (admin) — Delete a role. Refused for the administrator role, the site's default role and any role that still has users (reassign them first). Requires confirm=true.
- `wordpress_admin.getRole` (read) — One role with the full list of its capabilities and its user count.
- `wordpress_admin.listRoles` (read) — List the site's user roles with display name, number of users and number of capabilities.
- `wordpress_admin.removeCapabilityFromRole` (admin) — Remove a capability from a role. Refused for the administrator role (it would lock administrators out). Requires confirm=true.
- `wordpress_admin.getTheme` (read) — Details of one installed theme: name, version, author, description, parent theme, required WordPress / PHP version, block-theme flag and any errors WordPress found in it.
- `wordpress_admin.listThemes` (read) — List installed themes with version, parent theme, which one is active, whether an update is available and whether auto-update is on.
- `wordpress_admin.searchThemesDirectory` (read) — Search the WordPress.org theme directory. Returns slug, name, version, rating and active installs for each result.
- `wordpress_admin.setThemeAutoUpdate` (admin) — Switch automatic updates on or off for one theme.
- `wordpress_admin.switchTheme` (admin) — Make an installed theme the active theme. The site's look changes immediately for all visitors; widgets and menus may need to be reassigned. Requires confirm=true.
- `wordpress_admin.getCoreUpdateStatus` (read) — Current WordPress version, whether a newer version is offered, and how many plugin, theme and translation updates are waiting. Refreshes the update check first.
- `wordpress_admin.getTranslationUpdates` (read) — List the translation (language pack) updates waiting for WordPress, plugins and themes.

## Frequently asked questions

**Can the agent break my site?**

Every destructive or risky action needs confirm: true, updates can be dry runs, report-only mode blocks real updates site-wide, and the plugins the agent is connected through are protected. Code changes are off until you enable them.

**Who can use these tools?**

Only administrator accounts, and each tool also checks the specific WordPress capability its admin screen needs. On a multisite network, network-wide actions need the network administrator capability.

**Which AI agents can I use?**

Our own agent at goldnat.ai, and other AI agents that support the Servio protocol. The list of compatible clients is on this page.

**Can the AI see or change things I can't?**

No. It works as the WordPress user who connected it, with exactly that user's permissions. Connect it with an account that has only the access you want it to have.

**Will it change things without asking?**

Only if you approved write access when you connected it. Deleting or irreversible actions ask for an explicit confirmation.

**How do I disconnect an agent?**

Revoke its connection from the plugin page in your admin panel. The agent loses access immediately.

**Do I also need Goldnat for WordPress?**

Yes. Goldnat for WordPress — Admin runs on top of the free core plugin, which handles the secure connection.

## Guides

- [Managing Many WordPress Sites with an AI Agent](https://plugins.goldnat.ai/docs/06-managing-many-wordpress-sites) — A practical guide for agencies and freelancers who look after several WordPress sites — how to connect one AI agent to all of them with the Goldnat plugins, what it can check and change on each site, how permissions and confirmations keep it safe, and a weekly routine you can copy.
