mcp-tienda-nube

Name: mcp-tienda-nube
Author: codespar

Local

github.com/codesparBusiness & Marketing275Updated 4w ago

Repository

About mcp-tienda-nube

mcp-tienda-nube is an MCP server for Tienda Nube (Nuvemshop), a Latin American e-commerce platform. It lets MCP clients manage store products, orders, customers, categories, coupons and webhooks. It is aimed at merchants and developers working with Tienda Nube stores.

Key features

01Product and variant query, create and update
02Order lookup, status updates, closing and cancelling
03Customer and category management
04Discount coupon and abandoned cart listing
05Webhook subscription management
06Configuration through access token and store ID variables

Use cases

01Letting an AI assistant check orders and update shipping status
02Adjusting product prices and stock levels
03Reviewing abandoned carts to follow up with customers

MCP support

This project is an MCP server that exposes 24 tools to MCP clients for reading and writing Tienda Nube store data.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config

{
  "mcpServers": {
    "codespar-mcp-tienda-nube": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-tienda-nube"
      ],
      "env": {
        "TIENDANUBE_ACCESS_TOKEN": "<TIENDANUBE_ACCESS_TOKEN>",
        "TIENDANUBE_STORE_ID": "<TIENDANUBE_STORE_ID>"
      }
    }
  }
}

Run commandnpx -y @codespar/mcp-tienda-nube

Environment variables to set

TIENDANUBE_ACCESS_TOKENSecretAccess token for Tienda Nube

TIENDANUBE_STORE_IDStore identifier

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages

npm@codespar/mcp-tienda-nube0.2.2stdio

Tools

Saved tool list · updated 2w ago

Parameter	Type	Required	Description
page	number	No	Page number
per_page	number	No	Results per page (max 200)
since_id	number	No	Filter products after this ID
created_at_max	string	No	Max creation date (ISO 8601)
created_at_min	string	No	Min creation date (ISO 8601)

Details

From the project README

MCP Tienda Nube

MCP server for Tienda Nube (Nuvemshop) — the leading LATAM e-commerce platform, Argentine-founded, equivalent to Shopify for Latin America.

Quick Start

# Set your credentials
export TIENDANUBE_ACCESS_TOKEN="your-access-token"
export TIENDANUBE_STORE_ID="your-store-id"

# Run via stdio
npx tsx packages/argentina/tienda-nube/src/index.ts

# Run via HTTP
npx tsx packages/argentina/tienda-nube/src/index.ts --http

Environment Variables

Variable	Required	Description
`TIENDANUBE_ACCESS_TOKEN`	Yes	Access token from Tienda Nube
`TIENDANUBE_STORE_ID`	Yes	Store identifier
`MCP_HTTP`	No	Set to `"true"` to enable HTTP transport
`MCP_PORT`	No	HTTP port (default: 3000)

Tools (24)

Tool	Purpose
`list_products`	List products from the store
`get_product`	Get product details by ID
`create_product`	Create a new product
`update_product`	Update an existing product
`list_orders`	List orders
`get_order`	Get order details by ID
`list_customers`	List customers
`get_customer`	Get customer details by ID
`list_categories`	List product categories
`update_order_status`	Update order fulfillment/shipping status
`delete_product`	Delete a product by ID
`list_product_variants`	List variants of a product
`update_product_variant`	Update a product variant (price, stock, sku, weight)
`close_order`	Close an order (mark as fulfilled/closed)
`cancel_order`	Cancel an order, optionally restocking and refunding
`create_category`	Create a product category
`update_category`	Update a product category
`delete_category`	Delete a product category by ID
`list_webhooks`	List configured webhooks
`create_webhook`	Subscribe to a webhook event
`delete_webhook`	Delete a webhook by ID
`list_discount_coupons`	List discount coupons
`create_discount_coupon`	Create a discount coupon
`list_abandoned_carts`	List abandoned checkouts

Auth

Uses Bearer token authentication. Obtain your access token via the Tienda Nube Partners OAuth flow. The store ID is included in the API base URL.

API Reference

Tienda Nube API Docs

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

Authentication

Set these environment variables before launching the server:

TIENDANUBE_ACCESS_TOKEN (required, secret) — Access token for Tienda Nube
TIENDANUBE_STORE_ID (required) — Store identifier

Issue credentials at the provider's developer portal: https://tiendanube.github.io.

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

Read the getting-started guide

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.