MCP 服务器

carton-consignment-waybill-pack-list

io.github.theluckystrike/carton-consignment-waybill-pack-list
商业与运营 不可用 MCP 2026-07-28

此 MCP 可以做什么

Creates and manages packing lists, cartons, packed items, weights, shortfalls, shipping status, and packing slips for consignments.

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.
输入模式
{'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.
只读 幂等
输入模式
{'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.
输入模式
{'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.
只读 幂等
输入模式
{'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.
输入模式
{'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.
输入模式
{'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.
可能执行破坏性操作
输入模式
{'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.
只读 幂等
输入模式
{'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.
只读 幂等
输入模式
{'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.
只读 幂等
输入模式
{'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.
输入模式
{'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.
输入模式
{'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.
输入模式
{'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.
输入模式
{'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}
已更改
license_activate
2026年9月22日 02:40
已更改
license_status
2026年9月22日 02:40
已更改
packing_list_delete
2026年9月22日 02:40
已更改
packing_slip
2026年9月22日 02:40
已更改
packing_list_status
2026年9月22日 02:40
已更改
packing_shortfall
2026年9月22日 02:40
已更改
carton_report
2026年9月22日 02:40
已更改
packing_list_list
2026年9月22日 02:40
已更改
packing_list_show
2026年9月22日 02:40
已更改
unpack_item
2026年9月22日 02:40
已更改
pack_item
2026年9月22日 02:40
已更改
carton_add
2026年9月22日 02:40
已更改
packing_expect
2026年9月22日 02:40
已更改
packing_list_create
2026年9月22日 02:40
已添加
license_activate
2026年9月18日 02:40
已添加
license_status
2026年9月18日 02:40
已添加
packing_list_delete
2026年9月18日 02:40
已添加
packing_slip
2026年9月18日 02:40
已添加
packing_list_status
2026年9月18日 02:40
已添加
packing_shortfall
2026年9月18日 02:40
已添加
carton_report
2026年9月18日 02:40
已添加
packing_list_list
2026年9月18日 02:40
已添加
packing_list_show
2026年9月18日 02:40
已添加
unpack_item
2026年9月18日 02:40
已添加
pack_item
2026年9月18日 02:40
已添加
carton_add
2026年9月18日 02:40
已添加
packing_expect
2026年9月18日 02:40
已添加
packing_list_create
2026年9月18日 02:40