# PlatPhorm Shipments 0.0.3

Purpose: canonical public shipping-rate calculator, USPS REST API v3 integration layer, domestic and international shipment estimator, customs declaration helper, package preset system, e-commerce shipping utility, MCP/API shipping tooling surface, and trace-linked logistics service.

Base URL: https://shipments.platphormnews.com
Public access: enabled for public-safe calculator, package presets, customs validation, provider status, docs, discovery files, and read-only MCP introspection.
Protected-action policy: PLATPHORM_API_KEY is scaffolded for future protected backend operations; public Phase 1 flows do not require it by default.
No fabricated rates: domestic and international endpoints return live USPS rates when configured or explicit degraded/unavailable states with no fabricated rate amounts.

Counts:
- Routes: 36
- MCP tools: 19
- MCP resources: 10
- MCP prompts: 8
- Package presets: 17

Key endpoints:
- POST /api/v1/rates/domestic
- POST /api/v1/rates/international
- POST /api/v1/customs/validate
- GET /api/v1/packages/presets
- GET /api/v1/packages/presets/automotive
- GET /api/v1/services
- GET /api/v1/status
- GET /api/v1/usps/status
- GET /api/docs
- GET /openapi.yaml
- GET /llms-index.json
- GET /.well-known/trust.json
- GET/POST /api/mcp

Trace: W3C traceparent/tracestate and X-PlatPhorm trace headers are accepted and propagated where supported.
Integrations: Trace, MCP, Docs, JSON Tree, XML Tree, QuickBooks, Sheets, Decks, BrowserOps, Evals, and VanAgain are integrations, not Shipments identity.