webmcp/gallery

thepromogroup.co.za

active

10 tools · production · mixed

The Promo Group provides tools that let an agent search products, add items to quote lists or carts, and manage quantities for promotional products.

Tools10 total

add_to_cart

actionimperative/
quantitynumberrequiredNumber of units to add.
variantsobject—Optional variant selections, e.g. {"color": "Navy", "size": "L"}. Use exact strings from get_product.variant_options.
product_slugstringrequiredThe product slug from search_products.

add_to_quote_list

actionimperative/
notesstring—Any other customisation notes for this item.
quantitynumberrequiredNumber of units. Quote-flow typical minimums are 25-100.
variantsobject—Optional variant selections as a flat object, e.g. {"color": "Navy", "size": "L"}. Use exact option strings from get_product.variant_options.
is_brandedboolean—Whether the item should be branded (default true). Set false for plain/unbranded.
product_slugstringrequiredThe product slug from search_products, e.g. "frost-melange-beanie".
artwork_notesstring—Free-text artwork instructions, e.g. "Use logo from attached file, white on dark".
branding_methodstring—How the branding should be applied. Required when is_branded is true.
branding_positionstring—Where the branding goes, e.g. "Front", "Back", "Left Chest", "Lid".

find_product_by_sku

readimperative/
skustringrequiredThe exact SKU code, case-insensitive. Examples: "BP4580", "BAS-8040-BU", "PEN24016".

get_product

readimperative/
slugstringrequiredThe exact product slug copied from a search_products result (e.g. "mens-solo-hooded-sweater-blue"). Do not shorten, modify, or invent slugs — only use values returned by search_products.

remove_from_cart

actionimperative/
variantsobject—Variant selections that identify the specific line item (omit for products with no variants).
product_idstringrequiredThe product ID to remove.

remove_from_quote_list

actionimperative/
variantsobject—Variant selections that identify the specific line item (omit for products with no variants).
product_idstringrequiredThe product ID to remove.

search_products

readimperative/
querystringrequiredSearch keywords, e.g. "branded coffee mug" or "leather notebook".
categorystring—Optional category slug to narrow results, e.g. "drinkware", "bags", "clothing", "tech-gadgets", "office-stationery", "headwear", "home-living".
max_pricenumber—Optional maximum unit price in ZAR.
min_pricenumber—Optional minimum unit price in ZAR.

submit_contact_form

actiondeclarative/contact-us
namestring—The contact's full name.
emailstring—The contact's email address for our reply.
phonestring—South African phone number, with or without spaces, e.g. 0821234567.
companystring—Optional company name.
messagestring—The full inquiry message — what they're asking about, quantities, deadlines, any context.

update_cart_quantity

actionimperative/
quantitynumberrequiredNew quantity. Setting to 0 removes the item.
variantsobject—Variant selections that identify the specific line item, if the product has multiple variants in the cart.
product_idstringrequiredThe product ID in the cart.

update_quote_quantity

actionimperative/
quantitynumberrequiredNew quantity. Setting to 0 removes the item.
variantsobject—Variant selections that identify the specific line item, if the product has multiple variants in the list.
product_idstringrequiredThe product ID (from add_to_quote_list result or the quote list state).