# BigCommerce MCP MCP > BigCommerce MCP lets your AI agent operate your entire e-commerce backend. Manage full product catalogs, trace every order detail, review customer profiles, and validate coupon rules without touching a dashboard. It gives you direct control over transactions, inventory levels, and store settings from any compatible client. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** storefront-management, product-catalog, transaction-metrics, checkout-optimization, saas-ecommerce ## Description Need to audit an order? You don't have to navigate three different tabs in the BigCommerce admin panel just to see who bought what, when, and how much it cost. This MCP connects your AI agent directly to the core commerce systems. You can ask for a list of all live orders, dive into one specific transaction, and immediately extract every line-item detail—even if some products are out of stock or linked to an old coupon rule. It’s about getting raw data payloads instantly. If you're using Vinkius, this MCP lets your agent pull product variants, check the store's overall configuration settings, and even list all available brands and categories simultaneously. You get precise information on customer lifetime spending, whether it's for reporting or just locating an address. ## Tools ### get_order Retrieves the complete data payload for one specific BigCommerce order. ### get_order_products Pulls a list of line items attached to an existing order ID. ### get_product Gets all details for a single, specific product in the catalog. ### get_store_info Retrieves general metadata about the entire BigCommerce store setup. ### list_brands Lists every brand that is currently mapped in the catalog hierarchy. ### list_categories Outputs a list of all structured product categories available on the site. ### list_coupons Shows a list of every active and configured coupon code. ### list_customers Lists all registered customer accounts in the system, paginated. ### list_orders Provides a paginated list of recent or historical orders placed. ### list_products Outputs a paginated list of all main products in the catalog. ## 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 ### Analyze Order History Retrieve the full data payload for any specific transaction ID. ### Break Down Line Items Extract a detailed list of products and quantities associated with an order. ### Review Product Details Fetch complete information, including variations and attributes, for any product SKU. ### Audit Customer Records List registered customer accounts and pull details about their order history. ### Validate Discounts Check the rules and status of all active coupons on the store. ### View Store Configuration Get high-level data about how the entire BigCommerce storefront is set up. ## Use Cases ### Investigating a Refund Discrepancy A customer service rep asks their agent to check Order ID 1420. The agent runs get_order and get_order_products, instantly showing that the line-item discount was calculated using an expired coupon rule, proving why the refund wasn't processed correctly. ### Building a Product Filter Tool A developer needs to build a new filter page. They use list_brands and list_categories first to get all possible options, then run get_product on specific IDs to ensure the necessary product attributes exist. ### Analyzing Seasonal Sales Peaks An e-commerce manager needs a quarterly report. They use list_orders repeatedly, filtering by date range, and then pair it with list_customers data to see which customer segments are driving the most revenue. ### Checking Store Compliance A team member wants to know if a new marketing campaign requires specific local settings. They use get_store_info and cross-reference it with list_categories to ensure all regional tax rules are configured correctly. ## Benefits - Stop cross-referencing tabs. Instead of checking the order dashboard, you can use get_order to pull all transaction details in a single request. - Inventory checks become instant. Use list_products or get_product to confirm if a specific variant is active and available before telling a customer. - Never miss a coupon rule again. list_coupons lets your agent validate complex discounting strategies, checking expiry dates and exclusions automatically. - Customer data retrieval is faster. List customers gives you the full user roster, while get_order provides that user's spending history for reporting. - Audit everything from one spot. Combining list_categories with get_store_info lets you map out how products are structured across the whole site. ## How It Works The bottom line is you tell your agent what to check, and it pulls the live data from BigCommerce instantly. 1. Subscribe to this MCP, then provide your BigCommerce API Token and Store Hash. 2. Your AI client executes a command (e.g., 'Show me the details for Order ID 1420'). 3. The system runs the necessary functions, returning structured data like product lists or customer records directly into your chat window. ## Frequently Asked Questions **How do I list orders using list_orders?** The list_orders tool gives you a paginated view of recent transactions. This is useful for seeing the general scope of activity, but remember it only provides IDs; use get_order to pull the actual details. **What is the difference between list_products and get_product?** list_products gives you a paginated overview of all primary product SKUs in the catalog. Use get_product when you need the full, deep data payload for one specific item. **Can I check coupon rules with list_coupons?** Yes, list_coupons outputs a list of all configured codes and their general rules. If you need to verify how that code applied to a specific order, run get_order first. **Where do I find customer information? (list_customers)** Use the list_customers tool to get a paginated roster of all registered users. For details on a single user's transactions, you must run get_order. **How do I get all available brand names using list_brands?** list_brands returns a paginated list of every configured brand. You can iterate through these results to build a complete map of your storefront's branding structure. **What information does get_order_products provide for an order?** get_order_products delivers detailed line items associated with a specific Order ID. This includes product SKUs, quantities purchased, and the final price paid per item. **How do I check high-level store settings using get_store_info?** get_store_info pulls general metadata about your BigCommerce account. Use it to audit core configuration boundaries like currency, tax rates, and localized operational settings. **Can I list all active categories with list_categories?** list_categories provides a hierarchical view of every major category on your site. This is useful for mapping the overall navigation structure or verifying product placement logic.