Gooten MCP by usefulapi

Browse the Gooten catalog, stock, shipping and price quotes; search orders and cancel items.

¿Debería usar esto?

Calidad y seguridad

A
Calidad de la descripción
96%
Integridad del esquema
93%
Calidad de los nombres
78%
Riesgo de envenenamiento
100%
Coincidencia de permisos
100%
Cumplimiento del protocolo
100%

Hallazgos (3)

  • LOWTool 'gooten_get_shipping_options' description lacks action verben gooten_get_shipping_options
  • LOWTool 'gooten_list_print_ready_products' name length outside 3-30 rangeen gooten_list_print_ready_products
  • LOWTool 'gooten_list_print_ready_variants' name length outside 3-30 rangeen gooten_list_print_ready_variants

Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.

Costo de contexto

~4,144Tokens (definiciones de herramientas)
~1.7 KBTamaño de respuesta típico
Impacto significativo en la atención (3.24% del contexto de 128k)

Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.

Instalar

Instalación con un clic

Agrega esto a tu archivo `claude_desktop_config.json`:

{
  "mcpServers": {
    "gooten": {
      "url": "https://gooten.usefulapi.io/mcp"
    }
  }
}

Puntos de conexión remotos

https://gooten.usefulapi.io/mcpstreamable-http

Qué puede hacer

Inventario de herramientas

Herramientas (17)

🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢gooten_list_products(query, category, include_deprecated, page, page_size)

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.

Esquema de entrada

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

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.

Esquema de entrada

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

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

Esquema de entrada

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

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

Esquema de entrada

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

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.

Esquema de entrada

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

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

Esquema de entrada

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

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

Esquema de entrada

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

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

Esquema de entrada

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

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

Esquema de entrada

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢gooten_list_shipping_countries(include_unsupported)

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

Esquema de entrada

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

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

Esquema de entrada

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

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

Esquema de entrada

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

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.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Any value related to the order (partner name, address, phone, ...)."
    },
    "last_name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Customer last name on the order."
    },
    "email": {
      "type": "string",
      "minLength": 1,
      "maxLength": 254,
      "description": "Customer email on the order."
    },
    "postal_code": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20,
      "description": "Postal code on the order."
    },
    "start_date": {
      "description": "Orders created on or after this date, yyyy-mm-dd.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "end_date": {
      "description": "Orders created on or before this date, yyyy-mm-dd.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "unique_user_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Your own user id stored on the orders."
    },
    "page": {
      "description": "Page number, from 1 (default 1). Pass the previous reply's next_page.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100000
    },
    "page_size": {
      "description": "Results per page, 1-100 (default 25).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢gooten_get_order(order_id)

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.

Esquema de entrada

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

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.

Esquema de entrada

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

Esquema de entrada

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

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.

Esquema de entrada

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

Comunidad

Califica este servidor

Evidencia

Observaciones recientes

verificadoversión no registrada17 herramientas