# Squarespace MCP

> Squarespace MCP connects your AI client directly to your e-commerce store's backend data. It lets you read all your orders, track inventory levels, audit customer profiles, and analyze financial transactions without logging into the platform. You get a single conversational source for every piece of shop data.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** website-management, transaction-auditing, inventory-audit, customer-data, read-only-access, cms-integration

## Description

Instead of navigating through multiple dashboards or exporting CSV files just to find out if a specific client paid their balance, you talk to your AI agent. This MCP gives your agent read-only access to everything happening in your Squarespace store—from the moment an order is placed until it ships. Your AI can pull together full customer records by running `list_member_profiles` and then cross-reference those users against recent financial movements using `list_transactions`. You stop hunting for data across different tabs and start asking questions. Vinkius brings all this structured e-commerce intelligence into one context, letting your agent perform complex audits or simply answer, 'Did John Doe pay his balance last week?' instantly.

## Tools

### get_order_details
Fetches all the specifics for one individual order, including line items and shipping info.

### list_inventory
Returns a list of every product and its current stock count in the store.

### list_orders
Pulls a comprehensive listing of all commerce orders that have been placed on the site.

### list_products
Retrieves details for every product available in the store's catalog.

### list_member_profiles
Generates a list of all customer or member accounts, including contact and demographic data.

### list_transactions
Provides a chronological record of every financial movement, like payments and refunds.

## Prompt Examples

**Prompt:** 
```
Pull down my customer profiles list. I want to see if any users are from Canada natively mapped resolving via MCP tools.
```

**Response:** 
```
Pulling data utilizing direct pipeline `list_member_profiles`. Scanned 14 overall valid active objects retrieved and loaded internally. 

**Filtered Result**: I have detected 2 profiles with a shipping/contact locale mapped to Canada ('CA'):
- **Alice Vancouver (alice.v@mail.com)** | ID: P#98s0s1
- **Jean L. (jean.l@domain.ca)** | ID: P#001aX1

I can expand their full line item purchase history tracking backwards if needed.
```

**Prompt:** 
```
Use the transaction readout scanner to count how many completely refunded logs appear in the last batch.
```

**Response:** 
```
Cycling payload natively engaging `list_transactions` auditing backend ledgers internally...

Found **42** recent transactions stored loosely across internal responses. After analyzing inner data vectors, **3 transactions** possess fully executed refund events explicitly attached holding values returned to the buyer payload:

1. **Tx_abc123** ($40.00 | Jan 02)
2. **Tx_zzz009** ($15.00 | Jan 04)
3. **Tx_plx444** ($120.50 | Jan 10)

All remaining logs read normal processed settled positive values.
```

## Capabilities

### Audit Customer Data
Retrieve and map full customer records by listing profiles for contact details and purchase history.

### Track Shipment Statuses
List all commerce orders, then pull specific line items to check the status of unfulfilled or processed shipments.

### Assess Stock Levels
Get a real-time count and list of available stock for every product in your catalog.

### Review Sales History
Pull comprehensive lists of all financial transactions to track revenue, refunds, and payments.

### Examine Product Catalogues
View a complete list of every product available in the store, including general details and current stock counts.

## Use Cases

### Investigating Customer Payment Issues
A customer reports they were charged twice. Instead of manually cross-referencing payment sheets, the agent runs `list_transactions` and immediately identifies both charges on the correct account.

### Pre-Sale Inventory Check
You need to know if you can fulfill a large bulk order. You prompt your agent to check `list_products` first, then verify available stock with `list_inventory`, confirming if you have enough units before committing.

### Marketing Segmentation
You want to run a targeted campaign based on geography. The agent uses `list_member_profiles` to pull all customer data and filter it down to only users located in California.

### Post-Shipment Reconciliation
A client claims an order was never processed correctly. You use the agent to run `list_orders` first, then drill down with `get_order_details`, finding exactly which line items were stuck in the payment queue.

## Benefits

- Stop jumping between tabs. Instead of opening the admin dashboard to see if a customer paid their balance, just ask your agent about it; it runs `list_transactions` and gives you a clean answer.
- Never manually compile stock reports again. Running `list_inventory` provides an instant, comprehensive view of your entire product catalog's supply levels.
- Get full visibility into customer behavior by using `list_member_profiles`. You can analyze demographics or find specific contact points for marketing follow-ups.
- Simplify shipment tracking. Instead of finding a single order in the queue, you ask your agent to inspect unfulfilled shipments by running `get_order_details` on multiple items at once.
- Streamline financial audits. By calling `list_transactions`, you get a clean, organized ledger view that lets you track refunds and payments much faster than exporting raw data.

## How It Works

The bottom line is you give your agent permission to read everything, and it uses that access to pull specific data points into one unified response for you.

1. Start by activating this read-only MCP module connection within your preferred AI client.
2. Securely provide your developer API key to the host. This establishes the pipeline between the AI and your Squarespace store data.
3. Send a natural language request—for instance, asking the agent to 'list all products with low stock'—and receive an immediate, compiled answer.

## Frequently Asked Questions

**Can I use Squarespace MCP to see all my customer addresses?**
Yes, you can list member profiles using `list_member_profiles`. This tool gathers the contact and demographic data for all your registered users.

**How do I check if an order was refunded using Squarespace MCP?**
Run `list_transactions` to audit payment history. The agent will filter down the transaction ledger specifically for refund events attached to your orders.

**What is the best way to list all available products in Squarespace?**
Use the `list_products` tool. This gives you a clean, comprehensive listing of every unique product ID and its basic details in your store catalog.

**Does Squarespace MCP let me see low stock items? **
Yes. The agent can combine the `list_products` data with `list_inventory` to filter and report only on products that are near or below your set minimum stock level.

**Can I pull up a single order's details using Squarespace MCP?**
Yes, you call the `get_order_details` tool. This pulls every detail related to one specific transaction, including line items and payment method used.