# Nuvemshop — how to use (mcp.ai)

Plataforma de e-commerce Nuvemshop (Tiendanube), produtos, pedidos, clientes, categorias e cupons da sua loja via API oficial. A plataforma fornece a aplicação OAuth: você só clica em Autorizar e loga na sua loja Nuvemshop.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_nuvemshop?ms=1781045700000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `nuvemshop_categories`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/nuvemshop`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/nuvemshop/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/nuvemshop/categories` — Lista categorias da loja Nuvemshop (params opcionais: page, per_page, parent).
  - body: { page?: integer, per_page?: integer, parent?: string, account?: string }
- `POST https://api.mcp.ai/api/nuvemshop/coupons` — Lista cupons de desconto da loja Nuvemshop (params opcionais: page, per_page).
  - body: { page?: integer, per_page?: integer, account?: string }
- `POST https://api.mcp.ai/api/nuvemshop/coupons/write/create` — Cria cupom de desconto na Nuvemshop. action: create. data = JSON com code, type (percentage|absolute|shipping), value, etc.
  - body: { data: string, account?: string }
- `POST https://api.mcp.ai/api/nuvemshop/customers/get` — Leitura de clientes da loja Nuvemshop.
  - body: { customer_id?: string, page?: integer, per_page?: integer, q?: string, created_at_min?: string, updated_at_min?: string, account?: string, customer_ids?: string[] }
- `POST https://api.mcp.ai/api/nuvemshop/customers/list` — Leitura de clientes da loja Nuvemshop.
  - body: { customer_id?: string, page?: integer, per_page?: integer, q?: string, created_at_min?: string, updated_at_min?: string, account?: string, customer_ids?: string[] }
- `POST https://api.mcp.ai/api/nuvemshop/list/accounts` — Lista lojas Nuvemshop vinculadas a este install — store_id, label e apelido.
  - body: { account?: string }
- `POST https://api.mcp.ai/api/nuvemshop/orders/get` — Leitura de pedidos da loja Nuvemshop.
  - body: { order_id?: string, page?: integer, per_page?: integer, status?: string, payment_status?: string, shipping_status?: string, created_at_min?: string, updated_at_min?: string, q?: string, account?: string, order_ids?: string[] }
- `POST https://api.mcp.ai/api/nuvemshop/orders/list` — Leitura de pedidos da loja Nuvemshop.
  - body: { order_id?: string, page?: integer, per_page?: integer, status?: string, payment_status?: string, shipping_status?: string, created_at_min?: string, updated_at_min?: string, q?: string, account?: string, order_ids?: string[] }
- `POST https://api.mcp.ai/api/nuvemshop/orders/write/cancel` — Mutações em pedidos Nuvemshop.
  - body: { order_id: string, data?: string, account?: string, order_ids?: string[] }
- `POST https://api.mcp.ai/api/nuvemshop/orders/write/close` — Mutações em pedidos Nuvemshop.
  - body: { order_id: string, data?: string, account?: string, order_ids?: string[] }
- `POST https://api.mcp.ai/api/nuvemshop/orders/write/fulfill` — Mutações em pedidos Nuvemshop.
  - body: { order_id: string, data?: string, account?: string, order_ids?: string[] }
- `POST https://api.mcp.ai/api/nuvemshop/orders/write/open` — Mutações em pedidos Nuvemshop.
  - body: { order_id: string, data?: string, account?: string, order_ids?: string[] }
- `POST https://api.mcp.ai/api/nuvemshop/orders/write/pack` — Mutações em pedidos Nuvemshop.
  - body: { order_id: string, data?: string, account?: string, order_ids?: string[] }
- `POST https://api.mcp.ai/api/nuvemshop/orders/write/update` — Mutações em pedidos Nuvemshop.
  - body: { order_id: string, data?: string, account?: string, order_ids?: string[] }
- `POST https://api.mcp.ai/api/nuvemshop/products/get` — Leitura de produtos da loja Nuvemshop.
  - body: { product_id?: string, page?: integer, per_page?: integer, q?: string, category_id?: string, published?: boolean, created_at_min?: string, updated_at_min?: string, account?: string, product_ids?: string[], category_ids?: string[] }
- `POST https://api.mcp.ai/api/nuvemshop/products/list` — Leitura de produtos da loja Nuvemshop.
  - body: { product_id?: string, page?: integer, per_page?: integer, q?: string, category_id?: string, published?: boolean, created_at_min?: string, updated_at_min?: string, account?: string, product_ids?: string[], category_ids?: string[] }
- `POST https://api.mcp.ai/api/nuvemshop/products/write/create` — Cria ou edita produtos na Nuvemshop.
  - body: { product_id?: string, data: string, account?: string, product_ids?: string[] }
- `POST https://api.mcp.ai/api/nuvemshop/products/write/update` — Cria ou edita produtos na Nuvemshop.
  - body: { product_id?: string, data: string, account?: string, product_ids?: string[] }

## Example prompts
- "Liste os pedidos abertos da minha loja"
- "Quais produtos estão sem estoque?"
- "Crie um cupom de 10% chamado BEMVINDO"

## More
- Page: https://mcp.ai/nuvemshop
- Agent spec (llms.txt): https://mcp.ai/nuvemshop/llms.txt
- Postman collection: https://mcp.ai/nuvemshop/postman.json