# FreightSimple MCP by usefulapi

> FreightSimple MCP by usefulapi is an MCP server. Quote and book shipments, upload customs documents and track status in FreightSimple. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/freightsimple/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/freightsimple
- **MCP Registry name:** io.usefulapi/freightsimple
- **Listing updated:** 2026-11-13

## About

Quote and book shipments, upload customs documents and track status in FreightSimple.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http freightsimple https://freightsimple.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://freightsimple.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "freightsimple": {
      "url": "https://freightsimple.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "freightsimple": {
      "type": "http",
      "url": "https://freightsimple.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "freightsimple": {
      "serverUrl": "https://freightsimple.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "freightsimple": {
      "type": "http",
      "url": "https://freightsimple.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `freightsimple_list_carriers`: List the carriers available to this company, with their identifiers. GET /v1/carriers/list.
- `freightsimple_list_distribution_warehouse_brands`: List the distribution warehouse brands (for example Amazon sites) FreightSimple recognises, and whether each needs a delivery deadline. GET /v1/distribution-warehouse-brands/list.
- `freightsimple_list_dangerous_goods`: Look up dangerous goods reference data (UN numbers, classes, packing groups). The optional search text filters on UN number, class, proper shipping name or description. GET /v1/dangerous-goods/list.
- `freightsimple_get_shipment`: Get one shipment: its status, the quotes (when quoted), the selected quote, documents and tracking history. Give exactly one of shipment_id or tracking_id. Poll this after start_quoting until shipmentStatus is Quoted. GET /v1/shipments/get-shipment.
- `freightsimple_list_saved_commodities`: List the saved commodities (reusable product definitions) of this company. GET /v1/saved-commodities/list.
- `freightsimple_get_saved_commodity_by_sku`: Get one saved commodity by its SKU identifier. GET /v1/saved-commodities/get-by-sku.
- `freightsimple_start_quoting`: Create a shipment and start the carrier quoting process (no cost is committed). Returns shipmentId and warnings. Quoting takes about 30 seconds: then poll freightsimple_get_shipment until shipmentStatus is Quoted. A cross-border shipment needs a broker. POST /v1/shipments/start-quoting.
- `freightsimple_start_booking`: Book a quote from a quoted shipment. This makes a carrier pickup and commits the cost, so confirm must be true. Use the quoteId from get_shipment. Poll get_shipment until shipmentStatus is BookingConfirmed (about 15 seconds). POST /v1/shipments/start-booking.
- `freightsimple_upload_customs_documents`: Upload customs documents (base64 PDFs, for example the commercial invoice) to a cross-border shipment. Each upload goes straight to the carrier, so confirm must be true. Use mode Replace to swap a corrected set. Upload from BookingConfirmed until delivered. POST /v1/shipments/upload-customs-documents.
- `freightsimple_create_saved_commodity`: Save a reusable commodity definition for this company. POST /v1/saved-commodities/create.
- `freightsimple_update_saved_commodity`: Replace a saved commodity's fields. Send every required field again, not only the changed ones. POST /v1/saved-commodities/update.
- `freightsimple_delete_saved_commodity`: Delete a saved commodity by id. This cannot be undone. POST /v1/saved-commodities/delete.

## FAQ

### How do I add FreightSimple MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http freightsimple https://freightsimple.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/freightsimple-mcp-by-usefulapi
