PHPackages soderlind/vmfa-ai-ability - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. soderlind/vmfa-ai-ability ActiveWordpress-plugin[Utility & Helpers](/categories/utility) soderlind/vmfa-ai-ability ========================= Exposes Virtual Media Folders operations as WordPress Abilities API tools for AI agents and MCP adapters. 1.2.0(1mo ago)10GPL-2.0-or-laterPHPPHP >=8.3 Since Apr 19Pushed 2w agoCompare [ Source](https://github.com/soderlind/vmfa-ai-ability)[ Packagist](https://packagist.org/packages/soderlind/vmfa-ai-ability)[ RSS](/packages/soderlind-vmfa-ai-ability/feed)WikiDiscussions main Synced 1w ago READMEChangelog (2)Dependencies (2)Versions (5)Used By (0) Virtual Media Folders - AI Ability ================================== [](#virtual-media-folders---ai-ability) Exposes Virtual Media Folders operations as WordPress Abilities API tools for AI agents and MCP adapters. [Description](#description) | [Requirements](#requirements) | [Installation](#installation) | [MCP Integration](#mcp-integration) | [Tutorials](#tutorials) | [Changelog](CHANGELOG.md) [![vmfa-ai-ability-twitter-promo](https://private-user-images.githubusercontent.com/1649452/586817753-d1f7e012-eefa-4b22-b796-4985788ca49d.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODAxMjk4NDAsIm5iZiI6MTc4MDEyOTU0MCwicGF0aCI6Ii8xNjQ5NDUyLzU4NjgxNzc1My1kMWY3ZTAxMi1lZWZhLTRiMjItYjc5Ni00OTg1Nzg4Y2E0OWQucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI2MDUzMCUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNjA1MzBUMDgyNTQwWiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9MzA0MmUxZjUwNDRjOWNmZTdlODQ5OTQ5YTNkMDYzZDdhZGFlODM1M2Y5ODRlYjYwOTY5ZTQ3N2ZlYTBjZDgwMiZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmcmVzcG9uc2UtY29udGVudC10eXBlPWltYWdlJTJGcG5nIn0.MQtv3BKku7kV53BrhHbU33pnAA_h6Yl0wKSZHzdgGFg)](https://private-user-images.githubusercontent.com/1649452/586817753-d1f7e012-eefa-4b22-b796-4985788ca49d.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODAxMjk4NDAsIm5iZiI6MTc4MDEyOTU0MCwicGF0aCI6Ii8xNjQ5NDUyLzU4NjgxNzc1My1kMWY3ZTAxMi1lZWZhLTRiMjItYjc5Ni00OTg1Nzg4Y2E0OWQucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI2MDUzMCUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNjA1MzBUMDgyNTQwWiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9MzA0MmUxZjUwNDRjOWNmZTdlODQ5OTQ5YTNkMDYzZDdhZGFlODM1M2Y5ODRlYjYwOTY5ZTQ3N2ZlYTBjZDgwMiZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmcmVzcG9uc2UtY29udGVudC10eXBlPWltYWdlJTJGcG5nIn0.MQtv3BKku7kV53BrhHbU33pnAA_h6Yl0wKSZHzdgGFg)Description ----------- [](#description) This add-on for [Virtual Media Folders](https://github.com/soderlind/virtual-media-folders) registers folder management, rules, media cleanup, ZIP export, and AI-powered batch organisation as WordPress Abilities API tools, making them available to AI agents and MCP (Model Context Protocol) adapters. Add-on abilities are registered automatically when the corresponding add-on plugin is active — no extra configuration required. ### Registered Abilities [](#registered-abilities) #### Folder Management — always active [](#folder-management--always-active) AbilityDescription`vmfo/list-folders`List folders with IDs, names, paths, and counts`vmfo/create-folder`Create a folder with an optional parent`vmfo/add-to-folder`Assign one or more media items to a folder`vmfo/update-folder`Rename or move a folder`vmfo/delete-folder`Delete a folder`vmfo/remove-from-folder`Remove one or more media items from a folder`vmfo/get-suggestions`Get AI-powered folder suggestions for a media item#### Rules Engine — requires [vmfa-rules-engine](https://github.com/soderlind/vmfa-rules-engine) [](#rules-engine--requires-vmfa-rules-engine) AbilityDescription`vmfo-rules/list-rules`List all folder-assignment rules`vmfo-rules/create-rule`Create an automatic folder-assignment rule`vmfo-rules/update-rule`Update an existing rule`vmfo-rules/delete-rule`Delete a rule`vmfo-rules/preview`Preview which media a rule would match (dry run)`vmfo-rules/apply`Apply rules to existing media#### Media Cleanup — requires [vmfa-media-cleanup](https://github.com/soderlind/vmfa-media-cleanup) [](#media-cleanup--requires-vmfa-media-cleanup) AbilityDescription`vmfo-cleanup/start-scan`Start a background scan for unused, duplicate, or oversized media`vmfo-cleanup/get-scan-status`Get current scan progress`vmfo-cleanup/cancel-scan`Cancel the running scan`vmfo-cleanup/get-stats`Get dashboard statistics from the last scan`vmfo-cleanup/list-results`List paginated scan results by type`vmfo-cleanup/archive`Move media to an archive folder`vmfo-cleanup/trash`Move media to the WordPress trash`vmfo-cleanup/delete`Permanently delete media and files from disk#### Folder Exporter — requires [vmfa-folder-exporter](https://github.com/soderlind/vmfa-folder-exporter) [](#folder-exporter--requires-vmfa-folder-exporter) AbilityDescription`vmfo-folder-exporter/start-export`Start an async ZIP export of a folder`vmfo-folder-exporter/get-export-status`Get the status of an export job`vmfo-folder-exporter/list-exports`List all recent export jobs`vmfo-folder-exporter/delete-export`Delete an export job and its ZIP file#### AI Organizer — requires [vmfa-ai-organizer](https://github.com/soderlind/vmfa-ai-organizer) [](#ai-organizer--requires-vmfa-ai-organizer) AbilityDescription`vmfo-ai-organizer/start-scan`Start an AI-powered batch folder-assignment scan`vmfo-ai-organizer/get-scan-status`Get current scan progress`vmfo-ai-organizer/cancel-scan`Cancel the running scanRequirements ------------ [](#requirements) - WordPress 7.0+ - PHP 8.3+ - [Virtual Media Folders](https://github.com/soderlind/virtual-media-folders) (required) - [WordPress MCP Adapter](https://github.com/wordpress/mcp-adapter) (required to expose abilities as MCP tools) Installation ------------ [](#installation) Recommended: Use the [Add-On Manager](https://github.com/soderlind/vmfa) to install the add-on. Manual installation: 1. Download [`vmfa-ai-ability.zip`](https://github.com/soderlind/vmfa-ai-ability/releases/latest/download/vmfa-ai-ability.zip) 2. Upload via `Plugins → Add New → Upload Plugin` 3. Activate via `WordPress Admin → Plugins` MCP Integration --------------- [](#mcp-integration) Once activated, all abilities are automatically exposed to MCP adapters. See: - [docs/mcp.md](docs/mcp.md) — authentication, endpoint, and client configuration (Claude, GitHub Copilot, Cursor) - [docs/README.md](docs/README.md) — full ability reference Tutorials --------- [](#tutorials) LevelTutorial101[Upload & Organise a Photo](docs/tutorials/101-first-folder-workflow.md)201[Detect & Clean Up Unused Media](docs/tutorials/201-media-cleanup.md)301[Automate Folder Assignment with Rules](docs/tutorials/301-rules-automation.md)Changelog --------- [](#changelog) See [CHANGELOG.md](CHANGELOG.md). License ------- [](#license) GPL-2.0-or-later ### Health Score 41 — FairBetter than 87% of packages Maintenance94 Actively maintained with recent releases Popularity2 Limited adoption so far Community6 Small or concentrated contributor base Maturity52 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~12 days Total 2 Last Release 38d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/1649452?v=4)[Per Søderlind](/maintainers/soderlind)[@soderlind](https://github.com/soderlind) --- Top Contributors [![soderlind](https://avatars.githubusercontent.com/u/1649452?v=4)](https://github.com/soderlind "soderlind (33 commits)") --- Tags mcpwordpress-abilitieswordpress-plugin ### Embed Badge ![Health badge](/badges/soderlind-vmfa-ai-ability/health.svg) ``` [![Health](https://phpackages.com/badges/soderlind-vmfa-ai-ability/health.svg)](https://phpackages.com/packages/soderlind-vmfa-ai-ability) ``` ### Alternatives [helsingborg-stad/municipio A bootstrap theme for creating municipality sites. 4028.3k10](/packages/helsingborg-stad-municipio)[mautic/core Mautic Open Source Distribution 9.8k2.6k9](/packages/mautic-core)[roots/wp-stage-switcher WordPress plugin that allows you to switch between different environments from the admin bar 382458.3k3](/packages/roots-wp-stage-switcher)[vinkla/wordplate The WordPlate boilerplate 2.2k5.3k](/packages/vinkla-wordplate)[mediawiki/maps Adds various mapping features to MediaWiki 79149.7k3](/packages/mediawiki-maps)[rainlab/blog-plugin Blog plugin for October CMS 17158.6k](/packages/rainlab-blog-plugin) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)