mcpField
H
Hansatic

Hansatic

Local
github.com/1aleksaMaps & Travel0Updated 16w ago
Repository

About Hansatic

Hansatic is an MCP server for AI agents that submits cargo manifests to the Hansatic packing API and returns validated truck or container layouts. It accounts for physical loading constraints and provides freight metrics such as LDM, linear feet, and EUR pallet positions.

Key features

  1. 01Optimize cargo manifests for vehicles
  2. 02Respect rotation, stacking, fragility, weight, and axle constraints
  3. 03Return LDM, linear feet, and EUR pallet positions
  4. 04List built-in trucks, trailers, and containers
  5. 05Poll long-running packing jobs

Use cases

  1. 01Plan a truck load from a cargo manifest
  2. 02Check available vehicle dimensions and payloads
  3. 03Retrieve results for a large packing job

MCP support

The MCP server exposes `pack_cargo`, `list_vehicles`, and `check_job` tools to MCP clients. It connects to the Hansatic packing API using an API key.

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

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "hansatic": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote"
      ],
      "env": {
        "HANSATIC_API_KEY": "<HANSATIC_API_KEY>"
      }
    }
  }
}
Run commandnpx -y mcp-remote
Environment variables to set
HANSATIC_API_KEYSecret

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmmcp-remote

Tools

3

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
vehiclestringYesVehicle code, e.g. CURTAINSIDER_136 (13.6m curtainsider) or 40HC (40ft high-cube container). Get valid codes from list_vehicles.
itemsarrayYesThe cargo manifest
objectiveenumNoMinimize loading meters (default) or billed pallet positionsldm | pallets
unitsenumNoHow item numbers are read AND returned: mm/kg (default) or in/lbmetric | imperial
sandboxbooleanNoForce sandbox mode (nothing persisted). Omit to let the account tier decide: enterprise accounts create a real plan with a shareable link, others sandbox automatically.
namestringNoPlan name (production mode)
ldm_limit_mnumberNoRestrict the load to the first N loading meters (trucks)

Details

From the project README

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 → API → Generate 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

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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.