Container Loading

io.github.lxxmngPublished by GitHub account lxxmngv0.3.0Updated Oct 24, 2026

Plan optimal container & truck loads: 3D layouts, utilization, centre of gravity, crush checks.

VerifiedStreamable HTTPWeb executableProductivity & WorkflowData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Hosted MCP server that lets an assistant compute 3D container and truck load plans, right-size equipment, and draft loading and dangerous-goods paperwork.

What you can do
List container, truck, ULD and pallet types with internal dimensions and payload limits, and get quick volume/weight container suggestions for a cargo total. Compute a 3D load plan with utilization, centre of gravity, crush-protection violations and a securing checklist, optionally auto right-sizing the equipment. Import a versioned packing-list document from a WMS/ERP export and return a load plan plus container manifest, with per-line errors on invalid input. Export a loading work order with stuffing sequence, bracing actions, VGM, axle load and centre of gravity, plus an optional retailer inbound-packaging check. Draft dangerous-goods paperwork: IMDG transport-document descriptions, plac-
When to use it
Useful when planning how cargo fits into containers, trucks, ULDs or pallets, comparing container mixes for a given volume and weight, checking centre of gravity, axle load or securing, or preparing stuffing sequences and dangerous-goods documents for a shipment.
Requirements
A remote MCP endpoint; no local install or self-hosting. An API key sent as an Authorization Bearer header is needed for the full equipment catalogue and production optimizer; a public demo key gives clearly labelled synthetic plans with no signup. Network access to the hosted server.
Before you install
The public demo key produces synthetic, clearly labelled plans only. Exported work orders and dangerous-goods drafts are decision support, not certification — verify figures in your own retailer or carrier portal. Packing lists and cargo details are sent to a third-party hosted service.

Installation

In SourceWeft

  1. Open Container Loading 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.lxxmng%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": {
      "type": "http",
      "url": "https://mcp.loadingmcp.com/mcp"
    }
  }
}

README

Container Load Planning MCP Server

[npm]

Plan container & truck loads across 200+ equipment types from Claude, Cursor, or any MCP client.

LoadingMCP is a container load-planning MCP server that lets an AI assistant compute 3D load plans, right-size the container mix, and check that a load is legal and safe to ship. It covers 200+ equipment types (containers, trucks, ULDs, pallets) and returns volume & payload utilization, centre of gravity, crush & securing checks, VGM, axle load, and CTU/IMDG compliance signals. It runs as a hosted remote server, so there is nothing to self-host.

Ask your AI: "Plan a 40HC load for these pallets" or "What's the cheapest container mix for 48 m³ at 19 t?"

Coverage

  • 200+ equipment types — 20'/40'/45' containers, high cubes, reefers, open-tops, flat-racks, box/curtain-side trucks, air ULDs, and standard pallets — each with internal dimensions (mm) and max payload (kg)
  • 3D bin-packing engine — real placement, not a volume guess. Drums and pipes hex-nest; big bags and sacks load on top and are never crushed; hazmat classes drive IMDG segregation
  • Compliance & safety — volume + payload utilization %, centre of gravity, crush-protection violations, securing/bracing checklist, VGM, and axle-load figures
  • Right-sizing — auto-selects the cheapest container/truck that fits when you don't name one

Sister product to TrackingMCP (ocean container tracking) and SchedulesMCP (sailing schedules & reliability).

Tools

ToolWhat it does
list_equipmentList the container, truck, ULD, and pallet types LoadingMCP can plan into, with internal dimensions (mm) and max payload (kg).
suggest_containersQuick volume + weight estimate of how many of which container to use, given total cargo volume (m³) and weight (kg).
plan_loadCompute a 3D load plan: equipment used, utilization (volume & payload %), centre of gravity, crush-protection violations, and a securing checklist. Cargo type drives realism (drums/pipes hex-nest, big bags load on top). Omit the equipment code to auto right-size.
export_planExport a machine-readable loading work order: numbered stuffing sequence (which SKU, where, in what order and orientation), securing/bracing actions, declarable VGM / axle / CoG figures, and an optional retailer (Amazon FBA / Walmart) inbound-packaging check.

Quick connect

The server is hosted at https://mcp.loadingmcp.com/mcp. Try it with zero signup using the public demo key lmcp_demo_public (clearly-labelled synthetic plans from the offline preview packer). A real API key runs the full 200+ equipment catalogue and the production PackingSolver optimizer.

Claude Desktop

json
{  "mcpServers": {    "container-loading": {      "command": "npx",      "args": ["-y", "mcp-remote", "https://mcp.loadingmcp.com/mcp",               "--header", "Authorization: Bearer lmcp_demo_public"]    }  }}

Cursor / Windsurf / VS Code (native HTTP MCP)

json
{  "mcpServers": {    "container-loading": {      "url": "https://mcp.loadingmcp.com/mcp",      "headers": { "Authorization": "Bearer lmcp_demo_public" }    }  }}

Replace lmcp_demo_public with a key from loadingmcp.com/mcp. Don't add "type": "streamable-http" — Claude Desktop rejects unknown config fields; Cursor/Windsurf infer transport from url. Registry ID: io.github.lxxmng/container-loading.

Example prompts

  • "Plan a 40HC load for these pallets."
  • "What's the cheapest container mix for 48 m³ at 19 t?"
  • "Right-size a container for 120 drums of 200 L each."
  • "Check the centre of gravity and axle load for this truck load."
  • "Which equipment types can hold a 12 m pipe bundle?"
  • "Export a stuffing sequence and VGM for this 40' load."

Truthfulness

Demo output is synthetic and clearly labelled. export_plan is decision support to help you MEET published retailer/carrier specs — verify in your own portal; it is not a retailer certification.

Links

License

MIT

Source: README.md at commit f4c6c00

Tools

6

list_equipment

List the standard container, truck, ULD and pallet types LoadingMCP can plan loads into, with internal dimensions (mm) and max payload (kg).

Parameterscategory

suggest_containers

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).

ParametersvolumeM3requiredweightKgrequired

plan_load

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.

ParametersvgmmodeitemsrequiredjurisdictionvesselMotionequipmentCodesequenceStops

export_plan

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, 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. This is decision support to MEET published retailer/carrier specs — verify in your own portal; it is not a retailer certification.

ParametersmodeitemsrequiredretailersequipmentCode

import_packing_list

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.

ParameterspackingListrequired

export_dg_paperwork

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.

ParameterspackingListrequired

Version history

2
  1. v0.3.0LatestOct 5, 2026
  2. v0.2.0Sep 16, 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