Skip to main content
Glama
Tienda Nube MCP Server

Tienda Nube MCP Server

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_info

  • Produtos: 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 install

  • Compile o projeto: npm run build

Execução

  • Stdio (MCP padrão): npm start

  • HTTP 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_info

  • Listar 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 tools
tiendanube_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

    C2.8/5.0

    Scored across 121 tools

    Disambiguation2/5

    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.

    Naming Consistency4/5

    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.

    Tool Count1/5

    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.

    Completeness3/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      MCP 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
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server for Nuvemshop e-commerce platform, enabling AI agents to manage products, orders, customers, categories, and coupons via official API with OAuth authentication.
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables managing Amazon seller listings, orders, pricing, inventory, and reports through the SP-API via MCP tools.
      15
      26 npm
      4
      MIT