MCP-Server

packing-slip-cartons-shipment-weights

io.github.theluckystrike/packing-slip-cartons-shipment-weights
Business & Betrieb Commerce & Retail Öffentlich und erreichbar MCP 2026-07-28

Was dieses MCP kann

Creates and manages packing lists, cartons, packed goods, shipment weights, shortfalls and shipping status.

carton_add
Add a carton
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.
Eingabeschema
{'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}
carton_report
Weigh the cartons
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.
Nur Lesen Idempotent
Eingabeschema
{'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}
license_activate
Activate license
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.
Eingabeschema
{'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}
license_status
License status
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.
Nur Lesen Idempotent
Eingabeschema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
packing_expect
Declare what the order says should ship
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.
Eingabeschema
{'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}
packing_list_create
Open a packing list
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.
Eingabeschema
{'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}
packing_list_delete
Delete a packing list
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.
Destruktiv
Eingabeschema
{'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_list_list
List packing lists
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.
Nur Lesen Idempotent
Eingabeschema
{'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}
packing_list_show
Show one packing list
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.
Nur Lesen Idempotent
Eingabeschema
{'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}
packing_list_status
Move a packing list on
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.
Nur Lesen Idempotent
Eingabeschema
{'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}
packing_shortfall
What is still to pack
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.
Eingabeschema
{'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}
packing_slip
Produce the packing slip
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.
Eingabeschema
{'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}
pack_item
Pack goods into a carton
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.
Eingabeschema
{'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}
unpack_item
Take a packed line back out
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.
Eingabeschema
{'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}
Hinzugefügt
license_activate
24. September 2026 02:40
Hinzugefügt
license_status
24. September 2026 02:40
Hinzugefügt
packing_list_delete
24. September 2026 02:40
Hinzugefügt
packing_slip
24. September 2026 02:40
Hinzugefügt
packing_list_status
24. September 2026 02:40
Hinzugefügt
packing_shortfall
24. September 2026 02:40
Hinzugefügt
carton_report
24. September 2026 02:40
Hinzugefügt
packing_list_list
24. September 2026 02:40
Hinzugefügt
packing_list_show
24. September 2026 02:40
Hinzugefügt
unpack_item
24. September 2026 02:40
Hinzugefügt
pack_item
24. September 2026 02:40
Hinzugefügt
carton_add
24. September 2026 02:40
Hinzugefügt
packing_expect
24. September 2026 02:40
Hinzugefügt
packing_list_create
24. September 2026 02:40