LoadingMCP

Plan the stuff inside the box, to the standard, not by eye.

Base URL

https://api.loadingmcp.com

Authentication

Authorization: Bearer lmcp_…

Keys carry the lmcp_ prefix. See the authentication guide.

The planner returns { "ok": true, "engine": …, "plan": { … } }. A paid-plan key runs the full 3D solver; other keys return an estimate.

OpenAPI spec Import the spec into Postman or Insomnia, or generate a typed client with openapi-generator.

Endpoints

Planning

POSTCompute a load plan/v1/plan

Webhooks

POSTRegister an endpoint/v1/webhooks GETList endpoints/v1/webhooks GETEndpoint detail and deliveries/v1/webhooks/{id}PATCHUpdate an endpoint/v1/webhooks/{id}DELETEDelete an endpoint/v1/webhooks/{id}POSTSend a test delivery/v1/webhooks/{id}/test

MCP server

The container-loading server exposes the same capabilities as tool calls over Streamable HTTP. Point any MCP client at the endpoint below. See the MCP quickstart.

MCP endpoint

https://mcp.loadingmcp.com/mcp

list_equipmentStandard container, truck, ULD and pallet types with internal dims and max payload.

suggest_containersQuick estimate of how many of which container a cargo needs.

plan_loadFull 3D plan: utilisation, centre of gravity, crush checks, securing checklist.

export_planMachine-readable loading work order: stuffing sequence, securing, VGM and axle.

import_packing_listIngest a packing list into a plan and manifest, failing explicitly on bad rows.

export_dg_paperworkDraft IMDG 5.4.1 / 5.3 / 5.4.2 dangerous-goods paperwork.

Navo Tokens

On an account that holds Navo Tokens, one prepaid balance shared by the Navo products, MCP calls are paid from that balance. One balance opens every Navo service through MCP (TrackingMCP, AirCargoMCP, FreightRatesMCP, SchedulesMCP and LoadingMCP): no separate MCP access per product is needed. A product your account manager closed for your account stays closed, and a key scoped away from a product cannot reach it. MCP and API usage are counted separately: an MCP call never spends an API key's monthly call limit, and a REST call on your API key never spends Navo Tokens. An empty result is free, and a refused call charges nothing. Alerts and webhooks are free. Prices and packages are on the pricing page.

Prices.

– A new 3D load plan (plan_load, POST /v1/plan): 50 tokens.
– Recalculating a saved plan: 10 tokens, with no time limit.

A plan that places nothing is free.

When the balance cannot pay. The call is refused with 402 INSUFFICIENT_CREDITS, refused before the plan is computed, nothing is charged and no data is returned. Beside code and message, the error object carries four optional fields, the same on every Navo service:

– credits_required (integer, or null when the price is not known): the tokens this call needs;
– credits_balance (integer, or null when the account has no balance yet): the tokens your balance holds now;
– top_up_url (string): the Billing page of your account settings, where you buy more tokens, or null when no link can be given;
– packages (array of { plan, credits, usd }): the token packages you can buy, Starter 7,000 tokens for $69, Growth 40,000 tokens for $349, Scale 200,000 tokens for $1,399.

The fields are additive and optional. Keep branching on code, and read them when they are present.

The MCP server turns the fields into one sentence you can show the user as is: "Not enough Navo Tokens: this needs 50, your balance is 20. Buy more tokens: <link> (Starter 7,000 tokens for $69, Growth 40,000 tokens for $349, Scale 200,000 tokens for $1,399)."

A refusal for a balance that cannot pay

{
  "ok": false,
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Not enough Navo Tokens to run this load plan.",
    "reason": "insufficient_balance",
    "balance": 20,
    "cost": 50,
    "credits_required": 50,
    "credits_balance": 20,
    "top_up_url": "https://app.trackingmcp.com/settings?tab=billing&buy=credits",
    "packages": [
      { "plan": "starter", "credits": 7000, "usd": 69 },
      { "plan": "growth", "credits": 40000, "usd": 349 },
      { "plan": "scale", "credits": 200000, "usd": 1399 }
    ]
  }
}