https://github.com/soapyred/freighttools
https://github.com/soapyred/freighttools
Last synced: 3 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/soapyred/freighttools
- Owner: SoapyRED
- Created: 2026-03-14T12:30:01.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-05-23T10:39:58.000Z (11 days ago)
- Last Synced: 2026-05-23T11:26:39.027Z (11 days ago)
- Language: TypeScript
- Homepage: https://freighttools.vercel.app
- Size: 12.8 MB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
README
# FreightUtils
**Free freight tools for AI agents, developers, and freight professionals.** Live at [www.freightutils.com](https://www.freightutils.com).
- 19 free tools — calculators, dangerous goods, customs, reference data
- 19 REST endpoints (anonymous 25/day, free key 100/day, Pro £19/mo for 50,000/mo)
- MCP server for AI agents: [`freightutils-mcp` on npm](https://www.npmjs.com/package/freightutils-mcp), currently v2.1.1
- n8n custom node: [`n8n-nodes-freightutils`](https://www.npmjs.com/package/n8n-nodes-freightutils)
## Surfaces
| Where | Purpose |
|------|------|
| [`freightutils.com`](https://www.freightutils.com) | Interactive web tools |
| [`/api-docs`](https://www.freightutils.com/api-docs) | REST API reference (OpenAPI 3.0.3) |
| [`/playground`](https://www.freightutils.com/playground) | Try every endpoint live in your browser, no terminal required |
| [`/api/mcp`](https://www.freightutils.com/api/mcp) | Streamable HTTP MCP transport |
| [`/changelog`](https://www.freightutils.com/changelog) ([RSS](https://www.freightutils.com/changelog.xml)) | Public release history |
## Stack
Next.js 16 + React 19 + Tailwind 4 + TypeScript on Vercel. Upstash KV for auth + rate limits. Stripe for Pro subscriptions. Sentry for observability. Resend for transactional email.
## Development
```bash
npm install
npm run dev # local on :3000
npm run smoke # smoke test against deployed preview
npm test # unit tests
```
PRs auto-deploy a Vercel preview. Standing convention: code reviewer merges its own PRs once CI is green (see [`CLAUDE.md`](CLAUDE.md) for the full sprint hygiene rules, FAULT history, and distribution-cascade contract).
## Related repos
- [`SoapyRED/freightutils-mcp`](https://github.com/SoapyRED/freightutils-mcp) — npm-published MCP server
- [`SoapyRED/n8n-nodes-freightutils`](https://github.com/SoapyRED/n8n-nodes-freightutils) — n8n community node
- [`SoapyRED/zapier-freightutils`](https://github.com/SoapyRED/zapier-freightutils) — Zapier integration
- [`SoapyRED/make-freightutils`](https://github.com/SoapyRED/make-freightutils) — Make.com custom app
Identifier strings can diverge per platform (Make.com forbids underscores); the JSON contract is consistent across every surface.
## Licence
Code: see repo. Data: redistributed under the original source licences — UNECE ADR 2025 (Labeline), WCO HS 2022, public IATA / ICAO airline references, UNECE UN/LOCODE, live GOV.UK Trade Tariff. Per-record provenance via `/api/*` response fields. See [`docs/DATA_PROVENANCE.md`](docs/DATA_PROVENANCE.md).
Built by [Marius Cristoiu](https://www.linkedin.com/in/marius-cristoiu-a853812a2/), ADR-certified freight transport planner.