# Tienda Nube MCP (CodeSpar) > A community MCP server that lets your agent manage products, orders, customers, coupons and webhooks in your Tienda Nube store. Tienda Nube MCP (CodeSpar) is a local MCP server for Tienda Nube (Nuvemshop in Brazil), the Latin American ecommerce platform. It's made by CodeSpar, a third party that publishes open-source MCP servers for Latin American services; Tienda Nube doesn't make or support it, and CodeSpar marks it as beta. The server calls Tienda Nube's API with your store's own access token, so your agent works on the store that token belongs to. What you can do with it - List, read, create, update and delete products, and list variants and update their price, promotional price, stock, SKU and weight (list_products, get_product, create_product, update_product, delete_product, list_product_variants, update_product_variant). - List and read orders, filtered by order, payment or shipping status, and close or cancel an order, choosing the reason, whether to email the customer and whether to restock (list_orders, get_order, close_order, cancel_order). - List, search and read customers (list_customers, get_customer). - List, create, update and delete product categories (list_categories, create_category, update_category, delete_category). - List coupons and create percentage, fixed-amount or free-shipping coupons (list_discount_coupons, create_discount_coupon). - List abandoned checkouts (list_abandoned_carts). - List, create and delete webhooks for store events (list_webhooks, create_webhook, delete_webhook). How it connects It runs on your computer with npx -y @codespar/mcp-tienda-nube and reads two environment variables, TIENDANUBE_ACCESS_TOKEN and TIENDANUBE_STORE_ID. Tienda Nube issues access tokens only to apps, through its OAuth flow: you create an app in Tienda Nube's Partners Portal, install it on your store and exchange the code for a token, which comes back with your store ID. CodeSpar's docs show setup for Claude Code, Claude Desktop, Cursor and VS Code. Good to know - Many of its tools change your live store straight away: deleting products and categories, cancelling orders and creating coupons. - update_order_status also sends shipping and tracking fields, but Tienda Nube's API takes only an order status and a note on that endpoint, so expect only the status change to work. - list_discount_coupons has a code filter that Tienda Nube's API doesn't recognise, so it returns every coupon. - It calls Tienda Nube's v1 API, which Tienda Nube now documents as its legacy version. - It's MIT-licensed and calls Tienda Nube directly; nothing goes through CodeSpar's own servers. - It's a community project by CodeSpar, not an official Tienda Nube product. - Type: Plugin - Made by: codespar - Category: E-commerce - Formats: Local MCP - Version: 0.2.2 - Website: https://codespar.dev/servers/tienda-nube - Source: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/argentina/tienda-nube - Page: https://pluginboard.ai/plugins/mcp-tienda-nube ## Works with - Claude - GitHub Copilot - Cursor - Claude Code - Codex - Antigravity - Gemini CLI - OpenClaw - OpenCode - Hermes Agent ## Install You'll need: - `TIENDANUBE_ACCESS_TOKEN` (required): Access token for Tienda Nube - `TIENDANUBE_STORE_ID` (required): Store identifier Replace each `` placeholder with your own value. ### Claude Add to claude_desktop_config.json: ```json { "mcpServers": { "tienda-nube-mcp-codespar": { "command": "npx", "args": [ "-y", "@codespar/mcp-tienda-nube@0.2.2" ], "env": { "TIENDANUBE_ACCESS_TOKEN": "", "TIENDANUBE_STORE_ID": "" } } } } ``` ### GitHub Copilot Add to VS Code: vscode:mcp/install?%7B%22name%22%3A%22tienda-nube-mcp-codespar%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40codespar%2Fmcp-tienda-nube%400.2.2%22%5D%2C%22env%22%3A%7B%22TIENDANUBE_ACCESS_TOKEN%22%3A%22%3CTIENDANUBE_ACCESS_TOKEN%3E%22%2C%22TIENDANUBE_STORE_ID%22%3A%22%3CTIENDANUBE_STORE_ID%3E%22%7D%7D Run in your terminal: ```shell code --add-mcp '{"name":"tienda-nube-mcp-codespar","command":"npx","args":["-y","@codespar/mcp-tienda-nube@0.2.2"],"env":{"TIENDANUBE_ACCESS_TOKEN":"","TIENDANUBE_STORE_ID":""}}' ``` Copilot CLI: ```shell copilot mcp add tienda-nube-mcp-codespar --env TIENDANUBE_ACCESS_TOKEN= --env TIENDANUBE_STORE_ID= -- npx -y @codespar/mcp-tienda-nube@0.2.2 ``` ### Cursor Add to Cursor: cursor://anysphere.cursor-deeplink/mcp/install?name=tienda-nube-mcp-codespar&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBjb2Rlc3Bhci9tY3AtdGllbmRhLW51YmVAMC4yLjIiXSwiZW52Ijp7IlRJRU5EQU5VQkVfQUNDRVNTX1RPS0VOIjoiPFRJRU5EQU5VQkVfQUNDRVNTX1RPS0VOPiIsIlRJRU5EQU5VQkVfU1RPUkVfSUQiOiI8VElFTkRBTlVCRV9TVE9SRV9JRD4ifX0%3D Add to .cursor/mcp.json: ```json { "mcpServers": { "tienda-nube-mcp-codespar": { "command": "npx", "args": [ "-y", "@codespar/mcp-tienda-nube@0.2.2" ], "env": { "TIENDANUBE_ACCESS_TOKEN": "", "TIENDANUBE_STORE_ID": "" } } } } ``` ### Claude Code Run in your terminal: ```shell claude mcp add -e TIENDANUBE_ACCESS_TOKEN= -e TIENDANUBE_STORE_ID= tienda-nube-mcp-codespar -- npx -y @codespar/mcp-tienda-nube@0.2.2 ``` ### Codex Run in your terminal: ```shell codex mcp add --env TIENDANUBE_ACCESS_TOKEN= --env TIENDANUBE_STORE_ID= tienda-nube-mcp-codespar -- npx -y @codespar/mcp-tienda-nube@0.2.2 ``` ### Antigravity Add to ~/.gemini/config/mcp_config.json: ```json { "mcpServers": { "tienda-nube-mcp-codespar": { "command": "npx", "args": [ "-y", "@codespar/mcp-tienda-nube@0.2.2" ], "env": { "TIENDANUBE_ACCESS_TOKEN": "", "TIENDANUBE_STORE_ID": "" } } } } ``` ### Gemini CLI Run in your terminal: ```shell gemini mcp add -e TIENDANUBE_ACCESS_TOKEN= -e TIENDANUBE_STORE_ID= tienda-nube-mcp-codespar npx -y @codespar/mcp-tienda-nube@0.2.2 ``` ### OpenClaw In a terminal: Run openclaw mcp add tienda-nube-mcp-codespar --command npx, with --arg before each argument (-y @codespar/mcp-tienda-nube@0.2.2) and --env NAME=value for each variable it needs. ### OpenCode Run in your terminal: ```shell opencode mcp add tienda-nube-mcp-codespar --env TIENDANUBE_ACCESS_TOKEN= --env TIENDANUBE_STORE_ID= -- npx -y @codespar/mcp-tienda-nube@0.2.2 ``` ### Hermes Agent Add to ~/.hermes/config.yaml: ```json { "mcp_servers": { "tienda-nube-mcp-codespar": { "command": "npx", "args": [ "-y", "@codespar/mcp-tienda-nube@0.2.2" ], "env": { "TIENDANUBE_ACCESS_TOKEN": "", "TIENDANUBE_STORE_ID": "" } } } } ``` --- From Pluginboard (https://pluginboard.ai).