@codespar/mcp-tienda-nube
v0.2.2
Published
MCP server for Tienda Nube — LATAM e-commerce platform
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 --httpEnvironment 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
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 NubeTIENDANUBE_STORE_ID(required) — Store identifier
Issue credentials at the provider's developer portal: https://tiendanube.github.io.
License
MIT
