Freight Desk

Logistics checks for forwarding, procurement and e-commerce agents: a one-call shipment pre-filing check (containers, AWB, ports, HS format, packing list vs declarations, container fit, Incoterms, letter-of-credit dates, holidays, dangerous goods), chargeable weight + container load plans, Incoterms 2020 and ISO 6346 validation, from $0.01 per call or $1/day. Pay with x402 (USDC on Base) or MPP (USDC.e on Tempo), or buy a desk pass with a plain USDC transfer (1 / 5 / 15 USDC = 24 h / 7 days / 30 days) and use it from any MCP client at /mcp. The same checks also come as an offline command-line kit (3 USDC by transfer). No API keys, no accounts.

Shipment pre-filing check

$0.20/call

One call before you book, file or present documents: checks a shipment the way a forwarder's documentation desk does and returns ranked errors/warnings with fixes. Container numbers (ISO 6346), AWB, IMO, UN/LOCODE ports, HS code format; packing list vs declared packages, gross/net weight and m3; whether the cartons fit the booked container (or which one they need) and payload; chargeable weight by mode; Incoterms 2020 fit (mode, containers, named place side, CIF/CIP 110% cover); letter-of-credit dates under UCP 600 (late shipment, 21-day presentation, expiry); public holidays at origin and destination around ETD/ETA (live) and Lunar New Year / Golden Week; likely dangerous goods (lithium batteries, perfume, aerosols...). Bare call: a sample FOB Shanghai -> Los Angeles shipment with typical mistakes.

GET https://freight-desk.agent-arena-base.workers.dev/v1/shipment-check

Chargeable weight + container load plan

$0.03/call

From carton dims, weight and quantity: total m3 and kg, chargeable weight for air (IATA 1:6000), international express (1:5000 per piece, over-limit pieces flagged), US parcel (139 in3/lb), sea LCL (W/M) and EU road (1:3000); how many cartons fit a 20GP / 40GP / 40HC / 45HC (grid, payload-capped) and how many boxes you need; with your rates, the cost of every option and the cheapest. Bare call: 120 cartons of 60x40x40 cm, 18 kg.

GET https://freight-desk.agent-arena-base.workers.dev/v1/chargeable

Incoterms 2020 rule check

$0.02/call

Incoterms® 2020 for one rule (or all 11): where risk passes, who pays loading, export clearance, main carriage, insurance (CIF = ICC (C), CIP = ICC (A), 110%), unloading, import clearance and duties, plus checks against your deal: wrong mode (FOB/CIF by air), FOB/CIF with containers (use FCA/CIP), EXW exports, DDP import-VAT trap, named place on the wrong side, under-insurance, letter-of-credit fit. Always includes the 11-rule matrix. Bare call: FOB by container.

GET https://freight-desk.agent-arena-base.workers.dev/v1/incoterms

Container / air waybill / IMO number check

$0.01/call

Validate up to 50 container numbers (ISO 6346 check digit, owner code -> carrier or lessor, equipment category, O/0 and I/1 typo hints, the correct check digit), ISO size/type codes (22G1, 45G1, 45R1...), air waybill numbers (mod-7 check digit, airline from prefix) and IMO ship numbers. Catches mistyped numbers before they go on a bill of lading, customs entry or booking. Bare call checks a sample with one mistyped container.

GET https://freight-desk.agent-arena-base.workers.dev/v1/container-check

Day pass: 24 hours, up to 300 calls

$1.00/pass

Buy once, call all day: a signed token for up to 300 successful calls to every paid route (shipment checks, chargeable weight + load plans, Incoterms, container/AWB/IMO validation) for 24 hours. Send it as Authorization: Bearer <token> or X-Freight-Pass: <token>. $1.00 = the price of 5 shipment checks; meant for forwarding, procurement and e-commerce agents that check many shipments.

GET https://freight-desk.agent-arena-base.workers.dev/v1/pass

Week pass: 7 days, up to 3000 calls

$5.00/pass

Buy once, call all week: a signed token for up to 3000 successful calls to every paid route (shipment checks, chargeable weight + load plans, Incoterms, container/AWB/IMO validation) for 7 days. Send it as Authorization: Bearer <token> or X-Freight-Pass: <token>. $5.00 = the price of 25 shipment checks; meant for forwarding, procurement and e-commerce agents that check many shipments.

GET https://freight-desk.agent-arena-base.workers.dev/v1/pass/week

Try the free preview

curl "https://freight-desk.agent-arena-base.workers.dev/v1/peek?container=CSQU3054383"

How to call (paid)

import { wrapFetchWithPayment } from "x402-fetch";
import { privateKeyToAccount } from "viem/accounts";
const pay = wrapFetchWithPayment(fetch, privateKeyToAccount(process.env.PRIVATE_KEY));
const check = await (await pay("https://freight-desk.agent-arena-base.workers.dev/v1/shipment-check?incoterm=FOB&origin=CNSHA&destination=USLAX&containers=MSCU1234566&container_type=40HC&cartons=60x40x40@18x600&etd=2026-12-20")).json();
const plan = await (await pay("https://freight-desk.agent-arena-base.workers.dev/v1/chargeable?cartons=60x40x40@18x120&rate_lcl_wm=45&rate_20gp=1800")).json();

MPP: the same 402 also carries WWW-Authenticate: Payment with method="tempo", intent="charge" (USDC.e on Tempo, pull mode).

Use it from Claude, Cursor or VS Code (MCP)

Add https://freight-desk.agent-arena-base.workers.dev/mcp as a remote MCP server (Streamable HTTP). check_container_number and sample_shipment_check (the full checker on a sample shipment with typical mistakes) are free. shipment_check, chargeable_weight, incoterms_check and validate_numbers need a Freight Desk pass, set once as a header. The prompt precheck_shipping_documents takes pasted invoice / packing list / B/L / letter-of-credit text and runs the check.

{ "mcpServers": { "freight-desk": { "type": "http", "url": "https://freight-desk.agent-arena-base.workers.dev/mcp", "headers": { "Authorization": "Bearer <pass>" } } } }

Desk pass by plain USDC transfer (no x402 client needed): send at least 1 USDC (24 hours, 300 calls), 5 USDC (7 days, 3,000 calls) or 15 USDC (30 days, 15,000 calls) on Base to 0xb7EA350C9Ed9787726E25726f0d02D094800bD33 from any wallet or exchange, then open https://freight-desk.agent-arena-base.workers.dev/v1/pass/redeem?tx=<transaction hash> (or call the MCP tool redeem_transfer_pass) to get your token. Same tx, same token. No refunds are possible, so try the free tools and the output examples first. Instructions as JSON.

Offline kit: the same checks on your own machine

A folder with a command-line tool (Node 18+, no installs, no account, your data never leaves your computer), the document consistency matrix, letter-of-credit presentation rules, booking / sea / air / customs checklists, templates and samples. 3 USDC by plain transfer on Base to 0xb7EA350C9Ed9787726E25726f0d02D094800bD33, then open https://freight-desk.agent-arena-base.workers.dev/v1/kit/download?tx=<transaction hash>. Included with 7-day and 30-day passes. What is inside, sha256 and a sample report.

Payment policy

Input is validated before any payment is touched (bad input = 400). Failed work is never settled or broadcast. x402 (Base): the result is released only after the USDC settlement is confirmed (by the facilitator, or on-chain on Base). MPP (Tempo): the server broadcasts your signed USDC.e transfer and releases the result when the receipt shows it; with no definite answer from the Tempo RPC the result is released anyway, marked unconfirmed, so you are never charged without getting it. Pass calls that fail are not counted.

Machine-readable

/api · /openapi.json · /llms.txt · /.well-known/x402 · /health · MCP: POST /mcp