# Shipyu

> Shipyu is a shipment tracking API for developers. One POST creates a tracker; HMAC-signed webhooks deliver every status change, normalized across 100+ carriers (USPS, UPS, FedEx, DHL, and more). Test mode is free. Usage-based pricing: $0.020 per tracker, falling to $0.015 at volume — no platform fee, no seats.

Key facts:

- Base URL: https://shipyu.com/api/v1 with Bearer API-key auth (keys look like sk_shipyu_test_... or sk_shipyu_live_...).
- Core objects: trackers (trk_ ids), webhooks (HMAC-signed, 5 retries with backoff), usage.
- Test mode is free forever and uses deterministic TEST_* tracking numbers — an agent can verify an integration without spending money.
- Signup is instant and self-serve at https://shipyu.com/signup; a test API key is issued immediately.

## Documentation

- [Full API documentation as plain text](https://shipyu.com/llms-full.txt): every endpoint, parameter, and schema — start here
- [OpenAPI 3.1 specification (JSON)](https://shipyu.com/api/openapi): machine-readable spec, no auth required
- [Interactive API reference](https://shipyu.com/docs/reference): Scalar UI over the same spec
- [Changelog](https://shipyu.com/changelog): what shipped, dated and specific; every entry also serves markdown at https://shipyu.com/changelog/<slug>.md and RSS at https://shipyu.com/changelog/feed.xml
- [Pricing](https://shipyu.com/pricing): usage-based rate table and calculator

## Comparisons

- [Shipyu vs AfterShip](https://shipyu.com/compare/aftership): monthly cost side by side at every volume AfterShip publishes a price for, quoted from their own pricing page and dated 2026-08-07, plus carrier coverage, webhooks, and the cases where AfterShip is the better choice. Also served as plain markdown at https://shipyu.com/compare/aftership.md

## AI agent integration

- [AGENTS.md](https://shipyu.com/AGENTS.md): integration instructions written for agents — auth, the minimal working call, webhook signature verification, rate limits, which errors are worth retrying, and the API behaviours that most often cost a wasted call
- [Use Shipyu from Claude Code, Cursor, and other agents](https://shipyu.com/mcp): setup guide for the official MCP server
- MCP endpoint: https://shipyu.com/api/mcp (MCP Streamable HTTP, JSON-only; authenticate with a Shipyu API key as Bearer token; tools: create_tracker, get_tracker, delete_tracker, list_webhooks, create_webhook, test_webhook, get_usage)

## Optional

- [Contact](https://shipyu.com/contact): integration help and volume pricing
- [Terms](https://shipyu.com/terms), [Privacy](https://shipyu.com/privacy)