Skip to content
MCP server

Tiendanube MCP

Tiendanube and Nuvemshop developer docs, API endpoint, scope and webhook lookups

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.1.0
Listing updated
today

Similar MCP servers

About Tiendanube MCP

Tiendanube MCP is an open-source MCP server for e-commerce. It runs locally on your machine and is started by your AI client.

This server is for people building partner apps or custom integrations on Tiendanube and Nuvemshop, not for running a store. Its README points store operators to the platform's official Admin MCP instead. Here an assistant can answer which endpoint, OAuth scope or webhook event a task needs and receive generated code for parts every app repeats.

Indexes for Admin API version 2025-03 work without a network: 228 endpoints with their required scopes and reference pages, 18 OAuth scope groups and 57 webhook events, with the three mandatory privacy events listed separately. Documentation search and reading hit nuvemshop.dev live in English, Portuguese or Spanish, and only memory holds it, since that documentation has no open licence.

Scaffolding tools return an Express and TypeScript webhook receiver with signature verification and a test, plus an OAuth install flow. The server asks for no store token, writes nothing to disk and connects only to nuvemshop.dev and tiendanube.dev. The README is in Spanish.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "tiendanube-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@commenteme/tiendanube-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "tiendanube-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@commenteme/tiendanube-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

search-docs
Searches the documentation index and cites the best sections.
read-doc
Reads a documentation page or section by URL or path.
lookup-endpoint
Finds an Admin API endpoint with full URL, scope and reference.
lookup-scope
Returns OAuth scopes and the resources they open.
lookup-webhook-event
Lists webhook events by group with registration and verification steps.
scaffold-webhook-handler
Returns an Express TypeScript webhook receiver with a test.
scaffold-oauth-callback
Returns an Express OAuth install flow.

What it does

Live docs search
search-docs and read-doc read official documentation in three languages and cite the page URL.
Endpoint index
228 Admin API endpoints with scope and reference link, available offline.
Scope lookup
The 18 OAuth scope groups and the resources they open.
Webhook events
57 events with how to register and verify them.
Webhook scaffold
Express receiver with signature check and a node:test test.
OAuth scaffold
Install flow with state, code exchange and per-store registration.

Good for

  • Find the scope an endpoint needs
  • Generate a webhook receiver for order/paid and app/uninstalled
  • Create an OAuth install flow for a partner app
  • Look up webhook events for fulfillment orders

Pricing

Open source

MIT licence

Tiendanube MCP FAQ

Does it need store credentials?

No. It asks for no store token and only connects to nuvemshop.dev and tiendanube.dev.

Can it manage my store?

No. For operating a store the README recommends the official Admin MCP.

What does it require?

Node 18 or later; clients run it with npx.

What licence applies?

MIT.

Is Tiendanube MCP free?

Yes. Tiendanube MCP is open source, so you can use and self-host it for free.

How do I add Tiendanube MCP to Claude Code?

Run this command in your terminal: claude mcp add tiendanube-mcp -- npx -y @commenteme/tiendanube-mcp

What are the best alternatives to Tiendanube MCP?

The closest alternatives to Tiendanube MCP are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers