Your agent can ship parcels.
321label is an MCP server. Connect it to Claude, ChatGPT or any client that speaks the Model Context Protocol, and your agent quotes, buys, tracks and cancels labels — nine tools, no glue code.
One URL. Then talk to it.
The server speaks streamable HTTP at the URL on the right. Paste it into your client's "add connector" or MCP settings, authorise, and the nine tools appear. Each client gets its own Bearer token — self-serve, under AI agents in your account.
Sandbox is the default on every tool: labels are minted against the carriers' test systems and cost nothing. A real label is created only when the agent — or you — says sandbox: false.
- 3Open your client's connector / MCP settings and add a remote server.
- 2Paste the URL. Authorise — 321label accepts your Bearer token as the credential.
- 1Ask for a label. The agent quotes first, then creates — in sandbox until you say otherwise.
Everything the desk does, as tools.
Each tool maps one-to-one to a REST endpoint. Carriers are always named — never the systems behind them.
quote_labelLive rates for a shipment — carrier, service, price and ETA, cheapest first. Filter to a carrier or to parcel shop / home.
POST /v1/quotescreate_labelMint the label. Returns label_id, status, price, tracking and pdf_url. Live guest labels come back awaiting payment with a link for the human.
POST /v1/labelsget_labelRead a label or order back by id — status, price, tracking number, payment state, pdf_url (held until paid).
GET /v1/labels/{id}track_shipmentTrack a parcel bought here, by tracking number, order id or label id. Sandbox labels have no live tracking.
GET /v1/shipments/{ref}cancel_labelVoid a label by id. Idempotent — cancelling twice returns the same void state. The PDF is revoked.
POST /v1/labels/{id}/cancellist_carriersThe public carriers, their services (parcel shop / home), where they're offered, and which rules (cheapest / fastest) resolve to them.
GET /v1/carriersget_walletRead your prepaid balance — available, held, bonus and top-up limits. Needs an agent token.
GET /v1/walletlist_labelsList your account's labels, newest first, with paging and a status filter. Needs an agent token.
GET /v1/labelscreate_topup_linkStart a prepaid top-up and get back a checkout link to pay it. Needs an agent token.
POST /v1/wallet/topupsA parcel, from a chat.
The agent does what a good clerk does: quotes before it buys, names the carrier and the price, and hands the payment link to the human. It never sees a card.
Nothing is charged and nothing ships until sandbox is switched off on purpose.
Each agent gets its own credential, tied to your account — revoke one without touching the rest.
Idempotent by status: an agent that retries a cancel can't double-void or double-refund.
Want your agent at the desk? Create a token.
Sign in at /account and create an agent token under AI agents. Tokens are per client, sandbox is free, and real labels are paid per label — like everything else here.