# Cart.com (AmeriCommerce) MCP MCP > Cart.com (AmeriCommerce) MCP connects your AI agent directly to your entire e-commerce store backend. Manage everything from product catalogs and inventory updates to listing customers and tracking complex order fulfillment status, all through natural conversation. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** product-catalog, storefront-management, order-processing, inventory-tracking, customer-profiles ## Description Need an AI that actually knows how to run a storefront? This connector gives your agent direct access to the core functions of your AmeriCommerce store. Forget jumping between dashboards or cross-referencing spreadsheets. Your agent handles full e-commerce orchestration—it can list and search product catalogs, retrieve detailed customer profiles, and track incoming orders by status. It's about turning complex backend processes into simple conversation. Whether you need to quickly find out why an order is stuck in 'pending' or update a product description for a seasonal sale, your agent handles the API calls automatically. Because this MCP lives on Vinkius, you connect once and gain immediate access to this powerful commerce toolset alongside thousands of others from the catalog. ## Tools ### list_products Pulls a paginated list of all products currently in the catalog. ### get_product_details Gets all the current data points, price, and status for a specific product ID. ### create_product Creates and adds an entirely new product listing to the store catalog. ### list_orders Lists every order placed through the store, providing high-level status information. ### get_order_details Retrieves full metadata for one single order. ### list_customers Pulls a paginated list of all existing customer accounts. ### get_customer_details Fetches all available information on a specific customer profile. ### create_customer Adds a new customer profile to your database. ### list_categories Lists every defined product category available in your store. ### get_category_details Retrieves specific metadata for a given product category. ## Prompt Examples **Prompt:** ``` List all pending orders in my store. ``` **Response:** ``` I've retrieved your orders. You currently have 5 pending orders waiting for fulfillment. Would you like me to retrieve the order items for the most recent one? ``` **Prompt:** ``` Show the details for product ID '1001'. ``` **Response:** ``` I've retrieved the details for product 1001. It is the 'Premium Coffee Blend'. The current price is $24.99 and you have 150 units in stock. The status is set to active. ``` **Prompt:** ``` Search for a customer with email 'jane.smith@example.com'. ``` **Response:** ``` I've found the profile for Jane Smith (ID: 555). She has placed 3 orders in the past 6 months and is a member of the 'VIP Customers' group. Would you like to see her recent order history? ``` ## Capabilities ### Managing Inventory and Listings List, search, or update products in your main catalog to keep all pricing and details accurate. ### Handling Customer Records Search for specific customers or create new profiles by pulling existing customer metadata. ### Tracking Order Flow Retrieve full order details and list all current store orders, regardless of their fulfillment status. ### Organizing Store Structure List or get metadata for product categories to ensure your entire online store is logically grouped. ## Use Cases ### A customer asks about a specific item they bought months ago. The agent first searches for the user using `list_customers`, then uses `get_customer_details` to confirm their ID. Finally, it can cross-reference that profile against past orders and product data using `get_order_details` to give a complete answer. ### A new vendor supplies 50 SKUs we need to add immediately. Instead of manually inputting every item, the agent iterates through the list, calling `create_product` for each SKU. It can then run `list_products` afterwards to confirm all items are live and active. ### The fulfillment team needs a count of everything that hasn't shipped yet. They tell their agent, 'List all pending orders.' The agent uses `list_orders`, which returns the necessary data to confirm how many items need attention before packing can begin. ### We are restructuring our site and need to verify every product is in the right category. The manager runs `list_categories` first, then loops through all existing products by calling `list_products`. For each one, they can check its specific details using `get_product_details` against the category metadata. ## Benefits - Inventory checks are instant. Instead of manually running reports, you can ask your agent to run `list_products` and identify which items are below threshold, getting an immediate list of SKUs. - Customer service is faster. You don't need a separate CRM lookup; calling `get_customer_details` instantly provides the purchase history and profile data needed for support tickets. - Order auditing becomes simple. Use `list_orders` to get a summary view, then call `get_order_details` on any specific order ID to see exactly which items are missing or stuck in fulfillment. - Catalog maintenance is streamlined. If a vendor sends new goods, you can use the agent to run `create_product` and instantly list it live without touching the backend UI. - Store organization stays clean. You never have to guess where something belongs; running `list_categories` gives you the full map of your online store's structure. ## How It Works The bottom line is that once connected, your AI client can perform multi-step operations across your store without needing manual API sequences. 1. Subscribe to this MCP and enter your required Store Domain and Access Token using the Vinkius interface. 2. Connect your preferred client (like Cursor or Claude) to this MCP, giving it permission to interact with your store data. 3. Tell your agent what you need—for example, 'List all products under the Electronics category'—and it executes the necessary calls and returns structured results. ## Frequently Asked Questions **How do I use `list_products` with Cart.com (AmeriCommerce) MCP?** `list_products` provides a paginated list of all items in the catalog, which is useful for generating reports or checking product counts across the store. **Can I use `get_order_details` to check payment status?** Yes, running `get_order_details` provides full metadata on a single order. This includes details necessary for verifying payment status and tracking fulfillment progress. **`list_customers` is better than finding one customer by email.** If you need to audit or find multiple customers, `list_customers` pulls the entire list of accounts. If you know exactly who you're looking for, use `get_customer_details` directly. **How do I add a new product with `create_product`?** `create_product` takes all the required fields—like name, SKU, and category ID—and adds it live to your catalog. It's the single action you use for adding inventory. **What information does `get_customer_details` return about purchase history?** The tool returns a summarized view of purchase history. You'll get details on how many orders the customer placed and within what timeframe, helping you quickly gauge their engagement level. **If I use `get_order_details` with an invalid Order ID, what happens?** The MCP handles this by returning a specific error status or an empty result set. Your agent should check for these explicit failure indicators before attempting to process the order data. **How do I find out what product categories are available using `list_categories`?** Calling this tool provides a comprehensive list of all active category names. You can then use that metadata when structuring new products or updating existing ones via other tools. **Does `get_product_details` include the current inventory count?** Yes, it includes real-time stock levels for the product ID you specify. This is crucial data that lets your agent quickly flag low-stock items needing immediate attention. **How do I find my AmeriCommerce API Token?** Log in to your AmeriCommerce admin panel, navigate to **Tools** > **Apps & Addons**, and create a new application using the **Single Token Flow**. You will generate a non-expiring Access Token to use here. **Can I manage product categories via the agent?** Yes! Use the `list_categories` tool to see your existing structure and `get_category_details` to retrieve metadata for a specific category. **Can I filter orders by status?** Yes! Use the `list_orders` tool and provide the appropriate `order_status_id` parameter to filter for pending, shipped, or cancelled orders.