art.allover/agentee

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Shop all-over print cotton tees with your AI agent: search, cart, promos, checkout. Human pays.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "agentee": {
      "url": "https://allover.art/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (22)

• search_products read-only

  Search the allover.art catalog; returns one card per design (good_id, code, price, url) plus the total match count. Use it for any 'find me a …' request — list_collections is for curated themed pages, get_product for one card's sizes and fabrics. Filters combine: query is free text ('cat', 'neon koi'); theme is a canonical theme (Cats, Anime, Skulls; comma-separate several); style should follow the shopper's saved fit from get_user_prefs (basic → tee, oversized → oversized); max_price is USD. Ranked by relevance with a query, by best-sellers without. No paging: you get the top `limit` (default 24, max 48), so narrow the filters to reach the rest. Adult-only designs are excluded; an unknown color or style returns an error listing the valid values.

  Parameters:

  • color — string — Main color of the print.
  • limit — integer — Max cards to return (default 24, max 48).
  • query — string — Free-text search, e.g. 'cat' or 'neon koi'.
  • style — string — Garment cut: tee, oversized, long_sleeve or oversized_long_sleeve.
  • theme — string — Canonical theme filter (Cats, Anime, Skulls, ...); comma-separate several.
  • section — string — Catalog section.
  • max_price — number — Only items priced at or below this amount, USD.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_product read-only

  Get one product by its code: available sizes, fabrics, the price of each size+fabric variant, and the design's 'about' text. Call it before add_to_cart when the human hasn't picked a size yet or may want another fabric — a search card doesn't list them. code is the `code` field of a search_products card (the end of its /p/<code> url); add_to_cart then takes the numeric good_id, which this result also returns. Read-only; an unknown code returns error 'product not found'.

  Parameters:

  • code (required) — string — Product code from search_products results.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• list_collections read-only

  List active curated collections — themed landing pages on allover.art, trending first — with title, slug and url. Use it when the human wants ideas or a themed page to browse; send them the url. Collections are not a search filter: to find products in a theme, call search_products with theme or query. limit caps the list (default 50, max 100). Read-only.

  Parameters:

  • limit — integer — Max collections to return (default 50, max 100).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• view_cart read-only

  Show the lines in the user's cart with qty, size, fabric and subtotal. It is the same server-side cart the human sees at allover.art/cart when signed in, so items they added in the browser appear here too. Use it to get the zero-based line index that update_cart_item takes — re-read after removing a line, since later indexes shift. Prices are as added; for the payable total with fresh prices, promo and shipping use get_order_preview. Read-only.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• add_to_cart

  Add a catalog product to the user's cart and return the updated cart. good_id comes from a search_products or get_product result; size must be one of get_product's sizes — omit it to use the shopper's saved default from get_user_prefs. Omit fabric to take the first one offered in that size. qty (default 1) is added: if the same product, size and fabric is already in the cart, that line grows (capped at 99) instead of a new line appearing. An unknown good_id or unavailable size returns an error listing the available sizes, and the cart stays unchanged. For an AI-generated print use add_custom_to_cart; to change a line already in the cart, update_cart_item.

  Parameters:

  • good_id (required) — integer — Numeric product id from search_products/get_product.
  • qty — integer — Quantity to add (default 1, max 99).
  • size — string — Size label; must be one of the product's available sizes. Optional when a default size is saved.
  • fabric — string — Fabric label from get_product, if the product offers a choice.

  Hints: read-only no · destructive no · idempotent no · open-world no

• get_order_status read-only

  Look up orders placed with the signed-in account's email — the latest ones, or one by its number — with status, total and a tracking page url. Use it for 'where is my order'; for an order not placed yet use get_order_preview. status is e.g. draft (unpaid, from prepare_order), pending_payment, paid, in_production, shipped, delivered or cancelled. number is the full order number such as AO-261023-1234; without it you get the newest orders first (limit default 5, max 20). Read-only: it can't cancel or change an order. An account with no email returns an empty list and a note.

  Parameters:

  • limit — integer — Max orders to return (default 5, max 20).
  • number — string — Exact order number to look up, e.g. AO-261023-1234; omit for the most recent orders.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• update_cart_item destructive

  Change one line already in the cart, addressed by its zero-based index from view_cart: set qty (0 removes the line; max 99) and/or switch size or fabric, which re-prices the line. Pass only what changes. After a removal the lines below move up one index, so re-read view_cart before the next edit. A bad index or an unavailable size/fabric returns an error (with the sizes on offer) and changes nothing. Returns the updated cart. To add a different product use add_to_cart.

  Parameters:

  • index (required) — integer — Zero-based cart line index from view_cart.
  • qty — integer — New quantity; 0 removes the line.
  • size — string — New size for this line (must be available for the product).
  • fabric — string — New fabric for this line (must be available for the product).

  Hints: read-only no · destructive yes · idempotent no · open-world no

• apply_promo

  Validate a promo code the human gave you and attach it to the cart. Returns applied=true with the new subtotal, discount, shipping and total, or applied=false with a reason — an invalid or expired code, or a bundle price in the cart that beats it (codes don't stack with bundle pricing). Codes are case-insensitive and a cart holds one: a valid new code replaces the current one, a rejected one leaves it in place; remove_promo just drops it. Needs at least one item in the cart. Never guess or try codes the human didn't give. The code is re-checked in get_order_preview and prepare_order.

  Parameters:

  • code (required) — string — Promo code exactly as the human gave it (case-insensitive).

  Hints: read-only no · destructive no · idempotent yes · open-world no

• remove_promo

  Drop the promo code from the cart, so totals go back to full price (a bundle price, if any, still applies). Use it when the human no longer wants the code; it isn't needed before apply_promo, which replaces the code anyway. Safe to repeat: with no code applied or an empty cart it does nothing and still returns applied=false.

  Hints: read-only no · destructive no · idempotent yes · open-world no

• get_user_prefs read-only

  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 search in their fit: search_products style='oversized' for oversized, style='tee' for basic.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• set_user_prefs

  Save the shopper's default size and/or fit on their allover.art account, so later chats can skip asking. Call it only when the human states a size or fit or asks you to remember one; read it back with get_user_prefs. Pass only what they stated: an omitted field keeps its saved value, an empty string clears it. size is XS, S, M, L, XL or 2XL–5XL (case-insensitive); fit is basic or oversized. The saved size fills in add_to_cart when size is omitted, and the fit maps to search_products style (basic → tee, oversized → oversized). Any other value returns an error and saves nothing.

  Parameters:

  • fit — string — Fit preference: basic or oversized; empty string clears it.
  • size — string — Default size: XS, S, M, L, XL, 2XL…5XL; empty string clears it.

  Hints: read-only no · destructive no · idempotent yes · open-world no

• get_saved_addresses read-only

  Return up to 5 distinct shipping addresses from the user's past orders (matched by the account email), newest first. For a returning buyer, call it before asking for an address, show the options, and pass the one they pick to set_shipping_address — this tool only reads and selects nothing. An empty list means no past orders: ask the human for the address.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• set_shipping_address

  Set the delivery address for the current cart's checkout; get_order_preview and prepare_order use it. Needs at least one item in the cart and replaces any address set before. For a returning buyer, offer get_saved_addresses first and pass the chosen one here. The phone is normalized to international form; if that fails the result carries a warning — ask the human for the number with its country code, since the courier calls it. Only the required fields and the phone are checked; the street itself is not verified. Missing fields or an empty cart return an error and save nothing. The country can switch the order to local currency (UZS for Uzbekistan).

  Parameters:

  • name (required) — string — Recipient full name.
  • country (required) — string — Destination country: name or 2-letter code, e.g. 'Australia' or 'AU'.
  • city (required) — string — Destination city.
  • address (required) — string — Street, house and apartment in one line.
  • phone (required) — string — Recipient phone, ideally with country code, e.g. +61 412 462 423.
  • zip — string — Postal / ZIP code; omit where the country has none.

  Hints: read-only no · destructive no · idempotent yes · open-world no

• get_shipping_options read-only

  List the shipping methods for the current cart with price, ETA and the free-shipping threshold. Today there is one: worldwide tracked shipping, 7–14 business days, free once the cart subtotal reaches free_shipping_from. Use it to answer 'how much / how long is shipping' or to tell the human how much more gets free shipping. Read-only and works on an empty cart too. Prices here are USD for the cart as it is; the final shipping amount, in the destination's currency, is in get_order_preview.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• set_shipping_method

  Select the shipping method for the current cart's checkout by an id from get_shipping_options. Only 'worldwide' exists today and it is already the default, so this call is optional — use it when the human explicitly picks a method, or once more methods appear. Needs at least one item in the cart; an unknown option_id returns an error and changes nothing. Repeating it is harmless.

  Parameters:

  • option_id — string — Shipping option id from get_shipping_options (currently 'worldwide').

  Hints: read-only no · destructive no · idempotent yes · open-world no

• get_order_preview read-only

  Show the full order before checkout: re-priced lines, promo or bundle discount (they don't stack — the better one applies), shipping, the address from set_shipping_address, and the grand total in the order currency (local for some destinations, e.g. UZS for Uzbekistan). Call it once the address is set and show the result to the human for confirmation before prepare_order. Read-only and safe to repeat; prices come from the live catalog, not from the cart. ready_to_prepare stays false while the address is missing or a line is unavailable — fix what issues lists (update_cart_item, set_shipping_address) first. An empty cart returns an error.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• prepare_order

  Turn the cart, address and promo into a draft order and return {checkout_url, draft_id, expires_at}. Send checkout_url to the human: checkout opens pre-filled and they review and pay themselves — the agent never pays. Call it only after showing get_order_preview and getting the human's OK. Each call creates a NEW draft with its own number, so call it once per purchase; the cart itself is not emptied. The draft expires after 48 hours. Prices are re-checked; an empty cart, a missing address or no orderable items return an error (with issues) and create nothing.

  Hints: read-only no · destructive no · idempotent no · open-world no

• get_studio_options read-only

  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 generate_custom_print.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• generate_custom_print

  Generate a CUSTOM t-shirt print from a text prompt (AI, takes 2-10 min). SPENDS THE ACCOUNT OWNER'S STUDIO CREDITS: tell them the cost and their balance and get a yes BEFORE calling this — never spend silently, and never spend to 'try something' on your own initiative. Credits are earned (20 free on signup, 20 with every tee bought), so a wasted one is a real loss to them. Free exception: preserve=true prints their own image as-is and costs nothing. IMPORTANT: first call get_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 get_studio_status until done.

  Parameters:

  • prompt (required) — string — Text description of the design to generate.
  • model — string — Generation engine: nb2 (default) or gpt-image-2 — both 1 credit.
  • product — string — Studio product base from get_studio_options (default mens_oversize_tshirt).
  • preserve — boolean — true = print the image exactly as-is, no AI redraw (free); requires image_url.
  • image_url — string — https link to the user's OWN image, used as style/subject reference.
  • placement — string — Print size/position: portrait_extended (default), square_center or chest_small.
  • background — string — T-shirt background choice (see get_studio_options backgrounds).

  Hints: read-only no · destructive no · idempotent no · open-world yes

• get_studio_status read-only

  Poll a custom print started by generate_custom_print. status 'done' and 'failed' are final; anything else means still working — poll about every 30 seconds (generation takes 2–10 min) and don't start another generation meanwhile, since an account runs one at a time. When done it returns preview_url (the raw image: embed or attach it so the human sees the print) and design_url (the page to share); then offer add_custom_to_cart with the same print_id. 'failed' carries the reason, and its credits are refunded automatically. Read-only — polling costs nothing.

  Parameters:

  • print_id (required) — string — Generation id returned by generate_custom_print; the same id goes to add_custom_to_cart.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_studio_credits read-only

  Return the account owner's Studio credit balance; reading it spends nothing. Check it before generate_custom_print so you can tell the human the cost (1 credit per generation with either engine; preserve=true is free) and what will be left. No Studio account yet → balance 0 and studio_account=false; the first generation creates the account with 20 welcome credits. Every bought tee adds 20 credits, and more can be bought at allover.art/studio.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• add_custom_to_cart

  Put a finished custom print (from generate_custom_print) into the cart as a garment and return the updated cart. Call it once get_studio_status reports done and the human has chosen product and size; for catalog designs use add_to_cart instead. product is the garment the human picked in get_studio_options (default mens_oversize_tshirt); size must exist for it — an error lists the sizes. Adding the same print on the same product and size again grows that line (max 99). An unfinished print returns 'print is not ready' and nothing is added. Then checkout goes as usual: set_shipping_address → get_order_preview → prepare_order.

  Parameters:

  • print_id (required) — string — Finished print id — get_studio_status must report status=done.
  • size (required) — string — Size label; must be available for the chosen product.
  • qty — integer — Quantity (default 1, max 99).
  • product — string — Studio garment base, as chosen in get_studio_options (default mens_oversize_tshirt).

  Hints: read-only no · destructive no · idempotent no · open-world no

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.