Developer Reference
Constants
| Constant | Value | Description |
|---|---|---|
WCFORGE_PRO_VERSION | 1.0.0 | Plugin version |
WCFORGE_PRO_PLUGIN_FILE | __FILE__ | Main plugin file |
WCFORGE_PRO_PLUGIN_DIR | plugin_dir_path() | Plugin directory |
WCFORGE_PRO_PLUGIN_URL | plugin_dir_url() | Plugin URL |
WCFORGE_PRO_REST_NAMESPACE | windcodex-forge/v1 | REST namespace (same as the free plugin) |
WCFORGE_PRO_REST_ROUTE | /mcp | MCP route |
WCFORGE_PRO_LICENSE_OPTION | wcforge_pro_license_key | License key option |
WCFORGE_PRO_LICENSE_STATUS_OPTION | wcforge_pro_license_status | License status option |
REST Routes
| Route | Method | Description |
|---|---|---|
/wp-json/windcodex-forge/v1/mcp | POST | MCP JSON-RPC endpoint (Bearer token) |
/wp-json/windcodex-forge/v1/oauth/register | POST | Dynamic client registration (10 per hour per IP) |
/wp-json/windcodex-forge/v1/oauth/token | POST | Token exchange and refresh |
/wcforge-oauth/authorize | GET/POST | Consent screen (rewrite rule) |
Options
| Option | Description |
|---|---|
wcforge_settings | All settings (shared with Forge) |
wcforge_pro_license_key | License key |
wcforge_pro_license_status | Cached license status |
Notable keys in wcforge_settings:
| Key | Default | Description |
|---|---|---|
enabled | true | Connector master switch |
read_only | false | Strip non-read-only tools |
primitive_enabled | see Tools | Per-tool toggles |
allow_direct_live_writes | false | Expose wp_write_file |
backup_acknowledged | false | Required for wp_execute_php and admin login links |
live_site_override | false | Allow power tools on production-detected sites |
live_site_override_locked_domain | '' | Domain the override is locked to |
requests_per_minute_limit | 120 | 10-600 |
max_results_limit | 50 | List and query cap |
Filters
| Filter | Arguments | Description |
|---|---|---|
wcforge_pro_ability_capability | $capability (string), $tool_name (string) | Change the capability required to run a tool through the Abilities API. Default manage_options |
add_filter( 'wcforge_pro_ability_capability', function ( $capability, $tool_name ) {
return 'manage_options';
}, 10, 2 );WP-Cron
| Hook | Description |
|---|---|
wcforge_pro_run_cli_job | Runs a queued background WP-CLI job. Scheduled with wp_schedule_single_event() |
Filesystem Locations
| Path | Description |
|---|---|
wp-content/wcforge-pro-drafts/ | Sandbox draft area |
Terminal Commands
wp forge status
wp forge snapshots [--limit=<n>]WordPress Abilities API
On WordPress 6.9+, each tool is registered as an ability in the windcodex-forge category.
The MCP endpoint, the Abilities API, and the wp forge commands are the supported integration surfaces. Internal PHP classes are not a public API.