Hansatic

Created By
1aleksa2 days ago
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.
Overview

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

ToolWhat it does
pack_cargoOptimize 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_vehiclesAll built-in trucks, trailers and containers with interior dimensions and payload — the valid vehicle codes.
check_jobPoll 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>"
      }
    }
  }
}
Project Info
Created At
2 days ago
Updated At
2 days ago
Author Name
1aleksa
Star
-
Language
-
License
-
Category

Recommend Servers

View All