Synchronity
Qué hace este MCP
Supports product discovery and comparison across connected stores, shopping carts, shipping selection, checkout delegation, and in-chat payments.
Herramientas
Esquema de entrada
{'type': 'object', 'required': ['site_id'], 'properties': {'email': {'type': 'string', 'description': 'Buyer email; arms a back-in-stock alert for any out-of-stock item in items[].'}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['product_id', 'quantity'], 'properties': {'addons': {'type': 'object'}, 'quantity': {'type': 'integer'}, 'product_id': {'type': 'string'}, 'variant_id': {'type': 'string'}}}, 'description': 'Add several products in ONE call instead of calling this tool repeatedly. Each entry: { product_id, quantity, variant_id?, addons? }. Out-of-stock items are reported; pass `email` to auto-arm a back-in-stock alert for them.'}, 'addons': {'type': 'object', 'description': "Selected product add-ons as a map of addon_id -> chosen value(s). For select/radio/boolean pass a single value; for checkbox/multi pass an array; for text/number pass the value. Values for choice add-ons MUST come from the product's addons[].options[].value. Collect any addon with required:true before checkout."}, 'cart_id': {'type': 'string', 'description': 'Cart ID to add the product to'}, 'site_id': {'type': 'string', 'description': 'Registered site ID'}, 'quantity': {'type': 'integer', 'description': 'Quantity to add (must be >= 1)'}, 'product_id': {'type': 'string', 'description': 'Product ID to add'}, 'variant_id': {'type': 'string', 'description': 'Optional product variant ID (e.g., for size/color selection)'}}}
Esquema de salida
{'type': 'object', 'required': ['kind', 'siteId', 'cartId', 'items', 'subtotal', 'total'], 'properties': {'kind': {'const': 'cart'}, 'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'qty': {'type': 'number'}, 'image': {'type': 'string'}, 'title': {'type': 'string'}, 'itemId': {'type': 'string'}, 'lineTotal': {'type': 'string'}, 'unitPrice': {'type': 'string'}, 'removeAction': {'type': 'object', 'properties': {'label': {'type': 'string'}, 'params': {'type': 'object'}, 'toolName': {'type': 'string'}}}, 'setQtyAction': {'type': 'object', 'properties': {'label': {'type': 'string'}, 'params': {'type': 'object'}, 'toolName': {'type': 'string'}}}, 'variantTitle': {'type': 'string'}, 'addonsSummary': {'type': 'string'}}}}, 'total': {'type': 'string'}, 'cartId': {'type': 'string'}, 'siteId': {'type': 'string'}, 'subtotal': {'type': 'string'}, 'discounts': {'type': 'array', 'items': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'amount': {'type': 'string'}}}}}}
Esquema de entrada
{'type': 'object', 'required': ['site_id', 'cart_id', 'code'], 'properties': {'code': {'type': 'string', 'description': 'Coupon or promotional code string'}, 'cart_id': {'type': 'string', 'description': 'Cart ID'}, 'site_id': {'type': 'string', 'description': 'Registered site ID'}}}
Esquema de salida
{'type': 'object', 'required': ['kind', 'siteId', 'cartId', 'items', 'subtotal', 'total'], 'properties': {'kind': {'const': 'cart'}, 'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'qty': {'type': 'number'}, 'image': {'type': 'string'}, 'title': {'type': 'string'}, 'itemId': {'type': 'string'}, 'lineTotal': {'type': 'string'}, 'unitPrice': {'type': 'string'}, 'removeAction': {'type': 'object', 'properties': {'label': {'type': 'string'}, 'params': {'type': 'object'}, 'toolName': {'type': 'string'}}}, 'setQtyAction': {'type': 'object', 'properties': {'label': {'type': 'string'}, 'params': {'type': 'object'}, 'toolName': {'type': 'string'}}}, 'variantTitle': {'type': 'string'}, 'addonsSummary': {'type': 'string'}}}}, 'total': {'type': 'string'}, 'cartId': {'type': 'string'}, 'siteId': {'type': 'string'}, 'subtotal': {'type': 'string'}, 'discounts': {'type': 'array', 'items': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'amount': {'type': 'string'}}}}}}
Esquema de entrada
{'type': 'object', 'required': ['device_code'], 'properties': {'device_code': {'type': 'string', 'description': 'device_code returned by request_delegation'}}}
Esquema de salida
{'type': 'object', 'properties': {'status': {'type': 'string'}, 'delivery': {'type': 'string'}, 'user_code': {'type': 'string'}, 'approvalUrl': {'type': 'string'}, 'device_code': {'type': 'string'}, 'delegation_token': {'type': 'string'}}}
Esquema de entrada
{'type': 'object', 'required': ['site_ids', 'query'], 'properties': {'query': {'type': 'string', 'description': 'Search query for product comparison'}, 'category': {'type': 'string', 'description': 'Filter by category (optional)'}, 'in_stock': {'type': 'boolean', 'description': 'Filter to in-stock items only (optional)'}, 'site_ids': {'type': 'array', 'items': {'type': 'string'}, 'description': 'List of registered site IDs to compare across'}, 'max_price': {'type': 'string', 'description': 'Maximum price filter (optional)'}, 'min_price': {'type': 'string', 'description': 'Minimum price filter (optional)'}}}
Esquema de salida
{'type': 'object', 'properties': {'results': {'type': 'array', 'items': {'type': 'object', 'properties': {'site_id': {'type': 'string'}, 'products': {'type': 'array', 'items': {'type': 'object'}}, 'site_name': {'type': 'string'}}}}}}
Esquema de entrada
{'type': 'object', 'required': ['site_id'], 'properties': {'site_id': {'type': 'string', 'description': 'Registered site ID'}, 'currency': {'type': 'string', 'description': 'ISO 4217 currency code (e.g., "USD", "EUR", "GBP"). Defaults to site currency.'}}}
Esquema de salida
{'type': 'object', 'properties': {'items': {'type': 'array'}, 'cart_id': {'type': 'string'}}}
Esquema de entrada
{'type': 'object', 'required': ['site_id', 'cart_id', 'buyer_delegation_token', 'customer_name', 'customer_email', 'customer_phone', 'shipping_name', 'shipping_line1', 'shipping_city', 'shipping_state', 'shipping_postal_code', 'shipping_country'], 'properties': {'notes': {'type': 'string', 'description': 'Optional order notes'}, 'cart_id': {'type': 'string', 'description': 'Cart ID to checkout'}, 'site_id': {'type': 'string', 'description': 'Registered site ID'}, 'customer_name': {'type': 'string', 'description': 'Full name of the customer placing the order'}, 'shipping_city': {'type': 'string', 'description': 'Shipping city'}, 'shipping_name': {'type': 'string', 'description': 'Recipient full name'}, 'customer_email': {'type': 'string', 'description': 'Email address of the customer placing the order'}, 'customer_phone': {'type': 'string', 'description': 'Customer contact / billing phone number (E.164 preferred, e.g. +233201234567)'}, 'shipping_line1': {'type': 'string', 'description': 'Shipping address line 1 (street)'}, 'shipping_line2': {'type': 'string', 'description': 'Shipping address line 2 (apt/suite) [optional]'}, 'shipping_phone': {'type': 'string', 'description': 'Recipient phone for the shipping address (E.164 preferred); defaults to customer_phone if omitted'}, 'shipping_state': {'type': 'string', 'description': 'Shipping state or province'}, 'shipping_country': {'enum': ['AF', 'AX', 'AL', 'DZ', 'AS', 'AD', 'AO', 'AI', 'AQ', 'AG', 'AR', 'AM', 'AW', 'AU', 'AT', 'AZ', 'BS', 'BH', 'BD', 'BB', 'BY', 'BE', 'BZ', 'BJ', 'BM', 'BT', 'BO', 'BQ', 'BA', 'BW', 'BV', 'BR', 'IO', 'BN', 'BG', 'BF', 'BI', 'CV', 'KH', 'CM', 'CA', 'KY', 'CF', 'TD', 'CL', 'CN', 'CX', 'CC', 'CO', 'KM', 'CG', 'CD', 'CK', 'CR', 'CI', 'HR', 'CU', 'CW', 'CY', 'CZ', 'DK', 'DJ', 'DM', 'DO', 'EC', 'EG', 'SV', 'GQ', 'ER', 'EE', 'SZ', 'ET', 'FK', 'FO', 'FJ', 'FI', 'FR', 'GF', 'PF', 'TF', 'GA', 'GM', 'GE', 'DE', 'GH', 'GI', 'GR', 'GL', 'GD', 'GP', 'GU', 'GT', 'GG', 'GN', 'GW', 'GY', 'HT', 'HM', 'VA', 'HN', 'HK', 'HU', 'IS', 'IN', 'ID', 'IR', 'IQ', 'IE', 'IM', 'IL', 'IT', 'JM', 'JP', 'JE', 'JO', 'KZ', 'KE', 'KI', 'KP', 'KR', 'KW', 'KG', 'LA', 'LV', 'LB', 'LS', 'LR', 'LY', 'LI', 'LT', 'LU', 'MO', 'MG', 'MW', 'MY', 'MV', 'ML', 'MT', 'MH', 'MQ', 'MR', 'MU', 'YT', 'MX', 'FM', 'MD', 'MC', 'MN', 'ME', 'MS', 'MA', 'MZ', 'MM', 'NA', 'NR', 'NP', 'NL', 'NC', 'NZ', 'NI', 'NE', 'NG', 'NU', 'NF', 'MK', 'MP', 'NO', 'OM', 'PK', 'PW', 'PS', 'PA', 'PG', 'PY', 'PE', 'PH', 'PN', 'PL', 'PT', 'PR', 'QA', 'RE', 'RO', 'RU', 'RW', 'BL', 'SH', 'KN', 'LC', 'MF', 'PM', 'VC', 'WS', 'SM', 'ST', 'SA', 'SN', 'RS', 'SC', 'SL', 'SG', 'SX', 'SK', 'SI', 'SB', 'SO', 'ZA', 'GS', 'SS', 'ES', 'LK', 'SD', 'SR', 'SJ', 'SE', 'CH', 'SY', 'TW', 'TJ', 'TZ', 'TH', 'TL', 'TG', 'TK', 'TO', 'TT', 'TN', 'TR', 'TM', 'TC', 'TV', 'UG', 'UA', 'AE', 'GB', 'US', 'UM', 'UY', 'UZ', 'VU', 'VE', 'VN', 'VG', 'VI', 'WF', 'EH', 'YE', 'ZM', 'ZW'], 'type': 'string', 'description': 'ISO 3166-1 alpha-2 country code (e.g., "US", "GB")'}, 'shipping_postal_code': {'type': 'string', 'description': 'Shipping postal code'}, 'buyer_delegation_token': {'type': 'string', 'description': 'Delegation token from buyer (OAuth-like flow)'}}}
Esquema de salida
{'type': 'object', 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'title': {'type': 'string'}, 'quantity': {'type': 'number'}, 'line_total': {'type': 'object', 'properties': {'amount': {'type': 'string'}, 'currency': {'type': 'string'}}}}}}, 'total': {'type': 'object', 'properties': {'amount': {'type': 'string'}, 'currency': {'type': 'string'}}}, 'status': {'type': 'string'}, 'order_id': {'type': 'string'}, 'created_at': {'type': 'string'}}}
Esquema de entrada
{'type': 'object', 'required': ['site_id'], 'properties': {'site_id': {'type': 'string', 'description': 'Registered site ID'}}}
Esquema de salida
{'type': 'object', 'required': ['kind', 'siteId', 'cartId', 'items', 'subtotal', 'total'], 'properties': {'kind': {'const': 'cart'}, 'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'qty': {'type': 'number'}, 'image': {'type': 'string'}, 'title': {'type': 'string'}, 'itemId': {'type': 'string'}, 'lineTotal': {'type': 'string'}, 'unitPrice': {'type': 'string'}, 'removeAction': {'type': 'object', 'properties': {'label': {'type': 'string'}, 'params': {'type': 'object'}, 'toolName': {'type': 'string'}}}, 'setQtyAction': {'type': 'object', 'properties': {'label': {'type': 'string'}, 'params': {'type': 'object'}, 'toolName': {'type': 'string'}}}, 'variantTitle': {'type': 'string'}, 'addonsSummary': {'type': 'string'}}}}, 'total': {'type': 'string'}, 'cartId': {'type': 'string'}, 'siteId': {'type': 'string'}, 'subtotal': {'type': 'string'}, 'discounts': {'type': 'array', 'items': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'amount': {'type': 'string'}}}}}}
Esquema de entrada
{'type': 'object', 'required': ['site_id'], 'properties': {'cart_id': {'type': 'string', 'description': 'Cart ID (optional if an active cart exists for the site)'}, 'site_id': {'type': 'string', 'description': 'Registered site ID'}}}
Esquema de salida
{'type': 'object', 'required': ['kind', 'siteId', 'cartId', 'items', 'subtotal', 'total'], 'properties': {'kind': {'const': 'cart'}, 'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'qty': {'type': 'number'}, 'image': {'type': 'string'}, 'title': {'type': 'string'}, 'itemId': {'type': 'string'}, 'lineTotal': {'type': 'string'}, 'unitPrice': {'type': 'string'}, 'removeAction': {'type': 'object', 'properties': {'label': {'type': 'string'}, 'params': {'type': 'object'}, 'toolName': {'type': 'string'}}}, 'setQtyAction': {'type': 'object', 'properties': {'label': {'type': 'string'}, 'params': {'type': 'object'}, 'toolName': {'type': 'string'}}}, 'variantTitle': {'type': 'string'}, 'addonsSummary': {'type': 'string'}}}}, 'total': {'type': 'string'}, 'cartId': {'type': 'string'}, 'siteId': {'type': 'string'}, 'subtotal': {'type': 'string'}, 'discounts': {'type': 'array', 'items': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'amount': {'type': 'string'}}}}}}
Esquema de entrada
{'type': 'object', 'required': ['site_id', 'order_id'], 'properties': {'site_id': {'type': 'string', 'description': 'Registered site ID'}, 'order_id': {'type': 'string', 'description': 'Order ID'}, 'buyer_delegation_token': {'type': 'string', 'description': "The buyer's delegation token (from their checkout approval); required to read their order."}}}
Esquema de salida
{'type': 'object', 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'title': {'type': 'string'}, 'quantity': {'type': 'number'}, 'line_total': {'type': 'object', 'properties': {'amount': {'type': 'string'}, 'currency': {'type': 'string'}}}}}}, 'total': {'type': 'object', 'properties': {'amount': {'type': 'string'}, 'currency': {'type': 'string'}}}, 'status': {'type': 'string'}, 'order_id': {'type': 'string'}, 'created_at': {'type': 'string'}}}
Esquema de entrada
{'type': 'object', 'required': ['order_id'], 'properties': {'site_id': {'type': 'string', 'description': 'Registered site ID (optional if DEFAULT_SITE_ID is set)'}, 'order_id': {'type': 'string', 'description': 'Order ID to pay for'}}}
Esquema de salida
{'type': 'object', 'properties': {'mobile_money_provider_labels': {'type': 'object'}}}
Esquema de entrada
{'type': 'object', 'required': ['order_id'], 'properties': {'site_id': {'type': 'string', 'description': 'Registered site ID (optional if DEFAULT_SITE_ID is set)'}, 'order_id': {'type': 'string', 'description': 'Order ID to check payment status for'}}}
Esquema de salida
{'type': 'object', 'properties': {'message': {'type': 'string'}, 'reference': {'type': 'string'}, 'instruction': {'type': 'object', 'properties': {'action': {'type': 'string'}, 'provider': {'type': 'string'}, 'authorization_url': {'type': 'string'}}}, 'payment_status': {'type': 'string'}}}
Esquema de entrada
{'type': 'object', 'required': ['site_id', 'product_id'], 'properties': {'site_id': {'type': 'string', 'description': 'Registered site ID'}, 'product_id': {'type': 'string', 'description': 'Product ID from the site (platform-specific format)'}}}
Esquema de salida
{'type': 'object', 'required': ['kind', 'siteId', 'productId', 'title', 'price', 'inStock'], 'properties': {'url': {'type': 'string'}, 'kind': {'const': 'product'}, 'image': {'type': 'string'}, 'price': {'type': 'string'}, 'title': {'type': 'string'}, 'images': {'type': 'array', 'items': {'type': 'string'}}, 'siteId': {'type': 'string'}, 'inStock': {'type': 'boolean'}, 'addToCart': {'type': 'object', 'properties': {'label': {'type': 'string'}, 'params': {'type': 'object'}, 'toolName': {'type': 'string'}}}, 'productId': {'type': 'string'}, 'description': {'type': 'string'}}}
Esquema de entrada
{'type': 'object', 'required': ['site_id', 'product_id'], 'properties': {'page': {'type': 'integer', 'description': 'Page number (default: 1)'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Max reviews to return (default: 10)'}, 'site_id': {'type': 'string', 'description': 'Registered site ID'}, 'product_id': {'type': 'string', 'description': 'Product ID'}}}
Esquema de salida
{'type': 'object', 'properties': {'reviews': {'type': 'array', 'items': {'type': 'object'}}, 'authenticity_consensus': {'type': 'object', 'properties': {'flags': {'type': 'array', 'items': {'type': 'string'}}, 'trust_score': {'type': 'number'}, 'average_rating': {'type': 'number'}, 'verified_percentage': {'type': 'number'}}}}}
Esquema de entrada
{'type': 'object', 'required': ['order_id', 'channel'], 'properties': {'phone': {'type': 'string', 'description': 'Buyer mobile-money phone number (required for channel "mobile_money")'}, 'channel': {'enum': ['mobile_money', 'card'], 'type': 'string', 'description': 'Payment channel chosen by the buyer (from get_payment_methods)'}, 'gateway': {'enum': ['paystack', 'stripe', 'paypal'], 'type': 'string', 'description': "Payment gateway to use when the store has more than one enabled (see get_payment_methods.gateways[].id). Optional â\x80\x94 defaults to the store's first enabled gateway."}, 'site_id': {'type': 'string', 'description': 'Registered site ID (optional if DEFAULT_SITE_ID is set)'}, 'order_id': {'type': 'string', 'description': 'Order ID to pay for'}, 'provider': {'enum': ['mtn', 'vod', 'tgo', 'telecel', 'vodafone', 'tigo', 'airteltigo'], 'type': 'string', 'description': 'Mobile-money provider (required for channel "mobile_money"). Codes: mtn, vod (Vodafone/Telecel), tgo (AirtelTigo).'}, 'buyer_delegation_token': {'type': 'string', 'description': 'Delegation token from the buyer (from request_delegation/check_delegation). Required â\x80\x94 payments always need human approval.'}}}
Esquema de salida
{'type': 'object', 'properties': {'message': {'type': 'string'}, 'reference': {'type': 'string'}, 'instruction': {'type': 'object', 'properties': {'action': {'type': 'string'}, 'provider': {'type': 'string'}, 'authorization_url': {'type': 'string'}}}, 'payment_status': {'type': 'string'}}}
Esquema de entrada
{'type': 'object', 'required': ['site_id'], 'properties': {'page': {'type': 'integer', 'description': 'Page number (1-indexed, default: 1)'}, 'status': {'enum': ['pending', 'processing', 'completed', 'cancelled', 'refunded'], 'type': 'string', 'description': 'Filter by order status'}, 'site_id': {'type': 'string', 'description': 'Registered site ID'}, 'per_page': {'type': 'integer', 'description': 'Results per page (max 100, default: 20)'}, 'buyer_delegation_token': {'type': 'string', 'description': "The buyer's delegation token (from their checkout approval); required to list their orders."}}}
Esquema de salida
{'type': 'object', 'required': ['orders'], 'properties': {'orders': {'type': 'array', 'items': {'type': 'object', 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'title': {'type': 'string'}, 'quantity': {'type': 'number'}, 'line_total': {'type': 'object', 'properties': {'amount': {'type': 'string'}, 'currency': {'type': 'string'}}}}}}, 'total': {'type': 'object', 'properties': {'amount': {'type': 'string'}, 'currency': {'type': 'string'}}}, 'status': {'type': 'string'}, 'order_id': {'type': 'string'}, 'created_at': {'type': 'string'}}}}}}
Esquema de entrada
{'type': 'object', 'required': [], 'properties': {}}
Esquema de salida
{'type': 'object', 'required': ['sites'], 'properties': {'sites': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string'}, 'name': {'type': 'string'}, 'site_id': {'type': 'string'}, 'platform': {'type': 'string'}}}}}}
Esquema de entrada
{'type': 'object', 'required': ['items', 'shipping_address'], 'properties': {'items': {'type': 'array', 'items': {'type': 'object', 'required': ['site_id', 'product_id', 'quantity'], 'properties': {'addons': {'type': 'object'}, 'site_id': {'type': 'string'}, 'quantity': {'type': 'integer'}, 'product_id': {'type': 'string'}, 'variant_id': {'type': 'string'}}}, 'description': 'Products to buy. Each entry: { site_id, product_id, quantity, variant_id?, addons? }. Items may span multiple stores (grouped by site_id).'}, 'customer': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'email': {'type': 'string'}, 'phone': {'type': 'string'}}, 'description': 'Optional buyer contact carried for checkout; customer.email arms back-in-stock alerts for out-of-stock items.'}, 'shipping_address': {'type': 'object', 'required': ['country_code'], 'properties': {'city': {'type': 'string'}, 'state': {'type': 'string'}, 'postal_code': {'type': 'string'}, 'country_code': {'type': 'string', 'description': '2-letter ISO country code (required).'}}, 'description': 'Buyer delivery address (applied to every store).'}}}
Esquema de salida
{'type': 'object', 'oneOf': [{'type': 'object', 'required': ['kind', 'siteId', 'cartId', 'items', 'subtotal', 'total'], 'properties': {'kind': {'const': 'checkout'}, 'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'qty': {'type': 'number'}, 'image': {'type': 'string'}, 'title': {'type': 'string'}, 'itemId': {'type': 'string'}, 'lineTotal': {'type': 'string'}, 'unitPrice': {'type': 'string'}, 'removeAction': {'type': 'object', 'properties': {'label': {'type': 'string'}, 'params': {'type': 'object'}, 'toolName': {'type': 'string'}}}, 'setQtyAction': {'type': 'object', 'properties': {'label': {'type': 'string'}, 'params': {'type': 'object'}, 'toolName': {'type': 'string'}}}, 'variantTitle': {'type': 'string'}, 'addonsSummary': {'type': 'string'}}}}, 'total': {'type': 'string'}, 'cartId': {'type': 'string'}, 'siteId': {'type': 'string'}, 'shipping': {'type': 'string'}, 'subtotal': {'type': 'string'}, 'shippingOptions': {'type': 'array', 'items': {'type': 'object', 'properties': {'cost': {'type': 'string'}, 'label': {'type': 'string'}, 'optionId': {'type': 'string'}, 'description': {'type': 'string'}}}}, 'selectedShippingId': {'type': 'string'}}}, {'type': 'object', 'required': ['kind', 'carts'], 'properties': {'kind': {'const': 'multiCart'}, 'carts': {'type': 'array', 'items': {'type': 'object', 'required': ['siteId', 'storeName', 'cartId', 'items'], 'properties': {'error': {'type': 'string'}, 'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'qty': {'type': 'number'}, 'image': {'type': 'string'}, 'title': {'type': 'string'}, 'itemId': {'type': 'string'}, 'lineTotal': {'type': 'string'}, 'unitPrice': {'type': 'string'}, 'removeAction': {'type': 'object', 'properties': {'label': {'type': 'string'}, 'params': {'type': 'object'}, 'toolName': {'type': 'string'}}}, 'setQtyAction': {'type': 'object', 'properties': {'label': {'type': 'string'}, 'params': {'type': 'object'}, 'toolName': {'type': 'string'}}}, 'variantTitle': {'type': 'string'}, 'addonsSummary': {'type': 'string'}}}}, 'cartId': {'type': 'string'}, 'siteId': {'type': 'string'}, 'subtotal': {'type': 'string'}, 'storeName': {'type': 'string'}, 'shippingOptions': {'type': 'array', 'items': {'type': 'object', 'properties': {'cost': {'type': 'string'}, 'label': {'type': 'string'}, 'optionId': {'type': 'string'}, 'description': {'type': 'string'}}}}}}}}}]}
Esquema de entrada
{'type': 'object', 'required': ['site_id', 'cart_id', 'item_id'], 'properties': {'cart_id': {'type': 'string', 'description': 'Cart ID'}, 'item_id': {'type': 'string', 'description': 'Line item ID from the cart (cart.items[].item_id)'}, 'site_id': {'type': 'string', 'description': 'Registered site ID'}}}
Esquema de salida
{'type': 'object', 'required': ['kind', 'siteId', 'cartId', 'items', 'subtotal', 'total'], 'properties': {'kind': {'const': 'cart'}, 'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'qty': {'type': 'number'}, 'image': {'type': 'string'}, 'title': {'type': 'string'}, 'itemId': {'type': 'string'}, 'lineTotal': {'type': 'string'}, 'unitPrice': {'type': 'string'}, 'removeAction': {'type': 'object', 'properties': {'label': {'type': 'string'}, 'params': {'type': 'object'}, 'toolName': {'type': 'string'}}}, 'setQtyAction': {'type': 'object', 'properties': {'label': {'type': 'string'}, 'params': {'type': 'object'}, 'toolName': {'type': 'string'}}}, 'variantTitle': {'type': 'string'}, 'addonsSummary': {'type': 'string'}}}}, 'total': {'type': 'string'}, 'cartId': {'type': 'string'}, 'siteId': {'type': 'string'}, 'subtotal': {'type': 'string'}, 'discounts': {'type': 'array', 'items': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'amount': {'type': 'string'}}}}}}
Esquema de entrada
{'type': 'object', 'required': ['site_id', 'product_id'], 'properties': {'email': {'type': 'string', 'description': "Buyer's email for the restock alert (recommended â\x80\x94 without it no alert is sent)"}, 'site_id': {'type': 'string', 'description': 'Registered site ID'}, 'product_id': {'type': 'string', 'description': 'Product ID to watch'}, 'variant_id': {'type': 'string', 'description': 'Specific variant to watch (optional)'}, 'product_title': {'type': 'string', 'description': 'Product name, for a clearer alert + merchant view (optional)'}}}
Esquema de salida
{'type': 'object'}
Esquema de entrada
{'type': 'object', 'required': ['site_id'], 'properties': {'email': {'type': 'string', 'description': "Buyer's email. When provided, a one-time approval code is emailed to them and approval happens in-chat via submit_delegation_otp (recommended)."}, 'scopes': {'type': 'array', 'items': {'enum': ['read_products', 'manage_cart', 'execute_checkout', 'read_orders'], 'type': 'string'}, 'description': 'Scopes to request (defaults to all four scopes)'}, 'site_id': {'type': 'string', 'description': 'Site ID requiring delegation'}, 'marketing_opt_in': {'type': 'boolean', 'description': 'Set true ONLY if the buyer explicitly agreed to receive marketing/deals emails (e.g. ticked the opt-in box). Subscribes their email to the consumer mailing list.'}}}
Esquema de salida
{'type': 'object', 'properties': {'status': {'type': 'string'}, 'delivery': {'type': 'string'}, 'user_code': {'type': 'string'}, 'approvalUrl': {'type': 'string'}, 'device_code': {'type': 'string'}, 'delegation_token': {'type': 'string'}}}
Esquema de entrada
{'type': 'object', 'required': ['site_id'], 'properties': {'page': {'type': 'integer', 'description': 'Page number (1-indexed, default: 1)'}, 'query': {'type': 'string', 'description': 'Optional single search term (product name/keyword). OMIT to browse; for several names use `queries`.'}, 'queries': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Search several product names at once (e.g. when the buyer lists multiple items). Returns all matches in ONE call/card instead of searching one at a time. Use `query` for a single search, `queries` for several, or omit both to browse.'}, 'site_id': {'type': 'string', 'description': 'Registered site ID (e.g., "site_abc123" or "shopify_store_1")'}, 'category': {'type': 'string', 'description': 'Filter by product category (optional)'}, 'in_stock': {'type': 'boolean', 'description': 'Filter to in-stock items only (default: false)'}, 'per_page': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Results per page (default: 20, max: 100)'}, 'max_price': {'type': 'string', 'description': 'Maximum price filter in store currency, format: "199.99" (optional)'}, 'min_price': {'type': 'string', 'description': 'Minimum price filter in store currency, format: "19.99" (optional)'}}}
Esquema de salida
{'type': 'object', 'required': ['kind', 'siteId', 'products'], 'properties': {'kind': {'const': 'productList'}, 'siteId': {'type': 'string'}, 'products': {'type': 'array', 'items': {'type': 'object', 'required': ['productId', 'title', 'price', 'inStock'], 'properties': {'url': {'type': 'string'}, 'image': {'type': 'string'}, 'price': {'type': 'string'}, 'title': {'type': 'string'}, 'inStock': {'type': 'boolean'}, 'addToCart': {'type': 'object', 'properties': {'label': {'type': 'string'}, 'params': {'type': 'object'}, 'toolName': {'type': 'string'}}}, 'productId': {'type': 'string'}, 'hasOptions': {'type': 'boolean'}}}}, 'siteName': {'type': 'string'}}}
Esquema de entrada
{'type': 'object', 'required': ['site_id', 'cart_id', 'option_id'], 'properties': {'cart_id': {'type': 'string', 'description': 'Cart ID'}, 'site_id': {'type': 'string', 'description': 'Registered site ID'}, 'option_id': {'type': 'string', 'description': 'option_id from cart.shipping_options'}}}
Esquema de salida
{'type': 'object', 'required': ['kind', 'siteId', 'cartId', 'items', 'subtotal', 'total'], 'properties': {'kind': {'const': 'checkout'}, 'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'qty': {'type': 'number'}, 'image': {'type': 'string'}, 'title': {'type': 'string'}, 'itemId': {'type': 'string'}, 'lineTotal': {'type': 'string'}, 'unitPrice': {'type': 'string'}, 'removeAction': {'type': 'object', 'properties': {'label': {'type': 'string'}, 'params': {'type': 'object'}, 'toolName': {'type': 'string'}}}, 'setQtyAction': {'type': 'object', 'properties': {'label': {'type': 'string'}, 'params': {'type': 'object'}, 'toolName': {'type': 'string'}}}, 'variantTitle': {'type': 'string'}, 'addonsSummary': {'type': 'string'}}}}, 'total': {'type': 'string'}, 'cartId': {'type': 'string'}, 'siteId': {'type': 'string'}, 'shipping': {'type': 'string'}, 'subtotal': {'type': 'string'}, 'shippingOptions': {'type': 'array', 'items': {'type': 'object', 'properties': {'cost': {'type': 'string'}, 'label': {'type': 'string'}, 'optionId': {'type': 'string'}, 'description': {'type': 'string'}}}}, 'selectedShippingId': {'type': 'string'}}}
Esquema de entrada
{'type': 'object', 'required': ['site_id', 'cart_id', 'item_id', 'quantity'], 'properties': {'cart_id': {'type': 'string', 'description': 'Cart ID'}, 'item_id': {'type': 'string', 'description': 'Line item ID from the cart (cart.items[].item_id)'}, 'site_id': {'type': 'string', 'description': 'Registered site ID'}, 'quantity': {'type': 'integer', 'description': 'New absolute quantity for the line (>= 0; 0 removes the line)'}}}
Esquema de salida
{'type': 'object', 'required': ['kind', 'siteId', 'cartId', 'items', 'subtotal', 'total'], 'properties': {'kind': {'const': 'cart'}, 'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'qty': {'type': 'number'}, 'image': {'type': 'string'}, 'title': {'type': 'string'}, 'itemId': {'type': 'string'}, 'lineTotal': {'type': 'string'}, 'unitPrice': {'type': 'string'}, 'removeAction': {'type': 'object', 'properties': {'label': {'type': 'string'}, 'params': {'type': 'object'}, 'toolName': {'type': 'string'}}}, 'setQtyAction': {'type': 'object', 'properties': {'label': {'type': 'string'}, 'params': {'type': 'object'}, 'toolName': {'type': 'string'}}}, 'variantTitle': {'type': 'string'}, 'addonsSummary': {'type': 'string'}}}}, 'total': {'type': 'string'}, 'cartId': {'type': 'string'}, 'siteId': {'type': 'string'}, 'subtotal': {'type': 'string'}, 'discounts': {'type': 'array', 'items': {'type': 'object', 'properties': {'code': {'type': 'string'}, 'amount': {'type': 'string'}}}}}}
Esquema de entrada
{'type': 'object', 'required': ['site_id', 'cart_id', 'country_code'], 'properties': {'city': {'type': 'string', 'description': 'City'}, 'state': {'type': 'string', 'description': 'State/province/region code where carriers need it'}, 'cart_id': {'type': 'string', 'description': 'Cart ID'}, 'site_id': {'type': 'string', 'description': 'Registered site ID'}, 'postal_code': {'type': 'string', 'description': 'Postal/ZIP code for accurate rates'}, 'country_code': {'enum': ['AF', 'AX', 'AL', 'DZ', 'AS', 'AD', 'AO', 'AI', 'AQ', 'AG', 'AR', 'AM', 'AW', 'AU', 'AT', 'AZ', 'BS', 'BH', 'BD', 'BB', 'BY', 'BE', 'BZ', 'BJ', 'BM', 'BT', 'BO', 'BQ', 'BA', 'BW', 'BV', 'BR', 'IO', 'BN', 'BG', 'BF', 'BI', 'CV', 'KH', 'CM', 'CA', 'KY', 'CF', 'TD', 'CL', 'CN', 'CX', 'CC', 'CO', 'KM', 'CG', 'CD', 'CK', 'CR', 'CI', 'HR', 'CU', 'CW', 'CY', 'CZ', 'DK', 'DJ', 'DM', 'DO', 'EC', 'EG', 'SV', 'GQ', 'ER', 'EE', 'SZ', 'ET', 'FK', 'FO', 'FJ', 'FI', 'FR', 'GF', 'PF', 'TF', 'GA', 'GM', 'GE', 'DE', 'GH', 'GI', 'GR', 'GL', 'GD', 'GP', 'GU', 'GT', 'GG', 'GN', 'GW', 'GY', 'HT', 'HM', 'VA', 'HN', 'HK', 'HU', 'IS', 'IN', 'ID', 'IR', 'IQ', 'IE', 'IM', 'IL', 'IT', 'JM', 'JP', 'JE', 'JO', 'KZ', 'KE', 'KI', 'KP', 'KR', 'KW', 'KG', 'LA', 'LV', 'LB', 'LS', 'LR', 'LY', 'LI', 'LT', 'LU', 'MO', 'MG', 'MW', 'MY', 'MV', 'ML', 'MT', 'MH', 'MQ', 'MR', 'MU', 'YT', 'MX', 'FM', 'MD', 'MC', 'MN', 'ME', 'MS', 'MA', 'MZ', 'MM', 'NA', 'NR', 'NP', 'NL', 'NC', 'NZ', 'NI', 'NE', 'NG', 'NU', 'NF', 'MK', 'MP', 'NO', 'OM', 'PK', 'PW', 'PS', 'PA', 'PG', 'PY', 'PE', 'PH', 'PN', 'PL', 'PT', 'PR', 'QA', 'RE', 'RO', 'RU', 'RW', 'BL', 'SH', 'KN', 'LC', 'MF', 'PM', 'VC', 'WS', 'SM', 'ST', 'SA', 'SN', 'RS', 'SC', 'SL', 'SG', 'SX', 'SK', 'SI', 'SB', 'SO', 'ZA', 'GS', 'SS', 'ES', 'LK', 'SD', 'SR', 'SJ', 'SE', 'CH', 'SY', 'TW', 'TJ', 'TZ', 'TH', 'TL', 'TG', 'TK', 'TO', 'TT', 'TN', 'TR', 'TM', 'TC', 'TV', 'UG', 'UA', 'AE', 'GB', 'US', 'UM', 'UY', 'UZ', 'VU', 'VE', 'VN', 'VG', 'VI', 'WF', 'EH', 'YE', 'ZM', 'ZW'], 'type': 'string', 'description': 'ISO-3166 alpha-2 country code (e.g. US)'}}}
Esquema de salida
{'type': 'object', 'required': ['kind', 'siteId', 'cartId', 'items', 'subtotal', 'total'], 'properties': {'kind': {'const': 'checkout'}, 'items': {'type': 'array', 'items': {'type': 'object', 'properties': {'qty': {'type': 'number'}, 'image': {'type': 'string'}, 'title': {'type': 'string'}, 'itemId': {'type': 'string'}, 'lineTotal': {'type': 'string'}, 'unitPrice': {'type': 'string'}, 'removeAction': {'type': 'object', 'properties': {'label': {'type': 'string'}, 'params': {'type': 'object'}, 'toolName': {'type': 'string'}}}, 'setQtyAction': {'type': 'object', 'properties': {'label': {'type': 'string'}, 'params': {'type': 'object'}, 'toolName': {'type': 'string'}}}, 'variantTitle': {'type': 'string'}, 'addonsSummary': {'type': 'string'}}}}, 'total': {'type': 'string'}, 'cartId': {'type': 'string'}, 'siteId': {'type': 'string'}, 'shipping': {'type': 'string'}, 'subtotal': {'type': 'string'}, 'shippingOptions': {'type': 'array', 'items': {'type': 'object', 'properties': {'cost': {'type': 'string'}, 'label': {'type': 'string'}, 'optionId': {'type': 'string'}, 'description': {'type': 'string'}}}}, 'selectedShippingId': {'type': 'string'}}}
Esquema de entrada
{'type': 'object', 'required': ['device_code', 'code'], 'properties': {'code': {'type': 'string', 'description': 'The 6-digit code the buyer read from their email'}, 'site_id': {'type': 'string', 'description': 'Registered site ID (optional if DEFAULT_SITE_ID is set)'}, 'device_code': {'type': 'string', 'description': 'device_code returned by request_delegation'}}}
Esquema de salida
{'type': 'object', 'properties': {'status': {'type': 'string'}, 'delivery': {'type': 'string'}, 'user_code': {'type': 'string'}, 'approvalUrl': {'type': 'string'}, 'device_code': {'type': 'string'}, 'delegation_token': {'type': 'string'}}}
Esquema de entrada
{'type': 'object', 'required': ['order_id', 'otp'], 'properties': {'otp': {'type': 'string', 'description': 'One-time password entered by the buyer'}, 'site_id': {'type': 'string', 'description': 'Registered site ID (optional if DEFAULT_SITE_ID is set)'}, 'order_id': {'type': 'string', 'description': 'Order ID being paid for'}, 'buyer_delegation_token': {'type': 'string', 'description': 'Delegation token from the buyer (same one used for initiate_payment). Required.'}}}
Esquema de salida
{'type': 'object', 'properties': {'message': {'type': 'string'}, 'reference': {'type': 'string'}, 'instruction': {'type': 'object', 'properties': {'action': {'type': 'string'}, 'provider': {'type': 'string'}, 'authorization_url': {'type': 'string'}}}, 'payment_status': {'type': 'string'}}}
Cambios recientes en herramientas
Servidores MCP similares
AgentLot Marketplace
Enables agents and users to discover, bid on, purchase, deliver, and settle paid digital services and compute work.
Digital Manager Guru
Provides Digital Manager Guru checkout, customer, transaction, subscription, affiliate, coupon, blocklist, and digital-product sa…
Pagar.me
Connects to Pagar.me to manage customers, cards, orders, charges, invoices, payment captures, confirmations, retries, refunds, an…
roastify-mcp
Supports a coffee commerce workflow with product and blend catalogs, inventory, coupons, packaging design editing, artwork genera…
bitroad
Enables agents to search and purchase marketplace goods under spending controls, manage orders and returns, and handle payments a…
Singularity Layer MCP
Provides marketplace discovery, agent endpoint and asset management, dataset and product purchases, payment flows, and ERC-8004 a…
agentic-commerce
Enables on-chain commerce through Boson Protocol, including product offers, buyer and seller accounts, voucher exchanges, escrow-…
agentcard
Manages prepaid virtual cards with spending controls, approvals, funding, rewards, and connected-merchant shopping flows.