Tools

You never call these yourself: your assistant chooses them. This page is for when you want to know exactly what it can do on your site. At Read only, only the tools that read are offered.

As of 15 October 2026: 27 tools.

Account

Tool	What it does	Standard	Trusted
list_sites	The sites this connection may use, with their safety level and whether changes are paused.	Runs	Runs
get_usage	Website actions used and left this month, and when they renew.	Runs	Runs
get_operation	What happened to an earlier change: waiting, done, failed, or unknown.	Runs	Runs
get_guide	Opens a guide from this manual, so your assistant knows how to do a job well.	Runs	Runs

Many sites

Tool	What it does	Standard	Trusted
start_fleet_job	Runs a list of WP-CLI commands on up to 50 of your sites, in the background.	Each command as on its own site	Each command as on its own site
get_fleet_job	Shows a background job’s progress, site by site.	Runs	Runs
cancel_fleet_job	Stops the commands of a job that haven’t started yet.	Runs	Runs

Posts and pages

Tool	What it does	Standard	Trusted
get_site_overview	Site name, address, WordPress version, active theme, installed plugins, and what this connection may do.	Runs	Runs
search_content	Finds posts or pages by words and status.	Runs	Runs
get_content	Reads one post or page in full, with its current version.	Runs	Runs
create_draft	Writes a new post or page as a draft. Never publishes.	Runs	Runs
update_content	Edits a post’s or page’s title, content, excerpt, categories, tags or featured image.	Drafts: runs. Published: asks	Runs
publish_content	Publishes a draft now, or schedules it.	Asks	Runs

Images

Tool	What it does	Standard	Trusted
search_media	Finds images in the media library.	Runs	Runs
get_media	Reads one image: address, size and alt text.	Runs	Runs
upload_media	Adds an image from a public HTTPS address to the media library.	Runs	Runs
upload_image_file	Adds an image you attached in the chat to the media library, exactly as it is. In ChatGPT.	Runs	Runs
request_upload	Gives you your site’s WordPress upload page, when the app can’t pass on an attachment (Claude). Uploads nothing itself.	Runs	Runs
find_media_missing_text	Finds images missing alt text, a caption or a title, 10 at a time.	Runs	Runs
inspect_media	Shows your assistant the image itself, so it can describe what’s really there.	Runs	Runs
fill_media_text	Fills only the empty alt text, caption or title of one image. Never overwrites.	Asks	Runs
update_media	Changes an image’s alt text.	Asks	Runs

Plugins and REST

Tool	What it does	Standard	Trusted
find_abilities	Lists what your plugins share with assistants (the WordPress Abilities API).	Runs	Runs
read_ability	Runs a plugin ability that only reads.	Runs	Runs
run_ability	Runs a plugin ability that changes something.	Asks	Runs
read_rest_route	Reads from your site’s REST API, such as WooCommerce products.	Runs	Runs
write_rest_route	Changes something through your site’s REST API.	Asks	Runs

Abilities on your site

Besides these tools, your assistant finds more on your site with find_abilities and uses them with run_ability. Your plugins add some, and AI Puffer adds its own, for example:

• Stock photo search: ai-puffer/search-stock-images. Recipe
• SVG logos and icons: ai-puffer/sanitize-svg and ai-puffer/import-svg. Recipe
• Reading PDFs, on paid plans: ai-puffer/read-pdf. Recipe
• Content types, block layouts and theme drafts: see WordPress and themes.

Website actions

Each successful operation on your site uses one website action from your monthly allowance, such as reading a post or changing a price. One request can take several: reading a post, creating a draft and publishing it are three. Account and status calls are free, and so are starting, checking and stopping a background job; there, each command that succeeds on a site uses one action. See plans and usage.