Nuvemshop
Nuvemshop (Tiendanube) e-commerce platform, your store's products, orders, customers, categories and
Should I use this
Quality & Safety
Findings (3)
- LOWTool 'connect' description lacks action verbin connect
- LOWTool 'nuvemshop_products_write_create' name length outside 3-30 rangein nuvemshop_products_write_create
- LOWTool 'nuvemshop_products_write_update' name length outside 3-30 rangein nuvemshop_products_write_update
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"nuvemshop-mcp": {
"url": "https://api.mcp.ai/p_nuvemshop"
}
}
}Remote endpoints
https://api.mcp.ai/p_nuvemshopstreamable-httpWhat it can do
Tool inventory
Tools (24)
🟢nuvemshop_list_accounts(account)
Lista lojas Nuvemshop vinculadas a este install — store_id, label e apelido.
Input Schema
{
"type": "object",
"properties": {
"account": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢nuvemshop_products_list(product_id, page, per_page, q, category_id, ...)
Leitura de produtos da loja Nuvemshop. Ações: - list: produtos paginados (params: page, per_page, q busca textual, category_id, published, created_at_min, updated_at_min). - get: produto por id (requer product_id). [Flattened action: list] Bulk support: accepts product_ids, category_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"product_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"page": {
"type": "number"
},
"per_page": {
"type": "number"
},
"q": {
"type": "string"
},
"category_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"published": {
"type": "boolean"
},
"created_at_min": {
"type": "string"
},
"updated_at_min": {
"type": "string"
},
"account": {
"type": "string"
},
"product_ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
},
"category_ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢nuvemshop_products_get(product_id, page, per_page, q, category_id, ...)
Leitura de produtos da loja Nuvemshop. Ações: - list: produtos paginados (params: page, per_page, q busca textual, category_id, published, created_at_min, updated_at_min). - get: produto por id (requer product_id). [Flattened action: get] Bulk support: accepts product_ids, category_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"product_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"page": {
"type": "number"
},
"per_page": {
"type": "number"
},
"q": {
"type": "string"
},
"category_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"published": {
"type": "boolean"
},
"created_at_min": {
"type": "string"
},
"updated_at_min": {
"type": "string"
},
"account": {
"type": "string"
},
"product_ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
},
"category_ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡nuvemshop_products_write_create(product_id, data, account, product_ids)
Cria ou edita produtos na Nuvemshop. Ações: - create: cria produto (data = JSON com name, variants[], etc.). - update: edita produto (requer product_id; data = JSON só com os campos a mudar). [Flattened action: create] Bulk support: accepts product_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"product_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"data": {
"type": "string"
},
"account": {
"type": "string"
},
"product_ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡nuvemshop_products_write_update(product_id, data, account, product_ids)
Cria ou edita produtos na Nuvemshop. Ações: - create: cria produto (data = JSON com name, variants[], etc.). - update: edita produto (requer product_id; data = JSON só com os campos a mudar). [Flattened action: update] Bulk support: accepts product_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"product_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"data": {
"type": "string"
},
"account": {
"type": "string"
},
"product_ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢nuvemshop_orders_list(order_id, page, per_page, status, payment_status, ...)
Leitura de pedidos da loja Nuvemshop. Ações: - list: pedidos paginados (params: page, per_page, status, payment_status, shipping_status, created_at_min, updated_at_min, q). - get: pedido por id (requer order_id). [Flattened action: list] Bulk support: accepts order_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"order_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"page": {
"type": "number"
},
"per_page": {
"type": "number"
},
"status": {
"type": "string"
},
"payment_status": {
"type": "string"
},
"shipping_status": {
"type": "string"
},
"created_at_min": {
"type": "string"
},
"updated_at_min": {
"type": "string"
},
"q": {
"type": "string"
},
"account": {
"type": "string"
},
"order_ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢nuvemshop_orders_get(order_id, page, per_page, status, payment_status, ...)
Leitura de pedidos da loja Nuvemshop. Ações: - list: pedidos paginados (params: page, per_page, status, payment_status, shipping_status, created_at_min, updated_at_min, q). - get: pedido por id (requer order_id). [Flattened action: get] Bulk support: accepts order_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"order_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"page": {
"type": "number"
},
"per_page": {
"type": "number"
},
"status": {
"type": "string"
},
"payment_status": {
"type": "string"
},
"shipping_status": {
"type": "string"
},
"created_at_min": {
"type": "string"
},
"updated_at_min": {
"type": "string"
},
"q": {
"type": "string"
},
"account": {
"type": "string"
},
"order_ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴nuvemshop_orders_write_update(order_id, data, account, order_ids)
Mutações em pedidos Nuvemshop. Ações: - update: PUT no pedido (requer order_id; data = JSON com campos editáveis, ex. owner_note). - close | open | cancel | pack | fulfill: transição de status (requer order_id; data opcional, ex. cancel aceita { reason }). [Flattened action: update] Bulk support: accepts order_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"order_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"data": {
"type": "string"
},
"account": {
"type": "string"
},
"order_ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
}
},
"required": [
"order_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴nuvemshop_orders_write_close(order_id, data, account, order_ids)
Mutações em pedidos Nuvemshop. Ações: - update: PUT no pedido (requer order_id; data = JSON com campos editáveis, ex. owner_note). - close | open | cancel | pack | fulfill: transição de status (requer order_id; data opcional, ex. cancel aceita { reason }). [Flattened action: close] Bulk support: accepts order_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"order_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"data": {
"type": "string"
},
"account": {
"type": "string"
},
"order_ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
}
},
"required": [
"order_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴nuvemshop_orders_write_open(order_id, data, account, order_ids)
Mutações em pedidos Nuvemshop. Ações: - update: PUT no pedido (requer order_id; data = JSON com campos editáveis, ex. owner_note). - close | open | cancel | pack | fulfill: transição de status (requer order_id; data opcional, ex. cancel aceita { reason }). [Flattened action: open] Bulk support: accepts order_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"order_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"data": {
"type": "string"
},
"account": {
"type": "string"
},
"order_ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
}
},
"required": [
"order_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴nuvemshop_orders_write_cancel(order_id, data, account, order_ids)
Mutações em pedidos Nuvemshop. Ações: - update: PUT no pedido (requer order_id; data = JSON com campos editáveis, ex. owner_note). - close | open | cancel | pack | fulfill: transição de status (requer order_id; data opcional, ex. cancel aceita { reason }). [Flattened action: cancel] Bulk support: accepts order_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"order_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"data": {
"type": "string"
},
"account": {
"type": "string"
},
"order_ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
}
},
"required": [
"order_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴nuvemshop_orders_write_pack(order_id, data, account, order_ids)
Mutações em pedidos Nuvemshop. Ações: - update: PUT no pedido (requer order_id; data = JSON com campos editáveis, ex. owner_note). - close | open | cancel | pack | fulfill: transição de status (requer order_id; data opcional, ex. cancel aceita { reason }). [Flattened action: pack] Bulk support: accepts order_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"order_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"data": {
"type": "string"
},
"account": {
"type": "string"
},
"order_ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
}
},
"required": [
"order_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴nuvemshop_orders_write_fulfill(order_id, data, account, order_ids)
Mutações em pedidos Nuvemshop. Ações: - update: PUT no pedido (requer order_id; data = JSON com campos editáveis, ex. owner_note). - close | open | cancel | pack | fulfill: transição de status (requer order_id; data opcional, ex. cancel aceita { reason }). [Flattened action: fulfill] Bulk support: accepts order_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"order_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"data": {
"type": "string"
},
"account": {
"type": "string"
},
"order_ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
}
},
"required": [
"order_id"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢nuvemshop_customers_list(customer_id, page, per_page, q, created_at_min, ...)
Leitura de clientes da loja Nuvemshop. Ações: - list: clientes paginados (params: page, per_page, q, created_at_min, updated_at_min). - get: cliente por id (requer customer_id). [Flattened action: list] Bulk support: accepts customer_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"customer_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"page": {
"type": "number"
},
"per_page": {
"type": "number"
},
"q": {
"type": "string"
},
"created_at_min": {
"type": "string"
},
"updated_at_min": {
"type": "string"
},
"account": {
"type": "string"
},
"customer_ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢nuvemshop_customers_get(customer_id, page, per_page, q, created_at_min, ...)
Leitura de clientes da loja Nuvemshop. Ações: - list: clientes paginados (params: page, per_page, q, created_at_min, updated_at_min). - get: cliente por id (requer customer_id). [Flattened action: get] Bulk support: accepts customer_ids for batched execution.
Input Schema
{
"type": "object",
"properties": {
"customer_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"page": {
"type": "number"
},
"per_page": {
"type": "number"
},
"q": {
"type": "string"
},
"created_at_min": {
"type": "string"
},
"updated_at_min": {
"type": "string"
},
"account": {
"type": "string"
},
"customer_ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢nuvemshop_categories(page, per_page, parent, account)
Lista categorias da loja Nuvemshop (params opcionais: page, per_page, parent).
Input Schema
{
"type": "object",
"properties": {
"page": {
"type": "number"
},
"per_page": {
"type": "number"
},
"parent": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"account": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢nuvemshop_coupons(page, per_page, account)
Lista cupons de desconto da loja Nuvemshop (params opcionais: page, per_page).
Input Schema
{
"type": "object",
"properties": {
"page": {
"type": "number"
},
"per_page": {
"type": "number"
},
"account": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡nuvemshop_coupons_write_create(data, account)
Cria cupom de desconto na Nuvemshop. action: create. data = JSON com code, type (percentage|absolute|shipping), value, etc. [Flattened action: create]
Input Schema
{
"type": "object",
"properties": {
"data": {
"type": "string"
},
"account": {
"type": "string"
}
},
"required": [
"data"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢show_version
Show the current MCP platform and adapter versions.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡report_bug(message, context, conversation)
Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.
Input Schema
{
"type": "object",
"properties": {
"message": {
"type": "string"
},
"context": {
"default": "",
"type": "string"
},
"conversation": {
"default": "[]",
"type": "string"
}
},
"required": [
"message"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢connect
Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the toolkit and per-install URLs.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢toolkit_info
Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡marketplace(action, query, mcp_id, limit, tier_slug, ...)
The official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them. Covers capability requests like "find an MCP that does X", "consulta um CPF", "is there a tool for Y". Core flow: action=search discovers MCPs by intent → describe returns one MCP's full profile (every tool with its id + params, pricing, auth) so you pick the right tool_id → invoke RUNS that tool. KEY: invoke works even when the MCP is NOT installed — it runs the tool pontualmente (one-off), without adding the MCP to the toolkit and without bloating the tool list. If the MCP needs a credential/login, invoke returns a connect link; if it is paid and the wallet is empty, invoke returns a checkout/top-up link (the user opens it, then you retry). Use install only to make an MCP PERMANENT in the active toolkit (its tools then show up natively in future sessions); prefer invoke for a single/occasional use. list_tools lists what is callable right now. subscribe/cancel handle per-MCP billing; report_bug sends feedback; request_mcp asks us to build a NEW MCP when nothing fits. Search/describe flag installed_in_toolkit vs installed_in_workspace. Writes (install/uninstall/subscribe/cancel and the one-off install behind invoke) require workspace owner/admin. It also carries the mcp.ai PROMPT LIBRARY, which is about ready-made prompt TEXT rather than MCPs: search_prompts finds one, get_prompt returns its full text with {{variables}} filled, and publish_prompt saves a prompt and returns a shareable mcp.ai/p/<slug> link that opens without login.
Input Schema
{
"type": "object",
"properties": {
"action": {
"default": "search",
"type": "string",
"enum": [
"search",
"describe",
"install",
"uninstall",
"subscribe",
"cancel",
"resume",
"report_bug",
"request_mcp",
"list_tools",
"invoke",
"search_prompts",
"get_prompt",
"publish_prompt"
]
},
"query": {
"default": "",
"type": "string"
},
"mcp_id": {
"default": "",
"type": "string"
},
"limit": {
"default": 10,
"type": "number"
},
"tier_slug": {
"default": "",
"type": "string"
},
"immediate": {
"default": false,
"type": "boolean"
},
"cancel_reason": {
"type": "string",
"enum": [
"too_expensive",
"missing_features",
"switched_service",
"unused",
"customer_service",
"too_complex",
"low_quality",
"other"
]
},
"cancel_comment": {
"default": "",
"type": "string"
},
"message": {
"default": "",
"type": "string"
},
"report_context": {
"default": "",
"type": "string"
},
"conversation": {
"default": "[]",
"type": "string"
},
"request_name": {
"default": "",
"type": "string"
},
"request_details": {
"default": "",
"type": "string"
},
"tool_id": {
"default": "",
"type": "string"
},
"arguments": {
"default": "{}",
"type": "string"
},
"prompt_slug": {
"default": "",
"type": "string"
},
"prompt_vars": {
"default": "{}",
"type": "string"
},
"prompt_category": {
"default": "",
"type": "string"
},
"prompt_tool": {
"default": "",
"type": "string"
},
"prompt_title": {
"default": "",
"type": "string"
},
"prompt_description": {
"default": "",
"type": "string"
},
"prompt_body": {
"default": "",
"type": "string"
},
"prompt_targets": {
"default": [],
"type": "array",
"items": {
"type": "string",
"enum": [
"claude",
"chatgpt",
"cursor",
"lovable"
]
}
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡authenticate(token)
MCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token. Best: add it to this server's config as a header `Authorization: Bearer <token>` for a permanent, non-expiring connection. Or paste it here for a session-only login: call with { token: "<jwt>" } after the user pastes, or with no args to get the link.
Input Schema
{
"type": "object",
"properties": {
"token": {
"type": "string"
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}Community
Evidence