Hansatic

@1aleksa

About Hansatic

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.

#freight #logistics #supply-chain #bin-packing

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "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>"
      }
    }
  }
}

Tools

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 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 the status/result of a packing job by id (only needed if pack_cargo timed out on a very large manifest).

Overview

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.

Frequently asked questions

What API key do I need?

Get a free API key from [hansatic.com](https://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](https://hansatic.com/en/docs) for details.