Is nuvemshop-mcp safe to install?

SaferSkills independently audited nuvemshop-mcp (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.

CategoryWeightCategory scoreContribution

Securityprompt, exec, net, exfil, eval

35%

100

35.0 pts

Supply chainhash, typosquat, maintainer, lockfile

20%

100

20.0 pts

Maintenancestaleness, pinning, CI

15%

100

15.0 pts

TransparencySKILL.md, perms, README

15%

100

15.0 pts

Communityinstalls, verify, response

15%

100

15.0 pts

Findings & checks · 0 flagged

Securityscore 100 · 0 findings

✓—All security checks passedNo findings in this category for the latest scan.pass

Supply chainscore 100 · 0 findings

✓—All supply chain checks passedNo findings in this category for the latest scan.pass

Maintenancescore 100 · 0 findings

✓—All maintenance checks passedNo findings in this category for the latest scan.pass

Transparencyscore 100 · 0 findings

✓—All transparency checks passedNo findings in this category for the latest scan.pass

Communityscore 100 · 0 findings

✓—All community checks passedNo findings in this category for the latest scan.pass

The primary manifest — the file an agent reads to learn what this artifact does.

skills/nuvemshop-mcp/SKILL.md · 1 file

skills/nuvemshop-mcp/SKILL.md13.1 KB · Markdown

name: nuvemshop-mcp

description: Skill da REST API do Nuvemshop na MCP.AI: 18 endpoints em /api/nuvemshop. 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. Autentique com workspace API key (sk_live) gerada em app.mcp.ai/settings/api-keys. Use quando o usuário pedir algo coberto pelos endpoints.

Nuvemshop — REST API skill

Você tem acesso à Nuvemshop REST API na 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.

Base URL

https://api.mcp.ai/api/nuvemshop

Todo endpoint é um POST na Base URL + o path abaixo. Os parâmetros vão no corpo JSON.

Autenticação

Inclua em toda request:

Authorization: Bearer sk_live_...
Content-Type: application/json

Gere sua chave em https://app.mcp.ai/settings/api-keys (workspace API key sk_live_…, não expira, revogável). Uma única chave serve pra todos os seus MCPs.

Formato de resposta

{ "ok": true, "tool": "<tool_id>", "result": <payload> }

Exemplo cURL

curl -X POST https://api.mcp.ai/api/nuvemshop/categories \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{}'

Reportar problemas

Se um endpoint retornar erro, vazio ou dado inesperado, reporte (não desista calado): POST /api/nuvemshop/report com { "message": "...", "context"?: "...", "conversation"?: [...] }. Isso notifica o time da MCP.AI.

Endpoints (18)

#### nuvemshop_categories

Lista categorias da loja Nuvemshop (params opcionais: page, per_page, parent). _(POST /api/nuvemshop/categories)_

Parâmetro	Tipo	Obrigatório	Descrição
`page`	integer	Não
`per_page`	integer	Não
`parent`	string	Não
`account`	string	Não	Opcional quando há várias lojas Nuvemshop vinculadas a este install (store_id, label ou trecho). Use nuvemshop_list_accounts pra ver as opções; omita se só houver uma.

#### nuvemshop_coupons

Lista cupons de desconto da loja Nuvemshop (params opcionais: page, per_page). _(POST /api/nuvemshop/coupons)_

Parâmetro	Tipo	Obrigatório	Descrição
`page`	integer	Não
`per_page`	integer	Não
`account`	string	Não	Opcional quando há várias lojas Nuvemshop vinculadas a este install (store_id, label ou trecho). Use nuvemshop_list_accounts pra ver as opções; omita se só houver uma.

#### nuvemshop_coupons_write_create

Cria cupom de desconto na Nuvemshop. _(POST /api/nuvemshop/coupons/write/create)_

Parâmetro	Tipo	Obrigatório	Descrição
`data`	string	Sim	Corpo do cupom como JSON string
`account`	string	Não	Opcional quando há várias lojas Nuvemshop vinculadas a este install (store_id, label ou trecho). Use nuvemshop_list_accounts pra ver as opções; omita se só houver uma.

#### nuvemshop_customers_get

Leitura de clientes da loja Nuvemshop. _(POST /api/nuvemshop/customers/get)_

Parâmetro	Tipo	Obrigatório	Descrição
`customer_id`	string	Não	Obrigatório para get
`page`	integer	Não
`per_page`	integer	Não
`q`	string	Não
`created_at_min`	string	Não
`updated_at_min`	string	Não
`account`	string	Não	Opcional quando há várias lojas Nuvemshop vinculadas a este install (store_id, label ou trecho). Use nuvemshop_list_accounts pra ver as opções; omita se só houver uma.
`customer_ids`	string[]	Não	Bulk mode: multiple values for customer_id

#### nuvemshop_customers_list

Leitura de clientes da loja Nuvemshop. _(POST /api/nuvemshop/customers/list)_

Parâmetro	Tipo	Obrigatório	Descrição
`customer_id`	string	Não	Obrigatório para get
`page`	integer	Não
`per_page`	integer	Não
`q`	string	Não
`created_at_min`	string	Não
`updated_at_min`	string	Não
`account`	string	Não	Opcional quando há várias lojas Nuvemshop vinculadas a este install (store_id, label ou trecho). Use nuvemshop_list_accounts pra ver as opções; omita se só houver uma.
`customer_ids`	string[]	Não	Bulk mode: multiple values for customer_id

#### nuvemshop_list_accounts

Lista lojas Nuvemshop vinculadas a este install — store_id, label e apelido. _(POST /api/nuvemshop/list/accounts)_

Parâmetro	Tipo	Obrigatório	Descrição
`account`	string	Não	Opcional quando há várias lojas Nuvemshop vinculadas a este install (store_id, label ou trecho). Use nuvemshop_list_accounts pra ver as opções; omita se só houver uma.

#### nuvemshop_orders_get

Leitura de pedidos da loja Nuvemshop. _(POST /api/nuvemshop/orders/get)_

Parâmetro	Tipo	Obrigatório	Descrição
`order_id`	string	Não	Obrigatório para get
`page`	integer	Não
`per_page`	integer	Não
`status`	string	Não	open	closed	cancelled
`payment_status`	string	Não
`shipping_status`	string	Não
`created_at_min`	string	Não
`updated_at_min`	string	Não
`q`	string	Não
`account`	string	Não	Opcional quando há várias lojas Nuvemshop vinculadas a este install (store_id, label ou trecho). Use nuvemshop_list_accounts pra ver as opções; omita se só houver uma.
`order_ids`	string[]	Não	Bulk mode: multiple values for order_id

#### nuvemshop_orders_list

Leitura de pedidos da loja Nuvemshop. _(POST /api/nuvemshop/orders/list)_

Parâmetro	Tipo	Obrigatório	Descrição
`order_id`	string	Não	Obrigatório para get
`page`	integer	Não
`per_page`	integer	Não
`status`	string	Não	open	closed	cancelled
`payment_status`	string	Não
`shipping_status`	string	Não
`created_at_min`	string	Não
`updated_at_min`	string	Não
`q`	string	Não
`account`	string	Não	Opcional quando há várias lojas Nuvemshop vinculadas a este install (store_id, label ou trecho). Use nuvemshop_list_accounts pra ver as opções; omita se só houver uma.
`order_ids`	string[]	Não	Bulk mode: multiple values for order_id

#### nuvemshop_orders_write_cancel

Mutações em pedidos Nuvemshop. _(POST /api/nuvemshop/orders/write/cancel)_

Parâmetro	Tipo	Obrigatório	Descrição
`order_id`	string	Sim	ID do pedido
`data`	string	Não	Corpo como JSON string (obrigatório para update)
`account`	string	Não	Opcional quando há várias lojas Nuvemshop vinculadas a este install (store_id, label ou trecho). Use nuvemshop_list_accounts pra ver as opções; omita se só houver uma.
`order_ids`	string[]	Não	Bulk mode: multiple values for order_id

#### nuvemshop_orders_write_close

Mutações em pedidos Nuvemshop. _(POST /api/nuvemshop/orders/write/close)_

Parâmetro	Tipo	Obrigatório	Descrição
`order_id`	string	Sim	ID do pedido
`data`	string	Não	Corpo como JSON string (obrigatório para update)
`account`	string	Não	Opcional quando há várias lojas Nuvemshop vinculadas a este install (store_id, label ou trecho). Use nuvemshop_list_accounts pra ver as opções; omita se só houver uma.
`order_ids`	string[]	Não	Bulk mode: multiple values for order_id

#### nuvemshop_orders_write_fulfill

Mutações em pedidos Nuvemshop. _(POST /api/nuvemshop/orders/write/fulfill)_

Parâmetro	Tipo	Obrigatório	Descrição
`order_id`	string	Sim	ID do pedido
`data`	string	Não	Corpo como JSON string (obrigatório para update)
`account`	string	Não	Opcional quando há várias lojas Nuvemshop vinculadas a este install (store_id, label ou trecho). Use nuvemshop_list_accounts pra ver as opções; omita se só houver uma.
`order_ids`	string[]	Não	Bulk mode: multiple values for order_id

#### nuvemshop_orders_write_open

Mutações em pedidos Nuvemshop. _(POST /api/nuvemshop/orders/write/open)_

Parâmetro	Tipo	Obrigatório	Descrição
`order_id`	string	Sim	ID do pedido
`data`	string	Não	Corpo como JSON string (obrigatório para update)
`account`	string	Não	Opcional quando há várias lojas Nuvemshop vinculadas a este install (store_id, label ou trecho). Use nuvemshop_list_accounts pra ver as opções; omita se só houver uma.
`order_ids`	string[]	Não	Bulk mode: multiple values for order_id

#### nuvemshop_orders_write_pack

Mutações em pedidos Nuvemshop. _(POST /api/nuvemshop/orders/write/pack)_

Parâmetro	Tipo	Obrigatório	Descrição
`order_id`	string	Sim	ID do pedido
`data`	string	Não	Corpo como JSON string (obrigatório para update)
`account`	string	Não	Opcional quando há várias lojas Nuvemshop vinculadas a este install (store_id, label ou trecho). Use nuvemshop_list_accounts pra ver as opções; omita se só houver uma.
`order_ids`	string[]	Não	Bulk mode: multiple values for order_id

#### nuvemshop_orders_write_update

Mutações em pedidos Nuvemshop. _(POST /api/nuvemshop/orders/write/update)_

Parâmetro	Tipo	Obrigatório	Descrição
`order_id`	string	Sim	ID do pedido
`data`	string	Não	Corpo como JSON string (obrigatório para update)
`account`	string	Não	Opcional quando há várias lojas Nuvemshop vinculadas a este install (store_id, label ou trecho). Use nuvemshop_list_accounts pra ver as opções; omita se só houver uma.
`order_ids`	string[]	Não	Bulk mode: multiple values for order_id

#### nuvemshop_products_get

Leitura de produtos da loja Nuvemshop. _(POST /api/nuvemshop/products/get)_

Parâmetro	Tipo	Obrigatório	Descrição
`product_id`	string	Não	Obrigatório para get
`page`	integer	Não
`per_page`	integer	Não
`q`	string	Não	Busca textual
`category_id`	string	Não
`published`	boolean	Não
`created_at_min`	string	Não	ISO 8601
`updated_at_min`	string	Não	ISO 8601
`account`	string	Não	Opcional quando há várias lojas Nuvemshop vinculadas a este install (store_id, label ou trecho). Use nuvemshop_list_accounts pra ver as opções; omita se só houver uma.
`product_ids`	string[]	Não	Bulk mode: multiple values for product_id
`category_ids`	string[]	Não	Bulk mode: multiple values for category_id

#### nuvemshop_products_list

Leitura de produtos da loja Nuvemshop. _(POST /api/nuvemshop/products/list)_

Parâmetro	Tipo	Obrigatório	Descrição
`product_id`	string	Não	Obrigatório para get
`page`	integer	Não
`per_page`	integer	Não
`q`	string	Não	Busca textual
`category_id`	string	Não
`published`	boolean	Não
`created_at_min`	string	Não	ISO 8601
`updated_at_min`	string	Não	ISO 8601
`account`	string	Não	Opcional quando há várias lojas Nuvemshop vinculadas a este install (store_id, label ou trecho). Use nuvemshop_list_accounts pra ver as opções; omita se só houver uma.
`product_ids`	string[]	Não	Bulk mode: multiple values for product_id
`category_ids`	string[]	Não	Bulk mode: multiple values for category_id

#### nuvemshop_products_write_create

Cria ou edita produtos na Nuvemshop. _(POST /api/nuvemshop/products/write/create)_

Parâmetro	Tipo	Obrigatório	Descrição
`product_id`	string	Não	Obrigatório para update
`data`	string	Sim	Corpo do produto como JSON string
`account`	string	Não	Opcional quando há várias lojas Nuvemshop vinculadas a este install (store_id, label ou trecho). Use nuvemshop_list_accounts pra ver as opções; omita se só houver uma.
`product_ids`	string[]	Não	Bulk mode: multiple values for product_id

#### nuvemshop_products_write_update

Cria ou edita produtos na Nuvemshop. _(POST /api/nuvemshop/products/write/update)_

Parâmetro	Tipo	Obrigatório	Descrição
`product_id`	string	Não	Obrigatório para update
`data`	string	Sim	Corpo do produto como JSON string
`account`	string	Não	Opcional quando há várias lojas Nuvemshop vinculadas a este install (store_id, label ou trecho). Use nuvemshop_list_accounts pra ver as opções; omita se só houver uma.
`product_ids`	string[]	Não	Bulk mode: multiple values for product_id

Este MCP também funciona via conexão MCP (Claude / Cursor) em https://api.mcp.ai/p_nuvemshop — veja o README. A skill acima é pra consumir a REST API direto (agente próprio / código).

nuvemshop-mcp— agent skill

Is nuvemshop-mcp safe to install?

Nuvemshop — REST API skill

Base URL

Autenticação

Formato de resposta

Exemplo cURL

Reportar problemas

Endpoints (18)

Audit the pieces. Scan the whole. Decide.