Servers Playground How we check Add a server Log in

FreightFA

Working · 3.2 s

com.freightfa.mcp/freightfav0.4.1 Domain verified

Freight rate benchmarks (truckload, LTL, rail, intermodal, barge), market outlooks, FMCSA checks.

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.freightfa.com/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

ask_freight_analyst

Ask FreightFA's AI freight analyst a question in plain language: lane rates, mode choice, capacity, fuel, carrier vetting, market news, or drafting an RFP. Answers cite their sources and can include a priced rate card. Pass session_id from a previous answer to continue the same conversation. Each question counts toward the account's monthly FreightFA allowance.

questionstring, required

The question, up to 2,000 characters.

session_idstring, required

session_id returned by an earlier answer to continue that conversation, or null to start a new one.

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

FreightFA MCP server | mcptry

Tools (27)

ask_freight_analyst

Argument	Type	Description
question*	string	The question, up to 2,000 characters.
session_id*	any	session_id returned by an earlier answer to continue that conversation, or null to start a new one.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "question",
    "session_id"
  ],
  "properties": {
    "question": {
      "type": "string",
      "maxLength": 2000,
      "minLength": 1,
      "description": "The question, up to 2,000 characters."
    },
    "session_id": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
        },
        {
          "type": "null"
        }
      ],
      "description": "session_id returned by an earlier answer to continue that conversation, or null to start a new one."
    }
  }
}

calculate_margin

Margin on a load from the buy rate (carrier cost) and sell rate (what the shipper pays): margin in dollars and percent of sell, the per-mile spread when miles are given, and the sell price needed to hit a target margin. Pure arithmetic; does not count toward the allowance.

read-only

Argument	Type	Description
buy*	number	Carrier cost (buy rate) for the load, all-in, in dollars.
sell*	number	Shipper price (sell rate) for the load, all-in, in dollars.
miles*	any	Loaded miles, or null.
target_margin_pct*	any	Target margin as a percent of sell, e.g. 15, or null.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "buy",
    "sell",
    "miles",
    "target_margin_pct"
  ],
  "properties": {
    "buy": {
      "type": "number",
      "description": "Carrier cost (buy rate) for the load, all-in, in dollars.",
      "exclusiveMinimum": 0
    },
    "sell": {
      "type": "number",
      "description": "Shipper price (sell rate) for the load, all-in, in dollars.",
      "exclusiveMinimum": 0
    },
    "miles": {
      "anyOf": [
        {
          "type": "number",
          "exclusiveMinimum": 0
        },
        {
          "type": "null"
        }
      ],
      "description": "Loaded miles, or null."
    },
    "target_margin_pct": {
      "anyOf": [
        {
          "type": "number",
          "maximum": 90,
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "description": "Target margin as a percent of sell, e.g. 15, or null."
    }
  }
}

check_freight_bill

Compare what a shipper was billed (or quoted) for one truckload or LTL load with today's market price for the same lane. Use it when the user uploads, pastes, or describes a freight bill, carrier or broker invoice, or rate confirmation and asks whether the price is fair. Read the fields off the document yourself and pass only those; never send the document, its text, company or people's names, street addresses, or invoice, PRO, BOL, or account numbers. If the document doesn't say what kind of truck moved the load, ask the user. Dry Van and LTL return a verdict (above_market, at_market, good_price, below_floor) against FreightFA's market quote, negotiation target, and walk-away floor, plus what negotiating would have saved. Reefer and Flatbed return FreightFA's estimate and the gap with no verdict (no_call). The comparison is all-in with fuel; put detention, lumper, liftgate and other extras in accessorials so they are left out. Bills older than 90 days are not judged. Takes places, not miles. Each call counts as one estimate toward the account's monthly FreightFA allowance.

read-only

Argument	Type	Description
mode*	string	What moved. A plain truckload or FTL bill is 'Dry Van'.
origin*	string	Where the load picked up: city and state, or ZIP. Example: 'Chicago, IL 60601'. Not the bill-to or remit-to address.
pallets*	any	LTL only: pallet count, or null.
ship_date*	string \| null	Ship or pickup date as YYYY-MM-DD, or null if the bill doesn't say.

create_rate_alert

Create a lane rate alert for the signed-in user. Notifies them when the benchmark crosses the threshold.

Argument	Type	Description
mode*	string	Freight mode, e.g. 'FTL', 'LTL', 'Rail', 'Intermodal'.
origin*	string	Origin city/state or ZIP.
direction*	any	Trigger when the rate goes above or below the threshold. Defaults to 'below'.
destination*	string	Destination city/state or ZIP.
threshold_rate*	number	Rate threshold in USD.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "origin",
    "destination",
    "mode",
    "threshold_rate",
    "direction"
  ],
  "properties": {
    "mode": {
      "type": "string",
      "description": "Freight mode, e.g. 'FTL', 'LTL', 'Rail', 'Intermodal'."
    },
    "origin": {
      "type": "string",
      "minLength": 2,
      "description": "Origin city/state or ZIP."
    },
    "direction": {
      "anyOf": [
        {
          "enum": [
            "above",
            "below"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Trigger when the rate goes above or below the threshold. Defaults to 'below'."
    },
    "destination": {
      "type": "string",
      "minLength": 2,
      "description": "Destination city/state or ZIP."
    },
    "threshold_rate": {
      "type": "number",
      "description": "Rate threshold in USD.",
      "exclusiveMinimum": 0
    }
  }
}

create_rfp

Create a draft freight RFP in the user's FreightFA account with up to 50 lanes, and benchmark each lane against the market. Returns the RFP id, a link to finish and send it in the RFP Builder, and each lane's benchmark. Free accounts can have one RFP.

Argument	Type	Description
lanes*	array	The lanes to bid.
title*	string	RFP title, e.g. 'Q1 2027 Southeast truckload bid'.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "title",
    "lanes"
  ],
  "properties": {
    "lanes": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "origin",
          "destination",
          "mode",
          "equipment_type",
          "weight_lbs",
          "frequency",
          "target_rate"
        ],
        "properties": {
          "mode": {
            "enum": [
              "TL",
              "LTL",
              "Intermodal",
              "Rail",
              "Air",
              "Ocean"
            ],
            "type": "string",
            "description": "TL, LTL, Intermodal, Rail, Air, or Ocean."
          },
          "origin": {
            "type": "string",
            "minLength": 2,
            "description": "Origin city and state, or ZIP."
          },
          "frequency": {
            "type": [
              "string",
              "null"
            ],
            "description": "Volume, e.g. '3 loads/week', or null."
          },
          "weight_lbs": {
            "anyOf": [
              {
                "type": "number",
                "exclusiveMinimum": 0
              },
              {
                "type": "null"
              }
            ],
            "description": "Typical shipment weight in pounds, or null."
          },
          "destination": {
            "type": "string",
            "minLength": 2,
            "description": "Destination city and state, or ZIP."
          },
          "target_rate": {
            "anyOf": [
              {
                "type": "number",
                "exclusiveMinimum": 0
              },
              {
                "type": "null"
              }
            ],
            "description": "Target all-in rate in dollars per load, or null."
          },
          "equipment_type": {
            "type": [
              "string",
              "null"
            ],
            "description": "e.g. 'Dry Van', 'Reefer', 'Flatbed', or null."
          }
        }
      },
      "maxItems": 50,
      "minItems": 1,
      "description": "The lanes to bid."
    },
    "title": {
      "type": "string",
      "maxLength": 200,
      "minLength": 2,
      "description": "RFP title, e.g. 'Q1 2027 Southeast truckload bid'."
    }
  }
}

draft_pushback_email

Draft an email to a broker or carrier pushing back on a truckload quote, using the market benchmark for the lane and this week's market direction. Set want_counter to true to also draft a counter-offer. If no benchmark is given, the national all-in rate for the equipment is used. Included with FreightFA Pro and Desk accounts.

read-only

Argument	Type	Description
origin*	string	Origin city and state.
equipment*	string	Equipment type.
destination*	string	Destination city and state.
quoted_total*	number	The all-in quote being pushed back on, in dollars.
want_counter*	boolean \| null	true to include a counter-offer.
distance_miles*	number	Lane miles.
benchmark_per_mile*	any	All-in market benchmark in $/mi (e.g. from estimate_truckload_rate), or null to use the national rate.

estimate_barge_rate

Estimate an inland waterway barge freight rate for a bulk commodity, origin, destination, distance, and weight, from USDA's weekly downbound grain barge rates. Only priced when both ends are Mississippi/Illinois/Ohio River ports, the lane runs downriver, and the shipment is at least one barge-load (~1,500 short tons, 3,000,000 lb); otherwise returns available: false with the reason. Priced on river miles. Returns a directional benchmark for planning. Each call counts as one estimate toward the account's monthly FreightFA allowance.

read-only

Argument	Type	Description
origin*	string	Origin city and state, e.g. 'Minneapolis, MN'.
weight*	number	Shipment weight in pounds.
distance*	number	Lane distance in miles. recommend_mode returns it for a city or ZIP pair.
destination*	string	Destination city and state, e.g. 'New Orleans, LA'.
commodity_type*	string	Commodity being shipped, e.g. 'grain', 'corn', 'coal'. Barge only carries bulk commodities.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "commodity_type",
    "origin",
    "destination",
    "distance",
    "weight"
  ],
  "properties": {
    "origin": {
      "type": "string",
      "description": "Origin city and state, e.g. 'Minneapolis, MN'."
    },
    "weight": {
      "type": "number",
      "description": "Shipment weight in pounds.",
      "exclusiveMinimum": 0
    },
    "distance": {
      "type": "number",
      "description": "Lane distance in miles. recommend_mode returns it for a city or ZIP pair.",
      "exclusiveMinimum": 0
    },
    "destination": {
      "type": "string",
      "description": "Destination city and state, e.g. 'New Orleans, LA'."
    },
    "commodity_type": {
      "type": "string",
      "description": "Commodity being shipped, e.g. 'grain', 'corn', 'coal'. Barge only carries bulk commodities."
    }
  }
}

estimate_intermodal_rate

Estimate a door-to-door domestic intermodal (rail + truck) rate between two U.S. places: drayage to the nearest Class I ramp, the rail line-haul, and drayage from the destination ramp, with the ramps used. Says when a lane has no intermodal service. Each call counts as one estimate toward the account's monthly FreightFA allowance.

read-only

Argument	Type	Description
origin*	string	Origin city and state, or ZIP. Example: 'Chicago, IL'.
weight*	number	Shipment weight in pounds.
destination*	string	Destination city and state, or ZIP. Example: 'Los Angeles, CA'.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "origin",
    "destination",
    "weight"
  ],
  "properties": {
    "origin": {
      "type": "string",
      "minLength": 2,
      "description": "Origin city and state, or ZIP. Example: 'Chicago, IL'."
    },
    "weight": {
      "type": "number",
      "description": "Shipment weight in pounds.",
      "exclusiveMinimum": 0
    },
    "destination": {
      "type": "string",
      "minLength": 2,
      "description": "Destination city and state, or ZIP. Example: 'Los Angeles, CA'."
    }
  }
}

estimate_ltl_rate

Estimate a less-than-truckload rate using FreightFA's CzarLite-basis tariff calculator. Returns a directional benchmark for planning. Each call counts as one estimate toward the account's monthly FreightFA allowance.

read-only

Argument	Type	Description
weight*	number	Shipment weight in pounds.
distance*	number	Lane distance in miles. recommend_mode returns it for a city or ZIP pair.
commodity*	string \| null	Commodity description, or null for general freight.
freight_class*	string \| null	NMFC freight class such as '70', '92.5', '175'. Null to use the default class.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "distance",
    "weight",
    "freight_class",
    "commodity"
  ],
  "properties": {
    "weight": {
      "type": "number",
      "description": "Shipment weight in pounds.",
      "exclusiveMinimum": 0
    },
    "distance": {
      "type": "number",
      "description": "Lane distance in miles. recommend_mode returns it for a city or ZIP pair.",
      "exclusiveMinimum": 0
    },
    "commodity": {
      "type": [
        "string",
        "null"
      ],
      "description": "Commodity description, or null for general freight."
    },
    "freight_class": {
      "type": [
        "string",
        "null"
      ],
      "description": "NMFC freight class such as '70', '92.5', '175'. Null to use the default class."
    }
  }
}

estimate_network_cost

Price a supply chain of up to 10 legs (factory to port to warehouse to store, domestic or international) and total it, with each leg's mode, cost, and transit time. Saved to the user's Network Builder. Full costs are included with FreightFA Desk; other accounts can spend a one-time trial run by setting use_trial_run to true, otherwise legs come back without costs.

Argument	Type	Description
legs*	array	Legs in order.
name*	string	A name for the network, e.g. 'Shenzhen to Dallas stores'.
use_trial_run*	boolean \| null	true to spend the account's one-time trial run if it has no Desk plan.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "name",
    "legs",
    "use_trial_run"
  ],
  "properties": {
    "legs": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "origin",
          "destination",
          "weight_lbs",
          "commodity_type"
        ],
        "properties": {
          "origin": {
            "type": "string",
            "minLength": 2,
            "description": "Leg origin: city and state or country."
          },
          "weight_lbs": {
            "type": "number",
            "description": "Weight moved on this leg, in pounds.",
            "exclusiveMinimum": 0
          },
          "destination": {
            "type": "string",
            "minLength": 2,
            "description": "Leg destination."
          },
          "commodity_type": {
            "type": "string",
            "minLength": 2,
            "description": "What is shipped, e.g. 'Packaged Goods'."
          }
        }
      },
      "maxItems": 10,
      "minItems": 1,
      "description": "Legs in order."
    },
    "name": {
      "type": "string",
      "maxLength": 120,
      "minLength": 1,
      "description": "A name for the network, e.g. 'Shenzhen to Dallas stores'."
    },
    "use_trial_run": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "true to spend the account's one-time trial run if it has no Desk plan."
    }
  }
}

estimate_rail_rate

Estimate a Class I carload rail freight rate for a commodity, distance, and weight. Pass origin and destination to check for active freight track near both ends (USDOT rail network): rail_access names the railroads nearby, and a lane with no track within 50 miles of an end returns available: false with the reason instead of a price. Don't quote rail on such a lane. Returns a directional benchmark for planning. Each call counts as one estimate toward the account's monthly FreightFA allowance.

read-only

Argument	Type	Description
origin	string	Origin city or ZIP, e.g. 'Kansas City, MO'. Recommended: enables the rail access check.
weight*	number	Shipment weight in pounds.
distance*	number	Lane distance in miles. recommend_mode returns it for a city or ZIP pair.
destination	string	Destination city or ZIP, e.g. 'Atlanta, GA'. Recommended: enables the rail access check.
commodity_type*	string	Commodity being shipped, e.g. 'grain', 'chemicals', 'intermodal containers'.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "commodity_type",
    "distance",
    "weight"
  ],
  "properties": {
    "origin": {
      "type": "string",
      "description": "Origin city or ZIP, e.g. 'Kansas City, MO'. Recommended: enables the rail access check."
    },
    "weight": {
      "type": "number",
      "description": "Shipment weight in pounds.",
      "exclusiveMinimum": 0
    },
    "distance": {
      "type": "number",
      "description": "Lane distance in miles. recommend_mode returns it for a city or ZIP pair.",
      "exclusiveMinimum": 0
    },
    "destination": {
      "type": "string",
      "description": "Destination city or ZIP, e.g. 'Atlanta, GA'. Recommended: enables the rail access check."
    },
    "commodity_type": {
      "type": "string",
      "description": "Commodity being shipped, e.g. 'grain', 'chemicals', 'intermodal containers'."
    }
  }
}

estimate_truckload_rate

Estimate a full-truckload freight rate for a lane using FreightFA's DAT-basis rate engine. Returns a directional benchmark for planning. Each call counts as one estimate toward the account's monthly FreightFA allowance.

read-only

Argument	Type	Description
origin	any	Origin city and state; provide with destination, or use both ZIPs.
weight*	any	Shipment weight in pounds, or null.
distance*	number	Lane distance in miles. recommend_mode returns it for a city or ZIP pair.
origin_zip	any
request_id	any	request_id from recommend_mode for this lane, or null. Links the price to that search.
destination	any
pickup_date	any	Pickup date YYYY-MM-DD; omitted uses the calculator default.
equipment_type*	string	Equipment type, e.g. 'Dry Van', 'Reefer', 'Flatbed', 'Dump Truck'.

explain_freight_term

Plain-English definition of a freight market index, ratio, or charge from the FreightFA glossary: OTRI, OTVI, load-to-truck ratio, NTI, Cass Freight Index, RCAF, fuel surcharge, freight class, detention and demurrage, DIM weight, bill of lading, deadhead, accessorials, linehaul, and more. Returns who publishes it, how to read it, and why it matters. Omit the term to list every entry with its link. Does not count toward the allowance.

read-only

Argument	Type	Description
term	any	The term or abbreviation, e.g. 'OTRI' or 'linehaul rate'. Omit or null to list every term.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "term": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 2
        },
        {
          "type": "null"
        }
      ],
      "description": "The term or abbreviation, e.g. 'OTRI' or 'linehaul rate'. Omit or null to list every term."
    }
  }
}

find_intermodal_hubs

Look up U.S. intermodal rail hubs by city or state: which Class I railroads serve the metro, the named ramps to ask a carrier about, and notes. Leave both out to list every hub. Does not count toward the allowance.

read-only

Argument	Type	Description
city	string \| null	City or metro name, e.g. 'Houston'. Omit or null for any.
state	any	Two-letter state code, e.g. 'TX'. Omit or null for any.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "city": {
      "type": [
        "string",
        "null"
      ],
      "description": "City or metro name, e.g. 'Houston'. Omit or null for any."
    },
    "state": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 2,
          "minLength": 2
        },
        {
          "type": "null"
        }
      ],
      "description": "Two-letter state code, e.g. 'TX'. Omit or null for any."
    }
  }
}

get_barge_outlook

USDA weekly downbound grain barge rates for the river corridor between two Mississippi, Illinois, or Ohio River places, with next week's outlook where it has passed a backtest. Says when the places aren't on a priced corridor. Does not count toward the allowance.

read-only

Argument	Type	Description
origin*	string	Origin river city and state, e.g. 'St. Louis, MO'.
destination*	string	Destination river city and state, e.g. 'New Orleans, LA'.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "origin",
    "destination"
  ],
  "properties": {
    "origin": {
      "type": "string",
      "minLength": 2,
      "description": "Origin river city and state, e.g. 'St. Louis, MO'."
    },
    "destination": {
      "type": "string",
      "minLength": 2,
      "description": "Destination river city and state, e.g. 'New Orleans, LA'."
    }
  }
}

get_freight_brief

Start here for any general freight market question. FreightFA's daily freight brief in one call, with no inputs: today's U.S. national truckload rates per mile (dry van, reefer, flatbed, all-in including fuel) and diesel, next week's truck rate outlook, truck capacity, how rail carload prices are moving, ocean, air, and barge readings with their outlooks, and FreightFA's newest stories with links. Every figure carries its date and source, and a figure that failed FreightFA's checks is listed as held back, with the reason, instead of being shown. Rebuilt several times a day; cite it as FreightFA with the date. Does not count toward the estimate allowance.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

get_freight_index_outlook

Latest reading and next-period outlook for a global freight index: drewry_wci (Drewry World Container Index, $/40ft container), baltic_dry_index (dry bulk shipping), tac_air_index (air cargo rates), or iata_jet_fuel (jet fuel price). Omit the index to get all four. A forecast band is shown only where it has passed a backtest and the source readings are consistent; otherwise the answer says what was held back and why. Does not count toward the allowance.

read-only

Argument	Type	Description
index	any	Which index. Omit or null for all four.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "index": {
      "anyOf": [
        {
          "enum": [
            "drewry_wci",
            "baltic_dry_index",
            "tac_air_index",
            "iata_jet_fuel"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Which index. Omit or null for all four."
    }
  }
}

get_freight_news

FreightFA's newest freight news: FreightFA Pulse market stories and updates (truck, rail, ocean, industry), articles from The FreightFA Brief newsletter, videos, and podcast episodes. Returns titles, dates, short summaries and links, newest first. Filter by source or by a topic keyword such as 'intermodal' or 'tariffs'. Works with no inputs. Use it for what is happening in freight right now; cite the linked page. Does not count toward the monthly allowance.

read-only

Argument	Type	Description
limit	any	How many items to return. Defaults to 8.
topic	any	Optional keyword or two to match in titles and summaries, e.g. 'ocean rates'.
source	any	Which feed: all (default), pulse (daily stories and market updates), articles (The FreightFA Brief), videos, or podcast.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 20,
          "minimum": 1
        },
        {
          "type": "null"
        }
      ],
      "description": "How many items to return. Defaults to 8."
    },
    "topic": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 80
        },
        {
          "type": "null"
        }
      ],
      "description": "Optional keyword or two to match in titles and summaries, e.g. 'ocean rates'."
    },
    "source": {
      "anyOf": [
        {
          "enum": [
            "all",
            "pulse",
            "articles",
            "videos",
            "podcast"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Which feed: all (default), pulse (daily stories and market updates), articles (The FreightFA Brief), videos, or podcast."
    }
  }
}

get_market_outlook

FreightFA's forecast for next week's U.S. national spot rate per mile (all-in including fuel) for dry van, reefer, or flatbed: the current weekly average, a p10/p50/p90 band, and whether rates look to be rising, falling, or stable, with the rationale and caveat. Omit the equipment type to get all three. National, not lane-specific. Does not count toward the estimate allowance.

read-only

Argument	Type	Description
equipment	any	Equipment type. Omit or null for all three.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "equipment": {
      "anyOf": [
        {
          "enum": [
            "dry_van",
            "reefer",
            "flatbed"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Equipment type. Omit or null for all three."
    }
  }
}

get_market_snapshot

Today's U.S. national truckload rates per mile for dry van, reefer, and flatbed (all-in including fuel, with linehaul and fuel split), FreightFA's live-quote index, and EIA diesel, each with its source week and the change over the last 7 days. Use it for 'what are truck rates right now' questions; cite it as FreightFA with the as-of date. Does not count toward the estimate allowance.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

get_rail_market_outlook

How U.S. rail carload prices are moving: the change in Class I railroads' average revenue per carload versus a year earlier, from their SEC filings (fuel surcharges included), for Agricultural or Industrial freight, with the outlook where it has passed a backtest. Omit the group to get both. National, not lane-specific. Does not count toward the allowance.

read-only

Argument	Type	Description
group	any	Commodity group. Omit or null for both.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "group": {
      "anyOf": [
        {
          "enum": [
            "Agricultural",
            "Industrial"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "description": "Commodity group. Omit or null for both."
    }
  }
}

get_rfp

Fetch one of the signed-in user's RFP documents, including its lanes.

read-only

Argument	Type	Description
rfp_id*	string	The RFP document id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "rfp_id"
  ],
  "properties": {
    "rfp_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "The RFP document id."
    }
  }
}

list_rate_alerts

List the signed-in user's lane rate alerts.

read-only

Argument	Type	Description
active_only*	boolean \| null	True to return only active alerts.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "active_only"
  ],
  "properties": {
    "active_only": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "True to return only active alerts."
    }
  }
}

list_recent_searches

List the signed-in user's recent freight rate searches and the lanes they priced (website, chat and assistant), newest first, each with its price breakdown (linehaul, fuel, market quote, target, floor) and how often it was priced.

read-only

Argument	Type	Description
limit*	any	Max rows to return (default 10).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "limit"
  ],
  "properties": {
    "limit": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 25,
          "minimum": 1
        },
        {
          "type": "null"
        }
      ],
      "description": "Max rows to return (default 10)."
    }
  }
}

list_rfps

List the signed-in user's RFP documents, newest first, with lane counts.

read-only

Argument	Type	Description
limit*	any	Max rows to return (default 20).
status*	string \| null	Filter by status such as 'draft' or 'sent'. Null for all statuses.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "status",
    "limit"
  ],
  "properties": {
    "limit": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 50,
          "minimum": 1
        },
        {
          "type": "null"
        }
      ],
      "description": "Max rows to return (default 20)."
    },
    "status": {
      "type": [
        "string",
        "null"
      ],
      "description": "Filter by status such as 'draft' or 'sent'. Null for all statuses."
    }
  }
}

lookup_carrier

Vet a U.S. motor carrier from FMCSA SAFER data: operating authority, safety rating, insurance on file, driver and vehicle out-of-service rates, and FreightFA's risk flags. Search by USDOT number, MC number, or carrier name (give one). Data is cached for 24 hours. Does not count toward the estimate allowance.

read-only

Argument	Type	Description
name*	string \| null	Carrier legal or DBA name, or null.
mc_number*	string \| null	MC/MX docket number, digits only, or null.
dot_number*	string \| null	USDOT number, digits only, or null.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "dot_number",
    "mc_number",
    "name"
  ],
  "properties": {
    "name": {
      "type": [
        "string",
        "null"
      ],
      "description": "Carrier legal or DBA name, or null."
    },
    "mc_number": {
      "type": [
        "string",
        "null"
      ],
      "description": "MC/MX docket number, digits only, or null."
    },
    "dot_number": {
      "type": [
        "string",
        "null"
      ],
      "description": "USDOT number, digits only, or null."
    }
  }
}

recommend_mode

Rank the freight modes (dry van, reefer, flatbed, intermodal, rail, barge, dump truck) for a shipment between two U.S. places, with the reasons for each, and return the lane distance in miles. Use it first when you only have city names or ZIPs, then pass the distance to an estimate_* tool for a price. International lanes return the ocean/air routing instead. Does not count toward the estimate allowance.

read-only

Argument	Type	Description
origin*	string	Origin city and state, or ZIP. Example: 'Chicago, IL'.
weight*	number	Shipment weight in pounds.
destination*	string	Destination city and state, or ZIP. Example: 'Dallas, TX'.
commodity_type*	string	What is being shipped, e.g. 'Packaged Goods', 'Produce/Food', 'Machinery/Equipment', 'Hazmat/Chemicals'.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "origin",
    "destination",
    "weight",
    "commodity_type"
  ],
  "properties": {
    "origin": {
      "type": "string",
      "minLength": 2,
      "description": "Origin city and state, or ZIP. Example: 'Chicago, IL'."
    },
    "weight": {
      "type": "number",
      "description": "Shipment weight in pounds.",
      "exclusiveMinimum": 0
    },
    "destination": {
      "type": "string",
      "minLength": 2,
      "description": "Destination city and state, or ZIP. Example: 'Dallas, TX'."
    },
    "commodity_type": {
      "type": "string",
      "description": "What is being shipped, e.g. 'Packaged Goods', 'Produce/Food', 'Machinery/Equipment', 'Hazmat/Chemicals'."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "mode",
    "origin",
    "destination",
    "billed_total",
    "accessorials",
    "ship_date",
    "weight_lbs",
    "pallets",
    "freight_class"
  ],
  "properties": {
    "mode": {
      "enum": [
        "Dry Van",
        "Reefer",
        "Flatbed",
        "LTL"
      ],
      "type": "string",
      "description": "What moved. A plain truckload or FTL bill is 'Dry Van'."
    },
    "origin": {
      "type": "string",
      "minLength": 2,
      "description": "Where the load picked up: city and state, or ZIP. Example: 'Chicago, IL 60601'. Not the bill-to or remit-to address."
    },
    "pallets": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 9007199254740991,
          "exclusiveMinimum": 0
        },
        {
          "type": "null"
        }
      ],
      "description": "LTL only: pallet count, or null."
    },
    "ship_date": {
      "type": [
        "string",
        "null"
      ],
      "description": "Ship or pickup date as YYYY-MM-DD, or null if the bill doesn't say."
    },
    "weight_lbs": {
      "anyOf": [
        {
          "type": "number",
          "exclusiveMinimum": 0
        },
        {
          "type": "null"
        }
      ],
      "description": "LTL only: shipment weight in pounds. Null for truckload."
    },
    "destination": {
      "type": "string",
      "minLength": 2,
      "description": "Where the load delivered: city and state, or ZIP."
    },
    "accessorials": {
      "anyOf": [
        {
          "type": "number",
          "minimum": 0
        },
        {
          "type": "null"
        }
      ],
      "description": "The part of billed_total that is extras (detention, lumper, liftgate, residential, layover), in dollars. Null or 0 when there are none."
    },
    "billed_total": {
      "type": "number",
      "description": "Everything on the bill, in U.S. dollars.",
      "exclusiveMinimum": 0
    },
    "freight_class": {
      "type": [
        "string",
        "null"
      ],
      "description": "LTL only: NMFC freight class from the bill such as '70' or '92.5', or null."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "equipment_type",
    "distance",
    "weight"
  ],
  "properties": {
    "origin": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 160,
          "minLength": 2
        },
        {
          "type": "null"
        }
      ],
      "description": "Origin city and state; provide with destination, or use both ZIPs."
    },
    "weight": {
      "anyOf": [
        {
          "type": "number",
          "exclusiveMinimum": 0
        },
        {
          "type": "null"
        }
      ],
      "description": "Shipment weight in pounds, or null."
    },
    "distance": {
      "type": "number",
      "description": "Lane distance in miles. recommend_mode returns it for a city or ZIP pair.",
      "exclusiveMinimum": 0
    },
    "origin_zip": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^[0-9]{5}$"
        },
        {
          "type": "null"
        }
      ]
    },
    "request_id": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid",
          "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
        },
        {
          "type": "null"
        }
      ],
      "description": "request_id from recommend_mode for this lane, or null. Links the price to that search."
    },
    "destination": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 160,
          "minLength": 2
        },
        {
          "type": "null"
        }
      ]
    },
    "pickup_date": {
      "anyOf": [
        {
          "type": "string",
          "format": "date",
          "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
        },
        {
          "type": "null"
        }
      ],
      "description": "Pickup date YYYY-MM-DD; omitted uses the calculator default."
    },
    "equipment_type": {
      "type": "string",
      "description": "Equipment type, e.g. 'Dry Van', 'Reefer', 'Flatbed', 'Dump Truck'."
    },
    "destination_zip": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^[0-9]{5}$"
        },
        {
          "type": "null"
        }
      ]
    }
  }
}