# 3DPACK.ING MCP server

> Lets an AI client plan container and truck loads using plain English descriptions and provides interactive 3D load plans.

- Repository: https://github.com/OnurGumus/3dpacking-mcp
- Page: https://hostedmcp.org/servers/onurgumus/container-loading
- Transport: stdio, remote
- Stars: 0
- License: MIT
- Latest version: 0.4.0

## Install

### Claude Code

```sh
claude mcp add container-loading -- npx -y @3dpacking/mcp-server
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "container-loading": {
      "command": "npx",
      "args": [
        "-y",
        "@3dpacking/mcp-server"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "container-loading": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@3dpacking/mcp-server"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"container-loading","type":"stdio","command":"npx","args":["-y","@3dpacking/mcp-server"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "container-loading": {
      "command": "npx",
      "args": [
        "-y",
        "@3dpacking/mcp-server"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add container-loading -- npx -y @3dpacking/mcp-server
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.container-loading]
command = "npx"
args = ["-y", "@3dpacking/mcp-server"]
```

### Gemini CLI

```sh
gemini mcp add -s user container-loading npx -- -y @3dpacking/mcp-server
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "container-loading": {
      "command": "npx",
      "args": [
        "-y",
        "@3dpacking/mcp-server"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `THREEDPACKING_API_KEY` | no | no |  |
| `THREEDPACKING_USERNAME` | no | no |  |

## Tools (1)

- `pack_shipment`: Work out how a shipment fits into shipping containers, trucks or pallets, using a real 3D bin-packing solver. Describe the cargo in plain English -- quantities, dimensions, weights, and any constraints such as fragile, non-tiltable, max stack height or a preferred container type -- and get back which containers are needed, how full each one is, anything that did not fit, and a link to an interactive 3D load plan. Use this instead of estimating from volume. Volume arithmetic ignores stacking rules, orientation and weight limits, and overstates what fits by a wide margin on real cargo. For cargo that must not overhang -- drums, glass, anything that must stay level -- set `stability`. It is the one constraint the prompt cannot express, because it governs how the solver stacks rather than what is being shipped.

## FAQ

### Can I use this without an account?

Yes, the local npm installation works immediately using a shared demo account on the free plan.

### What happens if I don't provide credentials?

A request with no credentials will return a 401 error and a pointer to sign-in metadata to trigger a login prompt.

### How does the stability setting work?

The stability setting (75 to 100) determines how much of a box's footprint must be supported by the items underneath it.
