Tiendanube MCP

io.github.commentemeappPublished by GitHub account commentemeappv0.1.0Updated Nov 6, 2026

Live Tiendanube / Nuvemshop docs, Admin API endpoints, OAuth scopes, webhook events and scaffolds

VerifiedSTDIODesktop onlyKnowledge & MemoryDeveloper Tools

Overview

AI-generated overview

Local MCP server that gives an assistant live Tiendanube/Nuvemshop developer docs, Admin API endpoint and OAuth scope lookups, webhook events, and Express…

What you can do
  • Search and read the official Tiendanube/Nuvemshop developer docs live, with page URLs and best-matching sections
  • Look up Admin API 2025-03 endpoints by path, resource or keyword, including method, full URL, required OAuth scope and reference page
  • List OAuth scopes and the resources they open, or find the scope needed for a resource or endpoint path
  • List webhook events by group and find how to register and verify them
  • Generate an Express TypeScript webhook receiver with HMAC signature verification and a node:test
  • Generate an Express TypeScript OAuth 2 authorization-code flow with state and code exchange
When to use it
Useful when building or reviewing Tiendanube/Nuvemshop partner apps and integrations: choosing endpoints and scopes, debugging 401/403 errors, registering webhooks, or bootstrapping webhook and OAuth boilerplate. It is aimed at developers, not at operating a store day to day.
Requirements
Node.js 18 or newer; run locally over stdio via npx with the package @commenteme/tiendanube-mcp. No credentials, tokens or environment variables are needed. Network access to nuvemshop.dev and tiendanube.dev is required for the two documentation tools; the lookup and scaffold tools work offline.
Before you install
The documentation tools fetch pages live from nuvemshop.dev and tiendanube.dev and keep them only in memory; other hosts are refused. Scaffold tools return file contents for the client to write, so review generated code before saving it. It does not operate a store or write to disk itself.

Installation

In SourceWeft

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

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

[tiendanube-mcp · Servidor MCP para desarrollar apps e integraciones en Tiendanube y Nuvemshop]

tiendanube-mcp

Servidor MCP para desarrollar apps e integraciones en Tiendanube y Nuvemshop.

[npm] [node] [license]

Instalación

bash
claude mcp add tiendanube -- npx -y @commenteme/tiendanube-mcp

Requiere Node >= 18. El cliente ejecuta el servidor con npx, así que no hace falta instalarlo. Para Claude Desktop, Cursor, Windsurf, VS Code y otros clientes, mira Otros clientes.

Uso rápido

Reinicia el cliente y pide lo que necesitas en lenguaje natural. El asistente elige la herramienta:

  • "Que scope necesita POST /orders/{id}/fulfillment-orders/{id}/tracking-events?"
  • "Arma el receptor de webhooks para order/paid y app/uninstalled con la verificación de firma"
  • "Genera el flujo de instalación OAuth del app 1234"
  • "Que eventos de webhook hay para fulfillment orders?"
  • "Cómo funcionan los slots del checkout en NubeSDK?"

Que incluye

Para quien escribe apps de partners e integraciones propias: Admin API, OAuth, webhooks, NubeSDK, apps del Admin y temas.

  • Documentación oficial en vivo: search-docs y read-doc leen las páginas Markdown que nuvemshop.dev publica para agentes, en inglés, portugués o español. Cada respuesta trae la URL de la página.
  • Índices de la Admin API 2025-03, sin red: 228 endpoints con el scope que piden y su página de referencia, los 18 grupos de scopes OAuth y los 57 eventos de webhook, con los tres de privacidad obligatorios aparte.
  • Scaffolding: el receptor de webhooks (firma x-linkedstore-hmac-sha256 sobre el body crudo, 200 inmediato y una prueba) y el flujo OAuth (redirección con state y canje del code con body JSON). Las herramientas devuelven los archivos (ruta y contenido) para que el cliente los escriba.
  • Sin credenciales: no pide token de tienda, no escribe en disco y solo se conecta a nuvemshop.dev y tiendanube.dev.

Funciona con Claude Code, Claude Desktop, Cursor, VS Code, Windsurf y cualquier cliente MCP con transporte stdio.

Por que existe

Tiendanube tiene un Admin MCP oficial para operar una tienda conversando: crear productos, ajustar stock y precios, ver pedidos, manejar cupones y promociones. Si lo que necesitas es operar una tienda, ocupa ese. Para quien construye sobre la plataforma no había servidor: este responde que endpoint, que scope y que evento usar, y entrega el código de las partes que todo app repite. Va junto con las skills de tiendanube-skills.

Documentación

Otros clientes

En claude_desktop_config.json (Claude Desktop), ~/.cursor/mcp.json o .cursor/mcp.json (Cursor) y ~/.codeium/windsurf/mcp_config.json (Windsurf):

json
{  "mcpServers": {    "tiendanube": {      "command": "npx",      "args": ["-y", "@commenteme/tiendanube-mcp"]    }  }}

En VS Code, .vscode/mcp.json:

json
{  "servers": {    "tiendanube": {      "type": "stdio",      "command": "npx",      "args": ["-y", "@commenteme/tiendanube-mcp"]    }  }}

Cualquier cliente con transporte stdio sirve: el comando es npx y los argumentos, -y @commenteme/tiendanube-mcp. En Claude Code, --scope project deja la configuración en .mcp.json para compartirla con el equipo.

Herramientas

HerramientaQue haceRed
search-docsBusca en el índice llms.txt de la documentación y cita la mejor sección de las tres primeras páginas.Sí
read-docLee una página o una sección, por URL o ruta del sitio. Otros dominios se rechazan.Sí
lookup-endpointEndpoint por ruta (acepta ids reales, versión y store id), recurso o palabras: URL completa, scope y referencia.No
lookup-scopeLos scopes OAuth y los recursos que abren, o el scope de un recurso o una ruta.No
lookup-webhook-eventLos eventos de webhook por grupo, con como registrarlos y verificarlos.No
scaffold-webhook-handlerReceptor Express en TypeScript con verificación de firma y una prueba con node:test.No
scaffold-oauth-callbackInstalación OAuth en Express: state, canje del code y registro por app y tienda.No

De dónde vienen los datos

La documentación de nuvemshop.dev no tiene licencia abierta, así que el paquete no la trae: search-docs y read-doc la leen en vivo y la guardan solo en memoria mientras corre el proceso. Los archivos de data/ son índices de hechos armados por scripts/ingerir.ts desde esas páginas: métodos, rutas, nombres de recursos, de scopes y de eventos, y el enlace a cada página. Ningún texto de la documentación entra en el paquete. Las contradicciones que encontramos en la documentación están en tiendanube-skills/docs/divergencias.md.

Desarrollo

bash
git clone https://github.com/commentemeapp/tiendanube-mcp.gitcd tiendanube-mcpnpm cinpm run check

npm run check es el gate: Prettier, tipos, build, las pruebas (las herramientas de documentación leen páginas sintéticas de test/fixtures/, sin red), probar-mcp, que arranca el servidor por stdio como un cliente, y la búsqueda de rastros. Para probarlo en un cliente:

bash
claude mcp add tiendanube-local -- node /ruta/a/tiendanube-mcp/build/index.js

Actualizar los índices

Corre npm run ingerir: baja las páginas de recursos de la versión 2025-03, el llms.txt, la autenticación y los webhooks, y reescribe data/. Después, npm run check y commitea data/: el paquete lo necesita.

Ramas y publicación

El trabajo nace en una rama salida de dev y el PR va contra dev. Después de probar localmente, dev se promueve a main con merge de la rama completa. El CI corre npm run check en Node 18, 20 y 22.

Para publicar, sube la versión en package.json, server.json y CHANGELOG.md y empuja un tag v*: el workflow publish.yml corre el gate, publica en npm con provenance, crea el GitHub Release y publica server.json en el MCP Registry. Los cambios de cada versión están en CHANGELOG.md.

Contribuir · Licencia

Abre un PR contra dev, con Conventional Commits y npm run check en verde.

MIT. Lo que el paquete trae y lo que no, en NOTICE.

Hecho por commente.me · [email protected]

Source: README.md at commit f21933e

Tools

7

search-docs

Search Tiendanube / Nuvemshop docs

Search the official Tiendanube / Nuvemshop developer docs (Admin API, apps, NubeSDK, themes, Storefront API, AI and agents), fetched live from nuvemshop.dev. Returns matching pages with URL and, for the top three, the best matching section. Use it first for any "how do I" question; follow up with read-doc.

Parameterslimitqueryrequiredlocaleexcerpts

read-doc

Read a Tiendanube / Nuvemshop doc page

Read a page of the official docs, or one section of it, by URL or site path. Fetched live as Markdown from nuvemshop.dev or tiendanube.dev; other hosts are refused. Use it after search-docs, lookup-endpoint or when the user pastes a docs link.

ParametersurlrequiredlocalesectionmaxChars

lookup-endpoint

Look up an Admin API endpoint

Look up Tiendanube / Nuvemshop Admin API endpoints by path, resource or keywords: method, path, full URL with version and store_id, the OAuth scope it needs and the reference page. Works offline from an index of the 2025-03 reference. Use it when writing or reviewing API calls.

Parameterslimitqueryrequiredmethod

lookup-scope

Look up OAuth scopes

List the OAuth scopes of Tiendanube / Nuvemshop apps and the resources each one opens, or find the scope for a resource, endpoint path or scope name. Use it when choosing the scopes of an app in the Partners Portal or debugging a 401/403.

Parametersquery

lookup-webhook-event

Look up webhook events

List the webhook events of Tiendanube / Nuvemshop (orders, products, customers, fulfillment orders, locations, billing, app lifecycle and the required privacy webhooks), or find one, with how to register and verify them. Use it before registering webhooks or writing a receiver.

Parametersquery

scaffold-webhook-handler

Scaffold a webhook receiver

Generate an Express (TypeScript) webhook receiver for Tiendanube / Nuvemshop: x-linkedstore-hmac-sha256 verification over the raw body, immediate 200, one case per event and a node:test for the signature. Returns the files for the caller to write; the server never writes to disk.

Parametersdireventsrequired

scaffold-oauth-callback

Scaffold the OAuth install flow

Generate the Express (TypeScript) OAuth 2 authorization code flow of a Tiendanube / Nuvemshop app: install redirect with state, callback that exchanges the code with a JSON body and stores the token per app and store. Returns the files for the caller to write. For a full app, it points to the official templates.

ParametersdirappIdrequiredbrand

Version history

1
  1. v0.1.0LatestNov 5, 2026

Score

90% 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 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts