CustomCat MCP by usefulapi
Browse the CustomCat catalog, your products and designs; check shipping; create and cancel orders.
Should I use this
Quality & Safety
Findings (2)
- LOWTool 'customcat_list_catalog_categories' name length outside 3-30 rangein customcat_list_catalog_categories
- LOWTool 'customcat_list_shipping_methods' name length outside 3-30 rangein customcat_list_shipping_methods
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
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": {
"customcat": {
"url": "https://customcat.usefulapi.io/mcp"
}
}
}Remote endpoints
https://customcat.usefulapi.io/mcpstreamable-httpWhat it can do
Tool inventory
Tools (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.
Input Schema
{
"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}.
Input Schema
{
"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.
Input Schema
{
"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.
Input Schema
{
"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.
Input Schema
{
"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}.
Input Schema
{
"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}.
Input Schema
{
"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.
Input Schema
{
"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).
Input Schema
{
"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}.
Input Schema
{
"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}.
Input Schema
{
"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}.
Input Schema
{
"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"
}Community
Evidence