Packing slips: cartons, contents, weights, chargeable weight and what is still to pack.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Bearer <Pro license key or anonymous token from GET https://mcp.zovo.one/mcp/token>
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Add a carton to a packing list and return its C01-style id: a label, the empty weight in WHOLE GRAMS, and optionally length, width and height in WHOLE CENTIMETRES. Dimensions are what make a chargeable weight possible.
What is written on the box, e.g. Box 1 of 3 or Pallet A
The EMPTY carton with its packaging, in whole grams. 0 when it is not known
The packing list id, e.g. PL-2026-0001, or the order reference when only one list carries it
Outer width in whole centimetres
Outer height in whole centimetres
Outer length in whole centimetres. All three dimensions or none
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Add a carton to a packing list and return its C01-style id: a label, the empty weight in WHOLE GRAMS, and optionally length, width and height in WHOLE CENTIMETRES. Dimensions are what make a chargeable weight possible.
| Argument | Type | Description |
|---|---|---|
| note | string | |
| label* | string | What is written on the box, e.g. Box 1 of 3 or Pallet A |
| width_cm | integer | Outer width in whole centimetres |
| height_cm | integer | Outer height in whole centimetres |
| length_cm | integer | Outer length in whole centimetres. All three dimensions or none |
| tare_grams* | integer | The EMPTY carton with its packaging, in whole grams. 0 when it is not known |
| packing_list* | string | The packing list id, e.g. PL-2026-0001, or the order reference when only one list carries it |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"packing_list",
"label",
"tare_grams"
],
"properties": {
"note": {
"type": "string",
"maxLength": 2000
},
"label": {
"type": "string",
"maxLength": 200,
"description": "What is written on the box, e.g. Box 1 of 3 or Pallet A"
},
"width_cm": {
"type": "integer",
"maximum": 2000,
"minimum": 1,
"description": "Outer width in whole centimetres"
},
"height_cm": {
"type": "integer",
"maximum": 2000,
"minimum": 1,
"description": "Outer height in whole centimetres"
},
"length_cm": {
"type": "integer",
"maximum": 2000,
"minimum": 1,
"description": "Outer length in whole centimetres. All three dimensions or none"
},
"tare_grams": {
"type": "integer",
"maximum": 100000000,
"minimum": 0,
"description": "The EMPTY carton with its packaging, in whole grams. 0 when it is not known"
},
"packing_list": {
"type": "string",
"maxLength": 200,
"description": "The packing list id, e.g. PL-2026-0001, or the order reference when only one list carries it"
}
},
"additionalProperties": false
}Per carton and for the shipment: tare, net, gross, volume, volumetric weight and the chargeable weight, the greater of gross and volumetric. A carton with no dimensions makes the chargeable total null, never a guess.
| Argument | Type | Description |
|---|---|---|
| divisor | integer | Volumetric divisor in cm3 per kg: 5000 courier air (default), 6000 IATA air, 4000 some road tariffs |
| packing_list* | string | The packing list id, e.g. PL-2026-0001, or the order reference when only one list carries it |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"packing_list"
],
"properties": {
"divisor": {
"type": "integer",
"description": "Volumetric divisor in cm3 per kg: 5000 courier air (default), 6000 IATA air, 4000 some road tariffs"
},
"packing_list": {
"type": "string",
"maxLength": 200,
"description": "The packing list id, e.g. PL-2026-0001, or the order reference when only one list carries it"
}
},
"additionalProperties": false
}Turn Pro on for this connection with key, an MCPL1.<payload>.<signature> issued at checkout for this server or the bundle. Data under your token stays; a wrong or expired key changes nothing. license_status confirms it.
| Argument | Type | Description |
|---|---|---|
| key* | string | License key from checkout, MCPL1.<payload>.<signature> |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"key"
],
"properties": {
"key": {
"type": "string",
"description": "License key from checkout, MCPL1.<payload>.<signature>"
}
},
"additionalProperties": false
}Report this endpoint's licence state for your token as JSON: the product, the tier free or pro, why it is not Pro, and the checkout URL. Call it to explain a free-tier refusal. No arguments, nothing changes.
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}Put a quantity of one item into a named carton: a description, how many, and the per-unit weight in WHOLE GRAMS. Leave unit_grams out when it was not weighed and the carton gross comes back as a lower bound.
| Argument | Type | Description |
|---|---|---|
| sku | string | Stock code, upper-cased and stripped of spaces. Lines with a SKU are matched on it, lines without on their description |
| note | string | |
| carton* | string | The carton id, e.g. C01, or its exact label |
| quantity* | integer | How many units go into THIS carton. Split across cartons with one call each |
| unit_grams | integer | Weight of ONE unit in whole grams. Omit when not weighed; the carton is then a lower bound |
| description* | string | The goods going in, e.g. Oak shelf 900mm |
| packing_list* | string | The packing list id, e.g. PL-2026-0001, or the order reference when only one list carries it |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"packing_list",
"carton",
"description",
"quantity"
],
"properties": {
"sku": {
"type": "string",
"maxLength": 64,
"description": "Stock code, upper-cased and stripped of spaces. Lines with a SKU are matched on it, lines without on their description"
},
"note": {
"type": "string",
"maxLength": 2000
},
"carton": {
"type": "string",
"maxLength": 16,
"description": "The carton id, e.g. C01, or its exact label"
},
"quantity": {
"type": "integer",
"maximum": 1000000,
"minimum": 1,
"description": "How many units go into THIS carton. Split across cartons with one call each"
},
"unit_grams": {
"type": "integer",
"maximum": 100000000,
"minimum": 0,
"description": "Weight of ONE unit in whole grams. Omit when not weighed; the carton is then a lower bound"
},
"description": {
"type": "string",
"maxLength": 2000,
"description": "The goods going in, e.g. Oak shelf 900mm"
},
"packing_list": {
"type": "string",
"maxLength": 200,
"description": "The packing list id, e.g. PL-2026-0001, or the order reference when only one list carries it"
}
},
"additionalProperties": false
}Add an ordered line to a packing list so the shortfall is real: a SKU, a description and a quantity. Nothing is read from the quotes, work order or invoice store; what the order says is stated here.
| Argument | Type | Description |
|---|---|---|
| sku | string | Stock code, upper-cased and stripped of spaces. Lines with a SKU are matched on it, lines without on their description |
| quantity* | integer | How many units the order says should ship. Whole units |
| description* | string | The goods as the order names them, e.g. Oak shelf 900mm |
| packing_list* | string | The packing list id, e.g. PL-2026-0001, or the order reference when only one list carries it |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"packing_list",
"description",
"quantity"
],
"properties": {
"sku": {
"type": "string",
"maxLength": 64,
"description": "Stock code, upper-cased and stripped of spaces. Lines with a SKU are matched on it, lines without on their description"
},
"quantity": {
"type": "integer",
"maximum": 1000000,
"minimum": 1,
"description": "How many units the order says should ship. Whole units"
},
"description": {
"type": "string",
"maxLength": 2000,
"description": "The goods as the order names them, e.g. Oak shelf 900mm"
},
"packing_list": {
"type": "string",
"maxLength": 200,
"description": "The packing list id, e.g. PL-2026-0001, or the order reference when only one list carries it"
}
},
"additionalProperties": false
}Open a packing list against an order and return its PL-YYYY-NNNN number: the order reference, the consignee, where it ships to and the date. Free tier: 3 open at once; shipping or cancelling frees a slot.
| Argument | Type | Description |
|---|---|---|
| date | string | The day the list was raised, YYYY-MM-DD. Default today |
| note | string | |
| ship_to | string | The delivery address, printed on the slip. Omit to leave it off |
| consignee* | string | Who receives the goods, as named on the order |
| reference* | string | The order this ships against, by id, e.g. WO-2026-0001, INV-2026-0007 or PO-4471 |
| duplicate_ok | boolean | Open it even though an OPEN list already exists on this reference. Default false |
| reference_kind | string | What the reference is. Inferred from the id when omitted: WO- work order, INV- invoice, Q- quote, otherwise a plain order |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"reference",
"consignee"
],
"properties": {
"date": {
"type": "string",
"maxLength": 10,
"description": "The day the list was raised, YYYY-MM-DD. Default today"
},
"note": {
"type": "string",
"maxLength": 2000
},
"ship_to": {
"type": "string",
"maxLength": 2000,
"description": "The delivery address, printed on the slip. Omit to leave it off"
},
"consignee": {
"type": "string",
"maxLength": 200,
"description": "Who receives the goods, as named on the order"
},
"reference": {
"type": "string",
"maxLength": 64,
"description": "The order this ships against, by id, e.g. WO-2026-0001, INV-2026-0007 or PO-4471"
},
"duplicate_ok": {
"type": "boolean",
"description": "Open it even though an OPEN list already exists on this reference. Default false"
},
"reference_kind": {
"enum": [
"quote",
"work_order",
"invoice",
"order"
],
"type": "string",
"description": "What the reference is. Inferred from the id when omitted: WO- work order, INV- invoice, Q- quote, otherwise a plain order"
}
},
"additionalProperties": false
}Delete a packing list for good, with its cartons and packed lines. A shipped list is refused: it is the record of what left the building. Cancel a list you no longer want instead of deleting a real shipment.
| Argument | Type | Description |
|---|---|---|
| confirm* | boolean | Must be true. There is no undo and nothing is copied anywhere first |
| packing_list* | string | The packing list id, e.g. PL-2026-0001, or the order reference when only one list carries it |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"packing_list",
"confirm"
],
"properties": {
"confirm": {
"type": "boolean",
"const": true,
"description": "Must be true. There is no undo and nothing is copied anywhere first"
},
"packing_list": {
"type": "string",
"maxLength": 200,
"description": "The packing list id, e.g. PL-2026-0001, or the order reference when only one list carries it"
}
},
"additionalProperties": false
}Packing lists newest first, with cartons, units, gross weight and how many ordered lines are still short. Filter by status, by order reference or by consignee. Returns at most 500 rows.
| Argument | Type | Description |
|---|---|---|
| status | string | Only lists in this status |
| divisor | integer | Volumetric divisor in cm3 per kg: 5000 courier air (default), 6000 IATA air, 4000 some road tariffs |
| consignee | string | Only lists whose consignee contains this text |
| open_only | boolean | Only draft and packed lists, the ones that count against the free tier. Default false |
| reference | string | Only lists against this order reference, matched case-insensitively |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"status": {
"enum": [
"draft",
"packed",
"shipped",
"cancelled"
],
"type": "string",
"description": "Only lists in this status"
},
"divisor": {
"type": "integer",
"description": "Volumetric divisor in cm3 per kg: 5000 courier air (default), 6000 IATA air, 4000 some road tariffs"
},
"consignee": {
"type": "string",
"maxLength": 200,
"description": "Only lists whose consignee contains this text"
},
"open_only": {
"type": "boolean",
"description": "Only draft and packed lists, the ones that count against the free tier. Default false"
},
"reference": {
"type": "string",
"maxLength": 64,
"description": "Only lists against this order reference, matched case-insensitively"
}
},
"additionalProperties": false
}The whole packing list: its cartons with contents and derived weights, the ordered lines, the shortfall, whether it is ready to ship and why not, and its status history. Nothing here is stored; it is computed.
| Argument | Type | Description |
|---|---|---|
| divisor | integer | Volumetric divisor in cm3 per kg: 5000 courier air (default), 6000 IATA air, 4000 some road tariffs |
| packing_list* | string | The packing list id, e.g. PL-2026-0001, or the order reference when only one list carries it |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"packing_list"
],
"properties": {
"divisor": {
"type": "integer",
"description": "Volumetric divisor in cm3 per kg: 5000 courier air (default), 6000 IATA air, 4000 some road tariffs"
},
"packing_list": {
"type": "string",
"maxLength": 200,
"description": "The packing list id, e.g. PL-2026-0001, or the order reference when only one list carries it"
}
},
"additionalProperties": false
}Move a packing list draft to packed to shipped, or cancel it. Shipping records the carrier, the tracking number and the date, and freezes the list. A shipped list cannot be reopened or edited.
| Argument | Type | Description |
|---|---|---|
| date | string | The day the step happened, YYYY-MM-DD. Default today |
| note | string | |
| force | boolean | Ship even though lines are short, over-packed or not on the order. Default false, and the reasons come back either way |
| status* | string | The status to move to. draft to packed to shipped, or cancelled from either open status |
| carrier | string | Who is carrying it, recorded when moving to shipped |
| tracking | string | The carrier's consignment or tracking number, recorded when moving to shipped |
| packing_list* | string | The packing list id, e.g. PL-2026-0001, or the order reference when only one list carries it |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"packing_list",
"status"
],
"properties": {
"date": {
"type": "string",
"maxLength": 10,
"description": "The day the step happened, YYYY-MM-DD. Default today"
},
"note": {
"type": "string",
"maxLength": 2000
},
"force": {
"type": "boolean",
"description": "Ship even though lines are short, over-packed or not on the order. Default false, and the reasons come back either way"
},
"status": {
"enum": [
"draft",
"packed",
"shipped",
"cancelled"
],
"type": "string",
"description": "The status to move to. draft to packed to shipped, or cancelled from either open status"
},
"carrier": {
"type": "string",
"maxLength": 200,
"description": "Who is carrying it, recorded when moving to shipped"
},
"tracking": {
"type": "string",
"maxLength": 200,
"description": "The carrier's consignment or tracking number, recorded when moving to shipped"
},
"packing_list": {
"type": "string",
"maxLength": 200,
"description": "The packing list id, e.g. PL-2026-0001, or the order reference when only one list carries it"
}
},
"additionalProperties": false
}Ordered against packed, line by line: what is still short, what was over-packed, and what was packed that is not on the order at all. A packed line with no ordered line is reported, never dropped.
| Argument | Type | Description |
|---|---|---|
| packing_list* | string | The packing list id, e.g. PL-2026-0001, or the order reference when only one list carries it |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"packing_list"
],
"properties": {
"packing_list": {
"type": "string",
"maxLength": 200,
"description": "The packing list id, e.g. PL-2026-0001, or the order reference when only one list carries it"
}
},
"additionalProperties": false
}The packing slip as plain text on every tier: cartons, contents, weights and a signature line, and no prices anywhere. Pro also gets it back as a .txt download link valid for one hour, named by out_path; an existing name is refused unless told to overwrite.
| Argument | Type | Description |
|---|---|---|
| divisor | integer | Volumetric divisor in cm3 per kg: 5000 courier air (default), 6000 IATA air, 4000 some road tariffs |
| out_path | string | Name for the downloaded .txt file, e.g. order-4471-slip. Pro only. Omit to get the slip back as text, which every tier can do; the file comes back as a download link valid for one hour |
| overwrite | boolean | Replace out_path if a file is already there. Default false, and an existing file is refused with nothing written |
| packing_list* | string | The packing list id, e.g. PL-2026-0001, or the order reference when only one list carries it |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"packing_list"
],
"properties": {
"divisor": {
"type": "integer",
"description": "Volumetric divisor in cm3 per kg: 5000 courier air (default), 6000 IATA air, 4000 some road tariffs"
},
"out_path": {
"type": "string",
"maxLength": 1000,
"description": "Name for the downloaded .txt file, e.g. order-4471-slip. Pro only. Omit to get the slip back as text, which every tier can do; the file comes back as a download link valid for one hour"
},
"overwrite": {
"type": "boolean",
"description": "Replace out_path if a file is already there. Default false, and an existing file is refused with nothing written"
},
"packing_list": {
"type": "string",
"maxLength": 200,
"description": "The packing list id, e.g. PL-2026-0001, or the order reference when only one list carries it"
}
},
"additionalProperties": false
}Remove one packed line from a packing list by its L01-style id and return the carton it came out of. The line is deleted, not zeroed, so the slip does not print an item nobody packed.
| Argument | Type | Description |
|---|---|---|
| line* | string | The packed line id, e.g. L03, as shown by packing_list_show or carton_report |
| packing_list* | string | The packing list id, e.g. PL-2026-0001, or the order reference when only one list carries it |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"packing_list",
"line"
],
"properties": {
"line": {
"type": "string",
"maxLength": 16,
"description": "The packed line id, e.g. L03, as shown by packing_list_show or carton_report"
},
"packing_list": {
"type": "string",
"maxLength": 200,
"description": "The packing list id, e.g. PL-2026-0001, or the order reference when only one list carries it"
}
},
"additionalProperties": false
}