io.github.lxxmng/container-loading is an MCP server published by io.github.lxxmng, hosted at mcp.loadingmcp.com. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 6 tools, including list_equipment, suggest_containers, plan_load, export_plan, import_packing_list.
Plan optimal container & truck loads: 3D layouts, utilization, centre of gravity, crush checks.
4 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
List the standard container, truck, ULD and pallet types LoadingMCP can plan loads into, with internal dimensions (mm) and max payload (kg).
| Parameter | Type | Description |
|---|---|---|
| category | string | Optional category filter |
{
"name": "list_equipment",
"description": "List the standard container, truck, ULD and pallet types LoadingMCP can plan loads into, with internal dimensions (mm) and max payload (kg).",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"category": {
"enum": [
"container",
"truck",
"uld",
"pallet"
],
"type": "string",
"description": "Optional category filter"
}
}
}
}None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Given total cargo volume (m³) and weight (kg), suggest how many of which container to use — a quick volume/weight estimate. For an exact, dimension-aware plan with utilization, CoG and securing, use plan_load (which can also auto right-size).
| Parameter | Type | Description |
|---|---|---|
| volumeM3 * | number | Total cargo volume in cubic metres |
| weightKg * | number | Total cargo weight in kilograms |
{
"name": "suggest_containers",
"description": "Given total cargo volume (m³) and weight (kg), suggest how many of which container to use — a quick volume/weight estimate. For an exact, dimension-aware plan with utilization, CoG and securing, use plan_load (which can also auto right-size).",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"volumeM3",
"weightKg"
],
"properties": {
"volumeM3": {
"type": "number",
"description": "Total cargo volume in cubic metres"
},
"weightKg": {
"type": "number",
"description": "Total cargo weight in kilograms"
}
}
}
}Compute a 3D load plan for cargo into a container or truck: containers used, utilization (volume & payload %), centre of gravity, crush-protection violations, and a securing checklist (round cargo that rolls, soft cargo that slumps). Cargo `type` drives realism — drums/pipes hex-nest, big bags/sacks load on top and are never crushed. Omit `equipmentCode` to auto right-size to the cheapest container that fits. A real API key runs the production PackingSolver optimizer; the public demo key uses the offline preview packer.
| Parameter | Type | Description |
|---|---|---|
| vgm | object | SOLAS Verified Gross Mass declaration (else a tare+cargo estimate is reported) |
| mode | string | Transport mode — scopes auto right-size to usable equipment (sea→containers, road→trucks, air→ULDs). Ignored when equipmentCode is given. |
| items * | array | Cargo lines to load |
| topUp | boolean | Also return `topUp`: for each cargo line, how many MORE units still fit in the same containers with every unit placed and the load still ready (e.g. "+6 of SKU A, fill 82%"), plus `topUpCombos`: up to 3 mixes of two lines that fit together (e.g. "+4 of A and +2 of B"). Takes longer, since it re-plan… |
| freight | object | Freight cost per unit: split the ocean freight for this load (rate per container x containers used) across the cargo lines, per line and per unit, so it can go into product cost. Uses the indicative market rate for the lane (20GP/40GP/40HC, real API key) or your ratePerContainer. Indicative, not a q… |
| massLimits | string | Australian mass tier (default general). hml = HVNL Higher Mass Limits for AU (tri-axle 22.5 t, 6-axle combination 45.5 t; needs an HML route, road-friendly suspension and mass accreditation) or the NT road-friendly-suspension limits for AU-NT. Ignored elsewhere. |
| jurisdiction | string | Road jurisdiction for the axle / gross-weight compliance check (default EU). Set CN for China GB 1589 drayage limits, AU for Australian HVNL general mass limits (NSW, Vic, Qld, SA, Tas, ACT), AU-WA for Western Australia, AU-NT for the Northern Territory. Australian jurisdictions also secure to the H… |
| vesselMotion | object | IMO CSS Annex 13 vessel motion + stowage position. When set, the sea leg uses the position-dependent DYNAMIC acceleration field (a container on deck forward sees a far harsher case than one low amidships) instead of the flat sea-area coefficient. |
| equipmentCode | string | Equipment code, e.g. 40HC (see list_equipment). Omit to auto right-size. |
| sequenceStops | boolean | Delivery-stop sequencing: with ≥2 distinct deliveryStop values, zone the load nose→doors in reverse delivery order. |
| vehicleTareKg | number | Your road vehicle tare in kg (container: prime mover + chassis/skeletal; truck: the truck). Replaces the nominal tare in the gross check (AU default 14,100 kg, elsewhere 11,600 kg for a container combination). For a truck it also sets the load the vehicle itself puts on each axle group in axleLoadsK… |
| complyingSteerAxle | boolean | AU only: the prime mover is an HVNL complying steer axle vehicle (6.5 t steer, 44 t combination). Default false. |
| extremeAxleSpacingMm | number | AU, AU-WA, AU-NT only: your vehicle extreme axle spacing in mm (steer axle centre to last axle centre) for the axle-spacing mass limit (HVNL Sch 1 s 5 Table 2, WA r 165, NT r 13). Default for a container: nominal prime mover + 40 ft tri-axle skeletal, 13,805 mm. Truck profiles have no steer position… |
{
"name": "plan_load",
"description": "Compute a 3D load plan for cargo into a container or truck: containers used, utilization (volume & payload %), centre of gravity, crush-protection violations, and a securing checklist (round cargo that rolls, soft cargo that slumps). Cargo `type` drives realism — drums/pipes hex-nest, big bags/sacks load on top and are never crushed. Omit `equipmentCode` to auto right-size to the cheapest container that fits. A real API key runs the production PackingSolver optimizer; the public demo key uses the offline preview packer.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"items"
],
"properties": {
"vgm": {
"type": "object",
"properties": {
"method": {
"enum": [
"M1",
"M2"
],
"type": "string",
"description": "VGM method: M1 = weighbridge of the packed container, M2 = certified calculated sum"
},
"dunnageKg": {
"type": "number",
"minimum": 0,
"description": "Dunnage/securing mass (kg) to fold into the calculated VGM estimate"
},
"declaredKg": {
"type": "array",
"items": {
"type": "number",
"minimum": 0
},
"description": "Shipper-declared SOLAS VGM per container (kg), index-aligned to containers used"
}
},
"description": "SOLAS Verified Gross Mass declaration (else a tare+cargo estimate is reported)"
},
"mode": {
"enum": [
"sea",
"road",
"air"
],
"type": "string",
"default": "sea",
"description": "Transport mode — scopes auto right-size to usable equipment (sea→containers, road→trucks, air→ULDs). Ignored when equipmentCode is given."
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"length",
"width",
"height",
"weight"
],
"properties": {
"id": {
"type": "string",
"description": "Your reference for this cargo line"
},
"type": {
"enum": [
"box",
"pallet",
"drum",
"cylinder",
"bigbag",
"roll",
"sack"
],
"type": "string",
"default": "box",
"description": "Cargo shape: drum/cylinder/roll hex-nest; bigbag/sack load on top, never crushed"
},
"bulky": {
"type": "boolean",
"default": false,
"description": "Bulky/awkward — never takes a load on top and needs handling clearance"
},
"width": {
"type": "number",
"description": "mm"
},
"height": {
"type": "number",
"description": "mm"
},
"length": {
"type": "number",
"description": "mm"
},
"weight": {
"type": "number",
"description": "kg per unit"
},
"quantity": {
"type": "integer",
"default": 1,
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"unNumber": {
"type": "string",
"description": "UN number, e.g. \"UN1263\" or \"1263\". When set, the engine DERIVES the IMDG class, packing group, subsidiary risks, marine-pollutant status, segregation groups, stowage category and EmS from the curated Dangerous Goods List — no need to hand-enter each. Explicit DG fields override the derived ones."
},
"rotatable": {
"type": "boolean",
"default": true,
"description": "false = keep the unit exactly as entered: never turned on the floor, never tipped onto its side"
},
"stackable": {
"type": "boolean",
"default": true,
"description": "Whether anything may be stacked on top"
},
"doubleWall": {
"type": "boolean",
"description": "Double-wall corrugated (vs single)"
},
"thisSideUp": {
"type": "boolean",
"default": false,
"description": "Must stay upright — restricts the packer to upright orientations"
},
"hazmatClass": {
"type": "string",
"description": "IMDG dangerous-goods class (e.g. \"3\", \"5.1\") — drives 7.2.4 segregation. Omit for non-hazardous."
},
"boardEctLbIn": {
"type": "number",
"description": "Corrugated edge-crush test (lb/in) → physical McKee crush limit for cartons",
"exclusiveMinimum": 0
},
"deliveryStop": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Multi-drop delivery-stop order (1 = first delivered, loaded last at the doors). ≥2 distinct stops + sequenceStops zones the load nose→doors.",
"exclusiveMinimum": 0
},
"packingGroup": {
"enum": [
"I",
"II",
"III"
],
"type": "string",
"description": "IMDG packing group. Derived from the UN number when unNumber is set."
},
"refrigerated": {
"type": "boolean",
"default": false,
"description": "Needs the cold chain (reefer only)"
},
"boardCaliperMm": {
"type": "number",
"description": "Corrugated board thickness (mm)",
"exclusiveMinimum": 0
},
"limitedQuantity": {
"type": "boolean",
"description": "Shipped as a limited quantity (IMDG 3.4) — exempt from most segregation except vs class 1/7."
},
"marinePollutant": {
"type": "boolean",
"description": "Marine pollutant (IMDG 2.10 / MARPOL Annex III). Derived from the DGL."
},
"maxStackWeightKg": {
"type": "number",
"minimum": 0,
"description": "Your crush limit: max kg allowed on top of one unit. Omit for a generous default; 0 = nothing may stack on it."
},
"segregationGroups": {
"type": "array",
"items": {
"type": "string"
},
"description": "IMDG 2.7.2.5 segregation groups this substance belongs to."
},
"subsidiaryHazards": {
"type": "array",
"items": {
"type": "string"
},
"description": "IMDG subsidiary hazard classes, e.g. [\"6.1\", \"8\"]."
},
"compatibilityGroup": {
"type": "string",
"description": "Class-1 explosives compatibility group (A–S)."
},
"segregateFromGroups": {
"type": "array",
"items": {
"type": "string"
},
"description": "IMDG segregation groups to keep this substance away from (its DGL column-16b provisions)."
}
}
},
"description": "Cargo lines to load"
},
"topUp": {
"type": "boolean",
"description": "Also return `topUp`: for each cargo line, how many MORE units still fit in the same containers with every unit placed and the load still ready (e.g. \"+6 of SKU A, fill 82%\"), plus `topUpCombos`: up to 3 mixes of two lines that fit together (e.g. \"+4 of A and +2 of B\"). Takes longer, since it re-plans the load per line."
},
"freight": {
"type": "object",
"properties": {
"basis": {
"enum": [
"volume",
"weight",
"chargeable"
],
"type": "string",
"description": "Split by cargo volume (default), weight, or chargeable (the larger of the two shares per line)."
},
"origin": {
"type": "string",
"description": "Port of loading, UN/LOCODE (e.g. CNSHA). Needed for a market rate."
},
"currency": {
"type": "string",
"description": "ISO 4217 code. Labels ratePerContainer (default USD); with a market rate it must match the lane currency (no conversion)."
},
"destination": {
"type": "string",
"description": "Port of discharge, UN/LOCODE (e.g. AUMEL). Needed for a market rate."
},
"ratePerContainer": {
"type": "number",
"description": "Your own rate per container. When given, no market rate is looked up.",
"exclusiveMinimum": 0
}
},
"description": "Freight cost per unit: split the ocean freight for this load (rate per container x containers used) across the cargo lines, per line and per unit, so it can go into product cost. Uses the indicative market rate for the lane (20GP/40GP/40HC, real API key) or your ratePerContainer. Indicative, not a quote. No rate = freight.available false with a reason."
},
"massLimits": {
"enum": [
"general",
"hml"
],
"type": "string",
"description": "Australian mass tier (default general). hml = HVNL Higher Mass Limits for AU (tri-axle 22.5 t, 6-axle combination 45.5 t; needs an HML route, road-friendly suspension and mass accreditation) or the NT road-friendly-suspension limits for AU-NT. Ignored elsewhere."
},
"jurisdiction": {
"enum": [
"EU",
"US",
"CN",
"AU",
"AU-WA",
"AU-NT"
],
"type": "string",
"description": "Road jurisdiction for the axle / gross-weight compliance check (default EU). Set CN for China GB 1589 drayage limits, AU for Australian HVNL general mass limits (NSW, Vic, Qld, SA, Tas, ACT), AU-WA for Western Australia, AU-NT for the Northern Territory. Australian jurisdictions also secure to the HVNL Sch 7 loading performance standards."
},
"vesselMotion": {
"type": "object",
"required": [
"lengthFraction",
"stowageZone"
],
"properties": {
"bOverGm": {
"type": "number",
"description": "Beam / metacentric-height ratio B/GM; derives the Annex 13 transverse B/GM correction.",
"exclusiveMinimum": 0
},
"lengthM": {
"type": "number",
"description": "Ship length between perpendiculars (m); with speedKn, derives the Annex 13 length/speed correction (50–300 m).",
"exclusiveMinimum": 0
},
"speedKn": {
"type": "number",
"description": "Service speed (kn); pairs with lengthM.",
"exclusiveMinimum": 0
},
"bGmFactor": {
"type": "number",
"description": "Explicit IMO CSS Annex 13 B/GM correction factor (fallback when bOverGm absent).",
"exclusiveMinimum": 0
},
"stowageZone": {
"enum": [
"onDeckHigh",
"onDeckLow",
"tweendeck",
"lowerHold"
],
"type": "string",
"description": "Vertical stowage zone."
},
"lengthFraction": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Longitudinal stowage position as a fraction of ship length from the aft perpendicular (0=aft, 1=fore)."
},
"lengthSpeedFactor": {
"type": "number",
"description": "Explicit IMO CSS Annex 13 length/speed correction factor (fallback when lengthM/speedKn absent).",
"exclusiveMinimum": 0
}
},
"description": "IMO CSS Annex 13 vessel motion + stowage position. When set, the sea leg uses the position-dependent DYNAMIC acceleration field (a container on deck forward sees a far harsher case than one low amidships) instead of the flat sea-area coefficient."
},
"equipmentCode": {
"type": "string",
"description": "Equipment code, e.g. 40HC (see list_equipment). Omit to auto right-size."
},
"sequenceStops": {
"type": "boolean",
"default": false,
"description": "Delivery-stop sequencing: with ≥2 distinct deliveryStop values, zone the load nose→doors in reverse delivery order."
},
"vehicleTareKg": {
"type": "number",
"description": "Your road vehicle tare in kg (container: prime mover + chassis/skeletal; truck: the truck). Replaces the nominal tare in the gross check (AU default 14,100 kg, elsewhere 11,600 kg for a container combination). For a truck it also sets the load the vehicle itself puts on each axle group in axleLoadsKg, split like the nominal tare.",
"exclusiveMinimum": 0
},
"complyingSteerAxle": {
"type": "boolean",
"description": "AU only: the prime mover is an HVNL complying steer axle vehicle (6.5 t steer, 44 t combination). Default false."
},
"extremeAxleSpacingMm": {
"type": "number",
"maximum": 40000,
"minimum": 3000,
"description": "AU, AU-WA, AU-NT only: your vehicle extreme axle spacing in mm (steer axle centre to last axle centre) for the axle-spacing mass limit (HVNL Sch 1 s 5 Table 2, WA r 165, NT r 13). Default for a container: nominal prime mover + 40 ft tri-axle skeletal, 13,805 mm. Truck profiles have no steer position: without it only the spacing between their axle groups is checked. Result: compliance.axle.spacing; an over-limit span is an AXLE_SPACING blocker."
}
}
}
}Export a load as a machine-readable LOADING WORK ORDER: a numbered stuffing sequence (which SKU, where, in what order and orientation), the securing/bracing action list, a securing shopping list per container (`securingBom`: straps, airbags, timber, bars, with quantities, specs and the work-order steps each goes to; recommendations to verify with the carrier), the key declarable figures (VGM, axle load, centre of gravity), and an optional per-retailer inbound-packaging check (Amazon FBA / Walmart). Feed it to a WES/TMS, a robotic palletiser, or a printable worker sheet. A real API key packs it with the production PackingSolver optimizer (the same plan plan_load returns for the same cargo); the public demo key uses the offline preview packer; `engine` in the result says which one ran. This is decision support to MEET published retailer/carrier specs — verify in your own portal; it is not a retailer certification.
| Parameter | Type | Description |
|---|---|---|
| mode | string | Transport mode for auto right-size (ignored when equipmentCode is given). |
| items * | array | Cargo lines to load |
| retailers | array | Retailer inbound-packaging profiles to check the load against. |
| equipmentCode | string | Equipment code, e.g. 40HC (see list_equipment). Omit to auto right-size. |
{
"name": "export_plan",
"description": "Export a load as a machine-readable LOADING WORK ORDER: a numbered stuffing sequence (which SKU, where, in what order and orientation), the securing/bracing action list, a securing shopping list per container (`securingBom`: straps, airbags, timber, bars, with quantities, specs and the work-order steps each goes to; recommendations to verify with the carrier), the key declarable figures (VGM, axle load, centre of gravity), and an optional per-retailer inbound-packaging check (Amazon FBA / Walmart). Feed it to a WES/TMS, a robotic palletiser, or a printable worker sheet. A real API key packs it with the production PackingSolver optimizer (the same plan plan_load returns for the same cargo); the public demo key uses the offline preview packer; `engine` in the result says which one ran. This is decision support to MEET published retailer/carrier specs — verify in your own portal; it is not a retailer certification.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"items"
],
"properties": {
"mode": {
"enum": [
"sea",
"road",
"air"
],
"type": "string",
"default": "sea",
"description": "Transport mode for auto right-size (ignored when equipmentCode is given)."
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"length",
"width",
"height",
"weight"
],
"properties": {
"id": {
"type": "string",
"description": "Your reference for this cargo line"
},
"type": {
"enum": [
"box",
"pallet",
"drum",
"cylinder",
"bigbag",
"roll",
"sack"
],
"type": "string",
"default": "box"
},
"width": {
"type": "number",
"description": "mm"
},
"height": {
"type": "number",
"description": "mm"
},
"length": {
"type": "number",
"description": "mm"
},
"weight": {
"type": "number",
"description": "kg per unit"
},
"quantity": {
"type": "integer",
"default": 1,
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"unNumber": {
"type": "string",
"description": "UN number (e.g. \"UN1263\") — derives the IMDG class/PG/segregation/stowage/EmS from the DGL."
},
"rotatable": {
"type": "boolean",
"default": true,
"description": "false = keep the unit exactly as entered: never turned on the floor, never tipped onto its side"
},
"stackable": {
"type": "boolean",
"default": true
},
"thisSideUp": {
"type": "boolean",
"default": false,
"description": "Must stay upright — restricts the packer to upright orientations"
},
"hazmatClass": {
"type": "string",
"description": "IMDG class (e.g. \"3\", \"5.1\"); omit if none"
},
"maxStackWeightKg": {
"type": "number",
"minimum": 0
}
}
},
"description": "Cargo lines to load"
},
"retailers": {
"type": "array",
"items": {
"enum": [
"AMAZON_FBA",
"WALMART_STORES",
"WALMART_WFS",
"GENERIC_GMA"
],
"type": "string"
},
"description": "Retailer inbound-packaging profiles to check the load against."
},
"equipmentCode": {
"type": "string",
"description": "Equipment code, e.g. 40HC (see list_equipment). Omit to auto right-size."
}
}
}
}ERP/TMS on-ramp: take a versioned "loadingmcp.packing-list" document (a WMS/ERP export — cargo lines + equipmentCode) and return a load plan + a container manifest. Parsing is fail-explicit: an invalid document returns the exact per-line issues, never a silently-dropped row. Pairs with plan_load's output for a full round-trip.
| Parameter | Type | Description |
|---|---|---|
| packingList * | object | A loadingmcp.packing-list document: { format: "loadingmcp.packing-list", formatVersion, equipmentCode, jurisdiction?, lines: [...] }. See docs/INTEGRATION.md. |
{
"name": "import_packing_list",
"description": "ERP/TMS on-ramp: take a versioned \"loadingmcp.packing-list\" document (a WMS/ERP export — cargo lines + equipmentCode) and return a load plan + a container manifest. Parsing is fail-explicit: an invalid document returns the exact per-line issues, never a silently-dropped row. Pairs with plan_load's output for a full round-trip.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"packingList"
],
"properties": {
"packingList": {
"type": "object",
"description": "A loadingmcp.packing-list document: { format: \"loadingmcp.packing-list\", formatVersion, equipmentCode, jurisdiction?, lines: [...] }. See docs/INTEGRATION.md.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
}
}Draft the dangerous-goods paperwork for a load from its cargo lines: an IMDG 5.4.1 transport-document description per DG line (UN, proper shipping name, class, PG, marine pollutant), the 5.3 placards + marks required, and the 5.4.2 container/vehicle packing-certificate statements. Input is a "loadingmcp.packing-list" document. This is a DRAFT from the curated DGL — it lists the fields a DG-competent person must still complete (flash point, net explosive mass, unverified PSN) and is never signed.
| Parameter | Type | Description |
|---|---|---|
| packingList * | object | A loadingmcp.packing-list document with DG-bearing lines (unNumber/hazmatClass/packingGroup/marinePollutant). See docs/INTEGRATION.md. |
{
"name": "export_dg_paperwork",
"description": "Draft the dangerous-goods paperwork for a load from its cargo lines: an IMDG 5.4.1 transport-document description per DG line (UN, proper shipping name, class, PG, marine pollutant), the 5.3 placards + marks required, and the 5.4.2 container/vehicle packing-certificate statements. Input is a \"loadingmcp.packing-list\" document. This is a DRAFT from the curated DGL — it lists the fields a DG-competent person must still complete (flash point, net explosive mass, unverified PSN) and is never signed.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"packingList"
],
"properties": {
"packingList": {
"type": "object",
"description": "A loadingmcp.packing-list document with DG-bearing lines (unNumber/hazmatClass/packingGroup/marinePollutant). See docs/INTEGRATION.md.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
}
}
}
}Names, descriptions and schemas were written by the server and are shown as data.