Lets an AI client plan container and truck loads using plain English descriptions and provides interactive 3D load plans.
Also known as OnurGumus/3dpacking-mcp, container-loading, @3dpacking/mcp-server
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- 354
- Latest version
- 0.4.0
- Last commit
- Oct 24, 2026
- License
- MIT
What is 3DPACK.ING MCP?
3DPACK.ING lets an AI client plan container and truck loads using plain English descriptions and provides interactive 3D load plans.
Summary generated from the project's README
About 3DPACK.ING MCP server
Logistics professionals and developers can plan container and truck loads using natural language descriptions through this MCP server. By describing a shipment in plain English, users receive details on container counts, utilization rates, and items that failed to fit. The server provides an interactive 3D load plan that allows for zooming and rotating to visualize the cargo placement.
Users can connect via a hosted HTTP endpoint using OAuth with a 3DPACK.ING account or by providing an API key and username. For local setups using Claude Desktop or Claude Code, the server can be run via npm. It uses the pack_shipment tool, which accepts a cargo prompt and optional settings for calculation speed and stability. The stability setting allows users to control how much a box can overhang, ranging from 75 to 100 percent for fragile or top-heavy items.
This tool differs from simple volume arithmetic by accounting for stacking rules, orientation, and weight limits. It prevents the overestimation of cargo capacity common in standard AI models. While a shared demo account is available for testing, individual accounts allow for higher limits and full 3D placement data in supported clients.
What you can do with it
- 1Calculate container capacityAsk the assistant to determine if a specific number of cartons will fit into a standard container size.
- 2Plan fragile cargo loadingRequest a load plan for delicate items that requires specific stacking support to prevent leaning.
- 3Optimize mixed pallet shipmentsFind the best combination of containers for a shipment consisting of various pallet types.
- 4Visualize cargo placementView an interactive 3D model of how items are arranged inside the shipping containers.
Written from the project's README. Every use case is checked against a quote from it.
How to install 3DPACK.ING MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall 3DPACK.ING MCP in Claude Code
$ claude mcp add container-loading -- npx -y @3dpacking/mcp-serverInstall 3DPACK.ING MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"container-loading": {
"command": "npx",
"args": [
"-y",
"@3dpacking/mcp-server"
]
}
}
}Install 3DPACK.ING MCP in VS Code
.vscode/mcp.json
{
"servers": {
"container-loading": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@3dpacking/mcp-server"
]
}
}
}Install 3DPACK.ING MCP in VS Code CLI
$ code --add-mcp '{"name":"container-loading","type":"stdio","command":"npx","args":["-y","@3dpacking/mcp-server"]}'Install 3DPACK.ING MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"container-loading": {
"command": "npx",
"args": [
"-y",
"@3dpacking/mcp-server"
]
}
}
}Install 3DPACK.ING MCP in Codex
$ codex mcp add container-loading -- npx -y @3dpacking/mcp-serverInstall 3DPACK.ING MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.container-loading] command = "npx" args = ["-y", "@3dpacking/mcp-server"]
Install 3DPACK.ING MCP in Gemini CLI
$ gemini mcp add -s user container-loading npx -- -y @3dpacking/mcp-serverInstall 3DPACK.ING MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"container-loading": {
"command": "npx",
"args": [
"-y",
"@3dpacking/mcp-server"
]
}
}
}Configuration
THREEDPACKING_API_KEYTHREEDPACKING_USERNAME
| Name | Description | |
|---|---|---|
| THREEDPACKING_API_KEY | — | |
| THREEDPACKING_USERNAME | — |
Automated checks
Ran Nov 12, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packagePass
- Remote endpoint uses HTTPSPass
- Destructive tools are labelledNot checked
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesPass
README
View on GitHub3DPACK.ING MCP server
Container and truck load planning for AI assistants. Describe a shipment in plain English; get back the containers it fits in, how full each one is, what did not fit, and a link to an interactive 3D load plan.
Backed by the 3DPACK.ING solver — the same one behind the web planner. Asked "will 500 cartons fit in a 40-foot", an assistant without this will do arithmetic on volumes, which ignores stacking rules, orientation and weight limits and overstates what fits by a wide margin on real cargo.
Install
Hosted (no install)
The server runs at https://3dpack.ing/mcp over streamable HTTP. Add the address to
your assistant and sign in with your 3DPACK.ING account when it asks — OAuth, the way
Claude, ChatGPT and Claude Code connect to any service. A free account works, on its
free monthly packs.
Claude (web, desktop): Settings → Connectors → Add custom connector → paste
https://3dpack.ing/mcp and choose sign-in.
ChatGPT (developer mode): add the same address with OAuth.
Claude Code:
claude mcp add --transport http 3dpacking https://3dpack.ing/mcp
# then /mcp → Authenticate
With an API key instead of signing in. Pass the key and the account it belongs to in the query string:
https://3dpack.ing/mcp?apiKey=your-key&username=your-username
or keep the key out of the URL: X-API-Key: your-key (or Authorization: Bearer your-key, or X-3dpacking-Api-Key) with ?username=your-username in the URL. Claude's
connector dialog only sends approved header names, so there use x-api-key. The shared
demo account is ?apiKey=test&username=test.
A request with no credentials at all is answered 401 with a pointer to the sign-in
metadata (/.well-known/oauth-protected-resource/mcp), which is what makes a client
show the login.
Local (npm)
Claude Desktop — add to claude_desktop_config.json:
{
"mcpServers": {
"3dpacking": {
"command": "npx",
"args": ["-y", "@3dpacking/mcp-server"]
}
}
}
Claude Code:
claude mcp add 3dpacking -- npx -y @3dpacking/mcp-server
It works immediately, with no account — the first call runs against a shared demo account on the free plan. For your own limits, sign up at https://3dpack.ing/login and add:
{
"mcpServers": {
"3dpacking": {
"command": "npx",
"args": ["-y", "@3dpacking/mcp-server"],
"env": {
"THREEDPACKING_API_KEY": "your-key",
"THREEDPACKING_USERNAME": "your-username"
}
}
}
}
Both must be set together — the API rejects a key without a username.
The 3D plan inside Claude
In hosts that support MCP Apps
— Claude on the web and desktop — the answer comes with the load drawn under it in 3D:
drag to turn, scroll to zoom, one colour per kind of piece, a pager for loads that take
several containers. The view is ui://3dpacking/load-plan-<hash>.html (named after its contents, so a changed view is never served from a host cache), drawing the placements
the tool result carries in _meta (so they reach the view, not the model). It needs
your own key: the shared demo account gets the answer and the link, not the
placements. Other hosts get the same answer as text with the link.
The tool
pack_shipment — one required argument, prompt, describing the cargo in plain
English, and two optional settings: a speed of fast, normal or thorough, and a
stability of 75 to 100.
stability is how much of a box must rest on what is underneath it, as a percentage of
its own footprint. Omit it for 75, the standard rule, which lets a quarter of a box
overhang and packs the most. Raise it for cargo that must not lean — drums, glass,
anything top-heavy — and use 100 when every stacked box has to sit fully supported. It
is the one constraint the prompt cannot carry, because it governs how the solver stacks
rather than what is being shipped, and a higher value fits fewer items.
Things it understands:
Pack 50 boxes of 60x40x30 cm into a 20ft container
Load 30 fragile boxes 80x60x40cm, max stack 3, into a 20ft container
Ship mixed pallets: 10x euro pallets, 15x US pallets, best container mix
Ship 24 pcs 200.3x120.2x100.2 cm (non-tiltable), optimal mix of 40ft and 20ft
What comes back:
Everything fits: 1 container.
Container 1 (589.3 x 235 x 239 cm internal)
items: 50
of which: 50x Boxes
used: volume 10.9%
5 empty gaps left
Interactive 3D load plan: https://3dpack.ing/app?g=6c4b9488-...
Notes on the shaping
The API returns the geometry of every unfilled cuboid in every container, with coordinates. That is what the 3D viewer needs and it is most of the payload on a real shipment. Spending a model's context on the coordinates of empty space, when the link opens a picture of exactly that, is a poor trade — so the summary keeps the count of gaps and drops the geometry. On a small pack that is 791 bytes down to 341; on a large one it is the difference between a usable answer and a flooded context.
A plan limit is not reported as an error. The API returns HTTP 500 for
NotSubscribed, the same status it uses for a solver crash; left alone, an assistant
reads that as "the service is broken" and tells the user to try again later, when what
actually happened is that they asked for a Pro feature. This server sorts the two
apart and relays the offer.
Anything that answers with non-JSON — a proxy, a VPN, a corporate egress allowlist — is reported as a network problem naming what actually replied, rather than as a packing failure. Only one of those is something the user can fix.
Environment
| Variable | Purpose |
|---|---|
THREEDPACKING_API_KEY |
Your API key. Falls back to the shared demo account. |
THREEDPACKING_USERNAME |
The account the key belongs to. Required with the key. |
THREEDPACKING_ENDPOINT |
Override the endpoint — staging, self-hosted, or a stub. |
Development
npm install
npm run smoke # calls the live solver with demo credentials and checks the shape
smoke.js is deliberately not mocked for the live checks. The thing that will break
this package is 3dpack.ing changing the shape of its answer, and no amount of mocking
catches that. Run it before publishing. To exercise the success path without spending
a calculation, point THREEDPACKING_ENDPOINT at a stub.
Licence
MIT.
3DPACK.ING MCP questions
How do I add 3DPACK.ING MCP to Claude Code?
Run claude mcp add container-loading -- npx -y @3dpacking/mcp-server in your terminal. Add --scope user to make it available in every project.
How do I add 3DPACK.ING MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
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.