au.com.vividads/vivid-ads-commerce

Est-ce que au.com.vividads/vivid-ads-commerce est sûr ?

Au dernier audit MCP Hub, le serveur MCP « au.com.vividads/vivid-ads-commerce » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.

Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.

Les 27 outils

• vivid_accept_quote≈ 351 tokens

  Return the secure payment link for a formal quote Vivid already emailed (e.g. #D786069) so the customer can complete the order without leaving the conversation. Requires the quote number AND the email it was sent to (identity). Read-only — nothing is charged; it returns the customer's existing Shopify checkout link. If the quote has already become an order, it says so instead of issuing another link. CODE REQUIRED: needs the customer's email AND a verified identity token. Without a token this tool emails the customer a 6-digit code and returns status need_verification with a verificationId — ask the customer for the code, call vivid_identity_verify, then call this tool again with the token. It shows nothing before that.

  Paramètres, retour & exemple (3)

  Paramètres

  • email · string · requis
    the email the quote was sent to (required)
  • token · string · optionnel
    identity token from vivid_identity_verify (required to see any details; without it a code is emailed to the customer)
  • quote_number · string · requis
    quote/draft number, e.g. '#D786069'

  Exemple d'appel

  {"name": "vivid_accept_quote", "arguments": {"email": "texte", "quote_number": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• vivid_artwork≈ 352 tokens

  Attach a customer-provided artwork file or link to a signage order (a successful attach does NOT mean it is print-ready — the team still checks it). EASIEST: pass a shareable link to the file (sourceUrl) — Google Drive, Dropbox, WeTransfer, etc. — and use the returned fileUrl in vivid_place_order's artwork {mode:'upload_file', fileUrl}. For a large file with no link yet, set requestUpload:true to get a direct-upload URL (the file uploads straight to storage — handles 50–200MB+), then call again with the returned fileId to get the share link.

  Paramètres, retour & exemple (5)

  Paramètres

  • fileId · string · optionnel
    after a direct upload completes, pass the returned file id here to finalise and get the share link
  • filename · string · optionnel
    filename (required with requestUpload), e.g. 'flyer.pdf'
  • sourceUrl · string · optionnel
    a shareable https link to the print-ready artwork (PDF/PNG/JPG/AI/EPS) — the easiest path
  • contentType · string · optionnel
  • requestUpload · boolean · optionnel
    set true to get a direct-upload URL for a large file (client uploads straight to storage)

  Exemple d'appel

  {"name": "vivid_artwork", "arguments": {"fileId": "texte", "filename": "texte", "sourceUrl": "texte", "contentType": "texte", "requestUpload": true}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• vivid_artwork_template≈ 326 tokens

  Get the official print-ready artwork TEMPLATE download links (PDF/AI, per size) for a product, straight from its vividads.com.au product page — for the customer or their designer to set up artwork correctly (bleed, safe area, size). Public, read-only; nothing is emailed. Give the links exactly as returned.

  Paramètres, retour & exemple (2)

  Paramètres

  • size · string · optionnel
    optional — only return the template for this size, e.g. '850x2000'
  • product · string · requis
    product name or handle, e.g. 'pull up banner', 'teardrop flag'

  Exemple d'appel

  {"name": "vivid_artwork_template", "arguments": {"product": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"name": "texte", "status": "texte", "message": "texte", "product": "texte", "templates": "texte", "agent_note": "texte", "productUrl": "texte"}}

• vivid_check_artwork≈ 275 tokens

  Check whether a customer's artwork PDF is print-ready BEFORE they order — powered by Vivid's own production preflight engine. Reports size vs the ordered size, bleed, RGB-vs-CMYK colour, font embedding and effective resolution, each with a plain-English fix. ADVISORY ONLY: it never blocks anything. If the customer is happy to proceed with the file as-is, that is always accepted — say so explicitly. Every order also gets a free digital proof before printing.

  Paramètres, retour & exemple (3)

  Paramètres

  • file_url · string · requis
    downloadable URL of the artwork PDF (e.g. the fileUrl from vivid_upload_artwork)
  • width_mm · number · optionnel
    ordered width in mm, if known — enables the size check
  • height_mm · number · optionnel
    ordered height in mm, if known

  Exemple d'appel

  {"name": "vivid_check_artwork", "arguments": {"file_url": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• vivid_contact_team≈ 618 tokens

  Open a support case with the Vivid Ads team (emails the team and saves a record) for anything the other tools cannot do: a problem with an order (damaged, faulty, missing, wrong item or colour — reprint/refund claims), an order change (address, cancel, hold, split into one line per design), proof help (resend, changes), a human design service request, a sample/swatch request, a trade/reseller or payment-terms account, a price-match request, a tight deadline, or simply 'I want to talk to a person'. Call it ONCE per issue, after collecting a clear summary and the customer's email or phone. It never returns order details: an order number is passed to the team as the customer's own reference (marked unverified unless an identity token from vivid_identity_verify is supplied). For B2B AI-automation enquiries use reason 'ai_automation'. Never use this to take payment or approve a proof.

  Paramètres, retour & exemple (10)

  Paramètres

  • name · string · optionnel
  • email · string · optionnel
    how the team replies (email or phone required)
  • phone · string · optionnel
  • token · string · optionnel
    optional identity token from vivid_identity_verify — marks the order reference as verified for the team
  • reason · string · requis · problem_with_order | order_change | proof_help | design_service | sample_request | trade_account | price_match | deadline
    what the case is about
  • company · string · optionnel
  • product · string · optionnel
  • summary · string · requis
    everything the team needs, in the customer's words: what happened / what they want, product, size, quantity, deadline. For a problem: what is wrong and when it arrived (photos can be sent with vivid_upload_artwork).
  • order_number · string · optionnel
    the customer's order or quote number, if this is about an existing order
  • idempotency_key · string · optionnel
    optional: a unique key for this request — a retry with the same key returns the first result instead of repeating the action

  Exemple d'appel

  {"name": "vivid_contact_team", "arguments": {"reason": "problem_with_order", "summary": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• vivid_cross_sell≈ 311 tokens

  Suggest relevant, NON-pushy add-on products to round out a customer's order — 1–2 genuinely useful companions with a reason. PREFERS real frequently-bought-together data from Vivid Ads' order history (pass `product` = the product handle the customer chose); falls back to curated use-case bundles (pass `use_case`). Omit both to get guidance. Pass already_have to avoid re-suggesting what they've chosen. Never pressure — helpful suggestions only.

  Paramètres, retour & exemple (3)

  Paramètres

  • product · string · optionnel
    the product handle the customer chose, e.g. 'pull-up-banners' — returns items frequently bought with it from real order history
  • use_case · string · optionnel
    curated fallback: 'trade-show', 'school-open-day', 'construction-fence', 'retail-promotion', 'real-estate', or 'corporate-conference'
  • already_have · array · optionnel
    product keys/handles the customer already chose (optional) — excluded from suggestions

  Exemple d'appel

  {"name": "vivid_cross_sell", "arguments": {"product": "texte", "use_case": "texte", "already_have": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• vivid_delivery_estimate≈ 392 tokens

  Estimate WHEN an order would arrive at an Australian postcode — the question behind 'can I get it by Friday?'. Works the timeline through honestly: production starts only after the customer approves their digital proof (3pm AEST cutoff), then production time for that product, then transit for their postcode (metro/regional/remote bands). Returns an arrival WINDOW plus the assumptions it made. This is an ESTIMATE, never a guarantee — always relay the caveat, and for a hard deadline tell them to call 1300 721 614. Free pickup from Derrimut VIC is usually the fastest option.

  Paramètres, retour & exemple (3)

  Paramètres

  • product · string · optionnel
    product name — used to read its real production time
  • postcode · string · requis
    4-digit Australian delivery postcode
  • artwork_ready · boolean · optionnel
    true if artwork is print-ready and the proof will be approved immediately

  Exemple d'appel

  {"name": "vivid_delivery_estimate", "arguments": {"postcode": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"status": "texte", "message": "texte", "agent_note": "texte", "production_hours": "texte"}}

• vivid_delivery_quote≈ 446 tokens

  EXACT delivery/freight cost to an Australian postcode for a product configuration — the SAME live rates the vividads.com.au checkout shows (carrier + shipping-rules apps; incl. GST). Use whenever the customer asks what shipping/delivery costs. Resolve the product + size/options + quantity first (vivid_product / vivid_price), then call with the postcode (suburb improves accuracy). Never estimate freight yourself. Always also mention free pickup from Derrimut VIC 3026.

  Paramètres, retour & exemple (7)

  Paramètres

  • size · string · optionnel
    (simple products) size, e.g. '850x2050'
  • state · string · optionnel
    VIC/NSW/QLD/SA/WA/TAS/NT/ACT (derived from postcode if omitted)
  • suburb · string · optionnel
  • options · object · optionnel
    FULL selected options for option-rich/custom products (same shape as vivid_price.options)
  • product · string · requis
    product name, e.g. 'pull up banner'
  • postcode · string · requis
    4-digit Australian postcode
  • quantity · number · optionnel

  Exemple d'appel

  {"name": "vivid_delivery_quote", "arguments": {"product": "texte", "postcode": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"rates": "texte", "pickup": "texte", "status": "texte", "message": "texte", "agent_note": "texte", "gstIncluded": "texte"}}

• vivid_fulfilment_order_status≈ 362 tokens

  Authoritative order state with a per-line-item breakdown and an order-level rollup. States: received, in_production, partially_ready, ready_for_pickup, dispatched, in_transit, out_for_delivery, delivered, completed, on_hold, cancelled. Includes the StarShipit shipping summary where available.

  Paramètres, retour & exemple (5)

  Paramètres

  • token · string · optionnel
    identity token from vivid_identity_verify — REQUIRED to see any details. Without it a 6-digit code is emailed to customer_email and the tool returns need_verification.
  • order_id · string · optionnel
    Shopify order GID, e.g. gid://shopify/Order/123.
  • order_name · string · optionnel
    Human order name, e.g. "#12345" (alias for order_id).
  • line_item_id · string · optionnel
    Optional Shopify line item GID to scope to one item.
  • customer_email · string · requis
    The email address on the order. REQUIRED for identity — order details are only returned when this email matches the order. The customer must give their email AND one of their order numbers.

  Exemple d'appel

  {"name": "vivid_fulfilment_order_status", "arguments": {"customer_email": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• vivid_fulfilment_pickup_status≈ 320 tokens

  Whether an order (or specific line items) is ready for pickup at Derrimut VIC — ready once printed and cut, before dispatch.

  Paramètres, retour & exemple (5)

  Paramètres

  • token · string · optionnel
    identity token from vivid_identity_verify — REQUIRED to see any details. Without it a 6-digit code is emailed to customer_email and the tool returns need_verification.
  • order_id · string · optionnel
    Shopify order GID, e.g. gid://shopify/Order/123.
  • order_name · string · optionnel
    Human order name, e.g. "#12345" (alias for order_id).
  • line_item_id · string · optionnel
    Optional Shopify line item GID to scope to one item.
  • customer_email · string · requis
    The email address on the order. REQUIRED for identity — order details are only returned when this email matches the order. The customer must give their email AND one of their order numbers.

  Exemple d'appel

  {"name": "vivid_fulfilment_pickup_status", "arguments": {"customer_email": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• vivid_fulfilment_production_stage≈ 393 tokens

  Where each line item is in production, per item plus a rollup. Stages (in order): received, in preflight, awaiting proof, proof approved, imposing, queued for print, sent to Caldera, printing, printed, at Zund cutter, cut, dispatched. Needs-action states: missing file, preflight failed, with design team, on hold (unpaid), proof rejected, duplicate. Each item also returns the press and the print timestamp.

  Paramètres, retour & exemple (5)

  Paramètres

  • token · string · optionnel
    identity token from vivid_identity_verify — REQUIRED to see any details. Without it a 6-digit code is emailed to customer_email and the tool returns need_verification.
  • order_id · string · optionnel
    Shopify order GID, e.g. gid://shopify/Order/123.
  • order_name · string · optionnel
    Human order name, e.g. "#12345" (alias for order_id).
  • line_item_id · string · optionnel
    Optional Shopify line item GID to scope to one item.
  • customer_email · string · requis
    The email address on the order. REQUIRED for identity — order details are only returned when this email matches the order. The customer must give their email AND one of their order numbers.

  Exemple d'appel

  {"name": "vivid_fulfilment_production_stage", "arguments": {"customer_email": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• vivid_fulfilment_shipping≈ 331 tokens

  StarShipit shipping: carrier, tracking number, tracking URL, ETA and delivered flag. shipping_state: not_dispatched, shipped, in_transit, out_for_delivery, delivered, exception.

  Paramètres, retour & exemple (5)

  Paramètres

  • token · string · optionnel
    identity token from vivid_identity_verify — REQUIRED to see any details. Without it a 6-digit code is emailed to customer_email and the tool returns need_verification.
  • order_id · string · optionnel
    Shopify order GID, e.g. gid://shopify/Order/123.
  • order_name · string · optionnel
    Human order name, e.g. "#12345" (alias for order_id).
  • line_item_id · string · optionnel
    Optional Shopify line item GID to scope to one item.
  • customer_email · string · requis
    The email address on the order. REQUIRED for identity — order details are only returned when this email matches the order. The customer must give their email AND one of their order numbers.

  Exemple d'appel

  {"name": "vivid_fulfilment_shipping", "arguments": {"customer_email": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• vivid_identity_start≈ 220 tokens

  Start email verification before showing a customer's private data (past orders, reorder, saved address, email order-status). Sends a 6-digit code to the email. Returns a verificationId. Then ask the customer for the code and call vivid_identity_verify. Use this whenever a customer asks to see 'my orders', 'reorder', or 'status by email' and you don't already have a valid identity token.

  Paramètres, retour & exemple (2)

  Paramètres

  • email · string · requis
    the customer's email to verify
  • purpose · string · optionnel
    reorder | order_status | saved_details (optional)

  Exemple d'appel

  {"name": "vivid_identity_start", "arguments": {"email": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• vivid_identity_verify≈ 207 tokens

  Complete email verification: pass the verificationId from vivid_identity_start and the 6-digit code the customer received. On success returns a short-lived identity token — pass that token to vivid_reorder / vivid_order_status to unlock the customer's private data. Codes expire in 10 minutes; attempts are limited.

  Paramètres, retour & exemple (2)

  Paramètres

  • code · string · requis
    the 6-digit code the customer received by email
  • verificationId · string · requis
    from vivid_identity_start

  Exemple d'appel

  {"name": "vivid_identity_verify", "arguments": {"code": "texte", "verificationId": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• vivid_order_artwork≈ 369 tokens

  Show a VERIFIED customer the PRINT-READY artwork files produced for one of their past orders (the actual files that went to print), so they can confirm them before reordering. Requires the order number and a valid identity token bound to the customer's email; only returns artwork for orders that belong to that customer. Returns view links to each print layout. Use when a customer asks 'what artwork did I print', 'show me my last print file', or before confirming a reorder. CODE REQUIRED: needs the customer's email AND a verified identity token. Without a token this tool emails the customer a 6-digit code and returns status need_verification with a verificationId — ask the customer for the code, call vivid_identity_verify, then call this tool again with the token. It shows nothing before that.

  Paramètres, retour & exemple (3)

  Paramètres

  • email · string · requis
    the customer's email (must match the identity token)
  • order · string · requis
    the order number to show artwork for, e.g. '117478'
  • token · string · optionnel
    the identity token from vivid_identity_verify (required — proves the customer owns this email/order)

  Exemple d'appel

  {"name": "vivid_order_artwork", "arguments": {"email": "texte", "order": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• vivid_order_status≈ 367 tokens

  Check the LIVE status of an order — real production stage (from the Enfocus Switch print workflow), ready-for-pickup, or shipped with carrier + tracking (from StarShipit, authoritative). Look up a real order by number (e.g. #119581) or a quote/draft by number (e.g. #D776755). Requires the customer's email, which must match the order. Use for 'where is my order', 'track order 12345', 'is my order ready'. Shipped/delivered from StarShipit is final; otherwise the live Switch stage is returned. CODE REQUIRED: needs the customer's email AND a verified identity token. Without a token this tool emails the customer a 6-digit code and returns status need_verification with a verificationId — ask the customer for the code, call vivid_identity_verify, then call this tool again with the token. It shows nothing before that.

  Paramètres, retour & exemple (3)

  Paramètres

  • email · string · optionnel
    the email the order was placed under (always required)
  • token · string · optionnel
    identity token from vivid_identity_verify (required to see any details; without it a code is emailed to the customer)
  • reference · string · optionnel
    order # or quote/draft # (e.g. '#119581' or '#D776755')

  Exemple d'appel

  {"name": "vivid_order_status", "arguments": {"email": "texte", "token": "texte", "reference": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• vivid_place_order≈ 820 tokens

  Create a Shopify DRAFT order for Vivid Ads team review — NOT a final/placed order, and NEVER charges a card. Before calling, summarise the exact product, quantity, configuration, verified price (if available), customer details, and delivery/pickup, then get the customer's explicit confirmation. Call WITHOUT confirm to get a Review summary; confirm:true only AFTER they confirm. Do NOT auto-retry after a timeout without first checking whether a draft was already created. Payment is a secure invoice/pay-link from the team; production waits on proof approval. Artwork is OPTIONAL here: an order can be placed with no file at all — the customer uploads later via the upload link emailed when the order is placed, or any time from My Account on the customer portal (portal.vividads.com.au), so never hold up an order waiting for artwork.

  Paramètres, retour & exemple (15)

  Paramètres

  • name · string · optionnel
  • size · string · optionnel
  • email · string · requis
  • items · array · optionnel
    For a MULTI-LINE order (e.g. two banners with DIFFERENT designs): one entry per line, each { product, size?, options?, quantity?, artwork? }. Different designs must be SEPARATE entries (quantity 1 each) with their OWN artwork. If provided, this replaces the single top-level product; contact/delivery/PO stay at the top level.
  • phone · string · optionnel
  • artwork · object · optionnel
    { mode:'ai_design'|'upload_file'|'design_brief', designId?, imageUrl?, printPdfUrl?, fileUrl?, brief? }
  • company · string · optionnel
  • confirm · boolean · optionnel
    set true ONLY after the customer reviews and confirms
  • options · object · optionnel
    FULL selected options (same shape as vivid_price.options). Use vivid_product to see them. Prefer this over `size` for option-rich products.
  • product · string · optionnel
  • delivery · object · optionnel
    pickup or delivery details. PICKUP: { method:'pickup', name, email, phone, pickupLocation?, notes? }. DELIVERY: { method:'delivery', name, email, phone, company?, address1, address2?, suburb, state, postcode, country, notes? }. Contact (name/email/phone) can live here or at the top level. Omit entirely to keep the old behaviour.
  • poNumber · string · optionnel
  • quantity · number · optionnel
  • customerType · string · optionnel
    retail|corporate|school|government|account — sets payment terms
  • idempotency_key · string · optionnel
    optional: a unique key for this request — a retry with the same key returns the first result instead of repeating the action

  Exemple d'appel

  {"name": "vivid_place_order", "arguments": {"email": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• vivid_price≈ 515 tokens

  Calculate the current price for an EXACT product configuration. Pass `options` with the full selected configuration (use vivid_product first), or just `size` for simple products. Some products take several seconds or need manual confirmation. Before calling, briefly tell the customer you're checking the live price. Never estimate or reuse another configuration's price. When presenting, repeat the exact product title, quantity, dimensions, and price-affecting options.

  Paramètres, retour & exemple (4)

  Paramètres

  • size · string · optionnel
    (simple products) size, e.g. '850x2000', or a named size like 'medium'
  • options · object · optionnel
    FULL selected options keyed by the schema keys from vivid_product, e.g. { size:'Medium', sides:'Double-sided', base:'Heavy Duty Metal Plate (5kg)' } or { size:'Custom', widthMm:700, heightMm:1000, eyelets:'4 x eyelets (all corners)', cutting:'Square or Rectangle' }
  • product · string · requis
    product name, e.g. 'pull up banner', 'corflute', 'a-frame', 'feather flag'
  • quantity · number · optionnel
    how many

  Exemple d'appel

  {"name": "vivid_price", "arguments": {"product": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"size": "texte", "sizes": "texte", "addOns": "texte", "status": "texte", "message": "texte", "product": "texte", "summary": "texte", "currency": "texte", "quantity": "texte", "unitPrice": 1, "agent_note": "texte", "totalPrice": 1}}

• vivid_price_breaks≈ 381 tokens

  Vivid's REAL published volume price breaks for a product + size (e.g. 1 → $135 ea, 2 → $132.30, 5 → $128.25, 10 → $121.50 — save 10%). Use for bulk/trade pricing questions, or right after a price when a slightly larger quantity would save the customer money. Prices are AUD incl. GST and come from the same source as the live price, so they can never contradict a quote. If the product has no breaks it says so — never invent a discount.

  Paramètres, retour & exemple (3)

  Paramètres

  • size · string · optionnel
    size — breaks are per size/variant
  • product · string · requis
    product name, e.g. 'premium pull up banner'
  • quantity · number · optionnel
    the customer's current quantity, to highlight the next worthwhile break

  Exemple d'appel

  {"name": "vivid_price_breaks", "arguments": {"product": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"size": "texte", "tiers": "texte", "status": "texte", "message": "texte", "product": "texte", "nextTier": "texte", "agent_note": "texte", "currentTier": "texte"}}

• vivid_product≈ 376 tokens

  Get a product's FULL real option schema (all dimensions, not just size) so you can configure it correctly before pricing/ordering. Returns each option's key, label, allowed values, default, whether it's required, whether it affects price, and display order — plus `turnaround` (the live production/lead time from the product page, e.g. 24 hours if artwork is approved by 3 pm AEST on a business day). Flags have Size/Printed Sides/Flag Base; corflute has Size (or custom W×H)/Eyelets/Cutting; table throws have Style/Size/Backside.

  Paramètres, retour & exemple (1)

  Paramètres

  • product · string · requis
    product name, e.g. 'feather flag', 'corflute', 'table throw'

  Exemple d'appel

  {"name": "vivid_product", "arguments": {"product": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"name": "texte", "status": "texte", "message": "texte", "options": [], "product": "texte", "agent_note": "texte", "turnaround": "texte", "pricingType": "texte", "instantPrice": "texte"}}

• vivid_proof_status≈ 366 tokens

  Check a customer's DIGITAL PROOF status: has the proof been emailed, is it awaiting their approval, being revised after rejection, or already approved (production underway). Use for 'where's my proof', 'did you send my proof', 'when do I approve'. Requires the order number AND the email on the order (identity — details only return when they match). Relay the returned agent_hint concisely; production starts only after the customer approves the emailed proof. CODE REQUIRED: needs the customer's email AND a verified identity token. Without a token this tool emails the customer a 6-digit code and returns status need_verification with a verificationId — ask the customer for the code, call vivid_identity_verify, then call this tool again with the token. It shows nothing before that.

  Paramètres, retour & exemple (3)

  Paramètres

  • email · string · requis
    the email address the order was placed under (required)
  • token · string · optionnel
    identity token from vivid_identity_verify. Without it the proof STATE is returned but not the approve/reject link.
  • order_number · string · requis
    order number, e.g. '#121978'

  Exemple d'appel

  {"name": "vivid_proof_status", "arguments": {"email": "texte", "order_number": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• vivid_recommend≈ 404 tokens

  Recommend Vivid Ads signage for a goal + business type (real Australian signage: pull-up banners, A-frames, corflute, fabric banners, flags, media walls). Call with goal and business; omit either to get the next question to ask the customer.

  Paramètres, retour & exemple (2)

  Paramètres

  • goal · string · optionnel
    e.g. foot-traffic, promote-sale, stand-out-expo, advertise-outside, opening-store, brand-presence
  • business · string · optionnel
    e.g. cafe-hospitality, retail, real-estate, events-expo, corporate, school, gym-fitness

  Exemple d'appel

  {"name": "vivid_recommend", "arguments": {"goal": "texte", "business": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"status": "texte", "message": "texte", "options": "texte", "products": [], "question": "texte", "agent_note": "texte"}}

• vivid_reorder≈ 611 tokens

  Reorder a customer's previous signage job — fast. Requires identity verification (emailed one-time code), not just an order number. action:'list' shows their past orders; action:'reorder' repeats one. ARTWORK: it reuses only the customer's previously APPROVED artwork (the print file), never a pre-approval upload; if it can't be confirmed automatically the team confirms it. A fresh proof is ALWAYS re-issued to confirm the artwork before printing. The customer may also supply new artwork or change the quantity. Re-prices with CURRENT pricing (never the old price). Creates a proof-gated draft order; never charges a card. CODE REQUIRED: needs the customer's email AND a verified identity token. Without a token this tool emails the customer a 6-digit code and returns status need_verification with a verificationId — ask the customer for the code, call vivid_identity_verify, then call this tool again with the token. It shows nothing before that.

  Paramètres, retour & exemple (10)

  Paramètres

  • name · string · optionnel
  • email · string · requis
    the email the customer ordered under (required to find past orders)
  • order · string · optionnel
    order name to reorder from, e.g. '#D12345' (optional)
  • token · string · optionnel
    the identity token from vivid_identity_verify (required — proves the customer owns this email)
  • action · string · optionnel
    'list' (show past orders) or 'reorder' (repeat one)
  • artwork · string · optionnel
    new print-ready artwork file URL (optional; default = reuse previous)
  • confirm · boolean · optionnel
    set true to place the reorder (draft, proof-gated, never charges)
  • product · string · optionnel
    which product to reorder, e.g. 'corflute' (optional; default = most recent eligible)
  • quantity · number · optionnel
    override quantity (optional; default = same as last time)
  • idempotency_key · string · optionnel
    optional: a unique key for this request — a retry with the same key returns the first result instead of repeating the action

  Exemple d'appel

  {"name": "vivid_reorder", "arguments": {"email": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• vivid_request_quote≈ 482 tokens

  Email the customer a formal QUOTATION. If the exact configuration can be priced and an email is given, this INSTANTLY emails a branded PDF-style quotation (line items, GST, total, quote number, 14-day validity, accept-online link) — status 'quoted'. For custom/unpriceable products it logs the request for the team to prepare and send (status 'received'). Never takes payment. Confirm product, quantity, size/options, name, and email before submitting.

  Paramètres, retour & exemple (13)

  Paramètres

  • name · string · optionnel
  • size · string · optionnel
  • email · string · requis
  • phone · string · optionnel
    customer phone (optional)
  • design · string · optionnel
    design preference: 'ai_design' | 'upload_own' | 'design_later'
  • company · string · optionnel
  • message · string · optionnel
    the customer's full request in their own words (multi-item OK)
  • options · object · optionnel
    FULL selected options (same shape as vivid_price.options) so the quotation is priced exactly — include size + any dropdowns/add-ons.
  • product · string · optionnel
  • quantity · number · optionnel
  • artworkUrl · string · optionnel
    link to the customer's uploaded artwork (e.g. the fileUrl returned by vivid_upload_artwork), if any
  • discountCode · string · optionnel
    any reseller/trade or discount code the customer mentioned (recorded, NOT applied here)
  • idempotency_key · string · optionnel
    optional: a unique key for this request — a retry with the same key returns the first result instead of repeating the action

  Exemple d'appel

  {"name": "vivid_request_quote", "arguments": {"email": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• vivid_search≈ 597 tokens

  Search the Vivid Ads catalogue by product name, category, or intended use (e.g. 'corflute', 'pull up banner', 'expo', 'shopfront'). Returns matching products grounded in Vivid's own Shopify collections, so it also surfaces same-range, same-purpose alternatives — products flagged `sameRange:true` come from the top match's curated collection (returned as `collection`). ALWAYS mention these to the customer (e.g. 'we have two Pull Up Banner options, and Fabric Banner Stands do the same job'). Treat a from-price as INDICATIVE only — use vivid_product for options then vivid_price for the exact configuration. Paginated: returns `total`, `has_more` and `next_offset`; pass `offset` to get the next page.

  Paramètres, retour & exemple (3)

  Paramètres

  • limit · integer · optionnel
    max products to return (default 8)
  • query · string · requis
    what the customer is looking for (a product name, a category, or a use-case like 'expo' or 'shopfront')
  • offset · integer · optionnel
    skip this many results — use next_offset from the previous page (default 0)

  Exemple d'appel

  {"name": "vivid_search", "arguments": {"query": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"count": 1, "query": "texte", "total": 1, "offset": 1, "status": "texte", "message": "texte", "has_more": true, "products": [], "agent_note": "texte", "collection": "texte", "next_offset": 1}}

• vivid_support_answer≈ 347 tokens

  Answer a customer's support / FAQ question in Vivid Ads' voice, grounded in the team's real support history + verified policy. Covers turnaround & production time, digital proofs & approval, artwork specs & file setup, products & options, quotes & pricing, delivery & pickup, changing/cancelling orders, reorders, and the print guarantee. Returns the best-matching answer(s) and topic; if nothing matches it returns escalate:true so you can hand off to the team. Use for questions like 'how long does it take?', 'what file format do you need?', 'can I change my order?', 'where do I pick up?'.

  Paramètres, retour & exemple (1)

  Paramètres

  • question · string · requis
    the customer's support question, in their own words

  Exemple d'appel

  {"name": "vivid_support_answer", "arguments": {"question": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}], "structuredContent": {"source": "texte", "status": "texte", "answers": "texte", "message": "texte", "escalate": "texte", "agent_note": "texte"}}

• vivid_upload_artwork≈ 542 tokens

  Upload a customer's artwork FILE through the agent (no website file picker needed). Accepts the file as base64, stores it in Vivid's Google Drive, and returns a stable shareable link plus metadata. Accepts PDF / AI / EPS / JPG / PNG. Does NOT verify print-readiness — the team checks that. Uploading needs no verification, but ATTACHING the file to an existing order does: pass the identity token from vivid_identity_verify, otherwise the file is held unattached and the reply says so. Use when a customer wants to send their print file via chat.

  Paramètres, retour & exemple (9)

  Paramètres

  • email · string · optionnel
    customer email (optional). Only recorded once verified — see token.
  • token · string · optionnel
    identity token from vivid_identity_verify. Required to attach this upload to an order or to record the email; without it the file is still stored, just not claimed by anyone.
  • orderId · string · optionnel
    attach to an existing order (optional). Ignored unless a valid token is supplied — an unverified caller must not be able to put a file on somebody else's order.
  • quoteId · string · optionnel
    associate with a quote request (optional)
  • filename · string · requis
    original filename incl. extension, e.g. 'banner-artwork.pdf'
  • mimeType · string · optionnel
    MIME type, e.g. 'application/pdf'
  • sessionId · string · optionnel
    associate with a design session (optional)
  • contentBase64 · string · requis
    the file contents, base64-encoded (data URI prefix OK). Small files only; for very large files share a download link instead.
  • idempotency_key · string · optionnel
    optional: a unique key for this request — a retry with the same key returns the first result instead of repeating the action

  Exemple d'appel

  {"name": "vivid_upload_artwork", "arguments": {"filename": "texte", "contentBase64": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

C'est votre serveur ?

Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».

Créer un compte / revendiquer →

Source

https://agent.vividads.com.au/api/ucp/public/mcp