Nuvemshop

io.github.mcp-dirPublished by GitHub account mcp-dirv0.1.0Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableProductivity & WorkflowBusiness & Commerce

Overview

AI-generated overview

Lets an assistant read and manage a Nuvemshop (Tiendanube) store's products, orders, customers, categories and coupons.

What you can do
A hosted MCP server exposing 18 tools for the Nuvemshop (Tiendanube) e-commerce platform via its official API. It covers product listing and lookup, product creation and updates, order listing, lookup and mutations such as update, close, open, cancel, pack and fulfill, plus customer listing and lookup, category listing, and coupon listing and creation. Both read and write operations are included.
When to use it
Useful when an assistant should answer questions about a Nuvemshop store or act on it, for example listing open orders, finding products that are out of stock, or creating a discount coupon. It fits merchants and teams already running a Nuvemshop or Tiendanube store who work through an MCP-capable client.
Requirements
A remote MCP-over-HTTP endpoint; no local package or runtime is needed. The server URL is Authorization is done through the platform's OAuth flow: you click Authorize and log in to your Nuvemshop store, described as magic-link login without a password. Works with any MCP client that supports MCP over HTTP.
Before you install
The server is proprietary and hosted, not open source. Tools include write operations that create or edit products, mutate orders (update, close, open, cancel, pack, fulfill) and create coupons, so changes affect the live store. Data returned by the tools is sent to the LLM host you choose, a sub-processor outside the provider's control; plans with training opt-out are recommended. Paid plans start from a free tier.

Installation

In SourceWeft

  1. Open Nuvemshop in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.mcp-dir%2Fnuvemshop-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "nuvemshop": {
      "type": "http",
      "url": "https://api.mcp.ai/p_nuvemshop"
    }
  }
}

README

This repository has no README.

Tools

24

nuvemshop_list_accounts

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

Parametersaccount

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.

Parametersqpageaccountper_pagepublishedproduct_idcategory_idproduct_idscategory_idscreated_at_minupdated_at_min

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.

Parametersqpageaccountper_pagepublishedproduct_idcategory_idproduct_idscategory_idscreated_at_minupdated_at_min

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.

Parametersdatarequiredaccountproduct_idproduct_ids

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.

Parametersdatarequiredaccountproduct_idproduct_ids

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.

Parametersqpagestatusaccountorder_idper_pageorder_idscreated_at_minpayment_statusupdated_at_minshipping_status

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.

Parametersqpagestatusaccountorder_idper_pageorder_idscreated_at_minpayment_statusupdated_at_minshipping_status

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.

Parametersdataaccountorder_idrequiredorder_ids

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.

Parametersdataaccountorder_idrequiredorder_ids

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.

Parametersdataaccountorder_idrequiredorder_ids

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.

Parametersdataaccountorder_idrequiredorder_ids

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.

Parametersdataaccountorder_idrequiredorder_ids

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.

Parametersdataaccountorder_idrequiredorder_ids

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.

Parametersqpageaccountper_pagecustomer_idcustomer_idscreated_at_minupdated_at_min

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.

Parametersqpageaccountper_pagecustomer_idcustomer_idscreated_at_minupdated_at_min

nuvemshop_categories

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

Parameterspageparentaccountper_page

nuvemshop_coupons

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

Parameterspageaccountper_page

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]

Parametersdatarequiredaccount

show_version

Show Version

Show the current MCP platform and adapter versions.

Takes no parameters.

report_bug

Report Bug

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

Parameterscontextmessagerequiredconversation

connect

Connection Status

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.

Takes no parameters.

toolkit_info

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.

Takes no parameters.

marketplace

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.

Parameterslimitqueryactionmcp_idmessagetool_idargumentsimmediatetier_slugprompt_bodyprompt_slugprompt_tool+11 more

authenticate

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.

Parameterstoken

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • License10 pts

    Declare a license in the repository or the registry entry.