Merchant abilities, governed through the Bridge

An agent can list and read Merchant's merchandising modules, campaigns, analytics, and recommendations, and, once the site enables MCP write access, toggle modules, manage campaigns, and read or update per-product settings such as pre-orders and add-to-cart text.

Abilities
126 read5 write1 destructive
Active installs
9K+
Rating
84% (11 ratings)
Version
2.3.2
Requires
WP 6.4+, PHP 7.4+
Last updated
2026-09-17 5:48pm GMT

What has to be true first

Merchant and WordPress 6.9 or later must both be active for these abilities to appear in the registry. Reads require manage_woocommerce; toggle-module requires manage_options; the two product-settings abilities also run a WooCommerce read or edit check on the specific product.

  • merchant/get-product-settings and merchant/update-product-settings only register when WooCommerce is active
  • The 5 write abilities (toggle-module, update-module-settings, create-campaign, update-campaign, delete-campaign) and update-product-settings still register without it, but their permission check refuses every call until the site turns on the wpvibe_mcp_write_access option, off by default

The 12 Merchant abilities

Grouped by what each one can change. Every one starts off until you enable it.

Read 6

  • Read

    List Modules

    Lists Merchant's merchandising modules and their on/off state.

    Permission
    manage_woocommerceShop managers and administrators
    MCP tool
    aafm-bridge-merchant-list-modules
  • Read

    Get Module Settings

    Reads a merchandising module's settings.

    Permission
    manage_woocommerceShop managers and administrators
    MCP tool
    aafm-bridge-merchant-get-module-settings
  • Read

    List Campaigns

    Lists marketing campaigns created with Merchant's modules.

    Permission
    manage_woocommerceShop managers and administrators
    MCP tool
    aafm-bridge-merchant-list-campaigns
  • Read

    Get Analytics

    Reads campaign and module performance analytics.

    Permission
    manage_woocommerceShop managers and administrators
    MCP tool
    aafm-bridge-merchant-get-analytics
  • Read

    Get Recommendations

    Reads suggested modules or campaigns based on the store's current setup.

    Permission
    manage_woocommerceShop managers and administrators
    MCP tool
    aafm-bridge-merchant-get-recommendations
  • Read

    Get Product Settings

    Reads a single product's settings for a supported per-product module such as pre-orders or add-to-cart text.

    Permission
    Custom checkmanage_woocommerce, plus a WooCommerce read check on the product
    MCP tool
    aafm-bridge-merchant-get-product-settings

Write 5

  • Write

    Toggle Module

    Turns a merchandising module on or off.

    Permission
    manage_options; also requires the wpvibe_mcp_write_access option, off by default
    MCP tool
    aafm-bridge-merchant-toggle-module
  • Write

    Update Module Settings

    Changes a merchandising module's settings.

    Permission
    manage_woocommerce; also requires the wpvibe_mcp_write_access option, off by default
    MCP tool
    aafm-bridge-merchant-update-module-settings
  • Write

    Create Campaign

    Creates a new marketing campaign.

    Permission
    manage_woocommerce; also requires the wpvibe_mcp_write_access option, off by default
    MCP tool
    aafm-bridge-merchant-create-campaign
  • Write

    Update Campaign

    Edits an existing marketing campaign.

    Permission
    manage_woocommerce; also requires the wpvibe_mcp_write_access option, off by default
    MCP tool
    aafm-bridge-merchant-update-campaign
  • Write

    Update Product Settings

    Changes a single product's settings for a supported per-product module.

    Permission
    Custom checkmanage_woocommerce plus a WooCommerce edit check on the product; also requires the wpvibe_mcp_write_access option, off by default
    MCP tool
    aafm-bridge-merchant-update-product-settings

Destructive 1

  • Destructive

    Delete Campaign

    Permanently deletes a marketing campaign.

    Permission
    manage_woocommerce; also requires the wpvibe_mcp_write_access option, off by default
    MCP tool
    aafm-bridge-merchant-delete-campaign

How to switch these on

Four steps from two active plugins to a governed connection.

  1. Install Merchant and Agent Abilities for MCP

    Both plugins need to be active on the same WordPress site. Merchant registers its own abilities; this plugin discovers and governs them.

  2. Open the Other plugins screen

    In Agent Abilities for MCP, open the Bridge tab (labeled "Other plugins" in the admin). Abilities from every registered plugin appear there, grouped by the plugin that registered them.

  3. Enable one ability at a time

    Every ability from Merchant starts off. Turn on only the ones you want an agent to reach, or enable the whole set in one click.

  4. Connect as a least-privilege user

    Approve the connection as a WordPress account scoped to what you actually want the agent to do. Each call still re-checks that account’s capability before it runs.

Read more in how bridging works or the full documentation.

Frequently asked questions

Does Merchant work with the Bridge?

Yes. It registers 10 abilities under the merchant/ namespace unconditionally, plus 2 more when WooCommerce is active, all with real annotations, so the Bridge can list and switch on each one.

What has to be true for Merchant's abilities to register?

merchant/get-product-settings and merchant/update-product-settings only register when WooCommerce is active. The 5 write abilities (toggle-module, update-module-settings, create-campaign, update-campaign, delete-campaign) and update-product-settings still register without it, but their permission check refuses every call until the site turns on the wpvibe_mcp_write_access option, off by default.

Does Merchant need anything special to work with the Bridge?

Merchant and WordPress 6.9 or later must both be active for these abilities to appear in the registry. Reads require manage_woocommerce; toggle-module requires manage_options; the two product-settings abilities also run a WooCommerce read or edit check on the specific product.

More Ecommerce plugins

An agent can list, create, update, and delete WooCommerce products, and list orders, add order notes, or change an order's status, all through the same REST layer as the wc/v3 API.

Ecommerce7M+ active installs
2 read2 write3 destructive
Built-in integration tooView abilities

An agent can check whether the store's PayPal account is connected, list configured payment methods, and look up a PayPal order's captures, refunds and shipment tracking, all read-only, once WooCommerce and the plugin's ability feature flag are both enabled.

Ecommerce800K+ active installs
4 read
View abilities

An agent can pull the connected Stripe account's status and balance, and read charges, payment intents, disputes, payouts and balance transactions by ID or as lists, all read-only, once WooCommerce and the plugin's ability feature flag are both enabled.

Ecommerce700K+ active installs
10 read
View abilities

Verified from Merchant's own free wordpress.org code on 28 September 2026, not from its marketing claims. Not every ability listed here has been run end to end against a live site. Plugin authors change their code, so a name, a capability, or a condition can be different in a later release. This site is not affiliated with, or endorsed by, Syed Balkhi or Merchant. Back to the full directory.

Back to the plugin directory

Bridge Merchant, keep the same control.

Every ability starts off, is scoped to the user you connect, and is written to the same audit log as core. Turn on only what you need.

Off by default. Capability checked on every call.