The plugin gives an AI assistant 31 tools. All of them only read: 27 cover WooCommerce data and 4 cover WordPress posts and pages. The table lists every one of them.
Registered Tools
List of all 31 registered tools in the system. Use the toggles to enable or disable individual tools.
| Name | Description | Functionality Type | Status |
|---|---|---|---|
| wc_products_search | PRIMARY PRODUCT SEARCH TOOL: Universal product search for ANY store type (electronics, food, pets, pharmacy, automotive, etc.). CRITICAL: This is the main search tool - use this FIRST for all product searches. When searching for specific products by name, ALWAYS use this tool FIRST to get the correct product ID, then use other tools with that ID. DO NOT use hardcoded product IDs. IMPORTANT: Each product includes a "permalink" field with the direct link to the product page - ALWAYS include these links when presenting products to users. | read | |
| wc_get_product | SECONDARY TOOL: Get a WooCommerce product by ID after using wc_products_search. Use this tool when you have a specific product ID from search results to get detailed product information. IMPORTANT: The product includes a "permalink" field with the direct link to the product page - ALWAYS include this link when presenting the product to users. | read | |
| wc_get_product_variations | Get all variations (colors, sizes, etc.) for a variable WooCommerce product. CRITICAL: You MUST get the product_id from wc_products_search first. DO NOT use hardcoded product IDs like 42. Each variation includes specific attributes like color, size, price, and stock status. IMPORTANT: Each variation includes a "permalink" field with the direct link to the variation page - ALWAYS include these links when presenting variations to users. | read | |
| wc_get_product_variation | Get a specific product variation by ID. IMPORTANT: The variation includes a "permalink" field with the direct link to the variation page - ALWAYS include this link when presenting the variation to users. | read | |
| wc_get_categories | Get all available WooCommerce product categories dynamically | read | |
| wc_get_tags | Get all available WooCommerce product tags dynamically | read | |
| wc_analyze_search_intent | Analyze user search query and suggest optimal WooCommerce search parameters | read | |
| wc_intelligent_search | FALLBACK SEARCH TOOL: Advanced intelligent product search with automatic fallback strategies. Use this tool ONLY when wc_products_search and wc_get_product do not provide satisfactory results. This tool handles complex queries and multiple fallback strategies but should be used as a last resort. WORKFLOW: 1) Try wc_products_search first, 2) Use wc_get_product for details, 3) Only use this tool if needed. CRITICAL: Each product includes a "permalink" field with the direct link to the product page - ALWAYS include these links when presenting products to users. | read | |
| wc_analyze_search_intent_helper | Analyze user search query and return optimized search parameters with category matching | read | |
| wc_get_products_by_brand | Get products by brand name. Automatically detects if brand is implemented as attribute, category, or custom taxonomy. | read | |
| wc_get_products_by_category | Get products by category name or slug. | read | |
| wc_get_products_by_attributes | Get products by custom attributes (color, size, etc.) | read | |
| wc_get_products_filtered | Get products with multiple filters: brand, category, price range, and attributes. | read | |
| wc_get_product_detailed | Get single product by ID with complete details. | read | |
| wc_get_product_reviews | Get all WooCommerce product reviews with filtering and pagination | read | |
| wc_get_product_review | Get a specific WooCommerce product review by ID | read | |
| wc_get_product_attributes | Get all GLOBAL product attribute definitions (like Color, Size, Material) available in the store. WARNING: This shows attribute types, NOT specific product colors/sizes. To get available colors/sizes for a specific product, use: 1) wc_products_search to find the product, 2) wc_get_product_variations with that product ID. | read | |
| wc_get_product_attribute | Get a specific WooCommerce product attribute by ID | read | |
| wc_get_attribute_terms | Get all terms for a specific product attribute (e.g., Red, Blue for Color attribute) | read | |
| wc_get_shipping_zones | Get all WooCommerce shipping zones and their coverage areas | read | |
| wc_get_shipping_zone | Get details about a specific WooCommerce shipping zone | read | |
| wc_get_shipping_methods | Get all shipping methods available for a specific shipping zone | read | |
| wc_get_shipping_locations | Get all locations (countries/states) covered by a specific shipping zone | read | |
| wc_get_tax_classes | Get all WooCommerce tax classes (Standard, Reduced Rate, Zero Rate, etc.) | read | |
| wc_get_tax_rates | Get all WooCommerce tax rates with filtering by class, country, state, etc. | read | |
| wc_get_payment_gateways | Get all available WooCommerce payment gateways (PayPal, Stripe, Bank Transfer, etc.) | read | |
| wc_get_payment_gateway | Get details about a specific WooCommerce payment gateway by ID | read | |
| wordpress_posts_list | List WordPress posts with filtering and search options | read | |
| wordpress_posts_get | Get a single WordPress post by ID | read | |
| wordpress_pages_list | List WordPress pages with filtering and search options | read | |
| wordpress_pages_get | Get a single WordPress page by ID | read |
Tool Configuration
Every tool has the functionality type read: it returns data and never changes anything.
Toggle Controls
The Tools tab in the plugin settings has a switch next to each tool. A switched-off tool disappears from the list the assistant sees.
- Blue, switch to the right: the tool is on
- Gray, switch to the left: the tool is off
What the Tools Can and Cannot Reach
- They read what a shop visitor can already see: published, catalog-visible products and their variations, categories, tags, brands, attributes, approved reviews (reviewer name only), shipping zones and enabled methods with their cost, tax classes and rates, the payment methods offered at checkout, and published posts and pages that are not password-protected
- They cannot create, edit or delete anything
- None of them returns orders, customers, users, e-mail addresses, store settings, or draft, private or password-protected content
Best Practices
Product Search
- Start with wc_products_search
- Open a result with wc_get_product and the ID the search returned
- Use wc_intelligent_search only when the first search comes back empty
- Give the customer the product's permalink with every answer
Performance
- Work with the IDs a search returns instead of hard-coded ones
- Ask for fewer results when you only need a few
- Page through large lists instead of loading them at once
Asking the Assistant
- A specific question gets a better answer than a broad one
- Plain language is fine; the assistant picks the tools
- For a full answer it may combine several tools, for example a product and its variations
Example Workflows
Finding a Product
- Search with wc_products_search
- Get the details with wc_get_product and the returned ID
- If it is a variable product, list the options with wc_get_product_variations
- Answer with the product's permalink
Reviewing WordPress Content
- List content with wordpress_posts_list or wordpress_pages_list
- Open an item with wordpress_posts_get or wordpress_pages_get
- Ask for an SEO or content review of what came back
Checking the Store Setup
- Shipping: wc_get_shipping_zones and wc_get_shipping_methods
- Payments: wc_get_payment_gateways
- Taxes: wc_get_tax_classes and wc_get_tax_rates
Tools by Group
- Products (search, details, variations): 4 tools
- Search helpers (intelligent search, intent analysis, filtering by category, brand and attributes): 8 tools
- Categories and tags: 2 tools
- Attributes: 3 tools
- Reviews: 2 tools
- Shipping: 4 tools
- Taxes: 2 tools
- Payment gateways: 2 tools
- WordPress posts and pages: 4 tools
31 tools in total, all read-only.
Next: Resources →