Hansatic
About
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.
Details
- Author
- 1aleksa
- Downloads
- 340
- Categories
- Other
Jump to
- 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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
HansaticCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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.
pack_cargo
Optimize how cargo is loaded into a truck, trailer or shipping container. Returns a physically valid layout (placements with x/y/z and rotation, respecting stacking, fragility, weight and axle constraints) plus the freight billing metrics: LDM (loading meters), linear feet, EUR pallet positions and total weight. Submits an async job and waits for the result — typically 5-30 seconds. Use list_vehicles first if you are unsure of the vehicle code.
list_vehicles
List all available trucks, trailers and shipping containers with their interior dimensions (mm) and max payload (kg). Use the returned codes as the "vehicle" argument of pack_cargo.
check_job
Check the status/result of a packing job by id (only needed if pack_cargo timed out on a very large manifest).
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"hansatic": {
"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>"
}
}
}
}
}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>"
}
}
}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.Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
