Agent Abilities
GitHubGet it free
Features
Abilities
Browse all abilities

WordPress core

ContentTaxonomies & TermsCommentsUsersMediaSite settingsPluginsThemes & stylesBlocksMenusSearch

Integrations

WooCommerceAdvanced Custom FieldsRank Math SEOYoast SEOAll in One SEO
Integrations
All integrationsWooCommerce52Advanced Custom Fields7Rank Math SEO5Yoast SEO3All in One SEO3
Bridge
AI clients
All clientsChatGPTClaude.aiClaude DesktopManusClaude CodeCursorVS CodeWindsurfGemini CLI
Resources
DocsChangelogPrompt LibraryBlogComparisonsSupport
GitHubGet it free

Governed ability

List WooCommerce coupons

aafm/wc-list-couponsRead only

List WooCommerce coupons is a governed ability in Agent Abilities for MCP, a free WordPress plugin that runs an MCP server on your site.

Lists WooCommerce coupons with their id, code, amount, discount type, expiry date, and usage count, plus a total. Requires the manage-WooCommerce capability.

How it is governed

The same model as every ability in the plugin, stated for this one.

  • Off until you enable it

    Like every ability, List WooCommerce coupons ships switched off. You turn it on one at a time, and an update never widens access on its own.

  • Reads only

    It reads data and returns it to your client. Nothing on your site is created, changed, or removed.

  • Capability gated

    A connection only sees List WooCommerce coupons if the user you connected can run it, and the plugin checks that capability again before it executes.

  • Every call audited

    The call is written to the log in your own database, denials included, with the argument keys and the identifiers it touched, never free-text content.

List WooCommerce coupons is one of the 52 governed WooCommerce abilities. See the full WooCommerce MCP integration.

See it in action

An illustrative run. Your real calls and data stay on your own site.

agent-abilities · auditGoverned
YouList WooCommerce coupons on this site.
RunRunning aafm/wc-list-coupons
GateAllowedread capability confirmed
Auditaafm/wc-list-coupons · principal: editor · args: id
ResultReturns the data the agent asked for. Nothing on the site changes.

Try it with a prompt

Example requests you could paste to your agent.

  1. List all the WooCommerce coupons with their codes and discount amounts.
  2. Show me every coupon and how many times each has been used.
  3. Which coupons are on the store, and when do they expire?

These are illustrative example prompts. The agent runs them as the user you connected, checked against that user's capabilities and written to your audit log.

Frequently asked

Short answers for List WooCommerce coupons.

Does the list include how each coupon is restricted?

List WooCommerce coupons returns a lean list: code, amount, discount type, expiry, and usage count, plus a total. For product or email restrictions and spend limits, read a single coupon by id.

Is this available to any user?

No. List WooCommerce coupons requires the manage WooCommerce capability, stays off until an administrator turns it on, and each read is logged.

Related abilities

More in WooCommerce.

Get WooCommerce coupon

Read only

Reads one WooCommerce coupon by id: code, amount, discount type, expiry, usage limits, spend limits, product and email restrictions, and other config. Requires the manage-WooCommerce capability.

View ability

Create WooCommerce coupon

Guarded write

Creates a WooCommerce coupon from a code and discount type, with optional amount, usage limits, spend limits, product restrictions, and email restrictions. Returns the full coupon shape. Requires the manage-WooCommerce capability.

View ability

Update WooCommerce coupon

Guarded write

Updates a WooCommerce coupon by id, changing only the fields you send. An empty request body is a no-op success. Returns the full coupon shape. Requires the manage-WooCommerce capability.

View ability

List WooCommerce customers

Read only

Lists WooCommerce customers with their id, email, name, username, order count, and total spent. Customer email is returned in full under the Integrations security disclaimer. Requires the manage-WooCommerce capability, and the list_users capability as of 1.5.0 (a stock WooCommerce Shop Manager does not hold it, so is now denied).

View ability

Get WooCommerce customer

Read only

Reads one WooCommerce customer by id, including email, name, username, order count, total spent, date created, and the full billing address (including phone) and shipping address. Customer PII is returned in full under the Integrations security disclaimer. Requires the manage-WooCommerce capability, and the list_users capability as of 1.5.0 (a stock WooCommerce Shop Manager does not hold it, so is now denied).

View ability

Create WooCommerce customer

Guarded write

Creates a WooCommerce customer from an email and username, with optional first name, last name, and billing/shipping address. Returns the full customer shape including PII under the Integrations security disclaimer. Requires the manage-WooCommerce capability, and the create_users capability as of 1.5.0 (this ability creates a real WordPress user account).

View ability

Back to all abilities

Governed by default, from the first call.

List WooCommerce coupons is off until you enable it, scoped to the user you connect, and logged like everything else. Turn on only what you need.

Get it on WordPress.orgRead the docs

Every ability off until you enable it, capability-gated on every call.