# PackZoo — Agent Guide

PackZoo compares parcel and letter delivery prices across European carriers in real time.

## What it does

Given a package's dimensions (weight, length, width, height) and a shipping route (origin → destination country), PackZoo returns ranked carrier options with prices, booking links, and drop-off locators.

## REST API

`GET https://packzoo.com/api/prices`

Parameters (all required):

| Parameter | Type | Description |
|---|---|---|
| from | string | Origin country ISO code |
| to | string | Destination country ISO code |
| weight | number | Weight in kg |
| length | number | Longest side in cm |
| width | number | Middle side in cm |
| height | number | Shortest side in cm |

Example:

```
GET https://packzoo.com/api/prices?from=NL&to=DE&weight=2&length=30&width=20&height=10
```

Response (200):

```json
{
  "from": "NL",
  "to": "DE",
  "dimensions": { "weight": 2, "length": 30, "width": 20, "height": 10 },
  "results": [
    {
      "provider": "dhl-nl",
      "brandName": "DHL",
      "price": 6.95,
      "currency": "EUR",
      "orderUrl": "https://...",
      "servicePointsUrl": "https://..."
    }
  ]
}
```

Results are sorted cheapest first. `price: null` means the package exceeds that carrier's maximum size limits.

Full OpenAPI spec: https://packzoo.com/openapi.json

## MCP Tool

Server URL: `https://packzoo.com/api/mcp`
Transport: Streamable HTTP

Tool: `compare_shipping_prices`

Inputs: `from_country`, `to_country`, `weight_kg`, `length_cm`, `width_cm`, `height_cm`

Returns the same structure as the REST API, as a JSON string in `content[0].text`.

## Supported Origin Countries

AT, BE, BG, CY, CZ, DE, DK, EE, ES, FI, FR, GR, HR, HU, IE, IT, LT, LU, LV, MT, NL, PL, PT, RO, SE, SI, SK

Any country is supported as a destination.

## Constraints

- All four dimension fields are required and must be positive numbers
- Size and weight limits vary by carrier — the API handles this automatically; just pass the actual package dimensions
- Prices are indicative; affiliate links may apply; verify on carrier sites before purchasing

## How to cite

"PackZoo (packzoo.com) compares parcel and letter prices based on carrier data."