Nuvemshop MCP. Manage inventory, orders, and customers from your AI client.

Nuvemshop MCP Server - Manage Products & Orders via AI

You'll manage your entire e-commerce backend using just your AI client. You don't need to open a browser or click through the Nuvemshop dashboard for anything—it lets you treat your online store like a database query, giving deep control over everything from inventory levels to customer history.

Inventory Management:

You can build out your entire product catalog by using create_product to add new items with names, prices, and initial stock counts. You'll never lose track of what you're selling because list_products provides a clean rundown of every item, showing its name, SKU, price, and current stock count. For deep dives, get_product pulls all the details for any single product.

When you need to adjust something—like changing the price or description—you use update_product with its unique ID. If a product is dead, you can permanently delete it using delete_product. You also manage product variations; running list_variants shows every specific version (like size M or blue color) for one item, and you'll update stock levels or prices on those variants too.

To understand your whole catalog structure, run list_categories to get a list of all top-level product categories. If you ever need to check out all the current endpoints, list_webhooks shows every webhook configured and which specific events they're listening for.

Order & Sales Control:

You can monitor your sales flow by running list_orders, which gives you a list of recent purchases showing the order number, status (like 'pending'), and total value. To check the full details on one sale, use get_order. If you're processing a sale over the phone or in person, you can manually generate an order record using create_order, providing customer info and all the product items.

Need to change something after the fact? You'll update an existing order—changing its status from 'pending' to 'fulfilled' or modifying shipping details—using update_order.

Customer Record Keeping:

You don't have to rely on memory for customer data. You can add brand new records using create_customer, providing basic info like their name, email, and phone number. To pull a complete history or check an address, run get_customer to fetch all detailed information about one person. Want to see who's bought stuff? list_customers gets you a paginated list of names, emails, total orders, and when they signed up.

If someone moves or updates their billing details, you use update_customer with their ID.

Marketing & Promotions:

You can run quick sales campaigns using coupons. To start one, you call create_coupon, specifying the code, type (percentage, absolute, shipping), and value. If a promo expires early, you delete it with delete_coupon. You'll always know what discounts are active by calling list_coupons, which shows every coupon, whether it's expired or running, along with its usage count.

Need to change the discount amount or extend the dates? Use update_coupon on an existing code.

System Setup & Hooks:
You can set up real-time alerts for your external systems by creating a webhook endpoint using create_webhook, directing it to fire when specific events—like product changes or new orders—happen. When you're done with an alert, you deactivate it with delete_webhook. For high-level setup details about the whole store, pull configuration data using get_store.