# Tiendanube MCP

> Tiendanube MCP is an open-source MCP server for e-commerce. Tiendanube and Nuvemshop developer docs, API endpoint, scope and webhook lookups. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/commentemeapp/tiendanube-mcp
- **MCP Registry name:** io.github.commentemeapp/tiendanube-mcp
- **Categories:** [e-commerce](https://ai-powered.com/categories/e-commerce), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/tiendanube-mcp
