home / mcp / tiendanube mcp server

Tiendanube MCP Server

Provides a Docker-enabled MCP server for Tiendanube/Nuvemshop with SSE and HTTP transports to manage products, orders, customers, and more.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "alexandreproenca-nuvemshop-mcp-server": {
      "url": "http://localhost:8080/sse",
      "headers": {
        "MCP_HOST": "0.0.0.0",
        "MCP_PORT": "8080",
        "LOG_LEVEL": "INFO",
        "MCP_TRANSPORT": "sse",
        "TIENDANUBE_BASE_URL": "https://api.tiendanube.com/v1",
        "TIENDANUBE_STORE_ID": "YOUR_STORE_ID",
        "TIENDANUBE_ACCESS_TOKEN": "YOUR_ACCESS_TOKEN"
      }
    }
  }
}

You can run a Tiendanube MCP Server to synchronize and interact with Tiendanube/Nuvemshop data using modern transports like Server-Sent Events and HTTP. This server provides structured endpoints to manage products, orders, customers, categories, coupons, and store information, enabling real-time updates and efficient data operations from your MCP clients.

How to use

You will connect your MCP client to the server using one of the available transports. The default transport is SSE, accessible via a dedicated endpoint that streams data and responses in real time. If you prefer a more traditional HTTP-based request/response flow, you can switch to the streamable HTTP transport and communicate through the designated HTTP endpoint. Use the appropriate method names (endpoints) exposed by the server to list, create, update, or delete resources such as products, orders, customers, categories, and coupons. The server handles authentication with Tiendanube credentials and routes requests to the Tiendanube API resources.

How to install

Prerequisites you need before installation are Docker and Docker Compose. You also need Tiendanube API credentials, specifically an Access Token and a Store ID.

Step by step, you can set up the MCP server as follows:

mkdir tiendanube-mcp
cd tiendanube-mcp

# Create essential files for the server locally
# The main server code file (example): tiendanube_server.py
# Docker configuration files: Dockerfile, docker-compose.yml
# Dependency listing: requirements.txt
# Environment configuration: .env (based on provided template)

Additional sections

Configuration and environment - Prepare an environment file that includes your Tiendanube credentials and server settings. Include values for TIENDANUBE_ACCESS_TOKEN, TIENDANUBE_STORE_ID, TIENDANUBE_BASE_URL, MCP_TRANSPORT, MCP_HOST, MCP_PORT, and LOG_LEVEL as required by your deployment.

Transport and endpoints - SSE transport endpoint: http://localhost:8080/sse - Streamable HTTP transport endpoint: http://localhost:8080/mcp - You can switch transports by adjusting MCP_TRANSPORT in the environment configuration.

Health check - Verify the server is running by querying the health endpoint: curl http://localhost:8080/health

Security notes - Do not commit the .env file to version control. Use separate tokens for development and production. Consider enabling HTTPS behind a reverse proxy. Apply rate limiting and configure CORS for public exposure.

Logging and maintenance - Logs are rotated and stored within Docker logs. Use docker-compose logs to view active output and diagnose issues.

Updating the server - Pull changes, rebuild images, and restart to apply updates. Use docker-compose down, docker-compose build --no-cache, and docker-compose up -d in sequence.

Troubleshooting common issues - If the server won’t start, inspect logs with docker-compose logs tiendanube-mcp and validate environment variables with docker-compose config. If connectivity to Tiendanube fails, verify your credentials and store ID.

Available tools

list_products

List and search products with filters such as stock, price, categories, and SKU.

get_product

Retrieve a product by ID.

get_product_by_sku

Retrieve a product by SKU.

create_product

Create a new product with variants.

update_product

Update product information.

delete_product

Delete a product.

update_product_stock_price

Bulk update stock and prices for products.

list_orders

List orders with filters.

get_order

Get order details.

get_order_history_values

Get value change history for an order.

get_order_history_editions

Get edition changelog for an order.

create_order

Create a new order.

update_order

Update an order.

close_order

Close an order.

open_order

Reopen an order.

cancel_order

Cancel an order.

list_customers

List or search customers.

get_customer

Get customer details.

create_customer

Create a new customer.

update_customer

Update customer information.

delete_customer

Delete a customer.

list_categories

List all categories.

get_category

Get category details.

create_category

Create a category.

update_category

Update a category.

delete_category

Delete a category.

list_coupons

List all coupons.

get_coupon

Get coupon details.

create_coupon

Create a discount coupon.

get_store

Get store information.