Zaslat MCP Server

Connect AI assistants to the Zaslat.cz shipping platform via the Model Context Protocol. Create shipments, fetch rates, track parcels, and search pickup points — all through natural language.

Why MCP — the third interface to logistics

Zaslat has long offered two ways to ship: the web app for humans and the REST API for systems. MCP is the third — built for AI assistants that act on behalf of a real user, with their account, their addresses, and their carrier contracts.

Where the REST API needs a clean integration and a developer behind it, MCP shines on the messy stuff in between:

An Excel sheet with addresses in three different formats — just upload it and ask the assistant to send them all.
A customer order that arrived as plain text in an email — paste it, get a shipment.
Quick questions like “what’s the cheapest way to send 2 kg to Berlin tomorrow?” answered in seconds.
One-off pickups, bulk cancellations, label reprints — without clicking through the dashboard or writing a script.

The Zaslat MCP Server connects any MCP-capable assistant — Claude, ChatGPT, n8n, custom agents — to a real Zaslat account. The AI understands context, follows the user’s preferences (default sender, preferred carrier, COD setup), and performs real actions: rate comparisons, shipment creation, tracking, label printing, cancellation.

It’s a fit for technically curious users and operations teams who want to automate shipping without owning an integration project. If you can describe what you need in plain language, the assistant can do it.

Quick start (Claude.ai / Claude Desktop)

Settings → Connectors → Add custom connector
URL: https://mcp.zaslat.cz/mcp
Choose OAuth — you will be redirected to the Zaslat login page
Approve access — the connector is ready

Authentication

The server accepts two credential types. Both are validated against the Zaslat backend on initialize and revalidated every 30 minutes for the lifetime of the MCP session.

OAuth 2.1 (recommended)

The server advertises its authorization metadata at:

GET https://mcp.zaslat.cz/.well-known/oauth-protected-resource

MCP clients that support OAuth (Claude.ai, Claude Desktop) discover the authorization server automatically and run the standard authorization-code flow with PKCE against api.zaslat.cz.

Scopes: rates, shipments:read, shipments:write

API key

For headless clients (n8n, scripts, custom agents) pass a Zaslat API key in the X-ApiKey header:

POST /mcp HTTP/1.1
Host: mcp.zaslat.cz
X-ApiKey: <your-api-key>
Content-Type: application/json

You can generate an API key after logging in at app.zaslat.cz under Settings → Integrations → API integration.

Tools

The Zaslat MCP Server exposes 9 tools covering the full shipping workflow — from rate comparison and parcel point search through shipment creation, label printing, tracking, and cancellation.

Rates and information

Tool	Description	Modifies data
`get_rates`	Compare carrier rates for a given route and package list.	No
`get_profile`	Load user profile, default sender address, and account settings.	No
`search_parcel_points`	Find nearest pickup / drop-off points by address, ZIP, or carrier.	No

Shipment management

Tool	Description	Modifies data
`create_shipment`	Create a new shipment (Home2Home, Shop2Home, Home2Shop, Shop2Shop).	Yes
`cancel_shipment`	Cancel a shipment that has not yet been picked up by the carrier.	Yes

Listing and tracking

Tool	Description	Modifies data
`list_shipments`	List shipments with filters and pagination.	No
`get_shipment_detail`	Full shipment details including the carrier tracking number.	No
`track_shipment`	Tracking status with event history.	No

Labels

Tool	Description	Modifies data
`print_label`	Generate a shipping label (PDF link or base64).	No

Typical workflow

1. get_profile           → Load default sender address
2. get_rates             → Compare carrier rates
3. search_parcel_points  → Find pickup point (Home2Shop / Shop2Shop)
4. create_shipment       → Create shipment with the selected carrier
5. print_label           → Download label for printing
6. track_shipment        → Track shipment status

Example prompts

Comparing rates

What are the shipping rates for a 30×20×15 cm, 3 kg package from Prague to Brno?

Compare carrier prices for a 5 kg shipment to Bratislava.

How much does it cost to ship 2 packages from Ostrava to Berlin?

Creating a shipment

Send a package via DPD to Jan Novák, Příčná 5, Brno 602 00, 2 kg.

Create a Zásilkovna shipment to pickup point 12345, recipient Eva Malá, phone 777123456.

Order PPL with cash on delivery 500 CZK to account 1234567890/0100.

Tracking and listing

Where is my shipment IZ123456?

Show me my last 10 shipments.

Find all undelivered DPD shipments from last week.

Show me shipments with unpaid COD from the last month.

Labels

Print the label for shipment IZ123456.

I need an A6 label for a thermal printer.

Bulk shipping

(upload Excel file) Send all shipments from this file via DPD.

Cancelling

Cancel shipment IZ123456.

Defaults & conventions

Default package size: 20 × 20 × 20 cm, 1 kg when dimensions are omitted. For FedEx and UPS always provide exact dimensions — every centimeter affects pricing.
Shipment IDs: Zaslat shipments use the format IZxxxxx (e.g. IZ123456). This differs from the carrier tracking number — retrieve it via get_shipment_detail.
Country codes: Use ISO 3166-1 alpha-2 (CZ, SK, DE).
Postal codes: No spaces (60200, not 602 00).

Support

Email: admin@zaslat.cz