# FreightPulse

> Real-time global logistics intelligence: fuel prices, freight rates, port congestion, supply-chain disruptions, and carrier lookups.
> Authentication: `X-API-Key: YOUR_KEY` or `Authorization: Bearer YOUR_KEY` header — BOTH optional. With no key, calls fall back to a 100 requests/day (per IP) guest tier.
> Base URL: `https://freightpulsehq.com/api/v1`
> Get a free key instantly, no credit card, no human sign-up: use the `register` MCP tool, or POST /oauth/register then /oauth/token (see /auth.md). Human sign-up: https://freightpulsehq.com/register
> MCP: `POST https://mcp.freightpulsehq.com/mcp` (this server) — one tool per endpoint below, plus `register` and `account_status`.

## Endpoints

- **GET /fuel-prices** (tool: `get_fuel_prices`) — Latest weekly average US diesel and gasoline prices by PADD region (EIA).
- **GET /freight-rates** (tool: `get_freight_rates`) — Trucking (ZIP-to-ZIP) or ocean/air quote from a limited set of Asian origins.
- **GET /port-congestion** (tool: `get_port_congestion`) — Port-call activity vs. a 90-day baseline (IMF PortWatch). At least one of port/country/region is required.
- **GET /disruptions** (tool: `get_disruptions`) — Active natural-hazard disruptions (GDACS/USGS/NOAA). Geopolitics/strikes not covered.
- **GET /carriers** (tool: `search_carriers`) — US trucking carrier lookup (FMCSA) or ocean NVOCC/OTI lookup (FMC).
- **GET /historical** (tool: `get_historical_data`) — Historical weekly series for fuel prices or curated port-congestion metrics.
- **register** (tool only, no direct REST equivalent) — self-service OAuth client_credentials registration, returns a working API key.
- **account_status** (tool only) — plan, quota, and rate-limit status for the current API key.

---

For parameters, examples, and error-path notes see: /llms-full.txt
Human docs: https://freightpulsehq.com/docs
Postman collection: https://freightpulsehq.com/postman-collection.json
Agent-readable auth guide: https://freightpulsehq.com/auth.md