Nuvemshop MCP. Control Your Store Data From Conversation.

Q: How do I list all products using the Nuvemshop MCP?

You use listproducts to retrieve a complete catalog listing. This function returns product names, SKUs, prices, and whether they are active or archived.

Q: Can I update an order status with the Nuvemshop MCP?

Yes. You use updateorder by providing the unique order ID and specifying the new status (like changing it from 'pending' to 'paid').

Q: What is the best way to manage product variants using Nuvemshop MCP?

You should first use listvariants with a specific product ID. This allows you to see all color, size, or material options and their individual stock levels.

Q: How do I set up automatic notifications using Nuvemshop MCP?

You must use the createwebhook tool. You provide a target URL and specify which events (like 'orders/create') should trigger an immediate notification.

Q: Can I create a coupon that only works for certain products with Nuvemshop MCP?

Yes, when you use createcoupon, you can include optional fields to specify which product IDs or categories the discount must apply to.

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.

Claude

ChatGPT

Cursor

Gemini

Windsurf

VS Code

JetBrains

Vercel

See Vinkius in Action

Give Claude and any AI agent real-world access

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.

Ask an AI about this

Waiting for input…

AI Agent

What AI agents can do with Nuvemshop: 24 Tools for E-commerce Operations

These tools let your agent perform every core e-commerce action—from listing customer accounts to updating product variants—all through simple, conversational commands.

Make your AI actually useful.

Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.

Start using Nuvemshop MCP

Create Coupon

This tool allows you to build a brand new discount coupon with specific codes, types (percent/absolute), values, and minimum purchase...

Create Customer

Use this to add a completely new customer record using basic details like their name...

Create Order

Generate an order manually, which is useful for processing phone sales or bulk...

Create Product

Add a new product to your catalog by providing its name, price, and initial stock...

Create Webhook

Set up a real-time notification endpoint so external apps know instantly when key...

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...

Get Order

Fetch complete information about a specific order to verify its status or prepare...

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...

List Coupons

See a full report of all active and past discount coupons, including their usage...

List Customers

Browse your entire customer database to find specific users or analyze general...

List Orders

Get a comprehensive list of all orders, allowing you to filter by status (paid...

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...

Update Coupon

Modify an existing coupon's value or validity dates without having to delete and...

Update Customer

Change customer details, like updating a mailing address or adding new contact phone...

Update Order

Modify an existing order's status (e.g., from pending to paid) or change the...

Update Product

Change core product data, such as updating the price or adjusting the stock quantity for a specific item.

Security and governance baked right in.

Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.

Claude AI

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.

Start a conversation

Open a new chat. The Nuvemshop integration is available immediately — no restart needed.

Antigravity

Configure Agent Environment

Open your Antigravity agent's workspace configuration or mcp-servers.json file.

Bind the Endpoint

Add the Vinkius endpoint URL to your agent's MCP connections list:

"mcp_servers": {
  "nuvemshop": {
    "serverUrl": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
  }
}

Provide your secure token in place of [YOUR_TOKEN_HERE] to ensure your agent requests are authenticated.

Execute

Start your Antigravity session. The agent will autonomously discover and utilize the Nuvemshop tools with full Vinkius guardrails applied.

Nuvemshop MCP is compatible with VS Code

VS Code Copilot

⚡

One-Click Install (Recommended)

In your Vinkius Dashboard, simply click the Add to VS Code button for this server. We'll automatically configure your local workspace.

Or configure manually

Open MCP Settings

Open VS Code, press Ctrl/Cmd + Shift + P, and search for GitHub Copilot: MCP Servers.

Add Server Config

Add the Vinkius endpoint configuration to your mcp-servers.json file:

"nuvemshop": {
  "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
}

Ensure you replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.

LangChain

Install Dependencies

Install the LangChain MCP adapters for your environment:

pip install langchain-mcp-adapters

Connect the Server

Use the SSEClient in LangChain to connect to the Vinkius managed endpoint:

from langchain_mcp_adapters.client import SSEClient

# Connect to Vinkius
client = SSEClient(url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
tools = client.get_tools()

CrewAI

Define the Tool

Load the Vinkius MCP tools into your CrewAI agents:

from crewai import Agent
from mcp_crewai import MCPTool

# Connect securely to Vinkius
vinkius_tools = MCPTool(url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")

# Assign to Agent
researcher = Agent(
    role='Data Researcher',
    tools=vinkius_tools.get_all()
)

Execute Task

Run your CrewAI process. The agent will autonomously route tasks to the Vinkius managed server.

Choose How to Get Started

Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.

Build Your Own

Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.

Import from OpenAPI, Swagger, or YAML specs
Create Agent Skills with progressive disclosure
Deploy to edge with MCPFusion framework
Built in DLP, auth, and compliance on each call
Real time usage dashboard and cost metering
Publish to catalog or keep private

Start building

Make Your AI Do More

Start with Nuvemshop, then connect any of our 5,200+ other servers whenever your AI needs more. One click, no limits.

Use this MCP plus 5,200+ others, all in one place
Add new capabilities to your AI anytime you want
Connections are secured and governed automatically
Track usage and costs across all your servers
Works with Claude, ChatGPT, Cursor, and more
New servers added to the catalog weekly

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Nuvemshop. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

VINKIUS CLOUD

Cloud Hosted

Managed infra

V8 Isolated

Sandboxed per request

Zero-Trust Proxy

No stored credentials

DLP Enforced

Policy on each call

GDPR Compliant

EU data residency

Token Compression

~60% cost reduction

Your data is protected. See how we built it.

The Dashboard Rabbit Hole

Today, changing anything in your store—even something simple like updating a product's description or checking if a coupon code still works—requires navigating through multiple tabs and clicking 'Save' repeatedly. You jump from the order list to the customer profile, then maybe back to inventory just to check stock levels. It’s a constant cycle of logging in, drilling down, copying data, and getting frustrated that you can't do it all in one chat.

With this MCP, your agent handles the clicks for you. You just ask: 'What is the current stock count on T-shirt Blue L?' The AI connects to Nuvemshop, runs the check using `get_product` or `list_variants`, and spits out the number. It’s instant access to operational data without ever needing a dashboard login.

Nuvemshop MCP: Full Store Control

The hardest part is keeping all those siloed pieces of information—product variants, order statuses, and customer addresses—synchronized. You spend time reconciling discrepancies between what the database says and what your sales team remembers.

Now, your agent manages it all through conversation. Need to update a product's price *and* notify an external accounting system? Your AI coordinates that flow. It’s not just reading data; it’s executing actions across your entire business stack.

Support 24/7 support@vinkius.com ↗

Security Vinkius Trust Center ↗

SLA Service Level Agreement ↗

Report Listing Send Report ↗

online-store

product-catalog

fulfillment

sku-management

coupons

webhooks

What Nuvemshop MCP does for your AI

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.

Built · Hosted · Managed by Vinkius Nuvemshop - Manage E-commerce Products & Orders

Server ID 019d75e0-8b5e-7061-83b5-df78a3019495

Vinkius Inspector

Compliance Grade A+

Score 100/100

Report View Report ↗

Benefits of connecting Nuvemshop MCP

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.

Nuvemshop MCP use cases

01 01

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.

02 02

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.

03 03

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.

04 04

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.

Nuvemshop MCP tradeoffs

What to watch out for, and the recommended way to handle each one.

Trying to fix stock by guessing IDs

Avoid

A user tries to update inventory but only knows the product name, like 'the blue shirt.' They guess an ID and fail, wasting time.

Instead

First, run list_products or list_variants to get the correct product ID. Then, use that precise ID with update_product to guarantee you hit the right item.

Manually tracking order status changes

Avoid

The fulfillment team has to log into the dashboard repeatedly just to see if an order moved from 'paid' to 'shipped.' This is slow and prone to human error.

Instead

Use list_orders to get a filtered list of orders by status. If you need automation, use create_webhook to ensure your inventory system gets notified instantly when the status changes.

Confusing product deletion with archiving

Avoid

A user deletes a discontinued item using an old method, but forgets that this removes all associated variants and images, causing data loss.

Instead

Understand that delete_product is final. If you just want it hidden, check the listing status first via get_product. Only run delete_product when you are absolutely certain.

When to use Nuvemshop MCP

Use this MCP if your workflow requires constant data interaction with core e-commerce entities: inventory, orders, and customers. If you need to create a new product, update pricing (update_product), or check customer history (get_customer), this is the tool. Don't use it if you only need general market trend analysis or complex financial forecasting; for that, you need external data sources. Also, don't try to write code logic around multiple steps without a clear path: always break down actions into discrete tools like list_products followed by update_product. If your goal is just reporting (e.g., 'Show me the total revenue last month'), list_orders will give you the raw data, but for active changes, this MCP is necessary.

Frequently asked questions about Nuvemshop MCP

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.

Give Claude and any AI agent real-world access

What AI agents can do with Nuvemshop: 24 Tools for E-commerce Operations

Create Coupon

This tool allows you to build a brand new discount coupon with specific codes, types (percent/absolute), values, and minimum purchase...

Create Customer

Use this to add a completely new customer record using basic details like their name...

Create Order

Generate an order manually, which is useful for processing phone sales or bulk...

Create Product

Add a new product to your catalog by providing its name, price, and initial stock...

Create Webhook

Set up a real-time notification endpoint so external apps know instantly when key...

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...

Get Order

Fetch complete information about a specific order to verify its status or prepare...

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...

List Coupons

See a full report of all active and past discount coupons, including their usage...

List Customers

Browse your entire customer database to find specific users or analyze general...

List Orders

Get a comprehensive list of all orders, allowing you to filter by status (paid...

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...

Update Coupon

Modify an existing coupon's value or validity dates without having to delete and...

Update Customer

Change customer details, like updating a mailing address or adding new contact phone...

Update Order

Modify an existing order's status (e.g., from pending to paid) or change the...

Update Product

Change core product data, such as updating the price or adjusting the stock quantity for a specific item.

Security and governance baked right in.

Claude AI

Open Claude Settings

Add Custom Connector

Start a conversation

Claude Code

Open your terminal

Add the MCP Server

Start coding

Cursor

One-Click Install (Recommended)

Open Cursor Settings

Add New Server

Use in Composer

Antigravity

Configure Agent Environment

Bind the Endpoint

Execute

VS Code Copilot

One-Click Install (Recommended)

Open MCP Settings

Add Server Config

Windsurf

One-Click Install (Recommended)

Open Windsurf Settings

Add Server Endpoint

LangChain

Install Dependencies

Connect the Server

CrewAI