Kubova — 3D Container Loading
Pack cargo into containers & onto pallets; a verifiable 3D loading plan. Free tier + REST API.
Should I use this
Quality & Safety
A
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
~3,265Tokens (tool definitions)
~8.1 KBTypical response size
Significant attention impact (2.55% of 128k context)
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"container-loading": {
"url": "https://kubova.com/mcp"
}
}
}Remote endpoints
https://kubova.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (4)
🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢pack_containers(cargos, container, containers, loadingMode, pallet, ...)
Pack a list of cargo SKUs into one or more shipping containers using the Kubova solver. Supports bulk loading (cartons straight into the container) and pallet loading (loadingMode:"pallet" + a pallet — cartons are stacked onto pallets first, then the pallets loaded). Per-SKU you can set allowed orientations, no-overstack/no-understack, and loading order. Returns per-container placements with x,y,z coordinates in cm, volume utilization, weight, a weightBalance object (centre of gravity + front/back & left/right weight split, flags an unbalanced load) for bulk loads, and any unplaced pieces.
Input Schema
{
"type": "object",
"properties": {
"cargos": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 200
},
"name": {
"type": "string",
"maxLength": 200
},
"shape": {
"type": "string",
"enum": [
"box",
"cylinder"
],
"default": "box"
},
"lengthCm": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 5000
},
"widthCm": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 5000
},
"heightCm": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 5000
},
"diameterCm": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 5000
},
"quantity": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 1000000,
"description": "Number of identical pieces of this SKU."
},
"weightKg": {
"type": "number",
"minimum": 0,
"description": "Weight of ONE piece in kg — NOT the row total. If a packing list shows both \"weight/piece\" and \"weight total\", use weight/piece (total = quantity × weightKg)."
},
"color": {
"type": "string",
"default": "#3b82f6"
},
"includeInLoading": {
"type": "boolean",
"default": true
},
"allowStacking": {
"type": "boolean",
"default": true
},
"allowRotation": {
"type": "boolean",
"default": true
},
"orientations": {
"type": "array",
"items": {
"type": "string",
"enum": [
"standard-0",
"standard-90",
"turnup-0",
"turnup-90",
"turnside-0",
"turnside-90"
]
},
"description": "Explicit allowed-pose subset; overrides allowRotation when set. standard = upright, turnup/turnside = tipped onto a face; 0/90 = yaw."
},
"noOverstack": {
"type": "boolean",
"description": "Nothing may rest on top of this SKU."
},
"noUnderstack": {
"type": "boolean",
"description": "Floor only — this SKU may not sit on other pieces."
},
"loadingOrder": {
"type": "string",
"enum": [
"optimized",
"rear",
"door"
],
"description": "Placement priority: rear = deepest (unloaded last), door = closest to the door (unloaded first)."
}
},
"required": [
"id",
"name",
"lengthCm",
"widthCm",
"heightCm",
"quantity",
"weightKg"
],
"additionalProperties": false
},
"minItems": 1,
"maxItems": 500
},
"container": {
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 200
},
"name": {
"type": "string",
"maxLength": 200
},
"innerLengthCm": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 5000
},
"innerWidthCm": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 5000
},
"innerHeightCm": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 5000
},
"doorWidthCm": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 5000
},
"doorHeightCm": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 5000
},
"maxPayloadKg": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1000000000
}
},
"required": [
"id",
"name",
"innerLengthCm",
"innerWidthCm",
"innerHeightCm",
"doorWidthCm",
"doorHeightCm",
"maxPayloadKg"
],
"additionalProperties": false
},
"containers": {
"type": "array",
"items": {
"$ref": "#/properties/container"
},
"maxItems": 20
},
"loadingMode": {
"type": "string",
"enum": [
"bulk",
"pallet"
],
"description": "'bulk' (default) loads cartons straight into the container. 'pallet' first stacks cartons onto pallets, then loads the pallets — requires the `pallet` field."
},
"pallet": {
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 200
},
"name": {
"type": "string",
"maxLength": 200
},
"lengthCm": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 5000,
"description": "Pallet footprint length (cm)."
},
"widthCm": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 5000,
"description": "Pallet footprint width (cm)."
},
"baseHeightCm": {
"type": "number",
"minimum": 0,
"maximum": 5000,
"description": "Pallet base self-height (cm), added below the cargo stack."
},
"maxStackHeightCm": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 5000,
"description": "Max cargo stack height ON the pallet (cm), excluding the base."
},
"maxPayloadKg": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1000000,
"description": "Max cargo weight per pallet (kg)."
},
"tareWeightKg": {
"type": "number",
"minimum": 0,
"maximum": 1000000,
"description": "Pallet self-weight (kg), added to container payload."
}
},
"required": [
"id",
"name",
"lengthCm",
"widthCm",
"baseHeightCm",
"maxStackHeightCm",
"maxPayloadKg",
"tareWeightKg"
],
"additionalProperties": false,
"description": "The pallet to stack onto. Required when loadingMode is \"pallet\"."
},
"options": {
"type": "object",
"properties": {
"loadingDirection": {
"type": "string",
"enum": [
"floor-to-top",
"right-to-left"
]
},
"maxContainers": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 1000
},
"deepOptimize": {
"type": "boolean",
"description": "Pallet mode only: run the exact optimizer for a tighter pallet plan (slower; Pro/Team plans)."
}
},
"additionalProperties": false
}
},
"required": [
"cargos"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢generate_report(cargos, container, containers, loadingMode, pallet, ...)
Generate a CAD-style PDF + 3D PNG report for a packing job. IMPORTANT: to keep the report consistent with a plan you already produced, pass the `result` object from your previous pack_containers call — the report then renders that exact plan instead of recomputing. Returns base64-encoded PDF + PNG per container.
Input Schema
{
"type": "object",
"properties": {
"cargos": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 200
},
"name": {
"type": "string",
"maxLength": 200
},
"shape": {
"type": "string",
"enum": [
"box",
"cylinder"
],
"default": "box"
},
"lengthCm": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 5000
},
"widthCm": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 5000
},
"heightCm": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 5000
},
"diameterCm": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 5000
},
"quantity": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 1000000,
"description": "Number of identical pieces of this SKU."
},
"weightKg": {
"type": "number",
"minimum": 0,
"description": "Weight of ONE piece in kg — NOT the row total. If a packing list shows both \"weight/piece\" and \"weight total\", use weight/piece (total = quantity × weightKg)."
},
"color": {
"type": "string",
"default": "#3b82f6"
},
"includeInLoading": {
"type": "boolean",
"default": true
},
"allowStacking": {
"type": "boolean",
"default": true
},
"allowRotation": {
"type": "boolean",
"default": true
},
"orientations": {
"type": "array",
"items": {
"type": "string",
"enum": [
"standard-0",
"standard-90",
"turnup-0",
"turnup-90",
"turnside-0",
"turnside-90"
]
},
"description": "Explicit allowed-pose subset; overrides allowRotation when set. standard = upright, turnup/turnside = tipped onto a face; 0/90 = yaw."
},
"noOverstack": {
"type": "boolean",
"description": "Nothing may rest on top of this SKU."
},
"noUnderstack": {
"type": "boolean",
"description": "Floor only — this SKU may not sit on other pieces."
},
"loadingOrder": {
"type": "string",
"enum": [
"optimized",
"rear",
"door"
],
"description": "Placement priority: rear = deepest (unloaded last), door = closest to the door (unloaded first)."
}
},
"required": [
"id",
"name",
"lengthCm",
"widthCm",
"heightCm",
"quantity",
"weightKg"
],
"additionalProperties": false
},
"minItems": 1,
"maxItems": 500
},
"container": {
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 200
},
"name": {
"type": "string",
"maxLength": 200
},
"innerLengthCm": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 5000
},
"innerWidthCm": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 5000
},
"innerHeightCm": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 5000
},
"doorWidthCm": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 5000
},
"doorHeightCm": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 5000
},
"maxPayloadKg": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1000000000
}
},
"required": [
"id",
"name",
"innerLengthCm",
"innerWidthCm",
"innerHeightCm",
"doorWidthCm",
"doorHeightCm",
"maxPayloadKg"
],
"additionalProperties": false
},
"containers": {
"type": "array",
"items": {
"$ref": "#/properties/container"
},
"maxItems": 20
},
"loadingMode": {
"type": "string",
"enum": [
"bulk",
"pallet"
],
"description": "'bulk' (default) loads cartons straight into the container. 'pallet' first stacks cartons onto pallets, then loads the pallets — requires the `pallet` field."
},
"pallet": {
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 200
},
"name": {
"type": "string",
"maxLength": 200
},
"lengthCm": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 5000,
"description": "Pallet footprint length (cm)."
},
"widthCm": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 5000,
"description": "Pallet footprint width (cm)."
},
"baseHeightCm": {
"type": "number",
"minimum": 0,
"maximum": 5000,
"description": "Pallet base self-height (cm), added below the cargo stack."
},
"maxStackHeightCm": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 5000,
"description": "Max cargo stack height ON the pallet (cm), excluding the base."
},
"maxPayloadKg": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1000000,
"description": "Max cargo weight per pallet (kg)."
},
"tareWeightKg": {
"type": "number",
"minimum": 0,
"maximum": 1000000,
"description": "Pallet self-weight (kg), added to container payload."
}
},
"required": [
"id",
"name",
"lengthCm",
"widthCm",
"baseHeightCm",
"maxStackHeightCm",
"maxPayloadKg",
"tareWeightKg"
],
"additionalProperties": false,
"description": "The pallet to stack onto. Required when loadingMode is \"pallet\"."
},
"options": {
"type": "object",
"properties": {
"loadingDirection": {
"type": "string",
"enum": [
"floor-to-top",
"right-to-left"
]
},
"maxContainers": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 1000
},
"deepOptimize": {
"type": "boolean",
"description": "Pallet mode only: run the exact optimizer for a tighter pallet plan (slower; Pro/Team plans)."
}
},
"additionalProperties": false
},
"result": {
"type": "object",
"additionalProperties": {},
"description": "OPTIONAL but strongly recommended: the exact `result` object returned by a prior pack_containers call, so the report renders THAT plan instead of repacking."
}
},
"required": [
"cargos"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢estimate_capacity(product, containers)
How many complete SETS of one product fit in a single container? A product is 1+ carton types with qtyPerSet each (e.g. a table shipping as 2 cartons: top + legs). All cartons of a set ride in the SAME container. Uses real 3D packing (not just volume math) and reports the binding limit (dimension / weight / volume) per container. Omit `containers` to evaluate the standard 20' DC, 40' DC and 40' HC.
Input Schema
{
"type": "object",
"properties": {
"product": {
"type": "object",
"properties": {
"name": {
"type": "string",
"maxLength": 200
},
"cartons": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"maxLength": 200
},
"lengthCm": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 5000
},
"widthCm": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 5000
},
"heightCm": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 5000
},
"weightKg": {
"type": "number",
"minimum": 0,
"maximum": 1000000
},
"qtyPerSet": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 1000000,
"default": 1,
"description": "How many of THIS carton make up one set/product. Default 1."
},
"allowRotation": {
"type": "boolean",
"default": true
},
"allowStacking": {
"type": "boolean",
"default": true
}
},
"required": [
"name",
"lengthCm",
"widthCm",
"heightCm",
"weightKg"
],
"additionalProperties": false
},
"minItems": 1,
"maxItems": 500
}
},
"required": [
"cartons"
],
"additionalProperties": false
},
"containers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 200
},
"name": {
"type": "string",
"maxLength": 200
},
"innerLengthCm": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 5000
},
"innerWidthCm": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 5000
},
"innerHeightCm": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 5000
},
"doorWidthCm": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 5000
},
"doorHeightCm": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 5000
},
"maxPayloadKg": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1000000000
}
},
"required": [
"id",
"name",
"innerLengthCm",
"innerWidthCm",
"innerHeightCm",
"doorWidthCm",
"doorHeightCm",
"maxPayloadKg"
],
"additionalProperties": false
},
"maxItems": 20,
"description": "Containers to evaluate. Omit to use the standard catalogue (20' DC, 40' DC, 40' HC)."
}
},
"required": [
"product"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢verify_key
Verify the connection. Returns the authenticated account identity and plan.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}Community
Evidence
Recent observations
verifiedversion not recorded4 tools
verifiedversion not recorded4 tools
verifiedversion not recorded4 tools
verifiedversion not recorded4 tools
verifiedversion not recorded4 tools
verifiedversion not recorded4 tools