How do I connect my Nuvemshop store?

You need to provide your Nuvemshop Store ID and an Access Token during the setup process in Vinkius. Once entered, the MCP is ready to use in your AI client.

Which AI clients can I use with this MCP?

You can use any MCP-compatible client, including Claude, Cursor, and Windsurf.

Can I delete products using this MCP?

Yes, you can use the delete_product capability to remove items, but be aware that this also removes all associated variants and images.

Is it possible to create manual orders?

Yes, the create_order capability allows you to manually enter orders for phone or in-person sales.

Can I manage my store's discount coupons?

Yes, you can create, list, update, and delete discount coupons through your AI agent.

How do I get a Nuvemshop Access Token and Store ID?

Go to the Nuvemshop Developer Portal, 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 capability 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.

An astronaut overseeing a futuristic data hub

Download PDF Markdown Version

Connect Nuvemshop to ChatGPT, Claude and Gemini

Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Run your entire online store through a simple chat interface.

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

Your AI does the work. We keep it safe and sound.

No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.

Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

V8 Isolate01

Each Connector runs inside its own sealed environment.

Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.

Kill Switch02

One switch stops every agent. Instantly.

One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.

FinOps per User03

Spending limits that pause instead of surprise.

Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.

Three controls, built into the layer your AI connects through.

Curated set · 24 capabilities