Usage examples

Once the MCP Server is connected, you interact with your Snipcart store by asking your AI assistant in natural language. Below are practical examples organized by use case. These work with any MCP-compatible client — Claude, GPT via Codex, Cursor, Windsurf, or others.

Orders

View recent orders

Show me the last 10 orders

List all orders from March 2026

Show me orders with status "Processed"

Get order details

Get the details for order 1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d

Update an order

Mark order abc123 as shipped with tracking number 1Z999AA10123456784

Add a note to order abc123: "Customer requested gift wrapping"

Send notifications

Send a shipping confirmation email for order abc123

Send an invoice email to the customer who placed order abc123

Notification types include: Comment, OrderStatusChanged, OrderShipped, TrackingNumber, and Invoice.

Digital goods

Get the download links for order abc123

Customers

Find a customer

Find the customer with email john@example.com

List customers who signed up in January 2026

View customer history

Show me all orders from customer cust_abc123

What's the order history for john@example.com?

Update customer info

Update customer cust_abc123's email to newemail@example.com

Products

Browse your catalog

List all my products

Show me products sorted by price

Manage stock

Update the stock for product prod_abc123 to 50 units

Allow out-of-stock purchases for product prod_abc123

Set stock by variant for product prod_abc123: Small = 10, Medium = 20, Large = 15

Archive a product

Archive product prod_abc123

This is a soft delete — you can restore it from the Snipcart dashboard.

Discounts

Create a coupon code

Create a 10% discount with code SUMMER10

Create a $5 off coupon with code WELCOME5, limited to 100 uses, expires December 31, 2026

Create a cart-total discount

Create a discount that gives $10 off when the cart total reaches $75

Create free shipping

Create a free shipping coupon with code FREESHIP

Manage discounts

List all active discounts

Update coupon SUMMER10 to expire on July 1, 2026

Delete discount disc_abc123

Note: You cannot delete a discount that has been used in completed orders.

Refunds

View refunds

Show me all refunds for order abc123

Create a refund

Refund $25.00 on order abc123 with comment "Damaged item"

Warning: Refunds are irreversible. The AI will confirm the amount with you before processing.

Abandoned carts

Show me abandoned carts from the last week

List abandoned carts with a minimum value of $50

Get details for abandoned cart cart_abc123

Shipping methods

Create a shipping method

Create a shipping method called "Express Shipping" with a rate of $25 for 0-5kg and $35 for 5-10kg

Manage shipping methods

List all shipping methods

Update shipping method ship_abc123 to only apply to US orders

Delete shipping method ship_abc123

Domains

What's my store's primary domain?

List all allowed checkout domains

Add staging.mystore.com to the allowed domains

Remove old-domain.com from the allowed domains

Tips for effective prompts

• Be specific with identifiers. When referencing an order, customer, or product, include the token or ID if you have it. The AI can search by email or name, but an ID is faster.
• Use date ranges. "Last week's orders" works, but "orders from March 1 to March 15, 2026" is more precise.
• Chain requests. You can ask follow-up questions: "Show me order abc123" followed by "Now refund $10 on it."
• Ask for summaries. "How many orders did we process this month?" or "What's our top-selling product?" — the AI can aggregate data across multiple API calls.

Next up: Use cases — Real-world scenarios like clean sales exports, bulk shipping setup, and abandoned cart analysis.