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
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.
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.