# BigCommerce MCP

> BigCommerce MCP controls your entire e-commerce backend from natural conversation. Check product metadata, pull full customer profiles, and track real-time order fulfillment status across your store's catalog and transactions.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** online-store, product-catalog, order-fulfillment, saas-ecommerce, inventory-tracking, variant-management

## Description

This connection lets you treat your online store like a giant spreadsheet that talks back. You tell your AI agent what data you need—say, 'What was the total value of all orders placed last week for VIP customers?'—and it handles the multi-step lookups across product details, customer records, and transaction history. It pulls together high-fidelity information from everything: current stock levels, detailed billing statuses, and even store configuration settings. You don't need to jump between dashboards or write complex API calls. Your AI agent acts like a dedicated commerce analyst who knows the entire system inside out. With Vinkius hosting this MCP, you connect once and gain access to all of BigCommerce's operational data.

## Tools

### get_customer_details
Pulls specific profile details for a single customer by their ID.

### get_order_details
Retrieves the full status, billing information, and items for one particular order.

### get_product_details
Gets detailed metadata about a specific product, including variants and stock counts.

### get_store_info
Fetches current operational details for the entire store, like currency or language settings.

### list_catalog_brands
Lists all product brands available in your catalog.

### list_catalog_categories
Retrieves a list of every defined category used to sort products.

### list_customers
Generates a list of all registered shoppers in your store.

### list_orders
Retrieves summaries and statuses for recent orders placed on the site.

### list_products
Lists all products, allowing you to filter results by name or brand.

## Prompt Examples

**Prompt:** 
```
List all products in my BigCommerce store and their current stock levels.
```

**Response:** 
```
I've retrieved your catalog. You currently have 150 products, including 'Enterprise Laptop' (Stock: 45) and 'Ergonomic Chair'. Would you like the detailed variant metadata for any of these?
```

**Prompt:** 
```
Show the last 5 orders and their fulfillment status.
```

**Response:** 
```
Fetching transactions... Your last 5 orders include 3 'Shipped' status and 2 'Pending' (Order IDs: 1024, 1025). Shall I retrieve the high-fidelity billing info for the pending ones?
```

**Prompt:** 
```
Get the full profile for customer ID '123'.
```

**Response:** 
```
Retrieving profile... John Doe (ID: 123) is a registered shopper since 2024 with 15 total orders. He belongs to the 'VIP' customer group. Need help checking his historical transaction metadata?
```

## Capabilities

### Manage Product Catalog Data
List, filter, and retrieve deep metadata for every product, variant, brand, and category in your store.

### Track Order Fulfillment Status
Monitor the entire order lifecycle, getting real-time details on billing status and shipping progress for specific transactions.

### Analyze Customer Profiles
Access full shopper records to understand customer history, total orders, and registered metadata.

### Audit Store Configuration
Retrieve core operational settings like language preferences, currency codes, and account status for reporting.

## Use Cases

### Investigating a Delayed Shipment
A customer complains about an order (ID 1024). You ask your agent to check the details. The agent runs `get_order_details` and immediately reports that the payment status is 'Pending' because of an address mismatch, saving you from chasing down fulfillment teams.

### Analyzing a Product Line Gap
The marketing team wants to see if there are any popular brands not currently listed. You instruct your agent to run `list_catalog_brands` and cross-reference that list against recent customer search data, identifying immediate sourcing opportunities.

### Preparing for a Sales Call
Before talking to a high-value client, you ask the agent for their profile. The agent uses `get_customer_details` and finds they are 'VIP' and have ordered from three specific categories in the last year, letting you tailor your pitch immediately.

### Auditing Site Structure
The web team needs to confirm if a new product category was added correctly. You instruct the agent to run `list_catalog_categories` and cross-reference it with `get_product_details` to ensure the metadata is correct before launch.

## Benefits

- Know the stock count instantly. Instead of checking a separate inventory system, you can use `get_product_details` to get real-time variant and stock levels.
- Never lose an order detail again. Use `get_order_details` to pull complete billing information and fulfillment status for any transaction ID.
- Deep dive into shoppers. With `list_customers` and `get_customer_details`, you can analyze who your best clients are without running reports manually.
- Keep the catalog clean. You can use `list_catalog_brands` or `list_catalog_categories` to audit how your products are organized across the site's structure.
- Check operational settings fast. The `get_store_info` tool lets you report on currency and language settings without logging into system administration.

## How It Works

The bottom line is: Your AI uses the credentials to query BigCommerce's structured data sources directly, eliminating manual logins and dashboard navigation.

1. First, you subscribe to this MCP and retrieve your Access Token, Store Hash, and Client ID from the BigCommerce dashboard.
2. Next, you connect these credentials within your AI client, granting it permission to read store data.
3. Finally, you ask your agent a question like, 'Show me all orders over $50 that are pending payment,' and the tool executes the sequence of calls for you.

## Frequently Asked Questions

**How do I check a customer's full profile using `get_customer_details`?**
You need the customer's unique ID. When you provide that ID, the tool returns their registered history, total orders placed, and any metadata attached to their account.

**Can I list all products and check their stock using `list_products`?**
The `list_products` tool gives you a filtered list of products. To get the *current* stock count, you'll need to run `get_product_details` on those specific product IDs.

**What information does `get_order_details` provide?**
`get_order_details` gives a complete view of one order. You get the billing status, fulfillment status, and all items included in that transaction.

**How do I find out what product brands exist? Use `list_catalog_brands`.**
You simply prompt the agent to run `list_catalog_brands`. It returns a clean list of every brand name currently defined in your BigCommerce catalog.

**Before running any commands, what authentication details must I provide when connecting via the Vinkius platform?**
You need your Access Token, Store Hash, and Client ID from your BigCommerce dashboard settings. This ensures that your agent has permission to perform actions on behalf of your store.

**Can I narrow down my search results when using the `list_products` tool?**
Yes, you can filter product listings by name or by brand. This lets your AI client focus only on a specific set of items without needing to process the entire catalog.

**Which specific configuration settings can I check using the `get_store_info` tool?**
The MCP retrieves core store details, including currency settings, language preferences, and account status. It gives you a quick operational report on your storefront setup.

**After listing categories with `list_catalog_categories`, how do I get product data that matches those sections?**
You can use the category list to inform targeted calls to `list_products` or check specific item attributes using `get_product_details`. This ensures your agent pulls contextually related data.

**How do I find my BigCommerce API credentials?**
Log in to your BigCommerce admin, navigate to **Settings** > **API Accounts**, and create a new V2/V3 API account to get your token, hash, and client ID.

**Does it support both V2 and V3 APIs?**
Yes! The server automatically routes requests to the correct endpoint (V3 for products/customers, V2 for orders) to ensure high-fidelity data access.

**Where do I find my Store Hash?**
Your store hash is the unique identifier in your BigCommerce API URL (e.g., 'xyz123' in api.bigcommerce.com/stores/xyz123/v3/).