Integrate Nuvemshop with Claude, Cursor, Chatbots & AI Agents MCP Server

Manage your Nuvemshop e-commerce via API — list products, orders, customers, coupons, and webhooks directly from any AI agent.

GDPR Free for Subscribers

Compatible with every major AI agent and IDE

Claude

ChatGPT

Cursor

Gemini

Windsurf

VS Code

JetBrains

Vercel

+ other MCP clients

create

Create coupon on Nuvemshop

You must provide the coupon code and type (percentage, absolute, or shipping). Optional fields include value, validity dates, minimum purchase amount, and applicable products/categories. Example: { "code": "SUMMER20", "type": "percentage", "value": 20, "min_price": 100, "start_date": "2026-06-01", "end_date": "2026-06-30" } Create a new discount coupon in your Nuvemshop store

create

Create customer on Nuvemshop

You must provide at minimum the customer name and email. Optional fields include phone, addresses, and tags. Example: { "first_name": "João", "last_name": "Silva", "email": "joao@example.com", "phone": "11999999999" } Create a new customer record in your Nuvemshop store

create

Create order on Nuvemshop

Useful for phone orders, in-person sales, or bulk order imports. You must provide customer information and at least one order item with product ID or variant ID and quantity. Example: { "email": "customer@example.com", "items": [{ "product_id": 123, "quantity": 2 }] } Create a new order manually in your Nuvemshop store

create

Create product on Nuvemshop

You must provide at minimum the product name and price. Optional fields include description, SKU, stock quantity, categories, images, and variants. Example: { "name": "T-Shirt Blue", "price": 49.90, "sku": "TSH-BLU-001", "stock": 100, "description": "Comfortable cotton t-shirt" } Create a new product in your Nuvemshop store

create

Create webhook on Nuvemshop

You must provide the URL to receive notifications and the events to subscribe to. Available events include: orders/create, orders/update, products/create, products/update, products/delete, customers/create, customers/update. Example: { "url": "https://your-app.com/webhooks/nuvemshop", "event": "orders/create" } Create a new webhook for real-time event notifications

delete

Delete coupon on Nuvemshop

You must provide the coupon_id. This action cannot be undone. Use this to deactivate expired or discontinued promotions. Be careful as this will prevent customers from using this coupon code. Delete a discount coupon from your Nuvemshop store

delete

Delete product on Nuvemshop

You must provide the product_id. This action cannot be undone. Use this to remove discontinued products, test products, or items that are no longer available. Be careful as this will also remove all associated variants and images for that product. Delete a product from your Nuvemshop store

delete

Delete webhook on Nuvemshop

You must provide the webhook_id. This action cannot be undone. Use this to remove webhook endpoints that are no longer needed or to stop receiving notifications for specific events. Delete a webhook from your Nuvemshop store

get

Get coupon on Nuvemshop

Use the coupon_id obtained from list_coupons to inspect full coupon details. Get detailed information about a specific coupon

get

Get customer on Nuvemshop

Use the customer_id obtained from list_customers to inspect full customer details. This is useful for customer support, order management, or analyzing purchase history. Get detailed information about a specific customer

get

Get order on Nuvemshop

Use the order_id obtained from list_orders to inspect full order details. This is useful for verifying order status, preparing shipments, or reviewing customer purchases. Get detailed information about a specific order

get

Get product on Nuvemshop

Use the product_id obtained from list_products to inspect full product details. This is useful for verifying product data before updating or checking stock levels. Get detailed information about a specific product

get

Get store on Nuvemshop

Use this to verify your store setup and understand available features. Get details about your Nuvemshop store

list

List categories on Nuvemshop

Each category includes name, description, and number of assigned products. Use this to understand your store's product organization and category structure. List all product categories in your Nuvemshop store

list

List coupons on Nuvemshop

Each coupon includes code, type (percentage, absolute, shipping), value, validity dates, usage count, and minimum purchase requirements. Use this to review active promotions and analyze coupon performance. List all discount coupons in your Nuvemshop store

list

List customers on Nuvemshop

Each customer includes name, email, phone number, total orders, total spent, and registration date. You can optionally specify page number and records per page. Use this to browse your customer database, analyze purchase patterns, or find specific customers by name or email. List all customers in your Nuvemshop store

list

List orders on Nuvemshop

Each order includes order number, customer name, total value, status (pending, paid, fulfilled, cancelled), payment status, and creation date. You can optionally filter by status, specify page number, and set records per page. Use this to monitor sales, track order fulfillment, and review revenue. List all orders in your Nuvemshop store

list

List products on Nuvemshop

Each product includes name, description, price, SKU, stock quantity, status (active, draft, archived), and images. You can optionally filter by status, specify page number, and set records per page (max: 200). Use this to browse your product catalog or find a specific product by name or SKU. List all products in your Nuvemshop store

list

List variants on Nuvemshop

Each variant includes SKU, price, stock quantity, and option values. Use the product_id from list_products to see all variants of that product. This is useful for managing inventory of products with multiple options. List all variants for a specific product

list

List webhooks on Nuvemshop

). Each webhook includes URL, events subscribed, and creation date. Use this to verify your integration endpoints are properly configured. List all webhooks configured in your Nuvemshop store

update

Update coupon on Nuvemshop

Common updates include changing discount value, extending validity dates, or modifying minimum purchase requirements. You must provide the coupon_id and the fields to update as JSON. Update an existing discount coupon

update

Update customer on Nuvemshop

Common updates include changing contact information, updating addresses, or adding tags. You must provide the customer_id and the fields to update as JSON. Only provide the fields you want to change. Update an existing customer record

update

Update order on Nuvemshop

Common updates include changing order status (e.g., from pending to paid, or from paid to fulfilled), updating shipping information, or modifying order items. You must provide the order_id and the fields to update as JSON. Update an existing order in your Nuvemshop store

update

Update product on Nuvemshop

You must provide the product_id and the fields to update as JSON. Only the fields provided will be updated. Common updates include: changing price, updating stock quantity, modifying description, or changing product status. The product_id must exist in your store. Update an existing product in your Nuvemshop store

Security & Code Integrity Audit

Every tool in the Nuvemshop MCP Server is continuously audited by the Vinkius Security Engine. We guarantee zero-trust payload isolation, strict data boundaries, and deterministic execution for enterprise-grade AI agents.

A+Score: 100

How Vinkius protects your data

Can I set different limits for each virtual assistant on my team?

Absolutely. You have full control in our command center. You can create an AI agent that only "reads" data so the support team can answer questions, and another superpowered agent that can "edit" and "create" information exclusively for your operations team. Each AI gets exactly the level of access you allow.

What happens if the underlying API rate limits my agent?

Our edge infrastructure automatically handles backoffs, queueing, and throttling. If an AI agent sends too many erratic requests, Vinkius manages the rate limits gracefully, ensuring your backend doesn't crash.

What if the AI ends up reading customer data or confidential information?

We have a built-in digital "bodyguard" called DLP (Data Loss Prevention). If a tool fetches data and the response contains social security numbers, credit cards, or personal customer info, Vinkius magically blocks and erases that information before it is delivered to the AI. The AI works only with what is strictly necessary, and your sensitive data never leaks.

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.

Nuvemshop Capabilities for AI Assistants

Add the Nuvemshop tool to your AI Agents. The toolkit allows Claude and ChatGPT to securely fetch and update targeted data.

Secure online store Access for Agents

Connect Nuvemshop to provide your chatbots with online store capabilities. The integration manages the backend execution for money moves workflows.

Autonomous product catalog Strategies

The Nuvemshop connection gives ChatGPT direct access to product catalog tools. The integration handles the logic required for continuous money moves operations.