This list is for FlitAgent 1.0.0. Your AI app sees the same tools, with their arguments, when it lists them. Every tool acts as the administrator who connected the site, so it can do only what that user can do.
Read tools are always there.
Write tools appear only while the site allows Read and propose changes (Turn on changes).
Page-builder and WooCommerce tools appear only while that plugin is active.
flitagent.com
list_sites lists the sites on your account with their access and whether changes are on. Every other tool takes a site argument, which may be left out when the account has one site.
Read: site and health
Tool
What it reads
get_site_info
Title, tagline, address, language, time zone and site icon.
get_site_health
WordPress, PHP and database versions, multisite and debug mode, and the last saved Site Health counts.
get_health_triage
Problems, most serious first, each with the tool that fixes it (Health triage).
get_update_readiness
Every pending update with its risk and blockers (Update readiness).
get_core_updates
The WordPress version, the updates WordPress last fetched and the automatic update settings.
get_maintenance_status
Whether the site is in maintenance mode.
get_connection_info
Which user the connection acts as, with its roles and key capabilities, and the active theme.
verify_core_checksums
Checks the WordPress core files against the checksums WordPress.org publishes.
verify_plugin_checksums
Checks plugin files against the checksums WordPress.org publishes.
Read Read tools are always there.
Read: content
Tool
What it reads
list_recent_content
The most recently modified posts and pages.
search_content
Searches titles, excerpts and content, like the site’s own search.
Installed plugins, which are active and which have updates.
list_themes
Installed themes, the active one and updates.
search_plugin_directory
Searches the WordPress.org plugin directory.
get_option
One option.
list_options
Options with a short, redacted preview of each value.
get_transient
One transient and when it expires.
list_transients
Transients with a redacted preview.
get_theme_mods
The active theme’s Customizer settings.
get_config
The wp-config.php settings that are not secret.
list_cron_events
Scheduled cron events, soonest first.
get_cron_status
Whether WP-Cron runs and how many events are overdue.
list_rewrite_rules
The permalink structure and rewrite rules.
get_cache_info
Object and page caching, and the cache plugins FlitAgent can purge.
get_user_meta
One user’s meta.
list_roles
User roles and their capabilities.
Read Read tools are always there.
Read: files, REST API and abilities
Tool
What it reads
list_files
Files in the active theme, its parent, or the themes, plugins or mu-plugins folders.
read_file
One text file from those folders.
search_files
Plain text in those files, with line numbers.
get_file_outline
An outline of one file, so only the needed part is read.
wp_rest_get
A GET request to any REST API route on the site, with the user’s own permissions.
list_abilities
The abilities registered with the WordPress Abilities API (WordPress 6.9 and later).
get_ability
One ability.
run_readonly_ability
Runs an ability that declares itself read-only.
Read Read tools are always there.
With Elementor, Bricks, Beaver Builder or Breakdance active, tools such as get_elementor_page and list_bricks_elements read their layouts and elements. With WooCommerce active, get_store_overview, list_orders and list_products read the store (WooCommerce reads).
Write tools: approval and rollback
Auto-approve
Every write waits for an administrator’s approval in FlitAgent → Approvals, except when all of these hold: the tool is marked auto below, an administrator ticked it under Auto-approve in FlitAgent → Settings, and the call is a low-risk one, for example update_post on a draft (Auto-approve policy).
Rollback
What rollback_change can do for each write:
Yes Restores the state before the write.
Nothing to restore The write cleared data WordPress rebuilds itself.
Files only Reinstalls the previous version; what the update changed in the database stays.
No It cannot be undone, and the preview says so.
Warning The preview says so before you approve. Keep backups for everything else; FlitAgent is not a backup tool. See Rollback and its limits.
Write: posts and pages
Tool
Auto-approve
Rollback
create_post Creates a post, page or other post type item, as a draft unless told otherwise.
Auto
Yes
update_post Changes the title, content, excerpt, status, slug, date, parent, template, author or featured image.
Auto
Yes
replace_in_post Replaces exact text in a title, content or excerpt.
Auto
Yes
restore_post_revision Restores a post from one of its revisions.
Auto
Yes
trash_post Moves an item to the trash.
Auto
Yes
restore_post Restores an item from the trash.
Auto
Yes
delete_post_permanently Deletes a trashed item for good.
No
No
set_post_meta Sets one custom field.
No
Yes
delete_post_meta Deletes one custom field.
Auto
Yes
set_post_terms Replaces, adds or removes categories, tags or other terms on a post.
Auto
Yes
Write Write tools appear only while the site allows Read and propose changes.
Write: terms, comments and media
Tool
Auto-approve
Rollback
create_term Creates a category, tag or other term.
Auto
Yes
update_term Changes a term’s name, slug, description or parent.
No
Yes
delete_term Deletes a term for good.
No
No
create_comment Posts a comment or reply as the connected user.
No
Yes
moderate_comment Approves, holds, spams, trashes or restores a comment.
Auto
Yes
delete_comment_permanently Deletes a trashed or spam comment for good.
No
No
upload_media_from_url Downloads an image from a public address into the media library.
No
Yes
update_media Changes a media item’s title, alt text, caption or description.
No
Yes
delete_media Deletes a media item and its files for good.
No
No
Write Write tools appear only while the site allows Read and propose changes.
Write: users and roles
Tool
Auto-approve
Rollback
create_user Creates a user with a role you may assign.
No
Yes
update_user Changes a user’s names, biography, website or email address.
No
Yes
set_user_role Replaces a user’s role.
No
Yes
set_user_meta Sets one user meta key.
No
Yes
delete_user_meta Deletes one user meta key.
No
Yes
set_user_capabilities Grants or removes capabilities of one user.
No
Yes
create_role Adds a role.
No
Yes
set_role_capabilities Changes what a role grants.
No
Yes
delete_role Removes a role no user has.
No
Yes
send_password_reset Emails a user WordPress’s password reset link.
No
No
delete_user Deletes a user and gives their posts to another user.
No
No
Write Write tools appear only while the site allows Read and propose changes.
Write: caches, transients and cron
Tool
Auto-approve
Rollback
flush_object_cache Empties the object cache.
Auto
Nothing to restore
purge_page_cache Purges the page cache through each active cache plugin.
delete_transient Deletes one transient. A name that looks like a secret, such as a token or key, always needs approval and has no rollback.
Auto
Nothing to restore
delete_all_transients Deletes every transient.
No
No
unschedule_cron_event Removes one scheduled cron event.
No
Yes
run_cron_event Runs one cron event now.
No
No
Write Write tools appear only while the site allows Read and propose changes.
Write: plugins, themes and WordPress
Tool
Auto-approve
Rollback
install_plugin Installs a plugin from WordPress.org, inactive. Rollback works while it is still inactive and still the installed version.
No
Yes
activate_plugin Activates a plugin.
No
Yes
deactivate_plugin Deactivates a plugin.
No
Yes
update_plugin Updates a plugin from WordPress.org.
No
Files only
delete_plugin Deletes an inactive plugin.
No
No
install_theme Installs a theme from WordPress.org, inactive. Rollback works while it is still inactive and still the installed version.
No
Yes
switch_theme Activates another theme.
No
Yes
update_theme Updates a theme from WordPress.org.
No
Files only
delete_theme Deletes a theme.
No
No
update_core Updates WordPress to a version WordPress.org offers.
No
No
Write Write tools appear only while the site allows Read and propose changes.
Write: settings and appearance
Tool
Auto-approve
Rollback
update_option Sets one option registered as a setting.
No
Yes
delete_option Deletes one such option.
No
Yes
set_permalink_structure Changes the permalink structure.
No
Yes
set_theme_mod Sets the logo, colors, background or header image of the active theme. Rollback works while that theme is active.
No
Yes
update_custom_css Replaces the Additional CSS. Rollback works while that theme is active.
No
Yes
update_template Replaces a block theme template or template part.
No
Yes
update_global_styles Replaces the custom global styles of the active theme.
No
Yes
Write Write tools appear only while the site allows Read and propose changes.
Write: menus and widgets
Tool
Auto-approve
Rollback
create_menu Creates an empty menu.
No
Yes
delete_menu Deletes a menu and its items.
No
Yes
add_menu_item Adds a link, post, page or term to a menu.
No
Yes
update_menu_item Changes a menu item.
No
Yes
delete_menu_item Deletes a menu item.
No
Yes
assign_menu_location Shows a menu in a theme location.
No
Yes
update_widget Changes a classic widget’s settings.
No
Yes
move_widget Moves a classic widget.
No
Yes
delete_widget Deletes a classic widget.
No
Yes
Write Write tools appear only while the site allows Read and propose changes.
Write: page builders and abilities
Tool
Auto-approve
Rollback
save_elementor_page Saves an Elementor layout, and the same for save_bricks_page, save_beaver_page and save_breakdance_page.
No
Yes
save_elementor_template Saves an Elementor template, which can change every page that uses it.
No
Yes
run_ability Runs an ability that is not read-only.
No
No
Write Write tools appear only while the site allows Read and propose changes.
Changes, plans and receipts
apply_change: applies a change after it was approved, with its change ID (Approvals).
submit_plan: sends up to 25 changes for approval under one title.
get_change: the state of one change.
list_receipts: the receipts of applied, failed and refused writes (Receipts and Activity).
rollback_change: undoes a write from its receipt, once. Auto, when the target is unchanged since the write and the original change could have been auto-approved; otherwise it needs approval.