Agentee MCP Server

The user's own published designs with live status (products on sale / hidden / pending). Args: limit? (default 50).

The user's designer-program stats (if they are a designer-partner): units sold, revenue, accrued royalties, available for payout, royalty percent, their designer page URL.

The user's Studio publications in moderation: in review / in catalog / needs changes. Args: limit?.

Get a short-lived URL to upload an image file to us (use when the designer has no public link — otherwise pass the URL straight to submit_design). Args: filename?. PUT the raw bytes to upload_url, then pass the returned upload_id to submit_design.

What the designer has already sent in and where it stands: in review / accepted / needs changes (with the reason). Args: limit?.

Add a product to the user's cart. Args: good_id (from search/get_product), size (must be one of the product's sizes), fabric? (if the product offers a choice), qty? (default 1). Returns the updated cart.

Remove a cart line by its index (from view_cart). Args: index.

Change a cart line by its index (from view_cart): set qty (0 removes), or switch size/fabric. Args: index, qty?, size?, fabric?.

Change the quantity of a cart line by its index (from view_cart); qty=0 removes it. Args: index, qty.

The user's Studio credit balance. Check before studio_generate (1 credit per generation, either engine; welcome bonus 20; every bought tee adds 20).

Generate a CUSTOM t-shirt print from a text prompt (AI, takes 2-10 min, costs the user's Studio credits — a free starter balance is auto-granted on first use). IMPORTANT: first call studio_options and ask the human to pick placement + product (and optionally background); do NOT silently use defaults. Args: prompt (design description), product? (one of ['kids_basic_tshirt_boy', 'kids_basic_tshirt_girl', 'kids_oversize_tshirt_boy', 'kids_oversize_tshirt_girl', 'mens_basic_tshirt', 'mens_oversize_tshirt', 'womens_basic_tshirt', 'womens_oversize_tshirt']), background? (t-shirt background, one of ['washed-beige', 'washed-black', 'washed-blue', 'washed-brown', 'washed-gray', 'washed-green', 'washed-orange', 'washed-pink', 'washed-red', 'washed-yellow', 'watercolor-beige', 'watercolor-blue', 'watercolor-sky']), placement? (print size/position, one of ['portrait_extended', 'square_center', 'chest_small']), model? (nb2 default | gpt-image-2 — both 1 credit, different styles), image_url? (https link to the user's OWN image — used as style/subject reference), preserve? (true = print the user's image exactly as-is, no AI redraw — kids' drawings, own art; FREE, no credits; requires image_url). Returns print_id — poll studio_status until done.

START HERE for any custom-print request: the menu of generation choices (print placements with plain-language descriptions, products, backgrounds, engines+costs). Present these to the human — at minimum ask which PLACEMENT and which PRODUCT they want — before calling studio_generate.

Check a custom print generation. Args: print_id (from studio_generate). When done returns preview_url — show it to the human.

Available shipping methods for the current cart/address, with price and ETA (free over the threshold).

Set the shipping address for this order (validated). Args: name, country, city, address, zip?, phone.

Choose a shipping method by its option_id (from get_shipping_options). Args: option_id.

Full order summary to show the human before ordering: line items, promo/discount, shipping, address, grand total. Prices are server-computed.

Look up the user's recent orders (or one by number) and their fulfilment status. Args: number?, limit? (default 5).

Return the shopper's saved default size and fit. Call this BEFORE asking the user for a size — if a default is set, apply it automatically (add_to_cart uses it when size is omitted), and prefer products matching their fit (basic vs oversized).

Save the shopper's default size and/or fit so they don't re-enter it each time. Args: size (XS…5XL), fit (basic | oversized). Pass only what the user stated.

Validate and apply a promo code to the cart (server-checked). Returns the new discount/shipping/total, or applied=false with a reason. Args: code.

Get the URL where the human opens their cart to review and pay. The agent never pays — checkout is always done by the person in the browser.

List active curated collections (themed landing pages) with their slugs and urls. Args: limit?.

Put a FINISHED custom print into the cart as a product. Args: print_id (must be done), product? (same set as studio_generate), size, qty?. Then the normal checkout flow applies (get_order_preview -> prepare_order).

Create a draft order from the cart + address + promo and return {checkout_url, draft_id, expires_at}. The human opens checkout_url — everything is pre-filled — reviews and pays. The agent never pays. Call get_order_preview and confirm with the human first.

Full details of one product by its code: available sizes, fabrics, per-variant price, and the design 'about' text. Args: code (from search_products).

Search the allover.art catalog (one card per design). Args: query? (free text, e.g. 'cat', 'neon koi'), theme? (canonical theme like Cats/Anime/Skulls, comma-separated for several), section? (mens|womens|kids), limit? (<=48), max_price? (USD). Returns product cards with good_id, price and url.

Remove the applied promo code from the cart.

Return shipping addresses the user used in past orders — offer these to a returning buyer instead of asking again.

Send one of the designer's own artworks for moderation. front/back accept EITHER a public image URL OR an upload_id from designer_upload_slot. Args: name (required), front (required), back?, layout? ('front_back' default, or 'r10' for a ready print-side file), note?, batch? (same string across a bulk run so the moderator sees them as one batch). Minimum 2048px on the short side. IMPORTANT for the designer: this queues the artwork for moderation — catalog listing follows production and is not instant.

Show the current contents of the user's cart (the same cart they see in the browser when signed in).