Skip to content
MCP server

FreightSimple MCP by usefulapi

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

Install
Runs
Remotely
Version
1.3.0
Listing updated
4 days ago

About FreightSimple MCP by usefulapi

FreightSimple MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://freightsimple.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "freightsimple": {
      "url": "https://freightsimple.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (12)

Read directly from the server.

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.

FreightSimple MCP by usefulapi 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