Themeisle Docs

Appearance

Robin Image Optimizer AI and MCP abilities ​

Robin Image Optimizer makes tools available through the WordPress Abilities API. A compatible, authenticated Abilities API or MCP (Model Context Protocol) client can use these tools to read and update optimization settings, process media, restore originals, and check job progress. Robin Image Optimizer exposes the abilities but does not connect an AI client to WordPress for you.

In this article

Requirements ​

Latest version of Robin Image Optimizer and WordPress 6.9 or later. Robin's abilities are available only when the WordPress Abilities API is available.

You also need a compatible connector, such as Easy MCP AI, and an AI client connected to your WordPress site. For setup instructions, see Getting Started with Easy MCP AI.

Connect your AI client and enable Robin's abilities ​

  1. In your WordPress dashboard, open Easy MCP AI > Dashboard. In the Connect your AI client area, choose your AI client and follow the on-screen steps to connect it to your site. If you use another compatible connector, follow its connection instructions.

  2. Open Easy MCP AI > Tools, then select Abilities.

  3. All abilities are off by default. In the Robin group, enable all needed abilities.

    Click Save changes to make them available to connected clients.

Available abilities ​

  • robin/optimize-media optimizes selected attachment IDs, or converts them to WebP or AVIF. Each call can process up to 500 attachments.
  • robin/restore-originals restores selected optimized attachments when original-image backups are available. Each call can process up to 500 attachments.
  • robin/get-job returns status, progress, savings, errors, and queue information for a job ID or attachment IDs.
  • robin/get-optimization-policy reads compression, conversion, upload optimization, backup, resizing, thumbnail, and scheduling settings.
  • robin/update-optimization-policy changes only the policy fields you supply and returns the effective policy.

The following abilities provide additional control over settings, optimization runs, backups, folders, and logs:

  • Settings and individual media
    • robin/reset-optimization-policy restores the optimization settings to their defaults.
    • robin/update-media-options accepts media_ids and the optional Boolean fields keep_dimensions and exclude. If you omit either field, that option is left unchanged.
  • Statistics and failures
    • robin/get-stats returns image counts, savings, run status, and groups of failed images.
    • robin/get-failures requires a group from robin/get-stats. To read another page, pass the returned next value as after.
  • Bulk optimization
    • robin/start-bulk-optimization starts a bulk run using the saved scheduling or background optimization policy.
    • robin/stop-bulk-optimization stops the run. It does not undo images that have already been optimized. Use robin/get-stats to monitor the run.
  • Service and delivery
    • robin/get-server-status returns the optimization service and plan status.
    • robin/test-delivery tests the saved delivery mode using temporary files. A server-side test may not match CDN behavior or what real visitors see.
  • Backups
    • robin/get-backups returns the number of backups (count) and their total size in bytes (size).
    • robin/restore-all-backups restores backups in batches. If the response has end: false, call the ability again and pass the failed attachment IDs accumulated so far as skip.
    • robin/clear-backups permanently deletes the backup files. This ability requires confirm: true.
  • Custom folders (Pro)
    • robin/browse-folders lists folders and accepts an optional site-root-relative dir to browse within a folder.
    • robin/add-custom-folder adds a folder using its site-root-relative path.
    • robin/scan-custom-folder scans a folder by its uid. If the scan is not finished, call the ability again with the same uid and the returned offset and total.
    • robin/remove-custom-folder removes a folder from Robin's list using its uid; it does not delete the image files.
    • After adding and scanning a folder, start optimization using the custom-folders scope.
  • Error logs
    • robin/get-log reads the error log created while the error_log policy field is enabled.
    • robin/clear-log deletes the error-log files.

Scope-based abilities use media-library when no scope is supplied. The other scopes are custom-folders and nextgen-gallery, for custom folders and NextGEN Gallery, respectively. Both require Pro and the corresponding integration.

Processing, safety, and license restrictions ​

If an optimize or restore response returns done: false and a cursor, call the same ability again with the same inputs and the returned cursor to continue processing the next chunk. For queued optimization, use the returned job_id with robin/get-job to check progress. Continue checking while the job state is working.

Optimizing media changes image files. Restoring replaces optimized files with their backed-up originals, so check the selected attachment IDs before approving either operation. Keep original-image backups enabled if you may need to restore images.

⚠️ Confirm destructive actions: robin/clear-backups permanently deletes the original-image backups, so you cannot use them to restore images afterward. The ability only runs when you explicitly pass confirm: true.

WebP conversion and scheduled optimization are available without Pro. AVIF conversion and the background optimization type require an active Pro license.

Was this helpful?