Shipment Tracking Links

Work out the carrier from a tracking number and return its tracking link. Covers UPS, FedEx, USPS, DHL, Royal Mail, PostNord and more.

Pay by wallet (x402) shipping-track

Example

Example answer

{
  "format": {
    "length": 4,
    "is_alpha": true,
    "is_numeric": false,
    "is_alphanumeric": false
  },
  "best_match": null,
  "carrier_count": 0,
  "original_input": "test",
  "tracking_number": "TEST",
  "detected_carriers": [],
  "universal_tracking_urls": [
    "https://parcelsapp.com/en/tracking/TEST",
    "https://www.17track.net/en/track#nums=TEST"
  ]
}

Inputs

Field	Type	Required	What it is
`tracking_number`	string	Yes	—

Output fields

How reliably each field appears in a successful answer.

Field	Type	Appears
`best_match`	object	Always (present in every successful answer)
`tracking_number`	string	Always (present in every successful answer)
`detected_carriers`	array	Always (present in every successful answer)
`universal_tracking_urls`	array	Always (present in every successful answer)

How to call it

The same tool through each route. MCP clients reach it through Strale’s server at https://api.strale.io/mcp; the call below is what the agent sends.

# Needs an API key. max_price_cents caps what this call may cost.
curl -X POST https://api.strale.io/v1/do \
  -H "Authorization: Bearer $STRALE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "capability_slug": "shipping-track",
    "inputs": {
      "tracking_number": "test_value"
    },
    "max_price_cents": 2
  }'

{
  "tool": "strale_execute",
  "arguments": {
    "slug": "shipping-track",
    "inputs": {
      "tracking_number": "test_value"
    },
    "max_price_cents": 2
  }
}

import { Strale } from "straleio";

const strale = new Strale({ apiKey: process.env.STRALE_API_KEY! });
const result = await strale.do({
  capability_slug: "shipping-track",
  inputs: {
    "tracking_number": "test_value"
  },
  max_price_cents: 2,
});

import os
from straleio import Strale, DoRequest

strale = Strale(api_key=os.environ["STRALE_API_KEY"])
result = strale.do(DoRequest(
    capability_slug="shipping-track",
    inputs={
        "tracking_number": "test_value",
    },
    max_price_cents=2,
))

# No account. The first request answers 402 with the price in USDC;
# an x402 client pays it from your wallet and repeats the request.
curl -i 'https://api.strale.io/x402/v2/shipping-track?tracking_number=test_value'

Limitations

Some regional carriers are not covered
Tracking via carrier websites — supported carriers may vary and some regional carriers are not covered
What to do instead: If tracking fails, use the tracking number format to identify the carrier and check their website directly