English Français العربية

Container Loading Calculator

Official registry Other

Work out how many flat-pack units fit in a 20ft or 40HQ container: layers, weight and utilisation.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http container-loading-calculator 'https://buildextechnology.com/api/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "container-loading-calculator": {
            "type": "http",
            "url": "https://buildextechnology.com/api/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Container loading calculator
  2. Options
  3. Why it refuses to calculate
  4. Container data used
  5. Web version
  6. Tests
  7. License

Container loading calculator

How many flat-pack units — or panels, or crates — fit in a 20ft or 40HQ container, and what limits the load: volume or payload. No dependencies, one file.

python3 container_loading.py 40hq 2900 2200 600 900
{
  "container": "40ft high cube",
  "units_per_layer": 4,
  "layers": 4,
  "units_by_volume": 16,
  "units_by_payload": 31,
  "units": 16,
  "limited_by": "volume",
  "volume_utilisation_pct": 80.2,
  "payload_utilisation_pct": 50.3
}

The same unit in a 20ft, with a heavier unit, is weight-limited instead:

python3 container_loading.py 20gp 1000 1000 500 5000
# units_by_volume 40 · units_by_payload 5 · units 5 · limited_by "weight"

Options

flagwhat it does
--max-layers Ncaps the number of layers when the packing method limits stacking
--rotatetries rotating each unit 90° and uses whichever fits more per layer

Why it refuses to calculate

If the packed length, width, height or the unit weight is missing, the tool raises an error listing exactly what is missing instead of returning a number. A guessed loading plan is how deposits get lost — the packed height and the unit weight are the two inputs that move the answer most, and both come from the factory packing method.

Container data used

Typical published internal dimensions and payloads. Confirm against the carrier's own data and the actual packing list before booking.

containerinternal L × W × H (mm)payload (kg)
20ft GP5898 × 2352 × 239328,200
40ft HQ12032 × 2352 × 269828,600

Volume utilisation is calculated on the packed envelope (length × width × height of one unit), not on the net product volume.

Web version

Same logic, in the browser, no install: container loading calculator — the tool we use ourselves when quoting flat-pack buildings and aluminium ceiling systems.

Tests

python3 tests/test_loading.py

License

MIT

Frequently asked questions

What is Container Loading Calculator?

Work out how many flat-pack units fit in a 20ft or 40HQ container: layers, weight and utilisation.

How do I install Container Loading Calculator?

It runs as a remote server. In Claude Code: claude mcp add --transport http container-loading-calculator 'https://buildextechnology.com/api/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Container Loading Calculator need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is Container Loading Calculator open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Container Loading Calculator?

It is published by CindyLiao1106. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.