# mcp-tienda-nube

MCP server connecting AI assistants to Tienda Nube e-commerce stores. It handles catalog changes, order statuses, and webhooks through simple conversational prompts.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 274
- Author: codespar
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/argentina/tienda-nube
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-tienda-nube

## What it does

The package provides 24 tools for interacting with Tienda Nube (Nuvemshop) online shops. An agent can read or update catalog items, modify variant prices, and inspect abandoned checkouts. Order actions include status updates and refunds.

Setup runs over stdio or HTTP. For network connections, specify a port via `MCP_PORT` (defaults to 3000). Connection requires two environment variables: `TIENDANUBE_ACCESS_TOKEN` and `TIENDANUBE_STORE_ID`. Tokens come from the Tienda Nube partner developer portal.

Invalid credentials cause all API calls to fail.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `TIENDANUBE_ACCESS_TOKEN`, `TIENDANUBE_STORE_ID` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp-tienda-nube -e TIENDANUBE_ACCESS_TOKEN=<TIENDANUBE_ACCESS_TOKEN> -e TIENDANUBE_STORE_ID=<TIENDANUBE_STORE_ID> -- npx -y @codespar/mcp-tienda-nube
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add tienda-nube --env TIENDANUBE_ACCESS_TOKEN=<TIENDANUBE_ACCESS_TOKEN> --env TIENDANUBE_STORE_ID=<TIENDANUBE_STORE_ID> -- npx -y @codespar/mcp-tienda-nube
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tienda-nube": {
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-tienda-nube"
            ],
            "env": {
                "TIENDANUBE_ACCESS_TOKEN": "<TIENDANUBE_ACCESS_TOKEN>",
                "TIENDANUBE_STORE_ID": "<TIENDANUBE_STORE_ID>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "tienda-nube": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-tienda-nube"
            ],
            "env": {
                "TIENDANUBE_ACCESS_TOKEN": "<TIENDANUBE_ACCESS_TOKEN>",
                "TIENDANUBE_STORE_ID": "<TIENDANUBE_STORE_ID>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e TIENDANUBE_ACCESS_TOKEN=<TIENDANUBE_ACCESS_TOKEN> -e TIENDANUBE_STORE_ID=<TIENDANUBE_STORE_ID> tienda-nube npx -y @codespar/mcp-tienda-nube
```
Replace <…> with your own values

## When to use it
- inspect abandoned shopping carts
- update variant stock and pricing details
- cancel customer orders and process refunds
- register event webhooks for store actions

## Example prompts
- List the five most recent orders and check their shipping status.
- Update the price and inventory count for product variant `98765`.
- Create a new discount coupon named `PROMO10`.

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40409
- [OpenWork MCP Gateway](https://affpapa.org/en/nevibecode/mcp/openwork-mcp-gateway.md) — MCP server · ★ 24242
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18727
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9366
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/en/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP server · ★ 7506

From the same set: [codespar/mcp-dev-latam](https://affpapa.org/en/nevibecode/by/codespar/mcp-dev-latam.md) — 124 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md