# Commerce.js MCP for AI Agents AI Agent Connect > Commerce.js MCP lets you manage your e-commerce store directly through your AI agent. Instead of navigating complex menus, you can list products, manage customer carts, and handle orders via natural conversation. It connects your storefront data to your daily workflow, making it easy to check inventory or pull up order details instantly without leaving your workspace. ## Overview - **Category:** ecommerce - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_ZgukHGQpP1qYi7hLmBlRzSHHjXtqzQC7UH0oJCwK/ai-agent-connect - **Tags:** storefront, shopping-cart, product-catalog, checkout, chec-api ## Description Imagine you're running a busy online store. Usually, when a customer asks about a specific order status or you need to check if a product is still in stock, you have to jump into your dashboard, filter through rows of data, and hunt for the right ID. It's a lot of clicking and constant tab-switching. This Connector changes that by putting your store data into a single chat window. You can have your AI agent pull up the latest orders, create new carts for customers, or check the details of a specific item in your catalog. It turns your AI into a storefront assistant that actually knows your inventory. Because Vinkius hosts this Connector, you can connect it to your favorite AI client in seconds and start talking to your store data instead of digging through a complex UI. It's about getting answers faster and moving products without the manual overhead of constant dashboard navigation. Whether you are trying to verify a shipping address or check the price of a new item, your agent handles the heavy lifting. You get to spend less time digging through backend menus and more time actually running your business. It makes the entire process of managing a storefront feel like a conversation rather than a data entry project. ## Tools ### get_order Pull up a specific order's details using its unique ID. This helps you see exactly what a customer bought and where it stands. ### generate_checkout_token Create a secure token for the checkout process. This prepares the transaction for a smooth, safe payment experience. ### get_product Fetch the full data for a single product. Use this to check descriptions, prices, and specific metadata. ### list_categories See all the categories in your store. This is great for understanding how your products are organized for shoppers. ### list_orders Get a list of recent orders from your store. Use this to keep an eye on daily sales and pending shipments. ### list_products Browse your entire product catalog. You can filter these by category to find specific items quickly. ### update_cart_item Change the quantity or details of an item in a cart. This helps you adjust customer selections before they pay. ### create_cart Make a new shopping cart or find an existing one. This is the first step for any customer starting a purchase. ### add_to_cart Put a specific product into a shopping cart. Use this to build out a customer's order programmatically. ### capture_order Finalize an order and capture the payment. This moves the transaction from pending to completed for your team. ## Prompt Examples **Prompt:** ``` What was the last order placed? ``` **Response:** ``` Here are the details for the most recent orders: | Order ID | Customer | Total | Status | | :--- | :--- | :--- | :--- | | #ORD-9928 | Jane Doe | $120.00 | **Paid** | | #ORD-9927 | Mike Smith | $45.50 | **Pending** | | #ORD-9926 | Sarah Lee | $89.00 | **Shipped** | Would you like me to pull up more details for any of these? ``` **Prompt:** ``` Can you add 3 units of the 'Coffee Mug' to a new cart? ``` **Response:** ``` I've created a new shopping cart for you (ID: `cart_8821`). **Cart Summary:** - **Item:** Organic Coffee Mug - **Quantity:** 3 - **Subtotal:** $45.00 I can also generate a checkout token for this cart if you're ready to proceed. ``` **Prompt:** ``` Show me all products in the 'Home Decor' category. ``` **Response:** ``` I found 4 items in your **Home Decor** category: * **Velvet Throw Pillow** - $25.00 * **Ceramic Vase** - $30.00 * **Scented Candle Set** - $15.00 * **Wall Hanging** - $40.00 Would you like to see the full metadata for any of these? ``` ## Capabilities ### Pull up specific order details Retrieve exact data for a single order to check its status and contents. ### List and filter your entire product catalog Browse your full inventory and filter items by category to find what you need. ### Create and manage customer shopping carts Generate new carts and modify items within them to prepare for a purchase. ### Generate checkout tokens for secure transactions Create secure tokens to move customers smoothly from their cart to the payment page. ### Browse your store categories and hierarchy See how your products are organized to understand your storefront's structure. ### Capture completed orders for fulfillment Finalize a transaction and capture the order details for your fulfillment team. ## Use Cases ### Handling frustrated customers A customer calls about a late package and is frustrated. Instead of hunting through a database, the agent uses `get_order` to see the exact status and `list_orders` to confirm the date it was shipped, providing an immediate answer. ### Verifying inventory layout A store manager wants to check if "Blue Shirts" are correctly listed in the "Apparel" category. The agent uses `list_products` filtered by category to verify the inventory layout and ensure everything is organized properly. ### Simulating purchase flows A developer needs to test a new "One-Click Buy" button for the storefront. They ask the agent to `create_cart`, `add_to_cart`, and `generate_checkout_token` to simulate a full purchase flow without manual data entry. ### Identifying top sellers A sales lead wants to see which items have been moving the fastest this week. They ask the agent to list the most recent orders using `list_orders`, allowing them to quickly identify top sellers and adjust marketing plans. ## Benefits - Stop switching tabs by letting your agent pull order data using `list_orders`. You can instantly see every detail of a customer's purchase, including shipping status and items, without ever logging into your store dashboard. - Update inventory and check prices instantly with `get_product` without logging into the dashboard. This lets you verify if an item is in stock or check its current price in a matter of seconds during a conversation. - Speed up customer support by using `get_order` to find shipping details in seconds. When a customer calls with a question, your agent can pull up their specific order history to provide immediate and accurate assistance. - Automate cart creation for customers using `create_cart` and `add_to_cart`. You can have your agent build out a complete shopping cart for a user based on a conversation, making it much easier for them to move toward a purchase. - Handle the final checkout steps faster by generating tokens with `generate_checkout_token`. This prepares the transaction for a smooth, safe payment experience, ensuring that the transition from cart to purchase is as fast as possible. - Organize your store better by quickly browsing your hierarchy with `list_categories`. You can ask your agent to show you how your products are grouped, which helps you maintain a clean and logical storefront for your shoppers. ## How It Works The bottom line is you get a voice-activated command center for your e-commerce store. 1. Subscribe to this Connector on Vinkius. 2. Plug in your Chec Public and Secret keys. 3. Start asking your AI client to manage products or orders. ## Frequently Asked Questions **Can Commerce.js MCP manage my products?** Yes, it allows your AI agent to list your products and filter them by category so you can find exactly what you're looking for. **How do I use Commerce.js MCP for order lookups?** You can ask your agent to find specific orders using an ID or ask it to list the most recent orders to see your latest sales. **Can I create shopping carts with the Commerce.js MCP?** Yes, your agent can create new shopping carts and add specific products to them, making it easy to build orders through conversation. **Does Commerce.js MCP work with my existing Chec account?** It connects directly to your Commerce.js (Chec) account using your public and secret keys to give your agent full access. **Can I use Commerce.js MCP to handle checkouts?** Yes, it can generate checkout tokens and capture orders, which helps move your customers from the cart to a completed purchase. **Is Commerce.js MCP good for customer support?** It's excellent for support teams because it allows for instant order status lookups during a live call without leaving your chat window. **Can I filter products by a specific category?** Yes! You can use the `list_products` tool and provide a `category_id` to retrieve only the products belonging to that specific group. **How do I view the details of a customer's order?** Use the `get_order` tool with the specific Order ID. Note that viewing orders requires your Secret Key to be configured in the server settings. **Can the AI help me manage shopping carts for customers?** Absolutely. The agent can use `create_cart`, `add_to_cart`, and `update_cart_item` to build and modify shopping sessions dynamically.