Hansatic
@1aleksa
MCP server for the Hansatic packing API — truck & container load optimization for AI agents. Returns physically valid layouts with LDM, linear feet and pallet positions.
概要
What is Hansatic?
Hansatic is an MCP server that gives AI agents the ability to pack trucks and shipping containers by wrapping the Hansatic packing API. It accepts a cargo manifest and returns a physically valid 3D layout with placement details, freight billing metrics (LDM, linear feet, EUR pallet positions), and respects rotation, stacking, fragility, weight, and axle constraints.
How to use Hansatic?
Obtain a free API key from hansatic.com, then add the server to your MCP client using the provided setup commands (e.g., claude mcp add hansatic -e HANSATIC_API_KEY=hk_live_... -- npx -y hansatic-mcp). Invoke the pack_cargo tool with a cargo manifest and vehicle code to receive a validated layout and metrics.
Key features of Hansatic
- Optimize a cargo manifest into a vehicle
- List built-in trucks, trailers, and containers
- Poll job status for very large manifests
- Support both metric and imperial units
- Sandbox mode for free-tier keys (no persistence)
- Production accounts receive a 3D editor link
Use cases of Hansatic
- Pack machine crates and EUR pallets into a curtainsider truck
- Automate load planning for logistics with validated layouts
- Retrieve freight billing metrics (LDM, linear feet, positions)
- Validate manual packing against physical constraints
FAQ from Hansatic
What API key do I need?
Get a free API key from hansatic.com after signing in. Every account includes 25 free sandbox packs per month, with no subscription required.
How do I set up the server?
Add the server to your MCP client configuration file with the environment variable HANSATIC_API_KEY set to your key. Examples for Claude Code, Claude Desktop, and Cursor are provided in the README.
What units are supported?
Metric (mm/kg) is the default. Pass units: "imperial" to use inches and pounds; results return in the same units.
What is the difference between sandbox and production?
Non-enterprise keys automatically sandbox — the full result is returned but nothing is persisted. Enterprise keys create a real plan in the workspace, accessible via a plan_url that opens in the 3D editor.
Is the optimization engine validated?
Yes. The engine is continuously validated against real dispatcher layouts. See how the algorithm is measured for details.
