Hansatic
Hansatic MCP — load planning for AI agents
Give your AI agent the ability to pack trucks and shipping containers. This MCP server wraps the Hansatic packing API: submit a cargo manifest, get back a physically valid layout — placements with rotation, stacking, fragility, weight and axle constraints respected — plus the freight billing metrics that matter: LDM (loading meters), linear feet, and EUR pallet positions.
"Pack 14 machine crates and 8 EUR pallets into a 13.6m curtainsider" → a validated 3D load plan with 5.25 LDM, in one tool call.
Setup Get an API key (free): hansatic.com → sign in → click your name → API → Generate key. Every account includes 25 free sandbox packs/month — no subscription needed to try it.
Add the server to your MCP client:
Claude Code
claude mcp add hansatic -e HANSATIC_API_KEY=hk_live_... -- npx -y hansatic-mcp
Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"hansatic": {
"command": "npx",
"args": ["-y", "hansatic-mcp"],
"env": { "HANSATIC_API_KEY": "hk_live_..." }
}
}
}
Cursor (.cursor/mcp.json) — same shape as Claude Desktop.
Tools
| Tool | What it does |
|---|---|
| pack_cargo | Optimize a cargo manifest into a vehicle. Async under the hood; returns the finished layout + metrics in one call (typically 5–30s). Production accounts get a plan_url — the layout opens in Hansatic's 3D editor. |
| list_vehicles | All built-in trucks, trailers and containers with interior dimensions and payload — the valid vehicle codes. |
| check_job | Poll a job by id (only for very large manifests that outlive the tool timeout). |
Notes
-
Units: metric (mm/kg) by default; pass units: "imperial" for in/lb — results come back in the same units.
-
Sandbox vs production: non-enterprise keys sandbox automatically (full result, nothing persisted). Enterprise keys create a real plan in the workspace, editable at the returned plan_url.
-
The engine is validated continuously against real dispatcher layouts — see how the algorithm is measured. REST API, OpenAPI spec and full docs: hansatic.com/en/docs
-
MIT licensed. The optimization engine runs server-side at hansatic.com.
Server Config
{
"mcpServers": {
"hansatic": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://hansatic.com/mcp",
"--header",
"Authorization:Bearer ${HANSATIC_API_KEY}"
],
"env": {
"HANSATIC_API_KEY": "<YOUR_HANSATIC_API_KEY>"
}
}
}
}