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 22 October 2026: 32 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 operation: waiting, done, failed, or unknown. Checks the original record and reconciles saved outcome and action accounting. May fence a late delivery; never repeats the change.	Runs	Runs
`get_guide`	Reads workflow guidance for the selected task; exact fields come from your site’s discovered abilities.	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. Block content uses the native Gutenberg abilities instead; this tool refuses to flatten existing blocks.	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
`check_upload`	Checks once for a new image you uploaded in WordPress, using the upload ticket and exact saved filename or image ID. Never uploads or chooses for you.	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

Saved workflows

Tool	What it does	Standard	Trusted
`list_workflows`	Your saved workflows on this site, for the WordPress user it acts as.	Runs	Runs
`get_workflow`	One saved workflow’s instructions, so your assistant can follow them.	Runs	Runs
`save_workflow`	Saves new instructions, or changes saved ones. A change needs the version it read.	Runs	Runs
`delete_workflow`	Deletes a workflow’s instructions, never the content they mention.	Runs	Runs

Abilities on your site

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

Lighthouse audits Beta (Free and Premium): ai-puffer/audit-page, through read_ability. One public page and device, four lab scores and bounded findings. Ten provider attempts/account/UTC day, one at a time; shared capacity limits also apply. Failed or blocked audits use no website actions. Availability and plan access may change. Recipe
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
PHP draft-file outlines, on paid plans: ai-puffer/theme-file-outline. Names, line numbers and a file hash; no code execution. Limits
Saved post revisions: ai-puffer/list-post-revisions, ai-puffer/get-post-revision and ai-puffer/restore-post-revision. Restore the selected title, body and excerpt while preserving publication status and current metadata. Recipe
Simple-product sales: ai-puffer/get-product-sale and ai-puffer/set-product-sale. Inspect, schedule or cancel using the website timezone. Recipe
Core-block text, links and draft copies use the existing Gutenberg abilities. Generic plain-content updates still refuse to overwrite block markup. Internal links · Separate draft copy
Content types, block layouts and theme drafts: see WordPress and themes.
From 2.5.19, native page workflows cover Beaver Builder, GenerateBlocks, SiteOrigin, Pagelayer and SeedProd. GeneratePress adds per-page layout settings. SeedProd requires Save in its editor to compile visitor HTML.
GeoDirectory uses its registered listing routes, with safe formatted descriptions in 2.5.19. WP Rocket supports non-secret cache inspection and native page-cache clearing.

From AI Puffer 2.5.18, Yoast SEO lookup errors distinguish missing input, a post that cannot be found and denied permissions. Give your assistant the post’s URL or ID. If access is denied, check the connected WordPress user’s permissions; changing the safety level does not grant that user more access.

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.

The manual upload helpers request_upload and check_upload are free status checks. They do not upload an image or poll for one. Use the returned ticket with the exact saved filename or attachment ID; ambiguous matches need your choice. Older sites keep the upload-page and media-search fallback.