Container Loading Calculator

io.github.CindyLiao1106Published by GitHub account CindyLiao1106v1.0.0Updated Oct 25, 2026

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

The publisher's own server: Calculator Tools MCP

VerifiedStreamable HTTPWeb executableData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

A remote MCP server that estimates how many flat-pack units fit in a 20ft or 40ft high-cube container, showing layers, weight limits and utilisation.

What you can do
Calculate container loading for one unit type: units per layer, layers that fit the height, and total units for a 20GP or 40HQ container, using the packed size and weight of a single unit. Report which constraint binds the load, volume or payload, along with volume and payload utilisation percentages. Apply optional limits on stacking height and try rotating units 90 degrees to fit more per layer. Refuse to return a figure when packed dimensions or unit weight are missing, listing what is needed instead.
When to use it
Useful when quoting or planning shipments of flat-pack goods, panels or crates and you want a quick check of whether volume or weight will cap the load before booking.
Requirements
A remote endpoint; no local install, account or API key is declared. The assistant supplies the container type and the packed length, width, height and weight of one unit.
Before you install
Container dimensions and payloads are typical published figures, not carrier-confirmed, so verify them against the carrier and the actual packing list before booking. Results depend heavily on the packed height and unit weight, which come from the factory packing method. Volume utilisation is based on the packed envelope, not net product volume.

Installation

In SourceWeft

  1. Open Container Loading Calculator in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.CindyLiao1106%2Fcontainer-loading/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "container-loading-calculator": {
      "type": "http",
      "url": "https://buildextechnology.com/api/mcp"
    }
  }
}

README

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
json
{  "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

Source: README.md at commit 96de5ed

Tools

1

container_loading

Container loading plan

Work out how many flat-pack units or panels fit in one 20ft (20GP) or 40ft high cube (40HQ) container. Returns units per layer, layers that fit the height, units limited by volume and by payload, the binding constraint, and the volume/payload utilisation. Use the packed size and weight of ONE unit. It does not estimate: if a dimension or the weight is missing it returns what is missing instead of a number.

ParameterscontainerrequiredmaxLayersunitWidthMmrequiredunitHeightMmrequiredunitLengthMmrequiredunitWeightKgrequiredallowRotation

Version history

1
  1. v1.0.0LatestOct 15, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Calculator integrations