CustomCat MCP by usefulapi

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"
}

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"
}

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"
}

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"
}

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"
}

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"
}

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"
}

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"
}

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"
}

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"
}

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"
}

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"
}