# Nuvemshop MCP for AI Agents AI Agent Connect > Nuvemshop MCP. Connect your Nuvemshop store to an AI agent to manage products, orders, customers, and coupons without switching tabs. Use natural language to update stock, track fulfillment, or create discount campaigns directly within your favorite AI client. This tool gives you a hands-free way to handle the repetitive backend tasks of e-commerce, allowing you to focus on growing your brand rather than fighting with a complex dashboard. ## Overview - **Category:** money-moves - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_q3RdAhJKw7vK2I60LhP3igR9p5rmU4yczLIB7OMl/ai-agent-connect - **Tags:** online-store, product-catalog, fulfillment, sku-management, coupons, webhooks ## Description The Nuvemshop MCP lets you treat your store like a conversation. Instead of hunting through different dashboard pages to update a single product's stock or check on a customer's order history, you just ask your agent to do it. It handles the heavy lifting of navigating the store's backend for you. You can add new items with specific SKUs and variants, manage your promotional codes, and keep your database organized. If you're looking for a way to manage your e-commerce operations without the constant context switching, this is how you do it. It's one of the many tools hosted on the Vinkius catalog that turns a complex dashboard into a simple chat interface. Whether you're trying to clear out old inventory or set up a new marketing push, your agent handles the API calls while you stay focused on the big picture. ## Tools ### create_coupon This tool creates a new discount coupon with specific types, values, and dates. It makes it easy to launch flash sales without manually editing every entry. ### create_customer This tool adds a new customer record including their name, email, and contact details. Use it to keep your database clean and updated. ### create_order This tool creates a new order manually for phone or in-person sales. It helps you capture offline revenue quickly. ### create_product This tool adds a new product to your catalog with price, SKU, and stock levels. It's the fastest way to expand your inventory. ### create_webhook This tool sets up a new webhook to receive real-time notifications for store events. Use it to connect your store to other apps. ### delete_coupon This tool removes an old or expired discount coupon from your store. It helps you keep your promotions list tidy. ### delete_product This tool permanently removes a product and all its associated variants from your catalog. Use it for discontinued items. ### delete_webhook This tool removes a webhook endpoint that is no longer needed. This helps you stay organized with your integrations. ### get_customer This tool fetches detailed information for a specific customer record. Use it to quickly find a user's contact info. ### get_order This tool views the full details of a specific order in your store. It helps you verify payment and shipping status. ### get_store This tool fetches your store's configuration details and plan information. It serves as a quick reference for store settings. ### list_coupons This tool sees a list of all active and expired discount coupons. Use it to audit your marketing spend. ### list_customers This tool browses your entire customer database with filters for page and size. It helps you analyze your audience. ### list_orders This tool views all store orders with filters for status and payment. Use it to monitor your daily sales. ### list_products This tool browses your full product catalog with filters for status and SKU. It is your primary inventory view. ### list_variants This tool sees all variants for a specific product, including stock and price. It is essential for managing complex items. ### list_webhooks This tool views all configured webhooks and their subscribed events. Use it to manage your external integrations. ### update_coupon This tool modifies the value, dates, or requirements of an existing coupon. It lets you adjust sales on the fly. ### update_customer This tool changes contact info, addresses, or tags for a customer record. Use it for quick profile updates. ### update_order This tool changes the status or shipping info for an existing order. This keeps your fulfillment pipeline moving. ### update_product This tool modifies prices, descriptions, or stock levels for a specific product. This is your main tool for inventory management. ### get_coupon This tool retrieves full details for a specific discount coupon. It is useful for checking specific discount rules. ### get_product This tool gets the complete data for a specific product in your catalog. Use it to double check SKU details. ### list_categories This tool views all product categories to see how your store is organized. It helps you plan your navigation. ## Prompt Examples **Prompt:** ``` What's the status of order #10234? ``` **Response:** ``` I've pulled up the details for **Order #10234**: | Detail | Information | | :--- | :--- | | **Customer** | João Silva | | **Total** | R$ 249.90 | | **Status** | Pending | | **Payment** | Unpaid | | **Created** | 2026-04-06 | Would you like me to update the status to Paid or Fulfilled? ``` **Prompt:** ``` Create a 15% off coupon for new customers. ``` **Response:** ``` I've successfully created your new promotion: - **Code**: NEW15 - **Type**: Percentage discount - **Value**: 15% - **Validity**: Active until end of year The coupon is now live and ready for your customers to use at checkout. ``` **Prompt:** ``` Show me all products that are currently out of stock. ``` **Response:** ``` I found 4 products currently with 0 stock: - **T-Shirt Blue M** (SKU: TSH-BLU-M) - **Sneaker White 42** (SKU: SNK-WHT-42) - **Cap Black** (SKU: CAP-BLK-001) - **Backpack Gray** (SKU: BPK-GRY-001) Would you like to update the status of any of these to 'Archived'? ``` ## Capabilities ### Update product stock and prices Your agent adjusts inventory levels and pricing across your catalog in seconds. ### Create and manage discount coupons Generate new promotional codes with specific values and dates instantly. ### Track and update order statuses Monitor your sales pipeline and move orders from pending to fulfilled with one command. ### Manage customer records and history Browse your entire customer database and pull up specific purchase histories. ### Organize product categories View and manage how your products are grouped across your store. ### Configure webhooks for real-time alerts Set up automated notifications for store events like new orders or product updates. ## Use Cases ### Low stock alerts You notice a product is running low. Ask your agent to use `list_products` to find items below 10 units and then `update_product` to set them to out of stock. ### Holiday Sale setup You need a 20% off code for the weekend. Ask your agent to use `create_coupon` with the specific dates and minimum spend requirements. ### Bulk Order Entry A customer calls in a large order. Use `create_order` to manually add the items to your store without having to navigate the complex order creation UI. ### Customer Support lookup A customer asks about a past purchase. Use `list_customers` to find them and `get_order` to see exactly what they bought and when it shipped. ## Benefits - Stop manual data entry by using `create_product` and `create_customer` to populate your store instantly. - Manage promotions faster with `create_coupon` and `update_coupon` to handle seasonal sales without dashboard fatigue. - Keep fulfillment on track by using `list_orders` and `update_order` to see what needs shipping and change statuses. - Organize your catalog more effectively by using `list_categories` and `list_variants` to see every SKU in one place. - Automate your notifications by using `create_webhook` to send real-time alerts to your other apps. - Get instant store snapshots with `get_store` to check your plan details and currency settings quickly. ## How It Works The bottom line is you get a hands-free way to manage your e-commerce store via natural language. 1. Subscribe to the Nuvemshop MCP on Vinkius. 2. Provide your Store ID and Nuvemshop Access Token in the configuration. 3. Ask your AI client to perform store actions like listing orders or creating coupons. ## Frequently Asked Questions **Can I use the Nuvemshop MCP to manage my store's inventory?** Yes, you can use it to list products, check stock levels, and update prices. It gives you a way to manage your catalog without leaving your AI client. **How do I create a new discount code with this Connector?** Just tell your agent the code name, the discount type, and any date requirements. It will create the coupon in your store automatically. **Can it help with customer support?** Yes, you can browse your customer database and get specific details for any user. It makes finding contact info or purchase history much faster. **Can I use the Nuvemshop MCP to track my sales?** You can list all orders and filter them by status to see your pending revenue. It's a great way to get a quick pulse on your daily sales. **Does this Connector support webhooks?** Yes, you can create and manage webhooks for real-time notifications. This helps you connect your store to other apps for automated workflows. **Is it hard to set up the Nuvemshop MCP?** It's simple. You just need your Store ID and an Access Token from your store settings. Once connected, your agent can start managing your store immediately. **How do I get a Nuvemshop Access Token and Store ID?** Go to the [**Nuvemshop Developer Portal**](https://dev.nuvemshop.com.br/), create an application, and follow the OAuth 2.0 Authorization Code flow to generate your access token. The token format is `AT-{store_id}-{hash}`. Your Store ID is the numeric part of the token or can be found in your store URL/dashboard settings. Use both the access token and store ID to authenticate API requests. **What are the API rate limits and how can I avoid hitting them?** Nuvemshop uses a Leaky Bucket algorithm with a default limit of 2 requests/second and a burst maximum of 40. Next and Evolution plans have this limit multiplied by 10. Monitor the `x-rate-limit-remaining` header in responses. If you hit the limit, the API returns HTTP 429. To avoid this, implement request queuing and respect the rate limit headers in your integrations. **Can I create orders manually through the API?** Yes! Use the `create_order` tool with customer information and order items. This is perfect for phone orders, in-person sales, bulk order imports, or orders from other sales channels. You need to provide at minimum the customer email and at least one item with product ID and quantity. The order will appear in your Nuvemshop dashboard as a manual order. **How do I manage product variants like size and color?** Use `list_variants` with a product_id to see all variants for a product. Each variant has its own SKU, price, and stock quantity. Variants are created when you set up product options (like size or color) in the product creation or update process. The API handles variants as part of the product object, and you can manage inventory for each variant individually.