# Nuvemshop MCP > Nuvemshop connects your entire e-commerce store directly to any AI agent. Manage product inventory, process customer orders, handle coupon codes, and update store data using natural conversation—no need to log into the Nuvemshop dashboard for anything. ## Overview - **Category:** money-moves - **Price:** Free - **Tags:** online-store, product-catalog, fulfillment, sku-management, coupons, webhooks ## Description Running an online shop means managing a ton of moving parts: stock levels fluctuate, customers change their minds, and promotions expire. This MCP gives you full control over your entire e-commerce operation without ever touching the store's dashboard. You can tell your AI agent to check current inventory or create an order for a phone sale, getting real-time data instantly. Want to update pricing? Just ask. Need to know how many times a coupon was used? Your agent pulls that report immediately. It handles everything from listing all product variants by size and color to setting up webhooks for automated notifications when a new customer signs up. Because it's hosted on Vinkius, you connect once using your preferred AI client, giving your agent immediate access to the full catalog of tools needed to run your business. ## Tools ### create_coupon This tool allows you to build a brand new discount coupon with specific codes, types (percent/absolute), values, and minimum purchase requirements. ### create_customer Use this to add a completely new customer record using basic details like their name and email address. ### create_order Generate an order manually, which is useful for processing phone sales or bulk imports of records. ### create_product Add a new product to your catalog by providing its name, price, and initial stock quantity. ### create_webhook Set up a real-time notification endpoint so external apps know instantly when key events occur (like an order being placed). ### delete_coupon Remove a discount coupon entirely if it's expired or no longer needed for sales. ### delete_product Completely remove a product from the store, which also deletes all associated variants and images. ### delete_webhook Deactivate or remove a specific webhook notification endpoint. ### get_coupon Retrieve detailed information about a single coupon using its unique ID. ### get_customer Get all details for one customer, which is helpful for support or checking purchase history. ### get_order Fetch complete information about a specific order to verify its status or prepare shipment details. ### get_product View full product data using the product ID, useful for checking stock levels before updating anything. ### get_store Check general store details, including your current plan, domain, and overall configuration. ### list_categories View the complete list of product categories to understand how your store is organized. ### list_coupons See a full report of all active and past discount coupons, including their usage count and validity dates. ### list_customers Browse your entire customer database to find specific users or analyze general purchase patterns. ### list_orders Get a comprehensive list of all orders, allowing you to filter by status (paid, pending, etc.) and track revenue. ### list_products List every product in your catalog, letting you filter or browse specifically by name or SKU. ### list_variants Retrieve all available variants (like small blue vs. large red) for a single product ID to manage specific stock counts. ### list_webhooks Review every webhook endpoint configured, ensuring your integrations are correctly set up and running. ### update_coupon Modify an existing coupon's value or validity dates without having to delete and recreate it. ### update_customer Change customer details, like updating a mailing address or adding new contact phone numbers. ### update_order Modify an existing order's status (e.g., from pending to paid) or change the shipping information. ### update_product Change core product data, such as updating the price or adjusting the stock quantity for a specific item. ## Prompt Examples **Prompt:** ``` Show me all pending orders and their total values. ``` **Response:** ``` I found 5 pending orders: 1. **Order #10234** — João Silva — R$ 249.90 — Created: 2026-04-06 2. **Order #10235** — Maria Santos — R$ 89.90 — Created: 2026-04-06 3. **Order #10236** — Carlos Oliveira — R$ 459.00 — Created: 2026-04-07 4. **Order #10237** — Ana Costa — R$ 129.90 — Created: 2026-04-07 5. **Order #10238** — Pedro Lima — R$ 319.90 — Created: 2026-04-07 Total pending revenue: R$ 1,248.60. Would you like to update the status of any order? ``` **Prompt:** ``` Create a new coupon SUMMER20 with 20% discount, minimum purchase of R$ 100, valid until June 30th. ``` **Response:** ``` I've successfully created the coupon: - **Code**: SUMMER20 - **Type**: Percentage discount - **Value**: 20% - **Minimum Purchase**: R$ 100.00 - **Valid Until**: June 30, 2026 - **Uses**: 0 / Unlimited The coupon is now active and ready for customers to use at checkout. ``` **Prompt:** ``` List all products with stock below 10 units so I can reorder. ``` **Response:** ``` I found 8 products with stock below 10 units: 1. **T-Shirt Blue M** — SKU: TSH-BLU-M — Stock: 3 — Price: R$ 49.90 2. **T-Shirt Blue L** — SKU: TSH-BLU-L — Stock: 7 — Price: R$ 49.90 3. **Sneaker White 42** — SKU: SNK-WHT-42 — Stock: 2 — Price: R$ 199.90 4. **Cap Black** — SKU: CAP-BLK-001 — Stock: 5 — Price: R$ 39.90 5. **Backpack Gray** — SKU: BPK-GRY-001 — Stock: 1 — Price: R$ 159.90 6. **Socks Pack** — SKU: SCK-PCK-001 — Stock: 8 — Price: R$ 29.90 7. **Belt Brown** — SKU: BLT-BRN-001 — Stock: 4 — Price: R$ 79.90 8. **Wallet Black** — SKU: WLT-BLK-001 — Stock: 6 — Price: R$ 89.90 Would you like to update stock quantities for any of these products? ``` ## Capabilities ### Manage Product Inventory Create, update, or delete products and manage all associated variants (like different sizes or colors) in bulk. ### Handle Customer & Order Lifecycle View customer records, track specific order statuses, or manually create new orders from simple details like an email address. ### Run Promotions and Discounts Create, update, or delete discount coupons using different calculation types, such as percentage off or fixed dollar amounts. ### Automate Store Integrations Set up real-time webhooks to notify external systems whenever a specific event happens in the store, like an order being placed. ## Use Cases ### Checking stock levels for bulk reordering The ops team needs to know which items are running low. They ask their agent to 'List all products with stock below 10 units.' The agent instantly runs `list_products` and reports back a clear list of SKUs, letting them place one reorder efficiently. ### Handling a large group sale A sales rep takes an order over the phone. Instead of writing it down, they tell their agent to 'Create an order for Jane Doe with two T-shirts.' The agent uses `create_order` and attaches the record directly to the customer's account. ### Running a flash sale promotion Marketing needs a quick discount. They instruct their AI client to 'Create a 15% off coupon valid for the next week.' The agent executes `create_coupon`, giving them the code and confirmation instantly. ### Updating details after a product redesign The development team needs to change the price of an old item. Instead of manually editing the listing, they command their agent to 'Update product 123 to cost $59.99' using `update_product`. ## Benefits - Instantly check product inventory levels or view the full customer database without opening any dashboard. You simply ask your agent to 'list all products with stock below 10' and get a clean, actionable list immediately. - Process sales on the fly. Need to record an order from a phone call? Use `create_order` directly through your AI client, supplying just the customer email and product IDs, bypassing manual checkout steps entirely. - Manage promotions in seconds. Instead of navigating coupon menus, you can tell your agent to 'Create a new 20% discount code valid until June 30th' using `create_coupon` and get confirmation immediately. - Keep data fresh. You can update product prices or change stock counts instantly with `update_product`. This is faster than logging in, finding the item, and hitting save multiple times. - Automate critical workflows by setting up webhooks. Use `list_webhooks` to check your setup, then use `create_webhook` to ensure that every time an order status changes, a third-party system gets notified automatically. ## How It Works The bottom line is that your AI acts as a dedicated store manager who knows every function of the platform. 1. Subscribe to this MCP and provide your Nuvemshop Access Token and Store ID. 2. Connect the service to your preferred AI client (Claude, Cursor, etc.). 3. Directly ask your agent to perform an action, like 'List all products with stock below 10' or 'Create a new customer for John Doe'. ## Frequently Asked Questions **How do I list all products using the Nuvemshop MCP?** You use `list_products` to retrieve a complete catalog listing. This function returns product names, SKUs, prices, and whether they are active or archived. **Can I update an order status with the Nuvemshop MCP?** Yes. You use `update_order` by providing the unique order ID and specifying the new status (like changing it from 'pending' to 'paid'). **What is the best way to manage product variants using Nuvemshop MCP?** You should first use `list_variants` with a specific product ID. This allows you to see all color, size, or material options and their individual stock levels. **How do I set up automatic notifications using Nuvemshop MCP?** You must use the `create_webhook` tool. You provide a target URL and specify which events (like 'orders/create') should trigger an immediate notification. **Can I create a coupon that only works for certain products with Nuvemshop MCP?** Yes, when you use `create_coupon`, you can include optional fields to specify which product IDs or categories the discount must apply to.