Refinery Payouts integrates with the WordPress Abilities API so AI agents and assistants can inspect and act on the payouts system on your behalf. Abilities are registered automatically when the Abilities API is available on the site.
What the Abilities API is
The Abilities API is an emerging WordPress core proposal for a standardized way to expose plugin functionality to AI tools. Each “ability” is a typed function with a name, description, input schema, and output schema. Tools that speak the API can list available abilities and invoke them safely.
If your site doesn’t have the Abilities API loaded, the plugin’s Abilities integration is a no-op — nothing breaks.
Registered abilities
Refinery Payouts registers the following abilities under the refinery-payouts/ namespace:
refinery-payouts/list-transfer-accounts— Returns all Transfer Accounts and their onboarding status.refinery-payouts/get-transfer-account— Returns a single Transfer Account with its Stripe details.refinery-payouts/list-commission-rules— Returns all enabled commission rules with their scopes and structures.refinery-payouts/get-commission-rule— Returns a single rule by ID.refinery-payouts/list-transfers— Returns transfer log entries with optional filters (status, order, account, date range).refinery-payouts/get-transfer-summary— Returns aggregate totals: transferred, refunded, and net per Transfer Account over a period.refinery-payouts/connection-status— Returns whether the plugin can authenticate with Stripe in the active mode.
Permissions
Each ability checks the calling user’s WordPress capabilities before running. Read-only abilities require manage_woocommerce; abilities that mutate state require manage_options. Anonymous calls are rejected.
Usage
An MCP-compatible AI client connected to your WordPress site can list and call these abilities directly. For example:
// Pseudo-code from an Abilities-aware agent
const accounts = await wp.abilities.invoke(
'refinery-payouts/list-transfer-accounts'
);
const summary = await wp.abilities.invoke(
'refinery-payouts/get-transfer-summary',
{ since: '2026-01-01' }
);Disabling the integration
To prevent any abilities from being registered, add this filter:
add_filter( 'refinery_payouts_register_abilities', '__return_false' );