The server marks this tool destructive: it may delete or overwrite data

gooten_cancel_order_items

WRITE: cancel specific items of an order (cannot be undone). Only items of orders in a pre-production status can be cancelled. Pass the numeric Gooten order id and the order item ids (OrderItemId from gooten_get_order). PUT /orderCancel.

destructive

Argument	Type	Description
order_id*	integer	Numeric Gooten order id (GootenId).
order_item_ids*	array	Order item ids to cancel (OrderItemId), 1-100.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "order_id",
    "order_item_ids"
  ],
  "properties": {
    "order_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Numeric Gooten order id (GootenId).",
      "exclusiveMinimum": 0
    },
    "order_item_ids": {
      "type": "array",
      "items": {
        "type": "integer",
        "maximum": 9007199254740991,
        "exclusiveMinimum": 0
      },
      "maxItems": 100,
      "minItems": 1,
      "description": "Order item ids to cancel (OrderItemId), 1-100."
    }
  }
}

gooten_check_stock

Which of the given SKUs are out of stock for a destination (country, state, postal code). Returns only the out-of-stock SKUs; an empty list means all are available. Unknown SKUs are an error. POST /variantstatus (a read: nothing is changed).

read-only

Argument	Type	Description
skus*	array	SKUs to check (1-50).
state	string	Shipping state/province code, e.g. NY (omit for countries without states).
postal_code*	string	Shipping postal code.
country_code*	string	2-letter ISO 3166-1 country code, e.g. US.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "skus",
    "country_code",
    "postal_code"
  ],
  "properties": {
    "skus": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 200,
        "minLength": 1,
        "description": "Gooten SKU (product variant), e.g. CanvsWrp-ImgWrp-10x10. See gooten_list_product_variants."
      },
      "maxItems": 50,
      "minItems": 1,
      "description": "SKUs to check (1-50)."
    },
    "state": {
      "type": "string",
      "maxLength": 20,
      "minLength": 1,
      "description": "Shipping state/province code, e.g. NY (omit for countries without states)."
    },
    "postal_code": {
      "type": "string",
      "maxLength": 20,
      "minLength": 1,
      "description": "Shipping postal code."
    },
    "country_code": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "2-letter ISO 3166-1 country code, e.g. US."
    }
  }
}

gooten_get_order

One order by its Safe Order ID: items with status, tracking numbers and carriers, images, options, totals, shipping and billing addresses, discount and metadata. GET /orders.

read-only

Argument	Type	Description
order_id*	string	Gooten Safe Order ID (the long id like 13-f91acc87-...), as returned by gooten_search_orders (Id).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "order_id"
  ],
  "properties": {
    "order_id": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "Gooten Safe Order ID (the long id like 13-f91acc87-...), as returned by gooten_search_orders (Id)."
    }
  }
}

gooten_get_order_billing

Billing breakdown of an order: product cost per item, shipping, surcharge, tax, fees, discount and total. Takes the numeric Gooten order id (GootenId from gooten_get_order), not the Safe Order ID. Needs the Partner Billing Key. GET /orderbilling.

read-only

Argument	Type	Description
order_id*	integer	Numeric Gooten order id.
currency_code	string	3-letter currency code (default USD). See gooten_list_currencies.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "order_id"
  ],
  "properties": {
    "order_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Numeric Gooten order id.",
      "exclusiveMinimum": 0
    },
    "currency_code": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "3-letter currency code (default USD). See gooten_list_currencies."
    }
  }
}

gooten_get_price_estimate

Estimate the cost of an order before placing it: per-item partner price, customer price and tax, plus shipping total, for SKUs shipped to an address. POST /price (a quote: nothing is ordered or charged).

read-only

Argument	Type	Description
city*	string	Shipping city.
items*	array	Order lines (1-50).
state	string	Shipping state/province code, if any.
postal_code*	string	Shipping postal code.
country_code*	string	2-letter ISO 3166-1 country code, e.g. US.
address_line1*	string	Shipping address line 1.
address_line2	string	Shipping address line 2.
currency_code	string	3-letter currency code (default USD). See gooten_list_currencies.

Input schema (JSON)

gooten_get_product_templates

Print templates for a SKU: how many images are needed, required pixel sizes/DPI, print spaces and layer coordinates, and preview assets. GET /producttemplates.

read-only

Argument	Type	Description
sku*	string	Gooten SKU (product variant), e.g. CanvsWrp-ImgWrp-10x10. See gooten_list_product_variants.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "sku"
  ],
  "properties": {
    "sku": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Gooten SKU (product variant), e.g. CanvsWrp-ImgWrp-10x10. See gooten_list_product_variants."
    }
  }
}

gooten_get_shipping_estimate

Shipping price range and delivery time for a product to a country: whether expedited is possible and estimated shipping days, plus min/max price and producing country when Gooten returns them. GET /shippriceestimate.

read-only

Argument	Type	Description
product_id*	integer	Catalog product id.
country_code*	string	2-letter ISO 3166-1 country code, e.g. US.
currency_code	string	3-letter currency code (default USD). See gooten_list_currencies.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "product_id",
    "country_code"
  ],
  "properties": {
    "product_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Catalog product id.",
      "exclusiveMinimum": 0
    },
    "country_code": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "2-letter ISO 3166-1 country code, e.g. US."
    },
    "currency_code": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "3-letter currency code (default USD). See gooten_list_currencies."
    }
  }
}

gooten_get_shipping_options

Available shipping methods (Standard, Expedited, Overnight) with price and delivery days for a cart of SKUs to a destination. POST /shippingprices (a quote: nothing is ordered).

read-only

Argument	Type	Description
items*	array	Cart lines (1-50).
state	string	Destination state/province code, if any.
postal_code*	string	Destination postal code.
country_code*	string	2-letter ISO 3166-1 country code, e.g. US.
currency_code	string	3-letter currency code (default USD). See gooten_list_currencies.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "items",
    "country_code",
    "postal_code"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "sku",
          "quantity"
        ],
        "properties": {
          "sku": {
            "type": "string",
            "maxLength": 200,
            "minLength": 1,
            "description": "Gooten SKU (product variant), e.g. CanvsWrp-ImgWrp-10x10. See gooten_list_product_variants."
          },
          "quantity": {
            "type": "integer",
            "maximum": 10000,
            "exclusiveMinimum": 0
          }
        }
      },
      "maxItems": 50,
      "minItems": 1,
      "description": "Cart lines (1-50)."
    },
    "state": {
      "type": "string",
      "maxLength": 20,
      "minLength": 1,
      "description": "Destination state/province code, if any."
    },
    "postal_code": {
      "type": "string",
      "maxLength": 20,
      "minLength": 1,
      "description": "Destination postal code."
    },
    "country_code": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "2-letter ISO 3166-1 country code, e.g. US."
    },
    "currency_code": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "3-letter currency code (default USD). See gooten_list_currencies."
    }
  }
}

gooten_list_currencies

Currencies Gooten can quote prices in (name, code, display format). GET /currencies.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

gooten_list_print_ready_products

Your print-ready products (PRPs: SKUs with artwork already attached) with their variant counts. Paging starts at 1. GET /prpproducts.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    }
  }
}

gooten_list_print_ready_variants

Orderable SKUs of your print-ready products, optionally for one PRP product name (from gooten_list_print_ready_products). GET /prpvariants.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
product_name	string	A PRP product name; omit for all variants.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    },
    "product_name": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "A PRP product name; omit for all variants."
    }
  }
}

gooten_list_product_variants

The orderable variants (SKUs) of a catalog product for a destination country, with option values (size, color, ...) and Gooten's price for your account. SKUs differ by region (inch vs cm sizes). GET /productvariants.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
page_size	integer	Results per page, 1-100 (default 25).
product_id*	integer	Catalog product id from gooten_list_products.
country_code*	string	2-letter ISO 3166-1 country code, e.g. US.
currency_code	string	3-letter currency code (default USD). See gooten_list_currencies.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "product_id",
    "country_code"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    },
    "page_size": {
      "type": "integer",
      "maximum": 100,
      "description": "Results per page, 1-100 (default 25).",
      "exclusiveMinimum": 0
    },
    "product_id": {
      "type": "integer",
      "maximum": 9007199254740991,
      "description": "Catalog product id from gooten_list_products.",
      "exclusiveMinimum": 0
    },
    "country_code": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "2-letter ISO 3166-1 country code, e.g. US."
    },
    "currency_code": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "3-letter currency code (default USD). See gooten_list_currencies."
    }
  }
}

gooten_list_products

Browse the Gooten print-on-demand product catalog (public data): product id, name, categories, cheapest price and shipping, stock and deprecation flags. Filter by name text or category; use product_id with gooten_list_product_variants. Prices are in USD for the cheapest variant.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
query	string	Only products whose name contains this text (case-insensitive).
category	string	Only products in this category (exact name, case-insensitive; see the categories list in the reply).
page_size	integer	Results per page, 1-100 (default 25).
include_deprecated	boolean	Include deprecated products (default false).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    },
    "query": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "Only products whose name contains this text (case-insensitive)."
    },
    "category": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "Only products in this category (exact name, case-insensitive; see the categories list in the reply)."
    },
    "page_size": {
      "type": "integer",
      "maximum": 100,
      "description": "Results per page, 1-100 (default 25).",
      "exclusiveMinimum": 0
    },
    "include_deprecated": {
      "type": "boolean",
      "description": "Include deprecated products (default false)."
    }
  }
}

gooten_list_shipping_countries

Countries Gooten ships to (code, name, whether supported, measurement system, default currency). By default only supported countries. GET /countries.

read-only

Argument	Type	Description
include_unsupported	boolean	Also list countries Gooten does not ship to (default false).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "include_unsupported": {
      "type": "boolean",
      "description": "Also list countries Gooten does not ship to (default false)."
    }
  }
}

gooten_search_orders

Search your Gooten orders by free text (name, address, phone...), last name, email, postal code, creation date range or your own user id. Returns order id, items with status and tracking, totals and addresses. Needs the Partner Billing Key. GET /ordersearch.

read-only

Argument	Type	Description
page	integer	Page number, from 1 (default 1). Pass the previous reply's next_page.
text	string	Any value related to the order (partner name, address, phone, ...).
email	string	Customer email on the order.
end_date	string	Orders created on or before this date, yyyy-mm-dd.
last_name	string	Customer last name on the order.
page_size	integer	Results per page, 1-100 (default 25).
start_date	string	Orders created on or after this date, yyyy-mm-dd.
postal_code	string	Postal code on the order.
unique_user_id

gooten_set_order_status

WRITE: change an order's status. Allowed targets: Cancelled (cancels the whole order), Hold (pause before production) and New (re-submit an order that was fixed, e.g. after an image or address issue; it then goes on to production and billing). Only orders in AccountingIssue, AddressIssue, HoldByCIImageIssue, ImageIssue, NeedsManualApproval, New, ReadyForAccounting, ReadyForImageDl or Pending can change; a held order cannot be released through the API (Gooten support must release it); otherwise Gooten refuses. POST /orderstatus.

destructive

Argument	Type	Description
status*	string	The new status.
order_id*	string	Gooten Safe Order ID (the long id like 13-f91acc87-...), as returned by gooten_search_orders (Id).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "order_id",
    "status"
  ],
  "properties": {
    "status": {
      "enum": [
        "Cancelled",
        "Hold",
        "New"
      ],
      "type": "string",
      "description": "The new status."
    },
    "order_id": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "Gooten Safe Order ID (the long id like 13-f91acc87-...), as returned by gooten_search_orders (Id)."
    }
  }
}

gooten_validate_address

Check a shipping address: validity, a score and Gooten's suggested corrected address. GET /addressvalidation.

read-only

Argument	Type	Description
city*	string	City.
line1*	string	Address line 1.
line2	string	Address line 2.
state	string	State/province code, if any.
postal_code*	string	Postal code.
country_code*	string	2-letter ISO 3166-1 country code, e.g. US.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "line1",
    "city",
    "postal_code",
    "country_code"
  ],
  "properties": {
    "city": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "City."
    },
    "line1": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Address line 1."
    },
    "line2": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Address line 2."
    },
    "state": {
      "type": "string",
      "maxLength": 20,
      "minLength": 1,
      "description": "State/province code, if any."
    },
    "postal_code": {
      "type": "string",
      "maxLength": 20,
      "minLength": 1,
      "description": "Postal code."
    },
    "country_code": {
      "type": "string",
      "pattern": "^[A-Za-z]{2}$",
      "description": "2-letter ISO 3166-1 country code, e.g. US."
    }
  }
}

Gooten MCP by usefulapi

Try it

gooten_cancel_order_items Destructive

Gooten MCP by usefulapi

Try it

gooten_cancel_order_items Destructive

Tools (17)