mcp-tienda-nube — Claude Code MCP server: what it does, how to install
MCP server connecting AI assistants to Tienda Nube e-commerce stores. It handles catalog changes, order statuses, and webhooks through simple conversational prompts.
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-nubeWhat mcp-tienda-nube 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.
What it helps with
- inspect abandoned shopping carts
- update variant stock and pricing details
- cancel customer orders and process refunds
- register event webhooks for store actions
Example prompts for the agent
- 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.
How to install mcp-tienda-nube
Platform CLI
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-nubeReplace <…> with your own values
Platform CLI
codex mcp add tienda-nube --env TIENDANUBE_ACCESS_TOKEN=<TIENDANUBE_ACCESS_TOKEN> --env TIENDANUBE_STORE_ID=<TIENDANUBE_STORE_ID> -- npx -y @codespar/mcp-tienda-nubeReplace <…> with your own values
Config file
{
"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
Config file
{
"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
Platform CLI
gemini mcp add -e TIENDANUBE_ACCESS_TOKEN=<TIENDANUBE_ACCESS_TOKEN> -e TIENDANUBE_STORE_ID=<TIENDANUBE_STORE_ID> tienda-nube npx -y @codespar/mcp-tienda-nubeReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-tienda-nube
How do I install mcp-tienda-nube in Claude Code?
Run `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 the placeholders with your actual store credentials.
What does mcp-tienda-nube do?
It equips your AI coding agent with 24 tools for Tienda Nube stores. You can manage products and process customer orders directly from the terminal.
How do I get the required access token and store ID?
Locate your store ID in your shop dashboard, then generate a Bearer access token through the Tienda Nube Partners OAuth flow on their developer portal.
