# Nuvemshop — MCP server on 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.

By: mcp.ai · official
Page: https://mcp.ai/nuvemshop

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_nuvemshop?ms=1781045820000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/nuvemshop/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/nuvemshop/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/nuvemshop/skill.md
Postman collection (v2.1): https://mcp.ai/nuvemshop/postman.json

## Tools
- nuvemshop_categories(page?: integer, per_page?: integer, parent?: string, account?: string) — Lista categorias da loja Nuvemshop (params opcionais: page, per_page, parent).
- nuvemshop_coupons(page?: integer, per_page?: integer, account?: string) — Lista cupons de desconto da loja Nuvemshop (params opcionais: page, per_page).
- nuvemshop_coupons_write_create(data: string, account?: string) — Cria cupom de desconto na Nuvemshop. action: create. data = JSON com code, type (percentage|absolute|shipping), value, etc.
- nuvemshop_customers_get(customer_id?: string, page?: integer, per_page?: integer, q?: string, created_at_min?: string, updated_at_min?: string, account?: string, customer_ids?: string[]) — Leitura de clientes da loja Nuvemshop.
- nuvemshop_customers_list(customer_id?: string, page?: integer, per_page?: integer, q?: string, created_at_min?: string, updated_at_min?: string, account?: string, customer_ids?: string[]) — Leitura de clientes da loja Nuvemshop.
- nuvemshop_list_accounts(account?: string) — Lista lojas Nuvemshop vinculadas a este install — store_id, label e apelido.
- nuvemshop_orders_get(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[]) — Leitura de pedidos da loja Nuvemshop.
- nuvemshop_orders_list(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[]) — Leitura de pedidos da loja Nuvemshop.
- nuvemshop_orders_write_cancel(order_id: string, data?: string, account?: string, order_ids?: string[]) — Mutações em pedidos Nuvemshop.
- nuvemshop_orders_write_close(order_id: string, data?: string, account?: string, order_ids?: string[]) — Mutações em pedidos Nuvemshop.
- nuvemshop_orders_write_fulfill(order_id: string, data?: string, account?: string, order_ids?: string[]) — Mutações em pedidos Nuvemshop.
- nuvemshop_orders_write_open(order_id: string, data?: string, account?: string, order_ids?: string[]) — Mutações em pedidos Nuvemshop.
- nuvemshop_orders_write_pack(order_id: string, data?: string, account?: string, order_ids?: string[]) — Mutações em pedidos Nuvemshop.
- nuvemshop_orders_write_update(order_id: string, data?: string, account?: string, order_ids?: string[]) — Mutações em pedidos Nuvemshop.
- nuvemshop_products_get(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[]) — Leitura de produtos da loja Nuvemshop.
- nuvemshop_products_list(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[]) — Leitura de produtos da loja Nuvemshop.
- nuvemshop_products_write_create(product_id?: string, data: string, account?: string, product_ids?: string[]) — Cria ou edita produtos na Nuvemshop.
- nuvemshop_products_write_update(product_id?: string, data: string, account?: string, product_ids?: string[]) — Cria ou edita produtos na Nuvemshop.

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

## Links
Docs: https://mcp.ai/docs/mcps/nuvemshop
Website: https://mcp.ai/mcps/nuvemshop