MCP MeasureMCP Measure

index observed

agentee

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

Should I use this

Quality & Safety

A
Description quality
97%
Schema completeness
73%
Naming quality
90%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Findings (2)

  • LOWTool 'order_status' description lacks action verbin order_status
  • LOWTool 'designer_stats' description lacks action verbin designer_stats

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~9,282Tokens (tool definitions)
~2.1 KBTypical response size
Significant attention impact (7.25% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "agentee": {
      "url": "https://allover.art/mcp"
    }
  }
}

Remote endpoints

https://allover.art/mcpstreamable-http

What it can do

Tool inventory

Tools (36)

šŸŸ¢ Read-onlyšŸŸ” WritešŸ”“ DeleteāšŖ Unknown
šŸŸ¢search_products(query, theme, section, limit, max_price)

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.

Input Schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free-text search, e.g. 'cat' or 'neon koi'."
    },
    "theme": {
      "type": "string",
      "description": "Canonical theme filter (Cats, Anime, Skulls, ...); comma-separate several."
    },
    "section": {
      "type": "string",
      "description": "Catalog section: mens, womens or kids."
    },
    "limit": {
      "type": "integer",
      "description": "Max cards to return (default 24, max 48)."
    },
    "max_price": {
      "type": "number",
      "description": "Only items priced at or below this amount, USD."
    }
  }
}

Output Schema

{
  "type": "object",
  "properties": {
    "total": {
      "type": "integer",
      "description": "Total catalog matches for the filters."
    },
    "showing": {
      "type": "integer",
      "description": "Number of cards returned."
    },
    "items": {
      "type": "array",
      "description": "Product cards.",
      "items": {
        "type": "object",
        "properties": {
          "good_id": {
            "type": "integer"
          },
          "code": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "product": {
            "type": "string"
          },
          "price": {
            "type": "number"
          },
          "currency": {
            "type": "string"
          },
          "theme": {
            "type": "string"
          },
          "image": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "description": "Canonical product page."
          }
        }
      }
    }
  }
}
šŸŸ¢get_product(code)

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

Input Schema

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "Product code from search_products results."
    }
  },
  "required": [
    "code"
  ]
}

Output Schema

{
  "type": "object",
  "properties": {
    "good_id": {
      "type": "integer"
    },
    "code": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "product": {
      "type": "string"
    },
    "price": {
      "type": "number"
    },
    "currency": {
      "type": "string"
    },
    "theme": {
      "type": "string"
    },
    "image": {
      "type": "string"
    },
    "url": {
      "type": "string"
    },
    "sizes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "fabrics": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "variants": {
      "type": "array",
      "description": "Price per size+fabric combination.",
      "items": {
        "type": "object",
        "properties": {
          "size": {
            "type": "string"
          },
          "fabric": {
            "type": "string"
          },
          "price": {
            "type": "number"
          }
        }
      }
    },
    "about": {
      "type": "string",
      "description": "Design description text (may be null)."
    },
    "error": {
      "type": "string",
      "description": "Present when the product was not found."
    }
  }
}
šŸŸ¢list_collections(limit)

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

Input Schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Max collections to return (default 50, max 100)."
    }
  }
}

Output Schema

{
  "type": "object",
  "properties": {
    "collections": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "slug": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "url": {
            "type": "string",
            "description": "Collection landing page."
          }
        }
      }
    }
  }
}
šŸŸ¢view_cart

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

Input Schema

{
  "type": "object",
  "properties": {}
}

Output Schema

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "description": "Cart lines in index order ā€” this index is what set_cart_quantity/cart_update/cart_remove take.",
      "items": {
        "type": "object",
        "properties": {
          "good_id": {
            "type": "integer"
          },
          "code": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "product": {
            "type": "string"
          },
          "size": {
            "type": "string"
          },
          "fabric": {
            "type": "string"
          },
          "price": {
            "type": "number"
          },
          "currency": {
            "type": "string"
          },
          "qty": {
            "type": "integer"
          },
          "custom": {
            "type": "boolean",
            "description": "True when the line is a user-generated custom print."
          }
        }
      }
    },
    "subtotal": {
      "type": "number",
      "description": "Sum of price x qty over all lines, USD."
    },
    "currency": {
      "type": "string"
    },
    "checkout_url": {
      "type": "string",
      "description": "Cart page URL for the human."
    },
    "error": {
      "type": "string",
      "description": "Present instead of a cart when the call failed (bad index, unavailable size, ...)."
    }
  }
}
šŸŸ”add_to_cart(good_id, size, fabric, qty)

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.

Input Schema

{
  "type": "object",
  "properties": {
    "good_id": {
      "type": "integer",
      "description": "Numeric product id from search_products/get_product."
    },
    "size": {
      "type": "string",
      "description": "Size label; must be one of the product's available sizes."
    },
    "fabric": {
      "type": "string",
      "description": "Fabric label from get_product, if the product offers a choice."
    },
    "qty": {
      "type": "integer",
      "description": "Quantity to add (default 1, max 99)."
    }
  },
  "required": [
    "good_id",
    "size"
  ]
}

Output Schema

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "description": "Cart lines in index order ā€” this index is what set_cart_quantity/cart_update/cart_remove take.",
      "items": {
        "type": "object",
        "properties": {
          "good_id": {
            "type": "integer"
          },
          "code": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "product": {
            "type": "string"
          },
          "size": {
            "type": "string"
          },
          "fabric": {
            "type": "string"
          },
          "price": {
            "type": "number"
          },
          "currency": {
            "type": "string"
          },
          "qty": {
            "type": "integer"
          },
          "custom": {
            "type": "boolean",
            "description": "True when the line is a user-generated custom print."
          }
        }
      }
    },
    "subtotal": {
      "type": "number",
      "description": "Sum of price x qty over all lines, USD."
    },
    "currency": {
      "type": "string"
    },
    "checkout_url": {
      "type": "string",
      "description": "Cart page URL for the human."
    },
    "error": {
      "type": "string",
      "description": "Present instead of a cart when the call failed (bad index, unavailable size, ...)."
    }
  }
}
šŸŸ”set_cart_quantity(index, qty)

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

Input Schema

{
  "type": "object",
  "properties": {
    "index": {
      "type": "integer",
      "description": "Zero-based cart line index from view_cart."
    },
    "qty": {
      "type": "integer",
      "description": "New quantity (0 removes the line, max 99)."
    }
  },
  "required": [
    "index",
    "qty"
  ]
}

Output Schema

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "description": "Cart lines in index order ā€” this index is what set_cart_quantity/cart_update/cart_remove take.",
      "items": {
        "type": "object",
        "properties": {
          "good_id": {
            "type": "integer"
          },
          "code": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "product": {
            "type": "string"
          },
          "size": {
            "type": "string"
          },
          "fabric": {
            "type": "string"
          },
          "price": {
            "type": "number"
          },
          "currency": {
            "type": "string"
          },
          "qty": {
            "type": "integer"
          },
          "custom": {
            "type": "boolean",
            "description": "True when the line is a user-generated custom print."
          }
        }
      }
    },
    "subtotal": {
      "type": "number",
      "description": "Sum of price x qty over all lines, USD."
    },
    "currency": {
      "type": "string"
    },
    "checkout_url": {
      "type": "string",
      "description": "Cart page URL for the human."
    },
    "error": {
      "type": "string",
      "description": "Present instead of a cart when the call failed (bad index, unavailable size, ...)."
    }
  }
}
šŸŸ¢checkout_link

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.

Input Schema

{
  "type": "object",
  "properties": {}
}

Output Schema

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "description": "Cart page for the human to review and pay."
    },
    "items_in_cart": {
      "type": "integer"
    },
    "note": {
      "type": "string"
    }
  }
}
šŸŸ¢order_status(number, limit)

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

Input Schema

{
  "type": "object",
  "properties": {
    "number": {
      "type": "string",
      "description": "Exact order number to look up; omit for the most recent orders."
    },
    "limit": {
      "type": "integer",
      "description": "Max orders to return (default 5, max 20)."
    }
  }
}

Output Schema

{
  "type": "object",
  "properties": {
    "orders": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "number": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "total": {
            "type": "number"
          },
          "currency": {
            "type": "string"
          },
          "created_at": {
            "type": "string",
            "description": "ISO 8601 timestamp."
          },
          "url": {
            "type": "string",
            "description": "Order tracking page."
          }
        }
      }
    },
    "note": {
      "type": "string",
      "description": "Present when the account has no email on file."
    }
  }
}
šŸŸ”cart_update(index, qty, size, fabric)

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

Input Schema

{
  "type": "object",
  "properties": {
    "index": {
      "type": "integer",
      "description": "Zero-based cart line index from view_cart."
    },
    "qty": {
      "type": "integer",
      "description": "New quantity; 0 removes the line."
    },
    "size": {
      "type": "string",
      "description": "New size for this line (must be available for the product)."
    },
    "fabric": {
      "type": "string",
      "description": "New fabric for this line (must be available for the product)."
    }
  },
  "required": [
    "index"
  ]
}

Output Schema

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "description": "Cart lines in index order ā€” this index is what set_cart_quantity/cart_update/cart_remove take.",
      "items": {
        "type": "object",
        "properties": {
          "good_id": {
            "type": "integer"
          },
          "code": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "product": {
            "type": "string"
          },
          "size": {
            "type": "string"
          },
          "fabric": {
            "type": "string"
          },
          "price": {
            "type": "number"
          },
          "currency": {
            "type": "string"
          },
          "qty": {
            "type": "integer"
          },
          "custom": {
            "type": "boolean",
            "description": "True when the line is a user-generated custom print."
          }
        }
      }
    },
    "subtotal": {
      "type": "number",
      "description": "Sum of price x qty over all lines, USD."
    },
    "currency": {
      "type": "string"
    },
    "checkout_url": {
      "type": "string",
      "description": "Cart page URL for the human."
    },
    "error": {
      "type": "string",
      "description": "Present instead of a cart when the call failed (bad index, unavailable size, ...)."
    }
  }
}
šŸ”“cart_remove(index)

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

Input Schema

{
  "type": "object",
  "properties": {
    "index": {
      "type": "integer",
      "description": "Zero-based cart line index from view_cart."
    }
  },
  "required": [
    "index"
  ]
}

Output Schema

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "description": "Cart lines in index order ā€” this index is what set_cart_quantity/cart_update/cart_remove take.",
      "items": {
        "type": "object",
        "properties": {
          "good_id": {
            "type": "integer"
          },
          "code": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "product": {
            "type": "string"
          },
          "size": {
            "type": "string"
          },
          "fabric": {
            "type": "string"
          },
          "price": {
            "type": "number"
          },
          "currency": {
            "type": "string"
          },
          "qty": {
            "type": "integer"
          },
          "custom": {
            "type": "boolean",
            "description": "True when the line is a user-generated custom print."
          }
        }
      }
    },
    "subtotal": {
      "type": "number",
      "description": "Sum of price x qty over all lines, USD."
    },
    "currency": {
      "type": "string"
    },
    "checkout_url": {
      "type": "string",
      "description": "Cart page URL for the human."
    },
    "error": {
      "type": "string",
      "description": "Present instead of a cart when the call failed (bad index, unavailable size, ...)."
    }
  }
}
āšŖapply_promo(code)

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.

Input Schema

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "Promo code to validate and apply."
    }
  },
  "required": [
    "code"
  ]
}

Output Schema

{
  "type": "object",
  "properties": {
    "applied": {
      "type": "boolean"
    },
    "code": {
      "type": "string",
      "description": "Normalized promo code (when applied)."
    },
    "subtotal": {
      "type": "number"
    },
    "discount": {
      "type": "number"
    },
    "shipping": {
      "type": "number"
    },
    "total": {
      "type": "number"
    },
    "currency": {
      "type": "string"
    },
    "reason": {
      "type": "string",
      "description": "Why the code was rejected (when applied=false)."
    },
    "error": {
      "type": "string",
      "description": "Present when the cart is empty or code is missing."
    }
  }
}
šŸ”“remove_promo

Remove the applied promo code from the cart.

Input Schema

{
  "type": "object",
  "properties": {}
}

Output Schema

{
  "type": "object",
  "properties": {
    "applied": {
      "type": "boolean",
      "description": "Always false after removal."
    }
  }
}
šŸŸ¢get_user_prefs

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

Input Schema

{
  "type": "object",
  "properties": {}
}

Output Schema

{
  "type": "object",
  "properties": {
    "size": {
      "type": "string",
      "description": "Saved default size, or null."
    },
    "fit": {
      "type": "string",
      "description": "Saved fit preference: basic | oversized, or null."
    }
  }
}
šŸŸ”set_user_prefs(size, fit)

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.

Input Schema

{
  "type": "object",
  "properties": {
    "size": {
      "type": "string",
      "description": "Default size: XS, S, M, L, XL, 2XLā€¦5XL."
    },
    "fit": {
      "type": "string",
      "description": "Fit preference: basic or oversized."
    }
  }
}

Output Schema

{
  "type": "object",
  "properties": {
    "size": {
      "type": "string"
    },
    "fit": {
      "type": "string"
    },
    "error": {
      "type": "string"
    }
  }
}
šŸŸ¢get_saved_addresses

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

Input Schema

{
  "type": "object",
  "properties": {}
}

Output Schema

{
  "type": "object",
  "properties": {
    "addresses": {
      "type": "array",
      "description": "Up to 5 distinct addresses from past orders, newest first.",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "country": {
            "type": "string"
          },
          "city": {
            "type": "string"
          },
          "address": {
            "type": "string"
          },
          "zip": {
            "type": "string"
          },
          "phone": {
            "type": "string"
          },
          "summary": {
            "type": "string",
            "description": "One-line address summary."
          }
        }
      }
    }
  }
}
šŸŸ”set_shipping_address(name, country, city, address, zip, ...)

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

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Recipient full name."
    },
    "country": {
      "type": "string",
      "description": "Destination country."
    },
    "city": {
      "type": "string",
      "description": "Destination city."
    },
    "address": {
      "type": "string",
      "description": "Street address line."
    },
    "zip": {
      "type": "string",
      "description": "Postal / ZIP code (optional where not used)."
    },
    "phone": {
      "type": "string",
      "description": "Contact phone number for delivery."
    }
  },
  "required": [
    "name",
    "country",
    "city",
    "address",
    "phone"
  ]
}

Output Schema

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "shipping": {
      "type": "object",
      "description": "Saved address snapshot.",
      "properties": {
        "name": {
          "type": "string"
        },
        "country": {
          "type": "string"
        },
        "city": {
          "type": "string"
        },
        "address_line": {
          "type": "string"
        },
        "zip": {
          "type": "string"
        },
        "phone": {
          "type": "string"
        },
        "full_address": {
          "type": "string"
        }
      }
    },
    "error": {
      "type": "string",
      "description": "Missing fields or empty cart."
    }
  }
}
šŸŸ¢get_shipping_options

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

Input Schema

{
  "type": "object",
  "properties": {}
}

Output Schema

{
  "type": "object",
  "properties": {
    "options": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Pass this to set_shipping_method."
          },
          "label": {
            "type": "string"
          },
          "price": {
            "type": "number"
          },
          "currency": {
            "type": "string"
          },
          "eta": {
            "type": "string"
          },
          "note": {
            "type": "string"
          }
        }
      }
    },
    "free_shipping_from": {
      "type": "number",
      "description": "Subtotal (USD) at which shipping becomes free."
    }
  }
}
šŸŸ”set_shipping_method(option_id)

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

Input Schema

{
  "type": "object",
  "properties": {
    "option_id": {
      "type": "string",
      "description": "Shipping option id from get_shipping_options (currently 'worldwide')."
    }
  }
}

Output Schema

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "shipping_method": {
      "type": "string"
    },
    "error": {
      "type": "string",
      "description": "Unknown option_id or empty cart."
    }
  }
}
šŸŸ¢get_order_preview

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

Input Schema

{
  "type": "object",
  "properties": {}
}

Output Schema

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "description": "Re-priced order lines.",
      "items": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string"
          },
          "product": {
            "type": "string"
          },
          "size": {
            "type": "string"
          },
          "qty": {
            "type": "integer"
          },
          "price": {
            "type": "number"
          },
          "custom": {
            "type": "boolean"
          }
        }
      }
    },
    "subtotal": {
      "type": "number"
    },
    "promo_code": {
      "type": "string"
    },
    "discount": {
      "type": "number"
    },
    "shipping": {
      "type": "object",
      "properties": {
        "method": {
          "type": "string"
        },
        "price": {
          "type": "number"
        }
      }
    },
    "shipping_address": {
      "type": "object",
      "description": "Address set via set_shipping_address (null if not set)."
    },
    "total": {
      "type": "number"
    },
    "currency": {
      "type": "string"
    },
    "ready_to_prepare": {
      "type": "boolean",
      "description": "True when an address is set and all lines are orderable."
    },
    "issues": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Lines that became unavailable, if any."
    },
    "note": {
      "type": "string"
    },
    "error": {
      "type": "string",
      "description": "Present when the cart is empty."
    }
  }
}
šŸŸ”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.

Input Schema

{
  "type": "object",
  "properties": {}
}

Output Schema

{
  "type": "object",
  "properties": {
    "draft_id": {
      "type": "string",
      "description": "Draft order number."
    },
    "checkout_url": {
      "type": "string",
      "description": "Pre-filled checkout link ā€” send it to the human to review and pay."
    },
    "expires_at": {
      "type": "string",
      "description": "ISO 8601 time when the draft expires (48 h)."
    },
    "total": {
      "type": "number"
    },
    "currency": {
      "type": "string"
    },
    "note": {
      "type": "string"
    },
    "error": {
      "type": "string",
      "description": "Empty cart, missing address or no orderable items."
    },
    "issues": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
}
šŸŸ¢studio_options

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.

Input Schema

{
  "type": "object",
  "properties": {}
}

Output Schema

{
  "type": "object",
  "properties": {
    "placements": {
      "type": "array",
      "description": "Print size/position choices.",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "description": {
            "type": "string"
          }
        }
      }
    },
    "products": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "label": {
            "type": "string"
          }
        }
      }
    },
    "backgrounds": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "models": {
      "type": "array",
      "description": "Generation engines with cost notes.",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "default": {
            "type": "boolean"
          }
        }
      }
    },
    "note": {
      "type": "string"
    }
  }
}
šŸŸ¢studio_generate(prompt, product, background, placement, model, ...)

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

Input Schema

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

Output Schema

{
  "type": "object",
  "properties": {
    "print_id": {
      "type": "string",
      "description": "Generation id ā€” poll studio_status with it."
    },
    "status": {
      "type": "string"
    },
    "cost_credits": {
      "type": "number",
      "description": "Credits spent on this generation."
    },
    "balance_before": {
      "type": "number"
    },
    "balance_after": {
      "type": "number",
      "description": "Credits left after this generation."
    },
    "tell_user": {
      "type": "string",
      "description": "Say this to the account owner ā€” what was spent from their balance and what is left."
    },
    "studio_account_created": {
      "type": "boolean",
      "description": "Present when a Studio account was auto-created for the user."
    },
    "signup_bonus": {
      "type": "number"
    },
    "note": {
      "type": "string"
    },
    "error": {
      "type": "string",
      "description": "e.g. not enough Studio credits, daily limit reached, invalid product."
    },
    "detail": {
      "type": "string"
    },
    "topup_url": {
      "type": "string",
      "description": "Where the user can buy credits (present on 'not enough credits')."
    }
  }
}
šŸŸ¢studio_status(print_id)

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

Input Schema

{
  "type": "object",
  "properties": {
    "print_id": {
      "type": "string",
      "description": "Generation id returned by studio_generate."
    }
  },
  "required": [
    "print_id"
  ]
}

Output Schema

{
  "type": "object",
  "properties": {
    "print_id": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "description": "Generation state; 'done' and 'failed' are terminal."
    },
    "preview_url": {
      "type": "string",
      "description": "Raw print image (when done) ā€” embed/attach it so the human sees the print in chat."
    },
    "design_url": {
      "type": "string",
      "description": "Shareable Studio design page (when done) ā€” the link to SHARE with the human."
    },
    "note": {
      "type": "string"
    },
    "error": {
      "type": "string",
      "description": "Generation failure reason (credits are refunded)."
    },
    "detail": {
      "type": "string"
    }
  }
}
šŸŸ¢studio_credits

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

Input Schema

{
  "type": "object",
  "properties": {}
}

Output Schema

{
  "type": "object",
  "properties": {
    "balance": {
      "type": "number",
      "description": "Current Studio credit balance."
    },
    "studio_account": {
      "type": "boolean",
      "description": "False if the user has no Studio account yet (first generate auto-creates one)."
    },
    "note": {
      "type": "string"
    },
    "error": {
      "type": "string"
    },
    "detail": {
      "type": "string"
    }
  }
}
šŸŸ”add_custom_to_cart(print_id, product, size, qty)

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

Input Schema

{
  "type": "object",
  "properties": {
    "print_id": {
      "type": "string",
      "description": "Finished print id ā€” studio_status must report status=done."
    },
    "product": {
      "type": "string",
      "description": "Studio product base, same set as studio_generate (default mens_oversize_tshirt)."
    },
    "size": {
      "type": "string",
      "description": "Size label; must be available for the chosen product."
    },
    "qty": {
      "type": "integer",
      "description": "Quantity (default 1, max 99)."
    }
  },
  "required": [
    "print_id",
    "size"
  ]
}

Output Schema

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "description": "Cart lines in index order ā€” this index is what set_cart_quantity/cart_update/cart_remove take.",
      "items": {
        "type": "object",
        "properties": {
          "good_id": {
            "type": "integer"
          },
          "code": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "product": {
            "type": "string"
          },
          "size": {
            "type": "string"
          },
          "fabric": {
            "type": "string"
          },
          "price": {
            "type": "number"
          },
          "currency": {
            "type": "string"
          },
          "qty": {
            "type": "integer"
          },
          "custom": {
            "type": "boolean",
            "description": "True when the line is a user-generated custom print."
          }
        }
      }
    },
    "subtotal": {
      "type": "number",
      "description": "Sum of price x qty over all lines, USD."
    },
    "currency": {
      "type": "string"
    },
    "checkout_url": {
      "type": "string",
      "description": "Cart page URL for the human."
    },
    "error": {
      "type": "string",
      "description": "Present instead of a cart when the call failed (bad index, unavailable size, ...)."
    }
  }
}
šŸŸ¢designer_stats

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.

Input Schema

{
  "type": "object",
  "properties": {}
}

Output Schema

{
  "type": "object",
  "properties": {
    "is_partner": {
      "type": "boolean"
    },
    "nickname": {
      "type": "string"
    },
    "royalty_percent": {
      "type": "number"
    },
    "landing": {
      "type": "string",
      "description": "The designer's public page URL."
    },
    "units_sold": {
      "type": "integer"
    },
    "revenue": {
      "type": "number"
    },
    "accrued": {
      "type": "number",
      "description": "Royalties accrued from paid orders."
    },
    "available_for_payout": {
      "type": "number",
      "description": "Accrued royalties from delivered orders, ready for payout."
    },
    "pitch": {
      "type": "string",
      "description": "Designer-program pitch to relay to the user ā€” present when is_partner is false."
    },
    "how_to_join": {
      "type": "string",
      "description": "How to join the designer program ā€” present when is_partner is false."
    },
    "note": {
      "type": "string"
    }
  }
}
šŸŸ¢designer_designs(limit)

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

Input Schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Max designs to return (default 50, max 200)."
    }
  }
}

Output Schema

{
  "type": "object",
  "properties": {
    "is_partner": {
      "type": "boolean"
    },
    "designs": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "design_id": {
            "type": "integer"
          },
          "name": {
            "type": "string"
          },
          "live_products": {
            "type": "integer",
            "description": "Active products with this design."
          },
          "status": {
            "type": "string",
            "description": "live | hidden | no products yet"
          },
          "url": {
            "type": "string",
            "description": "Product page (null if nothing is live)."
          }
        }
      }
    },
    "designer_page": {
      "type": "string"
    },
    "pitch": {
      "type": "string",
      "description": "Designer-program pitch to relay to the user ā€” present when is_partner is false."
    },
    "how_to_join": {
      "type": "string",
      "description": "How to join the designer program ā€” present when is_partner is false."
    },
    "note": {
      "type": "string"
    }
  }
}
šŸŸ”designer_upload_slot(filename)

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.

Input Schema

{
  "type": "object",
  "properties": {
    "filename": {
      "type": "string",
      "description": "Original file name, for readability."
    }
  }
}

Output Schema

{
  "type": "object",
  "properties": {
    "is_partner": {
      "type": "boolean"
    },
    "upload_id": {
      "type": "string"
    },
    "upload_url": {
      "type": "string"
    },
    "expires_in": {
      "type": "integer",
      "description": "Seconds the URL stays valid."
    },
    "method": {
      "type": "string"
    },
    "pitch": {
      "type": "string",
      "description": "Designer-program pitch to relay to the user ā€” present when is_partner is false."
    },
    "how_to_join": {
      "type": "string",
      "description": "How to join the designer program ā€” present when is_partner is false."
    },
    "note": {
      "type": "string"
    }
  }
}
šŸŸ”submit_design(name, front, session_id, back, layout, ...)

Send one of the designer's own artworks for moderation. TWO inputs, same path: either artwork files ā€” front/back accept a public image URL OR an upload_id from designer_upload_slot ā€” or session_id of a FINISHED Studio session of theirs (generated with studio_generate; no need to download the print, we fetch it server-side). Args: name (required), front OR session_id (one of them), 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.

Input Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Design name the moderator will see."
    },
    "front": {
      "type": "string",
      "description": "Image URL or upload_id. Omit when passing session_id."
    },
    "session_id": {
      "type": "string",
      "description": "Finished Studio session of this designer (print_id from studio_generate). Alternative to front."
    },
    "back": {
      "type": "string",
      "description": "Optional second side: URL or upload_id."
    },
    "layout": {
      "type": "string",
      "description": "'front_back' (default) or 'r10'."
    },
    "note": {
      "type": "string",
      "description": "Anything the moderator should know."
    },
    "batch": {
      "type": "string",
      "description": "Group id for a bulk upload."
    }
  },
  "required": [
    "name",
    "front"
  ]
}

Output Schema

{
  "type": "object",
  "properties": {
    "is_partner": {
      "type": "boolean"
    },
    "ok": {
      "type": "boolean"
    },
    "upload_id": {
      "type": "integer"
    },
    "status": {
      "type": "string"
    },
    "error": {
      "type": "string"
    },
    "pitch": {
      "type": "string",
      "description": "Designer-program pitch to relay to the user ā€” present when is_partner is false."
    },
    "how_to_join": {
      "type": "string",
      "description": "How to join the designer program ā€” present when is_partner is false."
    },
    "note": {
      "type": "string"
    }
  }
}
šŸŸ¢designer_uploads(limit)

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

Input Schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Max rows (default 50, max 200)."
    }
  }
}

Output Schema

{
  "type": "object",
  "properties": {
    "is_partner": {
      "type": "boolean"
    },
    "uploads": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer"
          },
          "name": {
            "type": "string"
          },
          "status": {
            "type": "string"
          },
          "reason": {
            "type": "string"
          },
          "batch": {
            "type": "string"
          }
        }
      }
    },
    "pitch": {
      "type": "string",
      "description": "Designer-program pitch to relay to the user ā€” present when is_partner is false."
    },
    "how_to_join": {
      "type": "string",
      "description": "How to join the designer program ā€” present when is_partner is false."
    },
    "note": {
      "type": "string"
    }
  }
}
šŸŸ¢designer_submissions(limit)

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

Input Schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Max submissions to return (default 20, max 100)."
    }
  }
}

Output Schema

{
  "type": "object",
  "properties": {
    "is_partner": {
      "type": "boolean"
    },
    "submissions": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer"
          },
          "design_name": {
            "type": "string"
          },
          "status": {
            "type": "string",
            "description": "in review | in catalog | needs changes"
          },
          "submitted_at": {
            "type": "string"
          }
        }
      }
    },
    "pitch": {
      "type": "string",
      "description": "Designer-program pitch to relay to the user ā€” present when is_partner is false."
    },
    "how_to_join": {
      "type": "string",
      "description": "How to join the designer program ā€” present when is_partner is false."
    },
    "note": {
      "type": "string"
    }
  }
}
šŸŸ¢designer_colorways

My colorway sets: one catalog card per set instead of one per colour. No args.

Input Schema

{
  "type": "object",
  "properties": {}
}

Output Schema

{
  "type": "object",
  "properties": {
    "is_partner": {
      "type": "boolean"
    },
    "sets": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "colorway_id": {
            "type": "integer"
          },
          "shown_as": {
            "type": "string"
          },
          "variants": {
            "type": "array",
            "items": {
              "type": "object"
            }
          }
        }
      }
    },
    "pitch": {
      "type": "string",
      "description": "Designer-program pitch to relay to the user ā€” present when is_partner is false."
    },
    "how_to_join": {
      "type": "string",
      "description": "How to join the designer program ā€” present when is_partner is false."
    },
    "note": {
      "type": "string"
    }
  }
}
šŸŸ”create_colorway(design_ids, primary)

Group my recolours of ONE artwork into a set (2+ of my designs). The catalog then shows one card for the set; every variant keeps its own page and link. Args: design_ids (list of my design ids), primary? (which one represents the set).

Input Schema

{
  "type": "object",
  "properties": {
    "design_ids": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "description": "At least two of my own design ids."
    },
    "primary": {
      "type": "integer",
      "description": "Which variant represents the set."
    }
  },
  "required": [
    "design_ids"
  ]
}

Output Schema

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "colorway_id": {
      "type": "integer"
    },
    "variants": {
      "type": "array",
      "items": {
        "type": "integer"
      }
    },
    "primary": {
      "type": "integer"
    },
    "error": {
      "type": "string"
    },
    "pitch": {
      "type": "string",
      "description": "Designer-program pitch to relay to the user ā€” present when is_partner is false."
    },
    "how_to_join": {
      "type": "string",
      "description": "How to join the designer program ā€” present when is_partner is false."
    },
    "note": {
      "type": "string"
    }
  }
}
šŸŸ”designer_add_to_colorway(colorway_id, design_id)

Add one more of my recolours to a set of mine. Args: colorway_id, design_id.

Input Schema

{
  "type": "object",
  "properties": {
    "colorway_id": {
      "type": "integer"
    },
    "design_id": {
      "type": "integer"
    }
  },
  "required": [
    "colorway_id",
    "design_id"
  ]
}

Output Schema

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "colorway_id": {
      "type": "integer"
    },
    "variants": {
      "type": "array",
      "items": {
        "type": "integer"
      }
    },
    "error": {
      "type": "string"
    },
    "pitch": {
      "type": "string",
      "description": "Designer-program pitch to relay to the user ā€” present when is_partner is false."
    },
    "how_to_join": {
      "type": "string",
      "description": "How to join the designer program ā€” present when is_partner is false."
    },
    "note": {
      "type": "string"
    }
  }
}
šŸ”“designer_remove_from_colorway(design_id)

Take one of my designs out of its set ā€” it gets its own catalog card again. A set left with a single variant is dissolved. Args: design_id.

Input Schema

{
  "type": "object",
  "properties": {
    "design_id": {
      "type": "integer"
    }
  },
  "required": [
    "design_id"
  ]
}

Output Schema

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "design_id": {
      "type": "integer"
    },
    "error": {
      "type": "string"
    },
    "pitch": {
      "type": "string",
      "description": "Designer-program pitch to relay to the user ā€” present when is_partner is false."
    },
    "how_to_join": {
      "type": "string",
      "description": "How to join the designer program ā€” present when is_partner is false."
    },
    "note": {
      "type": "string"
    }
  }
}
šŸŸ”set_colorway_primary(colorway_id, design_id)

Choose which variant of my set represents it in the catalog. Args: colorway_id, design_id.

Input Schema

{
  "type": "object",
  "properties": {
    "colorway_id": {
      "type": "integer"
    },
    "design_id": {
      "type": "integer"
    }
  },
  "required": [
    "colorway_id",
    "design_id"
  ]
}

Output Schema

{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "colorway_id": {
      "type": "integer"
    },
    "primary": {
      "type": "integer"
    },
    "error": {
      "type": "string"
    },
    "pitch": {
      "type": "string",
      "description": "Designer-program pitch to relay to the user ā€” present when is_partner is false."
    },
    "how_to_join": {
      "type": "string",
      "description": "How to join the designer program ā€” present when is_partner is false."
    },
    "note": {
      "type": "string"
    }
  }
}

Recommended Prompts

search_research
Search for information about [topic] using agentee
Expected tools: search_products
find_specific
Find [specific item] using agentee
Expected tools: search_products
list_items
List all [items] available in agentee
Expected tools: list_collections
retrieve_data
Get details about [item] from agentee
Expected tools: get_product
fetch_info
Fetch [information type] using agentee
Expected tools: get_product

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded36 tools
verifiedversion not recorded36 tools