Tienda Nube MCP Server
Click on "Deploy 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., "@Tienda Nube MCP Server list products with low stock"
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.
Tienda Nube MCP Server
Servidor MCP (Model Context Protocol) para integrar com a API da Tienda Nube/Nuvemshop.
Este servidor expõe ferramentas MCP abrangendo os principais recursos da API v1:
Autenticação e informações da loja:
tiendanube_get_store_infoProdutos: listar, buscar, obter, criar, atualizar, excluir
Pedidos: listar, obter, criar, atualizar, cancelar, fulfillment
Clientes: listar, buscar, obter, criar, atualizar, excluir
Categorias: listar, obter, criar, atualizar, excluir
Cupons: listar, obter, criar, atualizar, excluir
Webhooks: listar, obter, criar, atualizar, excluir
Requisitos
Node.js 18+
Variáveis de ambiente:
TIENDANUBE_ACCESS_TOKEN(obrigatório)TIENDANUBE_STORE_ID(obrigatório)
Instalação
Instale as dependências:
npm installCompile o projeto:
npm run build
Execução
Stdio (MCP padrão):
npm startHTTP utilitário:
npm run start:http(endpoint de saúde em/health)
Configuração do Cliente MCP
Adicione no seu cliente MCP (por exemplo, Claude Desktop) apontando para o binário ou para node dist/index.js.
Ferramentas Disponíveis Liste as ferramentas via MCP (ListTools). O servidor registra mais de 35 ferramentas cobrindo:
tiendanube_*product*tiendanube_*order*tiendanube_*customer*tiendanube_*category*tiendanube_*coupon*tiendanube_*webhook*
Exemplos de Uso (MCP CallTool)
Obter info da loja:
tiendanube_get_store_infoListar produtos:
tiendanube_list_products(args opcionais:page,per_page,language,q, etc.)Criar produto:
tiendanube_create_product(campos multilíngues e variantes suportados)Listar pedidos:
tiendanube_list_orders(filtros por status, pagamento, datas)Criar pedido:
tiendanube_create_order(cliente, itens, endereços)Gerenciar webhooks:
tiendanube_list_webhooks|tiendanube_create_webhook|tiendanube_update_webhook|tiendanube_delete_webhook
Notas Importantes
Rate limit e backoff: o cliente implementa retry para 429/5xx.
Serialização segura: respostas são sanitizadas para JSON.
Multi‑idioma: diversos campos aceitam
es,pt,en.
Problemas e Próximos Passos Se você precisar de recursos extras da documentação oficial (por exemplo, operações dedicadas para variantes ou imagens fora do payload do produto), abra uma issue ou peça aqui que eu adiciono as ferramentas MCP correspondentes.
Available Tools
121 toolstiendanube_add_cart_itemC
ADD CART ITEM - Add a variant to the cart (by id or token) with the desired quantity.
Inputs: variant_id (required), quantity (required), cart_id, cart_token.
tiendanube_add_coupon_to_abandoned_checkoutB
➕ ADD COUPON TO ABANDONED CHECKOUT - Add a discount coupon to an abandoned checkout.
Inputs: cart_id (required), coupon_id (required).
tiendanube_apply_cart_couponB
APPLY CART COUPON - Apply a discount coupon code to the cart.
Inputs: code (required), cart_id, cart_token.
tiendanube_cancel_orderA
❌ CANCEL ORDER - Cancel an existing order and optionally specify the cancellation reason. Use this for order cancellations due to customer requests, fraud detection, inventory issues, or other business reasons. Sets order status to 'cancelled' and may trigger automatic refund processes depending on payment status. Important for order management and customer service.
Inputs: order_id (required), reason.
tiendanube_clear_cartB
CLEAR CART - Remove all items from the cart.
Inputs: cart_id, cart_token.
tiendanube_close_orderC
CLOSE ORDER - Close (archive) an order.
Inputs: order_id (required).
tiendanube_confirm_draft_orderA
CONFIRM DRAFT ORDER - Confirm a draft order and convert it to a regular order.
Inputs: draft_order_id (required).
tiendanube_create_business_ruleB
Create a new business rule for filtering products, customers, or orders
Inputs: name (required), type (required), conditions (required), actions (required), +2 more.
tiendanube_create_categoryA
➕ CREATE NEW CATEGORY - Create a new product category with multi-language support and hierarchical organization. Use this for expanding catalog structure, organizing products, improving navigation, and setting up category-based promotions. Supports parent-child relationships for subcategories, localized names/descriptions, and Google Shopping integration for enhanced marketing.
Inputs: name_es (required), name_pt, name_en, description_es, +4 more.
tiendanube_create_couponA
➕ CREATE NEW COUPON - Create promotional discount coupons for marketing campaigns and customer incentives. Use this for launching sales, customer retention, first-time buyer discounts, and seasonal promotions. Supports percentage or fixed amount discounts, usage limits, validity periods, minimum order values, and product/category restrictions. Powerful tool for driving sales and customer engagement.
Inputs: code (required), type (required), value (required), valid, +6 more.
tiendanube_create_customerA
➕ CREATE NEW CUSTOMER - Create a new customer account with complete profile information. Use this for customer registration, manual account creation, bulk imports, or integrating with external systems. Requires name and email as minimum fields. Supports phone, identification documents, addresses, notes, passwords, and email invitation sending. Ideal for onboarding and customer management.
Inputs: name (required), email (required), password, send_invitation, +10 more.
tiendanube_create_draft_orderC
CREATE DRAFT ORDER - Create a new draft order (quote) with customer and product information.
Inputs: contact_name (required), contact_lastname (required), contact_email (required), payment_status (required), +6 more.
tiendanube_create_fulfillment_eventB
Create a tracking event for a fulfillment order
Inputs: order_id (required), fulfillment_order_id (required), status (required), happened_at (required), +7 more.
tiendanube_create_fulfillment_orderC
Create a new fulfillment order for specific line items
Inputs: order_id (required), line_items (required), location_id, tracking_company, +3 more.
tiendanube_create_invoiceC
CREATE INVOICE - Create an invoice for an order.
Inputs: order_id (required).
tiendanube_create_metafieldC
CREATE METAFIELD - Create a metafield for a given owner resource/id.
Inputs: owner_resource (required), owner_id (required), key (required), value (required), +2 more.
tiendanube_create_orderA
➕ CREATE NEW ORDER - Create a new order programmatically with complete customer and product information. Use this for manual order creation, bulk imports, external integrations, or processing orders from other channels. Requires customer details (name, email), product variants with quantities, and billing address. Supports custom pricing, shipping options, payment gateway selection, and inventory management.
Inputs: customer_name (required), customer_email (required), products (required), billing_address (required), +29 more.
tiendanube_create_productB
Create a new product in the store. At minimum requires name and price. Supports multiple languages, variants, images, categories, and extensive metadata.
Inputs: name_es (required), price (required), name_pt, name_en, +22 more.
tiendanube_create_product_custom_fieldC
Create a new product custom field
Inputs: name (required), value_type (required), description, values.
tiendanube_create_product_imageB
Create/add a new image to a product.
Inputs: product_id (required), src (required), position, alt.
tiendanube_create_product_variantC
Create a new variant for a product (price, stock, sku, etc.)
Inputs: product_id (required), price (required), promotional_price, stock, +7 more.
tiendanube_create_product_variant_custom_fieldC
Create a new product variant custom field
Inputs: name (required), value_type (required), description, values.
tiendanube_create_script_tagA
CREATE SCRIPT TAG - Register a new script tag (HTTPS URL only).
Inputs: src (required), event.
tiendanube_create_transactionA
Create a new transaction for an order. Used by payment providers to register payment attempts.
Inputs: order_id (required), payment_provider_id (required), payment_method (required), first_event (required), +1 more.
tiendanube_create_transaction_eventB
Create a new event for an existing transaction (capture, refund, void, etc.)
Inputs: order_id (required), transaction_id (required), type (required), status (required), +3 more.
tiendanube_create_webhookA
➕ CREATE NEW WEBHOOK - Set up real-time event notifications for external system integrations. Use this to establish automated workflows, sync data with external platforms, trigger business processes, and maintain real-time system connectivity. Supports all major store events including orders, customers, products, and categories. Requires HTTPS endpoints for security compliance.
Inputs: url (required), event (required).
tiendanube_delete_business_ruleC
Delete a business rule
Inputs: business_rule_id (required).
tiendanube_delete_categoryA
🗑️ DELETE CATEGORY - Permanently remove a product category from the store catalog. ⚠️ WARNING: Products in this category will be automatically moved to the parent category or become uncategorized. Use this for catalog cleanup, removing obsolete categories, or restructuring product organization. Consider the impact on navigation and product findability before deletion.
Inputs: category_id (required).
tiendanube_delete_couponA
🗑️ DELETE COUPON - Permanently remove a discount coupon from the store. ⚠️ WARNING: This action is irreversible and will immediately invalidate the coupon for all customers, including those who may already have it saved. Use this for cleaning up expired promotions, removing unused coupons, or terminating problematic discount codes. Consider deactivating instead of deleting if usage tracking is important.
Inputs: coupon_id (required).
tiendanube_delete_draft_orderC
DELETE DRAFT ORDER - Delete a specific draft order.
Inputs: draft_order_id (required).
tiendanube_delete_fulfillment_orderB
Delete a fulfillment order (cancels the fulfillment)
Inputs: order_id (required), fulfillment_order_id (required).
tiendanube_delete_metafieldC
DELETE METAFIELD - Delete a metafield by ID.
Inputs: metafield_id (required).
tiendanube_delete_product_custom_fieldA
Delete a product custom field (only custom fields created by current app)
Inputs: custom_field_id (required).
tiendanube_delete_product_variant_custom_fieldA
Delete a product variant custom field (only custom fields created by current app)
Inputs: custom_field_id (required).
tiendanube_delete_script_tagB
DELETE SCRIPT TAG - Remove a script tag.
Inputs: script_tag_id (required).
tiendanube_generate_checkout_sdk_templateB
Generate a Checkout SDK integration template (script tag + skeleton code and guidance).
Inputs: version, language, features, payment_provider_hint, +1 more.
tiendanube_get_abandoned_checkoutA
🔎 GET ABANDONED CHECKOUT - Retrieve a single abandoned checkout by ID, including customer, items and totals. Omit fields (or set to all/*) to return everything.
Inputs: checkout_id (required), fields.
tiendanube_get_business_ruleC
Get details of a specific business rule
Inputs: business_rule_id (required).
tiendanube_get_cartA
GET CART - Retrieve a shopping cart by numeric id or token. Returns items, totals and metadata.
Inputs: cart_id, cart_token, fields.
tiendanube_get_categoryA
🔍 GET SPECIFIC CATEGORY - Retrieve complete details for a single product category by its unique ID. Use this when you need comprehensive category information including localized names, descriptions, SEO metadata, parent-child relationships, subcategories, and product associations. Essential for category management, SEO optimization, and catalog organization.
Inputs: category_id (required), fields, language.
tiendanube_get_category_custom_fieldsB
GET CATEGORY CUSTOM FIELDS - Retrieve all custom fields for a category.
Inputs: category_id (required).
tiendanube_get_checkoutA
GET CHECKOUT - Retrieve checkout by ID, including items, customer, totals and status.
Inputs: checkout_id (required), fields.
tiendanube_get_couponA
🔍 GET SPECIFIC COUPON - Retrieve complete details for a single discount coupon by its unique ID. Use this when you need comprehensive coupon information including discount value, type, usage statistics, validity period, restrictions, and performance metrics. Essential for coupon management, customer support queries, and promotional analysis.
Inputs: coupon_id (required), fields.
tiendanube_get_customerA
🔍 GET SPECIFIC CUSTOMER - Retrieve complete details for a single customer by their unique ID. Use this when you need comprehensive customer information including personal details, contact info, billing/shipping addresses, total spent, last order, account status, and custom extra fields. Essential for customer service, account management, and personalized marketing.
Inputs: customer_id (required), fields.
tiendanube_get_custom_field_ownersB
List products associated with a specific custom field
Inputs: custom_field_id (required), per_page, page.
tiendanube_get_discountC
GET DISCOUNT - Retrieve a discount by ID.
Inputs: discount_id (required).
tiendanube_get_disputeC
Get details of a specific dispute
Inputs: dispute_id (required).
tiendanube_get_draft_orderB
GET DRAFT ORDER - Retrieve a single draft order by ID.
Inputs: draft_order_id (required), fields.
tiendanube_get_fulfillment_orderB
Get details of a specific fulfillment order
Inputs: order_id (required), fulfillment_order_id (required).
tiendanube_get_invoiceB
GET INVOICE - Retrieve an invoice for an order.
Inputs: order_id (required).
tiendanube_get_locationC
GET LOCATION - Retrieve a single location by ID.
Inputs: location_id (required), fields.
tiendanube_get_metafieldB
GET METAFIELD - Retrieve a single metafield by ID.
Inputs: metafield_id (required).
tiendanube_get_orderA
🔍 GET SPECIFIC ORDER - Retrieve complete details for a single order by its unique ID. Use this when you need comprehensive information about a specific order including customer data, product line items, pricing, shipping address, payment details, fulfillment status, tracking info, and order history. Essential for order processing, customer service, and detailed analysis.
Inputs: order_id (required), fields.
tiendanube_get_order_custom_fieldsB
GET ORDER CUSTOM FIELDS - Retrieve all custom fields for a specific order.
Inputs: order_id (required).
tiendanube_get_order_edit_historyB
GET ORDER EDIT HISTORY - Retrieve a log of all changes made to an order.
Inputs: order_id (required).
tiendanube_get_order_fulfillmentA
📦 GET ORDER FULFILLMENT - Retrieve detailed fulfillment and shipping information for a specific order. Use this to track order fulfillment status, shipping details, carrier information, tracking numbers, delivery dates, and fulfillment order line items. Essential for logistics management, customer support, and shipping status updates.
Inputs: order_id (required).
tiendanube_get_order_transactionA
GET ORDER TRANSACTION - Retrieve a single transaction by order and transaction IDs.
Inputs: order_id (required), transaction_id (required).
tiendanube_get_order_value_historyB
GET ORDER VALUE HISTORY - Get a history of an order's total value changes.
Inputs: order_id (required).
tiendanube_get_payment_optionC
GET PAYMENT OPTION - Retrieve a payment option by ID.
Inputs: option_id (required), fields.
tiendanube_get_payment_providerC
GET PAYMENT PROVIDER - Retrieve a provider by ID.
Inputs: provider_id (required), fields.
tiendanube_get_productA
Get detailed information about a specific product by ID, including variants, images, categories, and all metadata.
Inputs: product_id (required), fields, language.
tiendanube_get_product_custom_fieldA
Get details of a specific product custom field by ID
Inputs: custom_field_id (required).
tiendanube_get_product_variantB
Get a specific variant of a product by ID.
Inputs: product_id (required), variant_id (required).
tiendanube_get_product_variant_custom_fieldB
Get details of a specific product variant custom field by ID
Inputs: custom_field_id (required).
tiendanube_get_script_tagB
GET SCRIPT TAG - Retrieve a single script tag by ID.
Inputs: script_tag_id (required), fields.
tiendanube_get_shipping_carrierB
GET SHIPPING CARRIER - Retrieve a single carrier by ID.
Inputs: carrier_id (required).
tiendanube_get_store_infoB
Get basic information about the authenticated store including name, plan, configuration, and available features.
Inputs: no named parameters.
tiendanube_get_store_settingsA
Get extended store settings including languages, design, features and domains (from /store).
Inputs: no named parameters.
tiendanube_get_variant_custom_field_ownersC
List product variants associated with a specific custom field
Inputs: custom_field_id (required), per_page, page.
tiendanube_get_webhookA
🔍 GET SPECIFIC WEBHOOK - Retrieve complete details for a single webhook configuration by its unique ID. Use this when you need comprehensive webhook information including endpoint URL, event type, authentication settings, delivery status, and error logs. Essential for webhook troubleshooting, configuration verification, and integration maintenance.
Inputs: webhook_id (required), fields.
tiendanube_list_abandoned_checkoutsA
🧾 LIST ABANDONED CHECKOUTS - Retrieve paginated abandoned checkouts with filters. Use to analyze recovery opportunities, filter by dates or email, and export leads.
Inputs: page, per_page, fields, since_id, +6 more.
tiendanube_list_business_rulesC
List all business rules with filtering options
Inputs: per_page, page, type, status.
tiendanube_list_categoriesA
📂 LIST ALL CATEGORIES - Retrieve a hierarchical list of product categories with filtering and localization support. Use this for catalog management, navigation setup, category analytics, and organizing products. Supports filtering by parent category, text search, date ranges, and multi-language content. Returns category tree structure with names, descriptions, and product counts.
Inputs: page, per_page, fields, since_id, +7 more.
tiendanube_list_couponsA
🎫 LIST ALL COUPONS - Retrieve a comprehensive list of discount coupons with advanced filtering options. Use this for promotional campaign management, coupon analytics, expired coupon cleanup, and marketing strategy analysis. Supports filtering by code, discount type (percentage/fixed), validity status, date ranges, and usage statistics. Essential for e-commerce marketing and sales optimization.
Inputs: page, per_page, fields, since_id, +7 more.
tiendanube_list_customersA
👥 LIST ALL CUSTOMERS - Retrieve a paginated list of store customers with filtering and search capabilities. Use this for customer management, analytics, segmentation, and finding specific customers. Supports filtering by creation/update dates, text search by name/email/identification, and pagination for large customer bases. Returns customer profiles with contact info, spending totals, and order history.
Inputs: page, per_page, fields, since_id, +5 more.
tiendanube_list_discountsC
LIST DISCOUNTS - Retrieve store discounts (read-only).
Inputs: page, per_page, fields, since_id.
tiendanube_list_disputesC
List all disputes with filtering options
Inputs: per_page, page, status, reason, +2 more.
tiendanube_list_draft_ordersB
LIST DRAFT ORDERS - Retrieve paginated draft orders (quotes) with optional date filters.
Inputs: page, per_page, fields, since_id, +4 more.
tiendanube_list_fulfillment_ordersA
List all fulfillment orders for a specific order with filtering options
Inputs: order_id (required), per_page, page, status, +4 more.
tiendanube_list_locationsC
LIST LOCATIONS - Retrieve store locations with pagination and date filters.
Inputs: page, per_page, fields, since_id, +4 more.
tiendanube_list_metafieldsC
LIST METAFIELDS - List metafields, optionally filtered by owner_resource and owner_id.
Inputs: owner_resource, owner_id, key, namespace, +2 more.
tiendanube_list_ordersA
📋 LIST ALL ORDERS - Retrieve a paginated list of store orders with comprehensive filtering capabilities. Use this for order management, analytics, and finding specific orders. Supports filtering by status, payment state, shipping status, date ranges, total values, customer IDs, and text search. Returns order details including customer info, products, totals, and fulfillment data.
Inputs: page, per_page, fields, since_id, +16 more.
tiendanube_list_order_transactionsB
LIST ORDER TRANSACTIONS - Retrieve transactions for a given order.
Inputs: order_id (required), page, per_page.
tiendanube_list_payment_optionsC
LIST PAYMENT OPTIONS - Dedicated endpoint for payment options.
Inputs: page, per_page, fields, since_id.
tiendanube_list_payment_providersA
List available payment providers configured in the store (extracted from /store).
Inputs: no named parameters.
tiendanube_list_payment_providers_dedicatedC
LIST PAYMENT PROVIDERS - Dedicated endpoint for payment providers.
Inputs: page, per_page, fields, since_id.
tiendanube_list_product_custom_fieldsB
List all product custom fields with pagination support
Inputs: per_page, page.
tiendanube_list_product_imagesC
List all images for a product.
Inputs: product_id (required).
tiendanube_list_productsA
List all products in the store with optional filtering, pagination, and sorting. Supports filtering by category, stock levels, dates, and various other criteria.
Inputs: page, per_page, fields, ids, +18 more.
tiendanube_list_product_variant_custom_fieldsC
List all product variant custom fields with pagination support
Inputs: per_page, page.
tiendanube_list_product_variantsA
List all variants for a given product, including price, stock and SKU.
Inputs: product_id (required).
tiendanube_list_script_tagsC
LIST SCRIPT TAGS - Retrieve all script tags registered by the app.
Inputs: page, per_page, fields, since_id, +5 more.
tiendanube_list_shipping_carriersC
LIST SHIPPING CARRIERS - Retrieve shipping carriers configured for the store.
Inputs: page, per_page, fields.
tiendanube_list_shipping_providersA
List available shipping providers configured in the store (extracted from /store).
Inputs: no named parameters.
tiendanube_list_webhooksA
🔗 LIST ALL WEBHOOKS - Retrieve all configured webhook endpoints for real-time event notifications. Use this for integration management, webhook monitoring, debugging connectivity issues, and auditing external system integrations. Supports filtering by URL, event type, and date ranges. Essential for maintaining API integrations and event-driven architectures.
Inputs: page, per_page, fields, since_id, +6 more.
tiendanube_mark_order_as_paidC
MARK ORDER AS PAID - Mark an order as paid.
Inputs: order_id (required).
tiendanube_remove_cart_itemB
REMOVE CART ITEM - Remove an item from the cart by item_id or variant_id (we'll resolve the item id when needed).
Inputs: cart_id, cart_token, item_id, variant_id.
tiendanube_reopen_orderB
REOPEN ORDER - Reopen a previously closed order.
Inputs: order_id (required).
tiendanube_search_customersA
🔎 SEARCH CUSTOMERS - Find customers using text search across names, emails, and identification numbers. Use this for quick customer lookup, support queries, order assignment, and customer service scenarios. Supports pagination for large result sets. More flexible than listing with specific filters when you need fuzzy matching or don't know exact customer details.
Inputs: query (required), page, per_page.
tiendanube_search_productsA
Search for products using a text query. Supports pagination and filtering by category and publication status.
Inputs: query (required), page, per_page, language, +2 more.
tiendanube_send_abandoned_checkout_recovery_emailB
📧 SEND RECOVERY EMAIL - Trigger the recovery email for an abandoned checkout (if supported by API/version). Falls back gracefully if unsupported.
Inputs: checkout_id (required), language.
tiendanube_update_business_ruleB
Update an existing business rule
Inputs: business_rule_id (required), name, description, status, +2 more.
tiendanube_update_cart_item_quantityA
UPDATE CART ITEM QTY - Update line item quantity by item_id or variant_id (fallback removes+adds).
Inputs: quantity (required), cart_id, cart_token, item_id, +1 more.
tiendanube_update_categoryA
✏️ UPDATE CATEGORY - Modify existing category information including names, descriptions, and hierarchy relationships. Use this for category management, localization updates, SEO improvements, and reorganizing catalog structure. Supports multi-language content updates and parent category changes. Only provided fields will be updated, preserving existing data.
Inputs: category_id (required), name_es, name_pt, name_en, +5 more.
tiendanube_update_category_custom_fieldsB
UPDATE CATEGORY CUSTOM FIELDS - Replace or set custom fields for a category.
Inputs: category_id (required), custom_fields (required).
tiendanube_update_couponB
✏️ UPDATE COUPON - Modify existing discount coupon settings including discount value, validity period, usage limits, and restrictions. Use this for adjusting promotional campaigns, extending coupon validity, changing discount amounts, updating usage limits, and managing coupon lifecycle. Essential for dynamic marketing strategies and campaign optimization.
Inputs: coupon_id (required), code, type, value, +7 more.
tiendanube_update_customerA
✏️ UPDATE CUSTOMER - Modify existing customer information including personal details, contact information, and internal notes. Use this for customer profile updates, data corrections, preference changes, and maintaining accurate customer records. All fields are optional except customer_id - only provided fields will be updated, preserving existing data.
Inputs: customer_id (required), name, email, password, +10 more.
tiendanube_update_disputeB
Update a dispute status and provide response with evidence
Inputs: dispute_id (required), status (required), response, evidence.
tiendanube_update_fulfillment_orderC
Update an existing fulfillment order
Inputs: order_id (required), fulfillment_order_id (required), status, location_id, +4 more.
tiendanube_update_metafieldC
UPDATE METAFIELD - Update a metafield value by ID.
Inputs: metafield_id (required), value (required).
tiendanube_update_orderA
✏️ UPDATE ORDER - Modify specific fields of an existing order. Use this to update order status (open/closed/cancelled) or add internal owner notes for order management. Limited to certain fields after order creation to maintain data integrity. Commonly used for order state management and adding administrative comments.
Inputs: order_id (required), owner_note, status.
tiendanube_update_order_custom_fieldsB
UPDATE ORDER CUSTOM FIELDS - Replace or set custom fields for an order.
Inputs: order_id (required), custom_fields (required).
tiendanube_update_productB
Update an existing product. All fields are optional except product_id. Only provided fields will be updated.
Inputs: product_id (required), name_es, name_pt, name_en, +22 more.
tiendanube_update_product_custom_fieldC
Update an existing product custom field
Inputs: custom_field_id (required), name, description, values.
tiendanube_update_product_custom_field_valuesC
Associate or disassociate custom field values with a specific product
Inputs: product_id (required), custom_fields (required).
tiendanube_update_product_imageB
Update product image properties (src, position, alt).
Inputs: product_id (required), image_id (required), src, position, +1 more.
tiendanube_update_product_variantB
Update an existing variant for a product.
Inputs: product_id (required), variant_id (required), price, promotional_price, +8 more.
tiendanube_update_product_variant_custom_fieldC
Update an existing product variant custom field
Inputs: custom_field_id (required), name, description, values.
tiendanube_update_product_variant_custom_field_valuesC
Associate or disassociate custom field values with a specific product variant
Inputs: product_id (required), variant_id (required), custom_fields (required).
tiendanube_update_script_tagB
UPDATE SCRIPT TAG - Update the URL or event of a script tag.
Inputs: script_tag_id (required), src, event.
tiendanube_update_webhookA
✏️ UPDATE WEBHOOK - Modify existing webhook configuration including endpoint URL and event type. Use this for changing integration endpoints, updating event subscriptions, fixing broken webhook URLs, and adapting to system changes. Essential for maintaining active integrations and ensuring continuous data flow between systems.
Inputs: webhook_id (required), url, event.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 121 tools
Several tool groups have overlapping boundaries, such as list_payment_providers vs list_payment_providers_dedicated, get_order_fulfillment vs get_fulfillment_order vs list_fulfillment_orders, and product/variant custom fields vs metafields. The scale and similar verb_noun names across many related entities make it easy for an agent to select the wrong tool.
All tools consistently use the tiendanube_ prefix with snake_case verb_noun naming, and the common list/get/create/update/delete verbs are applied predictably. Minor deviations like add/remove/apply/clear/mark/confirm and the dedicated vs /store variants slightly weaken the pattern.
121 tools is far beyond a reasonable MCP tool surface and falls into the extreme-mismatch range. Many tools are near-duplicates or very narrow endpoint wrappers that could be consolidated.
The tool surface is extremely broad and covers orders, products, customers, categories, coupons, carts, checkouts, fulfillment, disputes, invoices, webhooks, and more. However, basic lifecycle operations like deleting a product, product variant, or product image are missing, which is a notable gap for an ecommerce catalog.
Maintenance
Related MCP Connectors
Unified MCP server for 70+ eCommerce platforms: products, orders, customers, and more.
Nuvemshop (Tiendanube) e-commerce platform, your store's products, orders, customers, categories and
Hosted Argentine commerce MCP: real AFIP invoicing, MercadoPago, logistics, catalog & WhatsApp.
The Mercado Pago MCP Server implements the Model Context Protocol to provide AI agents and LLMs with access to Mercado Pago's APIs and tools within compatible development environments. It acts as an intermediary that translates Mercado Pago resources into executable functions (tools) that AI applications can invoke to perform actions and automate flows. The server simplifies integration, enables using documentation to implement or improve code, and optimizes operations through natural language interactions without manual implementations.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables comprehensive management of Tiendanube and Nuvemshop stores, supporting operations for products, orders, customers, and categories. It provides flexible integration through SSE, HTTP, and STDIO transport modes with full Docker support.6MIT
- FlicenseNot gradedqualityDmaintenanceMCP server that exposes all 111 endpoints of the Tienda Nube API as tools for Cursor (or other MCP clients) to code directly with the API.15-
- AlicenseNot gradedqualityDmaintenanceMCP server for Nuvemshop e-commerce platform, enabling AI agents to manage products, orders, customers, categories, and coupons via official API with OAuth authentication.MIT
- AlicenseAqualityBmaintenanceEnables managing Amazon seller listings, orders, pricing, inventory, and reports through the SP-API via MCP tools.1526 npm4MIT