# Ecwid MCP

> Ecwid connects your online store operations to any AI agent. Search products, update inventory levels, audit customer orders, or pull detailed reports on discount codes without ever opening the control panel.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** online-store, catalog-management, shopping-cart, inventory-control, product-data, sales-tracking

## Description

Manage everything in your e-commerce catalog through natural conversation. This MCP lets you treat your entire store—from product listings to sales history—like a database you can just talk to. Need to know if a specific item is out of stock? Just ask. Want to check the payment status on an order from last Tuesday? You can do that too. It provides full control over catalog details, inventory counts, and customer records.

When working with e-commerce data, you need reliable tools; Vinkius makes this connection possible by hosting this MCP alongside thousands of others. This means your AI agent gets access to everything your store needs, all in one place. You can pull the store's general settings or check which discount codes are currently active. It’s about getting fast, accurate data and making changes—like resetting physical stock levels—without clicking through a dozen pages.

## Tools

### search_products
Searches the catalog to return product IDs, names, prices, SKUs, inventory counts, and images for items matching criteria.

### get_product
Retrieves comprehensive data for a single item ID, including pricing details, variations, attributes, choices, and SEO information.

### search_orders
Lists recent or specific orders to show numbers, totals, fulfillment status, payment status, and buyer context.

### get_order
Fetches the full record for one order using its unique ID or order number.

### search_customers
Allows you to query and find records for specific customers in your system.

### list_categories
Retrieves the complete list of product categories currently set up in the store structure.

### get_profile
Pulls static configuration data for the entire store, like timezone settings and format details.

### list_coupons
Returns a list of all active discount codes or coupons available in the shop.

### update_inventory
Changes the physical stock quantity for any specific product ID you point it to.

### get_app_storage
Retrieves custom data stored in the application's internal storage using a specified key, useful for tracking custom state.

## Prompt Examples

**Prompt:** 
```
Search for products containing 't-shirt' in my store
```

**Response:** 
```
Searching products... I found 5 items: 'Classic White T-shirt' ($20.00), 'V-Neck Blue T-shirt' ($22.00), etc. Each has inventory and SKU data available. Would you like to check the stock levels for any of these?
```

**Prompt:** 
```
Set inventory for product 12345 to 50 units
```

**Response:** 
```
Inventory updated! Product ID 12345 ('Cotton Polo') is now set to 50 units. The change is live in your store and synced across all channels.
```

**Prompt:** 
```
Show me the last 3 orders from yesterday
```

**Response:** 
```
Retrieving recent orders... I found 3 orders from yesterday: #1001 ($45.00, Paid), #1002 ($120.00, Awaiting Payment), and #1003 ($35.50, Shipped). Would you like to see the customer details for order #1001?
```

## Capabilities

### Search for products
You can quickly pull product IDs, names, prices, SKUs, inventory counts, and images based on keywords or criteria.

### Get full product details
This allows you to fetch complete information about a single item, including all variations, attributes, choices, and SEO data.

### Search and audit orders
You can list past or pending orders and pull key details like total cost, fulfillment status, and payment records.

### Manage customer data
Retrieve detailed information on specific buyers, including their historical order lists and context.

### Control inventory levels
You can update the current stock count for any product ID directly through your AI agent.

## Use Cases

### Quickly adjusting inventory after a physical count
A warehouse worker finds that 50 units of 'Blue Widget' are missing from the system. They tell their agent to run `update_inventory` for the widget ID and set the stock level to the correct number, completing the task in three seconds.

### Investigating a payment discrepancy on an old order
A customer calls questioning the final charge. Instead of manually searching by date and name, the agent uses `search_orders` to pull up the correct order number, allowing the support rep to instantly check the payment status.

### Developing product data for a new website section
A developer needs to know all possible attributes and variations for a specific item. They use `get_product` with the ID to pull every single technical detail needed to build out the schema.

### Verifying store settings before launch
Before going live, an owner wants to ensure the correct timezone is set globally. They prompt their agent to use `get_profile`, confirming the precise store format and configuration are exactly right.

## Benefits

- You can immediately update stock levels. Instead of going into the inventory dashboard to manually change counts, just tell your agent to use `update_inventory` for a product ID and set the new number.
- Order auditing is faster than ever. You don't need to drill down through multiple tabs; simply asking your agent to perform a search using `search_orders` gives you payment status, fulfillment details, and buyer info all at once.
- Get deep product data instantly. If you need to verify pricing, variations, or SEO for one item, calling `get_product` delivers the full technical spec without leaving your chat interface.
- Streamline customer service. When a client asks about their order, asking the agent to use `get_order` pulls up all necessary history and details so you can respond immediately.
- Audit store setup easily. You never have to guess what settings are live again; using `get_profile` retrieves precise global configurations like timezones or format standards.

## How It Works

The bottom line is you control your e-commerce data and operations using only natural language prompts from any compatible AI client.

1. Subscribe to this MCP and provide your Ecwid Store ID along with an Automation Token.
2. Your AI client connects, giving it permission to read and write data on behalf of your store.
3. You ask your agent a question—like 'What's the stock for product XYZ?' or 'Update inventory for ABC to 10.'—and it executes the action.

## Frequently Asked Questions

**How do I check product stock using the Ecwid MCP?**
Use `search_products` to find item IDs and their current inventory counts. If you need to change the stock level, use the `update_inventory` tool.

**Can I get details about a specific order number with Ecwid MCP?**
Yes, running `get_order` with the ID or number retrieves all the necessary data, including payment status and fulfillment records. This is much faster than manual lookup.

**Is ecwid-mcp useful for customer service inquiries?**
Absolutely. You can use `search_customers` and then `get_order` to pull up a complete history of past purchases, helping you resolve issues faster than ever before.

**What if I need to know about discounts or coupons?**
Use the `list_coupons` tool. It will list all active discount codes and show their current rules without needing access to any internal marketing panels.