Tiendanube MCP Server
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Tiendanube MCP Serverlist all products with stock lower than 10 units"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Tiendanube MCP Server - Docker Setup
A complete Model Context Protocol (MCP) server for Tiendanube/Nuvemshop API with Docker support and SSE transport.
🚀 Features
Resources
Products: Full CRUD with advanced filtering (stock, price, categories, SKU)
Orders: Complete order management with history tracking
Customers: Customer management with addresses and billing
Categories: Category hierarchy management
Coupons: Discount coupon management
Store: Store information and settings
Transport Modes
✅ SSE (Server-Sent Events) - For web-based clients
✅ Streamable HTTP - Modern HTTP transport
✅ STDIO - For CLI/terminal usage
Related MCP server: MCP VTEX Server
📋 Prerequisites
Docker and Docker Compose
Tiendanube API credentials:
Access Token
Store ID
🔧 Setup
1. Clone or Create Project Structure
mkdir tiendanube-mcp
cd tiendanube-mcpCreate the following files:
tiendanube_server.py(main server code)Dockerfiledocker-compose.ymlrequirements.txt.env(from.env.example)
2. Configure Environment Variables
Create .env file:
TIENDANUBE_ACCESS_TOKEN=your_access_token_here
TIENDANUBE_STORE_ID=your_store_id_here
TIENDANUBE_BASE_URL=https://api.tiendanube.com/v1
# Server Configuration
MCP_TRANSPORT=sse
MCP_HOST=0.0.0.0
MCP_PORT=8080
LOG_LEVEL=INFO3. Build and Run
# Build the Docker image
docker-compose build
# Start the server
docker-compose up -d
# View logs
docker-compose logs -f
# Stop the server
docker-compose down🌐 Accessing the Server
SSE Transport (Default)
URL: http://localhost:8080/sseStreamable HTTP Transport
Change .env:
MCP_TRANSPORT=streamable-httpURL: http://localhost:8080/mcp🔍 Health Check
curl http://localhost:8080/health📊 API Endpoints
Products
list_products- List/search products with filtersget_product- Get product by IDget_product_by_sku- Get product by SKUcreate_product- Create new product with variantsupdate_product- Update product informationdelete_product- Delete productupdate_product_stock_price- Bulk update stock/prices
Orders
list_orders- List orders with filtersget_order- Get order detailsget_order_history_values- Get value change historyget_order_history_editions- Get edition changelogcreate_order- Create new orderupdate_order- Update orderclose_order- Close orderopen_order- Reopen ordercancel_order- Cancel order
Customers
list_customers- List/search customersget_customer- Get customer detailscreate_customer- Create new customerupdate_customer- Update customerdelete_customer- Delete customer
Categories
list_categories- List all categoriesget_category- Get category detailscreate_category- Create categoryupdate_category- Update categorydelete_category- Delete category
Coupons
list_coupons- List all couponsget_coupon- Get coupon detailscreate_coupon- Create discount coupon
Store
get_store- Get store information
🎯 Usage Examples
Connect from Python Client
import requests
import json
# SSE endpoint
url = "http://localhost:8080/sse"
# List products
payload = {
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "list_products",
"arguments": {
"query": "shirt",
"per_page": 10
}
},
"id": 1
}
response = requests.post(url, json=payload)
print(response.json())Connect from cURL
# List products
curl -X POST http://localhost:8080/sse \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "list_products",
"arguments": {
"published": true,
"per_page": 20
}
},
"id": 1
}'Advanced Examples
# Get low stock products
curl -X POST http://localhost:8080/sse \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "list_products",
"arguments": {
"max_stock": 10,
"published": true
}
},
"id": 1
}'
# Create order
curl -X POST http://localhost:8080/sse \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "create_order",
"arguments": {
"products": [{"variant_id": 123456, "quantity": 2}],
"customer": {
"name": "John Doe",
"email": "john@example.com"
},
"payment_status": "paid"
}
},
"id": 1
}'🐳 Docker Commands
# Build
docker-compose build
# Start
docker-compose up -d
# Logs
docker-compose logs -f tiendanube-mcp
# Restart
docker-compose restart
# Stop
docker-compose down
# Remove everything
docker-compose down -v --rmi all
# Shell access
docker exec -it tiendanube-mcp-server bash🔐 Security Notes
Never commit
.envfile - Add to.gitignoreUse environment-specific tokens - Separate dev/prod credentials
Enable HTTPS - Use reverse proxy (nginx/traefik) for production
Rate limiting - Consider adding rate limits for production
CORS configuration - Configure allowed origins if exposing publicly
🔄 Updating
# Pull latest changes
git pull
# Rebuild
docker-compose down
docker-compose build --no-cache
docker-compose up -d📝 Logging
Logs are configured with rotation:
Max size: 10MB per file
Max files: 3
Location: Docker logs (use
docker-compose logs)
View logs:
# All logs
docker-compose logs -f
# Last 100 lines
docker-compose logs --tail=100
# Specific service
docker-compose logs -f tiendanube-mcp🐛 Troubleshooting
Server won't start
# Check logs
docker-compose logs tiendanube-mcp
# Verify environment variables
docker-compose config
# Test API credentials
curl -H "Authentication: bearer YOUR_TOKEN" \
https://api.tiendanube.com/v1/YOUR_STORE_ID/storeConnection refused
Verify port 8080 is not in use:
netstat -tuln | grep 8080Check firewall settings
Ensure container is running:
docker ps
Permission errors
# Fix permissions
chmod +x start.sh🌟 Production Deployment
With Nginx Reverse Proxy
server {
listen 443 ssl http2;
server_name mcp.yourdomain.com;
ssl_certificate /path/to/cert.pem;
ssl_certificate_key /path/to/key.pem;
location /sse {
proxy_pass http://localhost:8080/sse;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection 'upgrade';
proxy_set_header Host $host;
proxy_cache_bypass $http_upgrade;
# SSE specific
proxy_buffering off;
proxy_read_timeout 86400;
}
}With Docker Swarm
docker stack deploy -c docker-compose.yml tiendanubeEnvironment Variables for Production
TIENDANUBE_ACCESS_TOKEN=prod_token
TIENDANUBE_STORE_ID=prod_store_id
MCP_TRANSPORT=sse
MCP_HOST=0.0.0.0
MCP_PORT=8080
LOG_LEVEL=WARNING📚 Resources
📄 License
MIT License - See LICENSE file for details
🤝 Contributing
Contributions are welcome! Please open an issue or submit a pull request.
📧 Support
For issues related to:
This MCP Server: Open a GitHub issue
Tiendanube API: Contact Tiendanube support
MCP Protocol: Check MCP documentation
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Flicense-qualityDmaintenanceEnables interaction with e-commerce storefronts through a standardized API. Provides access to product catalogs, inventory management, and customer operations for online retail platforms.
- AlicenseBqualityDmaintenanceEnables complete VTEX e-commerce platform integration through natural language, allowing management of catalog, inventory, pricing, promotions, orders, marketplace operations, checkout, customer data, and payment configurations via AI conversations.84191MIT
- Alicense-qualityCmaintenanceEnables interaction with Shopify store data via the GraphQL Admin API to manage products, customers, orders, and collections. Supports multi-store configurations and provides comprehensive management tools for e-commerce administration in both local and remote environments.81MIT
- AlicenseBqualityDmaintenanceIntegrates with the Tienda Nube/Nuvemshop API to manage products, orders, customers, categories, coupons, and webhooks through MCP tools.10033MIT
Related MCP Connectors
Nuvemshop (Tiendanube) e-commerce platform, your store's products, orders, customers, categories and
Hosted Argentine commerce MCP: real AFIP invoicing, MercadoPago, logistics, catalog & WhatsApp.
Bling ERP (SMB and e-commerce management, by Locaweb) via the official v3 API, sales orders, product
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/AlexandreProenca/nuvemshop-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server