# Squarespace Commerce MCP

> Squarespace Commerce MCP connects your AI client directly to your entire e-commerce backend. Your agent can now check real-time inventory levels, pull up deep order histories, and process fulfillment actions—all without you ever logging into a CMS dashboard. Manage stock adjustments and track shipments programmatically using natural conversation.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** inventory-tracking, order-fulfillment, product-catalog, headless-cms, shipping-logistics, data-sync

## Description

This MCP gives your AI client direct access to the operational data powering your Squarespace Commerce store. Forget constantly signing into multiple dashboards just to verify if an order cleared or how much stock is left on hand. Instead, you simply tell your agent what you need done—whether it's finding a customer’s purchase history or adjusting product counts because of a sale made in person. It pulls deep data across your entire catalog and financial records. Need to know which orders are stuck? Just ask. Want to update inventory after an unexpected shipment arrival? The AI handles the math and sends the command. This capability sits within Vinkius, making it one of the most powerful commerce integrations available to any MCP-compatible client.

## Tools

### adjust_inventory
Increases or decreases the stock count for a specific product variant using a provided ID.

### fulfill_order
Marks an order as shipped and adds necessary tracking information to close out the transaction.

### get_order_details
Retrieves all specific data points for a single customer order ID.

### get_product_details
Gets detailed information, including metadata and variants, for one product by its ID.

### list_inventory
Generates a full report listing the current stock levels across all your product variants.

### list_orders
Lists multiple orders, supporting pagination to view every record in sequence.

### list_products
Returns a list of all available products and their primary IDs for the store.

### list_customer_profiles
Generates a list containing basic details about every registered shopper profile.

### list_transactions
Provides an overview of all recorded financial transactions for the store.

### list_webhooks
Shows a list of webhooks that are currently configured to push data externally.

## Prompt Examples

**Prompt:** 
```
Scan the current order list and figure out exactly which items are marked as pending fulfillment.
```

**Response:** 
```
Cycling via `list_orders` returning unresolved tickets:

1. 📦 **Order #62Bf (Pending/Open)** - Customer: Alice Lee - Value: $140.00
2. 📦 **Order #12Zx (Pending/Open)** - Customer: John M. - Value: $40.50

The rest of the transactions present in this pagination phase are cleanly fulfilled. Tell me the ID string if you want to apply a Courier track to any.
```

**Prompt:** 
```
Tell me the inner variant IDs attached to my product item tagged 'Winter Coat X5'. Our main store sells roughly 5 jackets.
```

**Response:** 
```
Invoked iterative search through `list_products` extracting 'Winter Coat X5' locating Primary ID object ~ `12abcd56`. Next requested Deep Metadata firing `get_product_details` to return your variables.

Here are the variants bound inside your Coat Parent Wrapper:
- **Variant A**: 'Black / Large' -> Variant ID: `vxA001` (Stock: 5)
- **Variant B**: 'Grey / Medium' -> Variant ID: `vxB004` (Stock: 2)

You can explicitly demand an inventory adjustment on these ID signatures via this interface freely.
```

**Prompt:** 
```
We just sold a 'Grey / Medium' offline to a friend. Adjust its variant inventory quantity ID vxB004 by -1 unit securely.
```

**Response:** 
```
Initializing an update request securely wrapping bounds connecting onto backend. Target Node `adjust_inventory` applied. 

**STATUS: ADJUSTMENT FINALIZED ✅**
Associated Variant: `vxB004`
Adjustment Processed: `-1 Unit Subtract`

The Squarespace backend accepted structural changes. Your active live stock now officially reflects 1 physical good available seamlessly avoiding overselling.
```

## Capabilities

### Manage Stock Levels
The agent reads current inventory levels or updates counts for specific product variants.

### Track and Fulfill Orders
You can list pending orders, pull detailed buyer information, and finalize shipment records by marking an order as fulfilled.

### Audit Product Data
Retrieve the core details of any product or get specific metadata about its variants, like color options or sizes.

## Use Cases

### Processing a Batch of Shipments
The ops manager asks their agent to scan all orders marked as 'Pending.' The agent uses `list_orders` to gather the list, then pulls specific details with `get_order_details` for each one. Finally, it runs `fulfill_order` on a batch of IDs, marking them shipped and updating tracking.

### Investigating Low Stock
A product owner notices sales slowing down on the 'Winter Coat X5' line. They ask their agent to list all products via `list_products`, then drill into the specific item using `get_product_details` to identify which variant IDs need an immediate stock increase via `adjust_inventory`.

### Auditing Customer Spending
The founder wants a quick report on customer loyalty. They ask their agent to pull all customer profiles using `list_customer_profiles`, cross-reference that with recent financial activity via `list_transactions`, and summarize who spent the most money last quarter.

## Benefits

- Stop checking dashboards just for stock counts. You can run `list_inventory` through your agent to instantly see which variants are running low, letting you decide exactly what needs reordering.
- Handle the fulfillment process in chat. By using `get_order_details` and then invoking `fulfill_order`, your agent pulls buyer data and finalizes shipping records without leaving your IDE.
- Need to account for an offline sale? You don't manually edit a spreadsheet; you simply tell the agent which variant ID needs updating, triggering an immediate stock adjustment via `adjust_inventory`.
- Tired of missing transaction details? By calling `list_transactions`, your AI client gives you a clean summary of every dollar that moved through the store’s books.
- Quickly understand product variations. Instead of navigating deep into the backend, asking for product metadata using `get_product_details` surfaces all variant options in plain text.

## How It Works

The bottom line is your AI client acts as an extension of your workflow, letting you manage complex commerce tasks entirely through chat prompts.

1. Enable this MCP connection within your computing environment and provide your Squarespace Developer API Key.
2. Your AI client accesses the commerce backend data via the Vinkius framework, making all tools available through conversation.
3. You give a natural language prompt to your agent, telling it exactly which data points you need or what action needs executing.

## Frequently Asked Questions

**How does the Squarespace Commerce MCP help me with low stock alerts?**
You can run a full inventory report using `list_inventory`. Your agent reads this data and pulls out every variant that falls below your specified threshold, giving you an immediate purchasing list.

**Can I use the Squarespace Commerce MCP to process returns?**
The tool set is designed for outgoing logistics. While it can't initiate a return workflow, you can still track customer history using `list_customer_profiles` and adjust stock counts with `adjust_inventory` after the return is verified.

**What tools do I use in Squarespace Commerce MCP to check an order status?**
You first list all orders using `list_orders`, then pinpoint a specific one and request its full details by invoking `get_order_details`. This gives you everything needed before you decide if it's ready for fulfillment.

**Do I need to know the product ID to use adjust_inventory?**
Yes. You must first find the correct product or variant ID, possibly by running `list_products` and then confirming details with `get_product_details`, before you can run `adjust_inventory`.

**Is list_transactions in the Squarespace Commerce MCP useful for tax reporting?**
Yes. Calling `list_transactions` pulls a comprehensive record of all financial movements, which provides the raw data needed to generate accurate reports for accounting purposes.