WordPress administration, by conversation.
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.
Goldnat for WordPress — Admin · Run your WordPress site administration by asking your AI agent.
Ask your own AI
Copy this to your AI agent — it will explain everything.
Paste it into Claude, ChatGPT, goldnat.ai or any assistant you use. It reads this plugin's plain-text page and walks you through what it does, how to install it and what to ask.
I run a WordPress site and I'm looking at "Goldnat for WordPress — Admin". Please read https://plugins.goldnat.ai/wordpress/wp-admin-ai-connect.md (and, if you need more, https://plugins.goldnat.ai/wordpress/wp-admin-ai-connect and https://plugins.goldnat.ai/wordpress/guide). Then explain to me in simple words: 1. what this plugin does and who it is for; 2. what I need before I start, and how to install it; 3. how to connect you (my AI agent) to my site, step by step; 4. what you will and will not be able to do on my site once connected; 5. five concrete things I could ask you to do with it, for a site like mine. Ask me about my site if that helps you give better examples.
See it in action
A demo video.
Why this plugin
What you get with Goldnat for WordPress — Admin.
✅
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.
Capabilities
What it does.
WordPress
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.
Safe by design
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.
WordPress core
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.
In plain language
What you can ask.
Type requests like these to your AI agent once it is connected. It works out which tools to use.
-
“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.
How it works
From install to your first request.
- Install the free core plugin first: Goldnat for WordPress (https://plugins.goldnat.ai/wordpress/wordpress-plugin). This plugin runs on top of it.
- Buy Goldnat for WordPress — Admin at goldnat.ai, download it, and upload it in your WordPress admin panel. Enter the license key you receive.
- 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).
- Ask the agent in plain language. It calls the plugin on your site as you, and shows you the result.
- Full installation guide with screenshots: https://plugins.goldnat.ai/wordpress/guide
What it will and won't 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.
Get started
Up and running.
1
Install the free Goldnat plugin
This plugin builds on the free Goldnat for WordPress plugin. Install and activate it first.
2
Buy a plan
Sign in to your Goldnat account and pick a plan. Paddle handles payment and tax.
3
Install and enter your license
Upload and activate the plugin in wp-admin, then enter your license key under Goldnat › Admin tools.
4
Choose the tool groups
On the same page, switch tool groups on or off. Turn on code changes only if you want your agent to install or update plugins and themes.
Compatible clients
Works with every AI client.
Pre-configured OAuth integrations for every major AI agent — including our own hosted agent at goldnat.ai. Connect in minutes, not hours.
Tools
Available tool calls.
65 tools exposed via the Servio protocol. AI agents call these by name with structured arguments.
app-passwords
-
wordpress_admin.createApplicationPasswordCreate 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.listApplicationPasswordsList a user's application passwords: name, creation date, last use and last IP. The passwords themselves are never returned. -
wordpress_admin.revokeAllApplicationPasswordsRevoke all application passwords of a user. Requires confirm=true. -
wordpress_admin.revokeApplicationPasswordRevoke one application password by its uuid. Whatever uses it stops working immediately. Requires confirm=true.
audit
-
wordpress_admin.getAdminAuditLogThe 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.
code-changes
-
wordpress_admin.bulkUpdatePluginsUpdate 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.deletePluginDelete 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.deleteThemeDelete an installed theme's files. The active theme and its parent theme cannot be deleted. Requires confirm=true. -
wordpress_admin.installPluginInstall 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.installThemeInstall 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.updateCoreUpdate 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.updatePluginUpdate 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.updateThemeUpdate 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.updateTranslationsInstall all waiting translation updates. Use dry_run=true to list them first. Requires confirm=true to update.
cron
-
wordpress_admin.getCronSchedulesList the recurrence schedules registered on the site (hourly, twicedaily, daily, weekly and any added by plugins) with their interval in seconds. -
wordpress_admin.listCronEventsList scheduled WP-Cron events: hook, next run time, recurrence, whether it is overdue and whether it is a WordPress core task. -
wordpress_admin.runCronEventNowRun 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.unscheduleCronEventRemove one scheduled event. WordPress core tasks (update checks, clean-ups) are refused unless force=true. Requires confirm=true.
db-cleanup
-
wordpress_admin.emptyTrashPermanently 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.getDatabaseCleanupStatsCount what can be cleaned from the database: post revisions, auto-drafts, trashed posts, spam and trashed comments, and expired transients. Changes nothing. -
wordpress_admin.getTrashedItemsList posts (of any post type) and comments that are in the trash, with totals. -
wordpress_admin.optimizeDatabaseClean 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.
export-import
-
wordpress_admin.exportContentCreate 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.importContentImport 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.
health
-
wordpress_admin.getDebugDataSystem 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.getDirectorySizesDisk 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.getSiteHealthRun 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.getSiteHealthTestRun 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.
logs
-
wordpress_admin.clearErrorLogEmpty the debug log file. The entries are gone for good. Requires confirm=true. -
wordpress_admin.getErrorLogRead 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.
maintenance
-
wordpress_admin.clearCacheFlush 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.deleteExpiredTransientsDelete all expired transients from the database. Safe: expired transients are never used again. -
wordpress_admin.disableMaintenanceModeRemove 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.enableMaintenanceModePut 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.flushRewriteRulesRebuild 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.getMaintenanceStatusWhether a maintenance file exists and whether it is stale (left over, no longer in effect). -
wordpress_admin.listTransientsList 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.regenerateThumbnailsRebuild 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.
options
-
wordpress_admin.getOptionRead the current value of one managed option (must be one listed by listAllowedOptions). -
wordpress_admin.listAllowedOptionsList 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.updateOptionChange 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.
plugins
-
wordpress_admin.activatePluginActivate 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.deactivatePluginDeactivate 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.getPluginDetails of one installed plugin: name, version, author, description, required WordPress / PHP version, active state, available update and auto-update state. -
wordpress_admin.listPluginsList installed plugins with version, active state (and network-active on multisite), whether an update is available and whether auto-update is on. -
wordpress_admin.searchPluginsDirectorySearch the WordPress.org plugin directory. Returns slug, name, version, rating, active installs, last update and tested-up-to for each result. -
wordpress_admin.setPluginAutoUpdateSwitch automatic updates on or off for one plugin.
privacy
-
wordpress_admin.createPrivacyErasureRequestCreate 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.createPrivacyExportRequestCreate 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.listPrivacyRequestsList personal data export and erasure requests with their status: pending (waiting for the person's e-mail confirmation), confirmed, failed or completed. -
wordpress_admin.processPrivacyErasureErase 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.processPrivacyExportGenerate 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.
roles
-
wordpress_admin.addCapabilityToRoleGrant a capability to a role; every user with that role gets it immediately. High-privilege capabilities require confirm=true. -
wordpress_admin.createRoleCreate 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.deleteRoleDelete 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.getRoleOne role with the full list of its capabilities and its user count. -
wordpress_admin.listRolesList the site's user roles with display name, number of users and number of capabilities. -
wordpress_admin.removeCapabilityFromRoleRemove a capability from a role. Refused for the administrator role (it would lock administrators out). Requires confirm=true.
themes
-
wordpress_admin.getThemeDetails 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.listThemesList installed themes with version, parent theme, which one is active, whether an update is available and whether auto-update is on. -
wordpress_admin.searchThemesDirectorySearch the WordPress.org theme directory. Returns slug, name, version, rating and active installs for each result. -
wordpress_admin.setThemeAutoUpdateSwitch automatic updates on or off for one theme. -
wordpress_admin.switchThemeMake 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.
updates
-
wordpress_admin.getCoreUpdateStatusCurrent 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.getTranslationUpdatesList the translation (language pack) updates waiting for WordPress, plugins and themes.
Pricing
Get the plugin.
Yearly — Single Site
Full feature set + support
- ✓ All 65 WordPress admin tools
- ✓ 1 site
- ✓ 1 year updates
- ✓ Email support
Yearly — 5 Sites
Full feature set + support
- ✓ All 65 WordPress admin tools
- ✓ Up to 5 sites
- ✓ 1 year updates
- ✓ Priority email support
Yearly — 50 Sites
Full feature set + support
- ✓ All 65 WordPress admin tools
- ✓ Up to 50 sites
- ✓ 1 year updates
- ✓ Priority email support
FAQ
Common 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.
WordPress platform
More plugins for WordPress
Questions about Goldnat for WordPress — Admin?