# Ecwid MCP MCP > Ecwid MCP lets your agent manage everything about your online store directly through conversation. You can search product details, update inventory counts, look up customer orders, and validate coupon rules—all without opening the Ecwid dashboard. This connection gives AI direct control over catalog data, real-time stock levels, sales records, and customer profiles. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** online-store, catalog-management, shopping-cart, inventory-control, product-data, sales-tracking ## Description You use this connector to give your agent complete hands-on access to your entire e-commerce backend. Whether you need a list of all current product categories or just want to check if a specific customer placed an order last week, the connection handles it. You can automatically change stock levels across multiple products, pull detailed financial logs from completed orders, and even find out what coupons are active right now by bypassing the manual controls. Managing a store involves many moving parts—stock counts, sales statuses, pricing rules. This MCP lets you run complex queries that track down specific data points, like finding a product based on its ID or checking which customer placed an order using their email address. Because your keys pass through Vinkius's zero-trust proxy, your credentials are only used in transit and never stored, keeping the store secure while letting your agent do serious work. ## Tools ### get_app_storage Retrieves saved application configuration values from Ecwid using a specific key. ### get_order Fetches the full details for a single order using its ID or number. ### get_product Gets all detailed information—pricing, choices, and attributes—for one specific product ID. ### get_profile Retrieves the general configuration settings for your entire Ecwid store profile. ### list_categories Returns a list of all existing product categories in the store. ### list_coupons Lists and checks details for all active discount coupons on the store. ### search_customers Searches your customer database using criteria like name or email address. ### search_orders Finds multiple order numbers and summaries, showing totals, payment status, and buyer details. ### search_products Searches the catalog for products by name or keyword, returning IDs, prices, and stock counts. ### update_inventory Changes the available stock quantity for a specific product ID. ## 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 ### Product Lookup Fetch full details on any product, including pricing, variations, attributes, and SEO data. ### Inventory Control Update the physical stock count for specific products directly from natural language commands. ### Order History Review Search and retrieve detailed information about past orders, including payment status and fulfillment logs. ### Customer Data Search Find specific customer profiles by name or other identifying details to check their purchase history. ### Coupon Validation Check the rules and status of any discount coupon without needing an actual order number. ## Use Cases ### End-of-Day Inventory Audit The inventory manager asks the agent to 'Check if any product category has less than 10 units of stock.' The agent runs `list_categories` and then checks related products, providing a prioritized list of items needing an emergency restock. ### Investigating Failed Payments Customer support gets a complaint about order #987. They ask the agent to use `get_order`. The agent pulls up the details, noting the payment failed due to an expired card, allowing support to give the customer immediate instructions. ### Batch Product Updates The marketing team wants to increase the stock count for all winter jackets. They ask the agent to 'Find product IDs containing 'jacket' and set their inventory to 150.' The agent runs `search_products` followed by multiple calls to `update_inventory`. ### Coupon Troubleshooting A customer claims a coupon code isn't working. Instead of asking the customer for their order, they ask the agent to run `list_coupons`, and the agent reports that the specific discount has expired or is restricted only to certain categories. ## Benefits - Instead of logging into the Ecwid dashboard to check stock, you can simply ask your agent to run `search_products` for 't-shirt' and get live inventory numbers instantly. You’ll know exactly what needs restocking. - Resolving customer issues is faster because you can ask the agent to perform a search on orders or customers without needing their account credentials; just give them the name, and they find the order. - You don't have to manually check coupon rules. Running `list_coupons` allows your agent to validate if a discount code works for a specific product before the customer even checks out. - Need to fix a stock count? The ability to use `update_inventory` means you can correct physical counts immediately, without having to navigate through multiple settings menus. - The power of this MCP is chaining: your agent can find products using `search_products`, then check their pricing with `get_product`, and finally update the stock using `update_inventory`, all in one conversation. ## How It Works The bottom line is that you treat your entire e-commerce backend as a single conversational resource. 1. Subscribe to this MCP, then enter your Ecwid Store ID and the Secret Automation Token. 2. Connect it to your preferred client (Claude, Cursor, etc.). 3. Instruct your agent to perform an action, like 'Check stock for product X' or 'Find orders from last month'. ## Frequently Asked Questions **How do I update inventory with `update_inventory`?** You must first identify the correct product ID. The agent needs this specific ID to know which item's stock count to change, so always verify the ID before running the command. **Can I use `search_orders` for tax reporting?** Yes, you can search orders and pull detailed financial logs. The agent provides payment constraints and fulfillment statuses, which are useful starting points for tax review, but always verify with your accounting software. **What is the difference between `get_product` and `search_products`?** `search_products` finds multiple product IDs based on a keyword or name. `get_product` requires you to already have a specific ID, then returns all the deep details for that one item. **How do I check available coupons using `list_coupons`?** Running `list_coupons` shows all active discount codes and their rules. If you need to test if a coupon works on a specific product, the agent can validate that rule for you. **If I need to read custom settings, how do I use `get_app_storage`?** It retrieves specific values stored in your Ecwid application backend. This is useful when you've configured a custom payload or state variable that isn't covered by standard product or order tools. **What should I do if I only know the customer's email, and want to find them using `search_customers`?** You can search for customers using criteria like name, email, or other identifiers. This tool returns a list of profiles, giving you enough context to verify account details before processing an order. **How do I check the global settings and timezone configuration with `get_profile`?** This tool fetches the static configuration for your entire store. You get access to core global data, such as time zone settings or general format details, which is essential for accurate logging. **If I have an order number but not a search criteria, what does `get_order` provide?** It pulls the full record for one specific order ID. You get all payment constraints, fulfillment status details, and buyer financial logs tied to that exact transaction.