Packrift MCP

Search Packrift's in-stock packaging catalog: corrugated shipping boxes, mailer boxes, poly and bubble mailers, poly bags, labels, packing tape, stretch film and void fill. The query can be a product type, an exact size or spec ("12x12x12 ECT-32 box", "10x13 poly mailer", "3 inch packing tape"), or a Packrift SKU. Returns up to 10 matches with live price, pack size, price per unit, stock and a product link. A different size is never labeled exact; when nothing matches exactly it returns the closest sizes marked as not exact and a quote link. If the buyer describes the item they are shipping rather than the packaging they want, use find_packaging_for_item instead.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "What the buyer wants, e.g. \"12x12x12 boxes\", \"white poly mailers 14.5x19\", \"SKU 1066\"."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "default": 5,
      "description": "Maximum results to return."
    },
    "response_format": {
      "type": "string",
      "enum": [
        "concise",
        "detailed"
      ],
      "default": "concise",
      "description": "concise (default) returns the essentials. detailed returns the full catalog record; use it only when a field you need is missing."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "results": {
      "type": "array"
    },
    "closest_sizes": {
      "type": "array"
    },
    "quote_url": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

Find the right Packrift box or mailer for an item the buyer ships. Give the item's length, width and height in inches, its weight, and what it is (for example "ceramic mug", "t-shirt", "hardcover book", "laptop"). Applies cushioning space by item type (2 in per side for fragile items), checks box strength against the weight, and compares billable shipping weight (UPS/FedEx and USPS dimensional weight). Returns up to 5 in-stock options with inside size, fit, strength, live price and a product link. Use search_products instead when the buyer already knows the packaging size they want.

{
  "type": "object",
  "properties": {
    "item_length_in": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Item length in inches."
    },
    "item_width_in": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Item width in inches."
    },
    "item_depth_in": {
      "type": "number",
      "exclusiveMinimum": 0,
      "description": "Item height or depth in inches."
    },
    "item_weight_lb": {
      "type": "number",
      "minimum": 0,
      "description": "Item weight in pounds. Use your best estimate; defaults to 1."
    },
    "use_case": {
      "type": "string",
      "description": "What the item is or how it ships, in plain words: \"fragile glass jar\", \"folded hoodie\", \"paperback book\", \"electronics\", \"heavy auto parts\". Free text is fine."
    },
    "packaging": {
      "type": "string",
      "enum": [
        "any",
        "box",
        "mailer"
      ],
      "default": "any",
      "description": "Limit results to boxes or mailers."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5,
      "default": 3,
      "description": "Number of options to return."
    },
    "response_format": {
      "type": "string",
      "enum": [
        "concise",
        "detailed"
      ],
      "default": "concise",
      "description": "concise (default) returns the essentials. detailed returns the full catalog record; use it only when a field you need is missing."
    }
  },
  "required": [
    "item_length_in",
    "item_width_in",
    "item_depth_in"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "required_inside_in": {
      "type": "array"
    },
    "advice": {
      "type": "string"
    },
    "results": {
      "type": "array"
    },
    "quote_url": {
      "type": "string"
    }
  },
  "additionalProperties": true
}

Get one Packrift product by SKU (or product handle): specs such as inside size, material, strength and pack count, live price and price per unit, stock, whether a quantity can ship now, volume pricing, nearby sizes and the product link. Use after search_products or find_packaging_for_item when the buyer wants more detail before choosing.

{
  "type": "object",
  "properties": {
    "sku": {
      "type": "string",
      "description": "Packrift SKU, e.g. \"1066\"."
    },
    "handle": {
      "type": "string",
      "description": "Product handle from a product URL, if you have it instead of a SKU."
    },
    "quantity": {
      "type": "integer",
      "minimum": 1,
      "description": "Optional number of packs the buyer wants, to check it can ship now."
    },
    "response_format": {
      "type": "string",
      "enum": [
        "concise",
        "detailed"
      ],
      "default": "concise",
      "description": "concise (default) returns the essentials. detailed returns the full catalog record; use it only when a field you need is missing."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "sku": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "url": {
      "type": "string"
    },
    "specs": {
      "type": "array"
    },
    "nearby_sizes": {
      "type": "array"
    }
  },
  "additionalProperties": true
}

Estimate the delivered cost of a Packrift order to a US ZIP code, using the same shipping rates and automatic volume discounts as Packrift checkout. Give the items as SKU and quantity (number of packs). Returns the subtotal after discounts, the shipping charge (free only when the order qualifies), the delivered total and the delivered cost per unit. Tax is not included; checkout shows the final amount. Not for carrier rate shopping or postage.

{
  "type": "object",
  "properties": {
    "destination_postal_code": {
      "type": "string",
      "description": "US delivery ZIP code, e.g. \"75201\"."
    },
    "destination_state": {
      "type": "string",
      "description": "Optional two-letter state code, e.g. \"TX\", for a more precise estimate."
    },
    "items": {
      "type": "array",
      "minItems": 1,
      "maxItems": 25,
      "description": "Items to price.",
      "items": {
        "type": "object",
        "properties": {
          "sku": {
            "type": "string",
            "description": "Packrift SKU."
          },
          "quantity": {
            "type": "integer",
            "minimum": 1,
            "description": "Number of packs."
          }
        },
        "required": [
          "sku",
          "quantity"
        ]
      }
    },
    "response_format": {
      "type": "string",
      "enum": [
        "concise",
        "detailed"
      ],
      "default": "concise",
      "description": "concise (default) returns the essentials. detailed returns the full catalog record; use it only when a field you need is missing."
    }
  },
  "required": [
    "destination_postal_code",
    "items"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array"
    },
    "shipping_options": {
      "type": "array"
    }
  },
  "additionalProperties": true
}

Create a checkout link on packrift.com for items the buyer has chosen. Give each item as SKU and quantity (number of packs); up to 25 lines. The link opens packrift.com checkout with those items and automatic volume discounts applied; the buyer adds their address and pays there. Returns the subtotal after volume discounts. This tool never places an order or charges anyone. Call it only after the buyer confirms the items and quantities.

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "minItems": 1,
      "maxItems": 25,
      "items": {
        "type": "object",
        "properties": {
          "sku": {
            "type": "string",
            "description": "Packrift SKU."
          },
          "quantity": {
            "type": "integer",
            "minimum": 1,
            "description": "Number of packs."
          }
        },
        "required": [
          "sku",
          "quantity"
        ]
      }
    },
    "discount_code": {
      "type": "string",
      "description": "Optional discount code the buyer has."
    },
    "response_format": {
      "type": "string",
      "enum": [
        "concise",
        "detailed"
      ],
      "default": "concise",
      "description": "concise (default) returns the essentials. detailed returns the full catalog record; use it only when a field you need is missing."
    }
  },
  "required": [
    "items"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "checkout_url": {
      "type": "string"
    },
    "cart_url": {
      "type": "string"
    },
    "lines": {
      "type": "array"
    }
  },
  "additionalProperties": true
}

Get a pre-filled quote request link for pallet or recurring quantities, custom sizes, printed or branded packaging, freight orders, or any spec Packrift does not stock exactly. Put everything the buyer told you in the fields: the spec, quantity, delivery ZIP and need-by date travel with the request. The buyer adds their email and submits the form on packrift.com; Packrift replies by email with pricing. Returns the link and what the buyer still needs to add.

{
  "type": "object",
  "properties": {
    "requested_spec": {
      "type": "string",
      "description": "What the buyer needs, e.g. \"18x12x12 ECT-44 kraft boxes, printed 1 color on 2 sides\". Include size, strength or thickness, color and any printing."
    },
    "quantity": {
      "type": "string",
      "description": "Quantity per order and how often, e.g. \"5,000 per quarter\"."
    },
    "delivery_zip": {
      "type": "string",
      "description": "US delivery ZIP code, if known."
    },
    "needed_by": {
      "type": "string",
      "description": "Date the buyer needs delivery, if known."
    },
    "sku": {
      "type": "string",
      "description": "A stocked Packrift SKU the request is for. Leave empty for custom, printed or branded packaging."
    },
    "response_format": {
      "type": "string",
      "enum": [
        "concise",
        "detailed"
      ],
      "default": "concise",
      "description": "concise (default) returns the essentials. detailed returns the full catalog record; use it only when a field you need is missing."
    }
  },
  "required": [
    "requested_spec"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "quote_url": {
      "type": "string"
    },
    "requested_spec": {
      "type": "string"
    }
  },
  "additionalProperties": true
}