Skip to main content
Glama

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

  1. Get an API key (free): hansatic.com → sign in → click your name → APIGenerate key. Every account includes 25 free sandbox packs/month — no subscription needed to try it.

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

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/1aleksa/hansatic-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server