Servers Playground How we check Add a server Log in

Nuvemshop

Working · 146 ms

io.github.mcp-dir/nuvemshop-mcpv0.1.0

Nuvemshop (Tiendanube) e-commerce platform, your store's products, orders, customers, categories and

Commerce

Source Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://api.mcp.ai/p_nuvemshop

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

authenticate

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.

tokenstring

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Nuvemshop MCP server | mcptry

Tools (24)

authenticate

Argument	Type	Description
token	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "token": {
      "type": "string"
    }
  }
}

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.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

marketplace

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.

Argument	Type	Description
limit	number
query	string
action	string
mcp_id	string
message

nuvemshop_categories

Lista categorias da loja Nuvemshop (params opcionais: page, per_page, parent).

read-only

Argument	Type	Description
page	number
parent	any
account	string
per_page	number

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "page": {
      "type": "number"
    },
    "parent": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "account": {
      "type": "string"
    },
    "per_page": {
      "type": "number"
    }
  }
}

nuvemshop_coupons

Lista cupons de desconto da loja Nuvemshop (params opcionais: page, per_page).

read-only

Argument	Type	Description
page	number
account	string
per_page	number

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "page": {
      "type": "number"
    },
    "account": {
      "type": "string"
    },
    "per_page": {
      "type": "number"
    }
  }
}

nuvemshop_coupons_write_create

Cria cupom de desconto na Nuvemshop. action: create. data = JSON com code, type (percentage|absolute|shipping), value, etc. [Flattened action: create]

Argument	Type	Description
data*	string
account	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "data"
  ],
  "properties": {
    "data": {
      "type": "string"
    },
    "account": {
      "type": "string"
    }
  }
}

nuvemshop_customers_get

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.

read-only

Argument	Type	Description
q	string
page	number
account	string
per_page	number
customer_id	any
customer_ids	array
created_at_min	string
updated_at_min	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "q": {
      "type": "string"
    },
    "page": {
      "type": "number"
    },
    "account": {
      "type": "string"
    },
    "per_page": {
      "type": "number"
    },
    "customer_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "customer_ids": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          }
        ]
      }
    },
    "created_at_min": {
      "type": "string"
    },
    "updated_at_min": {
      "type": "string"
    }
  }
}

nuvemshop_customers_list

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.

read-only

Argument	Type	Description
q	string
page	number
account	string
per_page	number
customer_id	any
customer_ids	array
created_at_min	string
updated_at_min	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "q": {
      "type": "string"
    },
    "page": {
      "type": "number"
    },
    "account": {
      "type": "string"
    },
    "per_page": {
      "type": "number"
    },
    "customer_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "customer_ids": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          }
        ]
      }
    },
    "created_at_min": {
      "type": "string"
    },
    "updated_at_min": {
      "type": "string"
    }
  }
}

nuvemshop_list_accounts

Lista lojas Nuvemshop vinculadas a este install — store_id, label e apelido.

read-only

Argument	Type	Description
account	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "account": {
      "type": "string"
    }
  }
}

nuvemshop_orders_get

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.

read-only

Argument	Type	Description
q	string
page	number
status	string
account	string
order_id	any
per_page	number
order_ids	array
created_at_min	string
payment_status	string
updated_at_min	string

nuvemshop_orders_list

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.

read-only

Argument	Type	Description
q	string
page	number
status	string
account	string
order_id	any
per_page	number
order_ids	array
created_at_min	string
payment_status	string
updated_at_min	string

nuvemshop_orders_write_cancel

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.

Argument	Type	Description
data	string
account	string
order_id*	any
order_ids	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "order_id"
  ],
  "properties": {
    "data": {
      "type": "string"
    },
    "account": {
      "type": "string"
    },
    "order_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "order_ids": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          }
        ]
      }
    }
  }
}

nuvemshop_orders_write_close

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.

Argument	Type	Description
data	string
account	string
order_id*	any
order_ids	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "order_id"
  ],
  "properties": {
    "data": {
      "type": "string"
    },
    "account": {
      "type": "string"
    },
    "order_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "order_ids": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          }
        ]
      }
    }
  }
}

nuvemshop_orders_write_fulfill

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.

Argument	Type	Description
data	string
account	string
order_id*	any
order_ids	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "order_id"
  ],
  "properties": {
    "data": {
      "type": "string"
    },
    "account": {
      "type": "string"
    },
    "order_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "order_ids": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          }
        ]
      }
    }
  }
}

nuvemshop_orders_write_open

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.

Argument	Type	Description
data	string
account	string
order_id*	any
order_ids	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "order_id"
  ],
  "properties": {
    "data": {
      "type": "string"
    },
    "account": {
      "type": "string"
    },
    "order_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "order_ids": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          }
        ]
      }
    }
  }
}

nuvemshop_orders_write_pack

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.

Argument	Type	Description
data	string
account	string
order_id*	any
order_ids	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "order_id"
  ],
  "properties": {
    "data": {
      "type": "string"
    },
    "account": {
      "type": "string"
    },
    "order_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "order_ids": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          }
        ]
      }
    }
  }
}

nuvemshop_orders_write_update

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.

Argument	Type	Description
data	string
account	string
order_id*	any
order_ids	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "order_id"
  ],
  "properties": {
    "data": {
      "type": "string"
    },
    "account": {
      "type": "string"
    },
    "order_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "order_ids": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          }
        ]
      }
    }
  }
}

nuvemshop_products_get

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.

read-only

Argument	Type	Description
q	string
page	number
account	string
per_page	number
published	boolean
product_id	any
category_id	any
product_ids	array
category_ids	array
created_at_min	string

nuvemshop_products_list

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.

read-only

Argument	Type	Description
q	string
page	number
account	string
per_page	number
published	boolean
product_id	any
category_id	any
product_ids	array
category_ids	array
created_at_min	string

nuvemshop_products_write_create

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.

Argument	Type	Description
data*	string
account	string
product_id	any
product_ids	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "data"
  ],
  "properties": {
    "data": {
      "type": "string"
    },
    "account": {
      "type": "string"
    },
    "product_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "product_ids": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          }
        ]
      }
    }
  }
}

nuvemshop_products_write_update

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.

Argument	Type	Description
data*	string
account	string
product_id	any
product_ids	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "data"
  ],
  "properties": {
    "data": {
      "type": "string"
    },
    "account": {
      "type": "string"
    },
    "product_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ]
    },
    "product_ids": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "string"
          },
          {
            "type": "number"
          }
        ]
      }
    }
  }
}

report_bug

Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.

Argument	Type	Description
context	string
message*	string
conversation	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "message"
  ],
  "properties": {
    "context": {
      "type": "string",
      "default": ""
    },
    "message": {
      "type": "string"
    },
    "conversation": {
      "type": "string",
      "default": "[]"
    }
  }
}

show_version

Show the current MCP platform and adapter versions.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

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.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "number",
      "default": 10
    },
    "query": {
      "type": "string",
      "default": ""
    },
    "action": {
      "enum": [
        "search",
        "describe",
        "install",
        "uninstall",
        "subscribe",
        "cancel",
        "resume",
        "report_bug",
        "request_mcp",
        "list_tools",
        "invoke",
        "search_prompts",
        "get_prompt",
        "publish_prompt"
      ],
      "type": "string",
      "default": "search"
    },
    "mcp_id": {
      "type": "string",
      "default": ""
    },
    "message": {
      "type": "string",
      "default": ""
    },
    "tool_id": {
      "type": "string",
      "default": ""
    },
    "arguments": {
      "type": "string",
      "default": "{}"
    },
    "immediate": {
      "type": "boolean",
      "default": false
    },
    "tier_slug": {
      "type": "string",
      "default": ""
    },
    "prompt_body": {
      "type": "string",
      "default": ""
    },
    "prompt_slug": {
      "type": "string",
      "default": ""
    },
    "prompt_tool": {
      "type": "string",
      "default": ""
    },
    "prompt_vars": {
      "type": "string",
      "default": "{}"
    },
    "conversation": {
      "type": "string",
      "default": "[]"
    },
    "prompt_title": {
      "type": "string",
      "default": ""
    },
    "request_name": {
      "type": "string",
      "default": ""
    },
    "cancel_reason": {
      "enum": [
        "too_expensive",
        "missing_features",
        "switched_service",
        "unused",
        "customer_service",
        "too_complex",
        "low_quality",
        "other"
      ],
      "type": "string"
    },
    "cancel_comment": {
      "type": "string",
      "default": ""
    },
    "prompt_targets": {
      "type": "array",
      "items": {
        "enum": [
          "claude",
          "chatgpt",
          "cursor",
          "lovable"
        ],
        "type": "string"
      },
      "default": []
    },
    "report_context": {
      "type": "string",
      "default": ""
    },
    "prompt_category": {
      "type": "string",
      "default": ""
    },
    "request_details": {
      "type": "string",
      "default": ""
    },
    "prompt_description": {
      "type": "string",
      "default": ""
    }
  }
}