# BigCommerce MCP > BigCommerce gives your AI agent full operational control over your e-commerce backend. Manage products, track every order detail, handle customer profiles, and validate coupon rules—all without logging into complex dashboards. It lets you treat your entire storefront like a single API endpoint. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** storefront-management, product-catalog, transaction-metrics, checkout-optimization, saas-ecommerce ## Description Connect your BigCommerce account to any MCP-compatible client and give your agent the keys to your online store. You gain instant access to every backend function: listing product variations, getting deep order payloads, or auditing user profiles. Instead of navigating multiple tabs across different control panels, you talk to your AI client and it performs the action immediately. Need to know if a specific coupon is still active? Your agent checks that constraint for you. Want to check inventory levels against live orders? It pulls those details in seconds. This MCP makes sure everything runs through Vinkius, giving you one reliable connection point to manage catalog structure, handle customer records, and process transactions directly from your workflow. ## Tools ### list_products Retrieves a paginated list of all products available in the BigCommerce catalog. ### get_order Pulls the complete, specific data payload for one single native BigCommerce order. ### list_customers Retrieves a paginated list of all registered users on your storefront. ### list_categories Lists the full hierarchy and structure of product categories. ### list_brands Retrieves a list of all brands currently mapped to your products. ### get_order_products Fetches only the specific line items associated with an already identified order. ### list_coupons Lists all configured coupons and promotional codes used across your store. ### get_product Retrieves every detail for a single, specific product ID. ### list_orders Lists all native orders placed on the store in paginated batches. ### get_store_info Retrieves high-level metadata about the entire BigCommerce storefront configuration. ## Prompt Examples **Prompt:** ``` List standard product endpoints matching page 1 in the active catalog. ``` **Response:** ``` Scanning catalog logic globally: Extracted 25 root products from page 1 securely. Top variants included 'Ergo Office Chair' (ID: 981, $299.00) and 'Standing Desk Model X' cleanly indexed alongside live inventory levels natively. ``` **Prompt:** ``` Fetch strictly explicitly details of BigCommerce Order ID 1420. ``` **Response:** ``` Loaded Order #1420 structurally. The state reflects 'Awaiting Shipment' mapped via standard Visa processing yielding a subtotal baseline summing exactly $1,402. Shipping route addresses correctly matched to physical regions. ``` **Prompt:** ``` Report active coupon arrays dynamically to understand limitations natively. ``` **Response:** ``` Auditing active logic constraints. Pulled explicit coupon data revealing 'HOLIDAY20' discounting rigidly 20% strictly bounded excluding digital categories and retaining an expiration cap naturally. ``` ## Capabilities ### Audit the entire product catalog List all products by page or retrieve full details for a single item, including its brand and category mapping. ### Deep dive into order history Pull complete transaction records, list paginated orders, and break down the specific line items within any given purchase. ### Manage customer data payloads List registered users and extract their profile details, including past order history and structural routing information. ### Validate discounts and rules Check all configured coupons or list active discounting strategies to ensure constraints are followed. ### Review store configuration metadata Fetch high-level details about the entire BigCommerce storefront setup, including localized settings. ## Use Cases ### A customer reports an incorrect discount on a recent purchase. The agent first uses `get_order` to pull the order payload. Then, it checks the active coupon rules using `list_coupons`. This quickly pinpoints whether the applied discount was valid based on current store constraints. ### A developer needs to update product variant data for a new sale. Instead of downloading CSVs, the agent runs `get_product` for key items and uses `list_categories` to understand where those products fit in the hierarchy. This informs the manual data structure update. ### A support rep needs to know a customer's lifetime value. The agent runs `list_customers` to find the user profile, then uses `list_orders` and specific order tools like `get_order_products` to calculate total spending across multiple purchases. ### A manager needs to check if a seasonal promotion is still running. The agent executes `list_coupons`, filters the results, and immediately reports back on the coupon code's status, expiration date, and applicable product restrictions. ## Benefits - Instantly verify complex transactions. Instead of manually digging through multiple tabs, you can use `get_order` to pull the exact payload for any order ID, including all line items and totals. - Keep track of product structure instantly. If you need to know what brands are active or list all available categories, using `list_brands` or `list_categories` gives you a clean overview without hitting the admin panel. - Handle customer issues faster than ever. Use `list_customers` and then follow up with order tools like `get_order` to build a full picture of a user's history in one conversation. - Validate pricing rules on the fly. Need to know if a specific discount is active? Running `list_coupons` allows you to check coupon constraints instantly, preventing checkout errors before they happen. - Prototype code endpoints easily. Developers can use this MCP to quickly test how product variants behave using `get_product`, simulating live data reads right from their chat environment. ## How It Works The bottom line is that you direct your AI client to perform actions on your live storefront backend without ever leaving your chat window. 1. Subscribe to this MCP and provide your required BigCommerce API Token and Store Hash. 2. Your AI client authenticates with the service, granting permission to read and write operational data across your store. 3. You command your agent using plain language; the agent then executes specific functions like getting an order or listing products. ## Frequently Asked Questions **How do I check if an order was affected by a coupon using BigCommerce MCP?** You must use both `get_order` and `list_coupons`. First, pull the full order payload with `get_order`, then cross-reference the discount codes listed in that data against the results from `list_coupons` to confirm validity. **Can I list all products without knowing their categories using BigCommerce MCP?** Yes, you can use `list_products` alone to get a paginated list of root product identifiers. To understand the structure, follow up with `list_categories` and `list_brands`. **What is the difference between `list_orders` and `get_order` in BigCommerce MCP?** `list_orders` gives you a paginated list of order IDs, acting like an index. You use `get_order` when you have a specific ID and need all the detailed transactional data for that single purchase. **Is this MCP suitable for managing customer billing details?** This MCP provides access to user profiles via `list_customers`, but it is designed for operational payloads, not complex financial ledger management. Always verify payment data against your dedicated accounting system. **How do I find specific line items from a large order?** You use the `get_order_products` tool. You feed it an Order ID, and it returns only the list of products that were purchased in that transaction, keeping your data clean.