CustomCat MCP by usefulapi
Browse the CustomCat catalog, your products and designs; check shipping; create and cancel orders.
我該用這個嗎
品質與安全性
發現項目（2）
- LOWTool 'customcat_list_catalog_categories' name length outside 3-30 range在 customcat_list_catalog_categories 中
- LOWTool 'customcat_list_shipping_methods' name length outside 3-30 range在 customcat_list_shipping_methods 中
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"customcat": {
"url": "https://customcat.usefulapi.io/mcp"
}
}
}遠端端點
https://customcat.usefulapi.io/mcpstreamable-http它能做什麼
工具清單
工具（12）
🟢customcat_list_products(since_id, updated_since, page, limit)
List the products you set up in CustomCat (a design on one or more catalog items) with variants, SKUs, cost, price, stock flag and design images. Use the variant SKUs when placing an order for these products. GET /product.
輸入結構描述
{
"type": "object",
"properties": {
"since_id": {
"description": "Only products created after this product id.",
"type": "string",
"maxLength": 100
},
"updated_since": {
"description": "Only products created or updated since this date (as CustomCat expects, e.g. 2026-10-01).",
"type": "string",
"maxLength": 60
},
"page": {
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
},
"limit": {
"description": "Results per page, 1-250 (default 25).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 250
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢customcat_get_product(product_id)
One of your CustomCat products by id (e.g. 22-2580581): variants, SKUs, cost, price, options, designs. GET /product/{product_id}.
輸入結構描述
{
"type": "object",
"properties": {
"product_id": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "CustomCat product id, e.g. 22-2580581."
}
},
"required": [
"product_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢customcat_list_designs(since_id, updated_since, page, limit)
List the designs uploaded to your CustomCat account: id, name, tags, image URLs, default product and last-updated time. GET /design.
輸入結構描述
{
"type": "object",
"properties": {
"since_id": {
"description": "Only designs created after this design id.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"updated_since": {
"description": "Only designs created or updated since this date.",
"type": "string",
"maxLength": 60
},
"page": {
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
},
"limit": {
"description": "Results per page, 1-250 (default 25).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 250
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢customcat_list_catalog_categories
The CustomCat catalog categories (Digisoft, Sublimation) and their subcategories (e.g. T-Shirts, Sweatshirts, Bags), to narrow customcat_list_catalog. GET /catalogcategory.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢customcat_list_catalog(category, subcategory, page, limit)
Browse the full CustomCat catalog of printable blank products (the items you can order with your own artwork). Filter by category and subcategory from customcat_list_catalog_categories. The reply carries the total in `total`. GET /catalog.
輸入結構描述
{
"type": "object",
"properties": {
"category": {
"description": "Catalog category (CustomCat's default is Digisoft).",
"type": "string",
"enum": [
"Digisoft",
"Sublimation"
]
},
"subcategory": {
"description": "Subcategory name, e.g. T-Shirts.",
"type": "string",
"maxLength": 100
},
"page": {
"description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100000
},
"limit": {
"description": "Results per page, 1-250 (default 25).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 250
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢customcat_get_catalog_product(catalog_product_id)
One catalog product by numeric id with its colors, sizes and SKUs. GET /catalog/{catalog_product_id}.
輸入結構描述
{
"type": "object",
"properties": {
"catalog_product_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Catalog product id."
}
},
"required": [
"catalog_product_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢customcat_get_catalog_sku(catalog_sku_id)
One catalog SKU with its price and stock status. Use it before ordering: a SKU that is out of stock, discontinued or invalid makes the order fail. GET /catalog/sku/{catalog_sku_id}.
輸入結構描述
{
"type": "object",
"properties": {
"catalog_sku_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Catalog SKU id (numeric), e.g. 39515."
}
},
"required": [
"catalog_sku_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢customcat_list_shipping_methods(country_code)
The shipping methods CustomCat offers for a destination country (ids and names). The method name is required when placing an order. GET /shipping.
輸入結構描述
{
"type": "object",
"properties": {
"country_code": {
"description": "2-letter ISO country code, e.g. US, GB (default: United States).",
"type": "string",
"pattern": "^[A-Za-z]{2}$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢customcat_get_shipping_cost(shipping_id, country_code, state, items)
Calculate the shipping cost of one shipping method for a destination and a list of catalog SKUs with quantities. Read-only quote: it places nothing. POST /shipping/{shipping_id} (shipping_id from customcat_list_shipping_methods).
輸入結構描述
{
"type": "object",
"properties": {
"shipping_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Shipping method id from customcat_list_shipping_methods."
},
"country_code": {
"description": "Destination 2-letter ISO country code (default US).",
"type": "string",
"pattern": "^[A-Za-z]{2}$"
},
"state": {
"description": "Destination state/province.",
"type": "string",
"maxLength": 60
},
"items": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"catalog_sku": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Catalog SKU."
},
"quantity": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 10000,
"description": "Quantity shipped."
}
},
"required": [
"catalog_sku",
"quantity"
]
},
"description": "Catalog SKUs and quantities being shipped."
}
},
"required": [
"shipping_id",
"items"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢customcat_get_order_status(order_id, sandbox)
Status of an order by YOUR order id: order status (Pending, Verified, Shipped), per-item production status, shipments with tracking ids, totals and the ship-to address. Set sandbox=true to look up a sandbox test order. GET /order/status/{order_id}.
輸入結構描述
{
"type": "object",
"properties": {
"order_id": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "Your order id, exactly as sent when the order was placed."
},
"sandbox": {
"description": "Look up a sandbox (test) order.",
"type": "boolean"
}
},
"required": [
"order_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴customcat_create_order(order_id, sandbox, confirm, shipping_first_name, shipping_last_name, ...)
WRITE: place an order for CustomCat to print and ship. This CHARGES the payment method on file in your CustomCat account (product cost + shipping; a front+back print adds $5 per line item) unless sandbox=true, which only validates the order. A real order (sandbox=false) also needs confirm=true, set only after the user confirmed it. The order id is yours and must be new (a duplicate is rejected). Needs the Write API key. Check stock with customcat_get_catalog_sku and the method name with customcat_list_shipping_methods first, and confirm the details with the user before calling. POST /order/{order_id}.
輸入結構描述
{
"type": "object",
"properties": {
"order_id": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"pattern": "^[A-Za-z0-9._-]+$",
"description": "Your unique order id (for example 101-102938)."
},
"sandbox": {
"type": "boolean",
"description": "true = test order, nothing is charged or produced; false = a real, paid order."
},
"confirm": {
"description": "Required (true) for a real order (sandbox=false): set it only after the user has confirmed the items, address, shipping method and that their CustomCat payment method will be charged.",
"type": "boolean"
},
"shipping_first_name": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"shipping_last_name": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"shipping_email": {
"type": "string",
"maxLength": 200,
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"description": "Customer email (required by CustomCat)."
},
"shipping_phone": {
"type": "string",
"minLength": 1,
"maxLength": 40
},
"shipping_address1": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"shipping_address2": {
"type": "string",
"maxLength": 200
},
"shipping_city": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"shipping_state": {
"type": "string",
"minLength": 1,
"maxLength": 60,
"description": "State/province code, e.g. MI."
},
"shipping_zip": {
"type": "string",
"minLength": 1,
"maxLength": 20
},
"shipping_country": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "2-letter ISO country code, e.g. US."
},
"shipping_method": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Method name from customcat_list_shipping_methods, e.g. Economy."
},
"items": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"sku": {
"description": "SKU of a product made in CustomCat (from customcat_list_products, e.g. 22-115-4774-254). Use this OR catalog_sku + design_url.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"catalog_sku": {
"description": "Catalog SKU (from customcat_list_catalog or customcat_get_catalog_sku) when you bring your own artwork.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"design_url": {
"description": "Fully qualified https URL of the front design (needed with catalog_sku; leave out for a back-only print).",
"type": "string",
"maxLength": 2000
},
"design_url_back": {
"description": "Optional https URL of the back design. A front+back print adds a $5 fee per line item.",
"type": "string",
"maxLength": 2000
},
"mockup_url": {
"description": "Optional mockup of the front, used in QA.",
"type": "string",
"maxLength": 2000
},
"mockup_url_back": {
"description": "Optional mockup of the back, used in QA.",
"type": "string",
"maxLength": 2000
},
"preset_id": {
"description": "Optional design placement preset (2 full front, 3 full back, 4 default centre chest, 1 left chest wide, 10 left chest tall, 9 default back). Omit for exact artboard placement.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"preset_back_id": {
"description": "Optional placement preset for the back design.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"use_embedded_dpi": {
"description": "Use the DPI embedded in the image instead of the default 300.",
"type": "boolean"
},
"line_item_id": {
"description": "Your own id for this line item.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"quantity": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 10000,
"description": "How many of this item."
}
},
"required": [
"quantity"
]
},
"description": "Line items: either {sku, quantity} for products made in CustomCat, or {catalog_sku, design_url, quantity} for your own artwork."
}
},
"required": [
"order_id",
"sandbox",
"shipping_first_name",
"shipping_last_name",
"shipping_email",
"shipping_phone",
"shipping_address1",
"shipping_city",
"shipping_state",
"shipping_zip",
"shipping_country",
"shipping_method",
"items"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴customcat_cancel_order(order_id)
WRITE: cancel (delete) an order by YOUR order id. CustomCat can only cancel an order that has not gone into production; one already printed or shipped is refused. Needs the Write API key. Confirm with the user first. DELETE /order/{order_id}.
輸入結構描述
{
"type": "object",
"properties": {
"order_id": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "Your order id, exactly as sent when the order was placed."
}
},
"required": [
"order_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}社群
證據