AgentFirst

List Products

List products available to buy and customize (t-shirts, mugs, caps), with base prices and variant counts.

Get Product

Get full details for one product by slug (e.g. classic-tee, ceramic-mug, dad-cap): description, base price, and all color/size variants.

Create Design

Create print artwork for a product. Use this when the user wants custom merch artwork. Pass an imageUrl (existing image) OR a prompt to generate transparent-background print art server-side. For quote/slogan merch, wrap the exact quote in double quotes inside the prompt (e.g. prompt: '"Ship It" in bold retro type') — the server renders a typographic lockup tuned to read on both black and white garments. Returns a design preview widget, design id, and URL. Keep designs original: no brand logos or

Analyze Brand

Extract a company's public website brand signals (name, colors, logo) and create standalone transparent merch design concepts. Use this before create_design when the user provides a company domain or asks for branded event merch.

Add To Cart

Add a product variant (by SKU, from get_product) to the cart, optionally printed with a design from create_design.

Get Cart

Show the current cart contents and total.

Remove From Cart

Remove a line from the current cart by its 1-based line number from get_cart. Use this when the user changes their mind or asks to fix the cart.

Create Checkout

Create a Stripe (test mode) checkout link for the current cart. Returns a URL the user opens to pay; the order is recorded immediately and marked paid after payment.

Get Order Status

Check an order's status (pending -> paid -> fulfilled). Defaults to this session's most recent order if no orderId given.