# FreightRateIntelligence.com > Freight market intelligence for AI agents and human analysts. > Every number has a source. Every estimate has a confidence grade. Every result has a receipt. > freightrateintelligence.com redirects here. ## What This Product Is FreightRateIntelligence.com provides cost-basis freight rate estimates and market intelligence derived from authoritative public economic data (EIA, BLS, FRED, FMCSA). This is NOT a load-board spot rate feed. It does NOT source data from DAT, Truckstop, or broker transaction systems. It IS a cost-basis intelligence layer — the economic floor and directional signal beneath the market, with full data provenance on every output. Best for: budget modeling, contract benchmarking, procurement analysis, rate trend monitoring, and freight market intelligence in agent workflows. Not for: covering a load today, real-time broker negotiation. --- ## Model Type All rate outputs are type: COST_BASIS Formula: rate_per_mile = (regional_diesel / equipment_mpg) + reefer_unit_fuel_per_mile [REEFER equipment only] + (bls_wage / avg_speed × labor_multiplier) + equipment_cost_per_mile + 0.15 margin + max(0, (diesel - 1.25) / 6.0) [ATA/DOE fuel surcharge, if enabled] × mode_multiplier [FTL=1.0, LTL=1.35, INTERMODAL=0.82] × market_premium_multiplier [DRY_VAN=1.0, REEFER=1.18, FLATBED=1.12] total_cost = rate_per_mile × miles Data sources refreshed automatically (FRI fetches all sources multiple times daily): - EIA diesel prices: published weekly Tuesday (PADD regional — 5 US regions) - BLS trucking hourly wage: published monthly (first Friday) - FRED economic indicators: varies by series (daily to monthly) - FMCSA carrier data: published daily - USDA AMS truck rates: published weekly (Tuesday), reefer produce lane transaction rates - Equipment constants (MPG, reefer burn rate): stable, DOE-sourced (annual) - Google Maps distance: real-time on demand Every response includes factor_versions with observation_date showing actual source publication date. --- ## Confidence System Every response includes a mechanical confidence grade — not subjective, not a score, a deterministic grade based on what data was available: HIGH — Distance from precomputed table OR Google Maps + PADD regional diesel MEDIUM — Distance from haversine estimate OR national diesel fallback LOW — City unrecognized, using national average lane — treat with caution Confidence is present on every response as: confidence.level: "HIGH" | "MEDIUM" | "LOW" confidence.label: human-readable explanation confidence.factors: array of specific reasons --- ## Skills (API Endpoints) ### rate-lookup Cost-basis rate estimate for any US lane. POST /v1/rates/lookup Required: origin (city/state, ZIP, or 3-letter code), destination Optional: equipment, mode, include_fuel_surcharge Optional (advanced): as_of (defaults to today), rate_type (reserved for future use) Equipment types: DRY_VAN (default), REEFER, FLATBED, STEP_DECK, POWER_ONLY, INTERMODAL Modes: FTL (default), LTL, REEFER, FLATBED, INTERMODAL Response fields: rate_per_mile — All-in USD per mile total_cost — rate_per_mile × miles miles — Lane distance currency — Always "USD" origin, destination — Normalized city names equipment — Equipment key (e.g. DRY_VAN) equipment_display — Human-readable name (e.g. "Dry Van (53')") mode — Freight mode (FTL, LTL, etc.) rate_type — Echoed from request (reserved — currently all return cost-basis) include_fuel_surcharge — Whether FSC is included as_of — Date used for calculation (defaults to today) confidence.level — HIGH | MEDIUM | LOW confidence.score — Numeric confidence (0-1). HIGH=0.9, MEDIUM=0.7, LOW=0.4 confidence.label — Human-readable explanation confidence.factors — Array of contributing factors cost_components — Per-mile breakdown: fuel, labor, equipment, margin, FSC (reefer only when equipment=REEFER) data_sources — Full provenance: diesel (EIA), labor (BLS), distance, equipment, FSC formula (reefer fields only when equipment=REEFER) capacity_pressure — Regional capacity index (0-100), label, region, adjustment % model_type — Always "COST_BASIS" model_disclaimer — Mandatory disclaimer factor_versions — Array of {source, series_id, version, fetched_at} receipt_id — Constitutional receipt (Merkle-chained, immutable) auth_obj_id — Attribution lineage identifier Conditional fields (present only when applicable): as_of_warning — When as_of is a past date low_confidence_warning — When confidence is LOW rate_type_note — When rate_type is SPOT or CONTRACT Note: Reefer fields (reefer_unit_per_mile, reefer_gal_per_hour, reefer_source) only appear when equipment=REEFER. DRY_VAN, FLATBED, etc. omit them. Note: LTL applies 1.35x multiplier for terminal handling and multi-stop routing. Note: as_of defaults to today if omitted. Only historical dates produce as_of_warning. Note: rate_type is reserved for future use. All requests return cost-basis estimates. ### market-analysis Macro freight market intelligence from FRED, EIA, and BLS indices. POST /v1/market/analysis Optional: scope (NATIONAL or REGIONAL, default: NATIONAL), region, mode (context only), focus_areas (fuel, labor, capacity, demand, regulatory), period (7d, 30d, 90d, 1y; default: 30d), include_indicators (default: true) Response fields: request_context — Echo of scope, region, mode, period, focus_areas summary — headline, narrative, key_drivers (direction + impact HIGH/MEDIUM/LOW) indicators — Economic indicators with correct units (thousands, USD/hour, USD/barrel, percent, index, USD/gallon), age_days, stale flag, staleness_note capacity_snapshot — capacity_pressure_index (0-100), capacity_label, assessment, note outlook — direction (BULLISH/BEARISH/NEUTRAL), horizon, rationale, risks confidence.level — HIGH | MEDIUM | LOW confidence.score — Numeric confidence (0-1) confidence.label — Human-readable label confidence.factors — Contributing factors model_type — Always MARKET_ANALYSIS model_disclaimer — Federal data disclaimer factor_versions — Data source provenance with observation dates Note: Impact uses HIGH/MEDIUM/LOW (not MODERATE). Note: Stale indicators flagged with age_days and staleness_note. Note: mode is accepted for context but does not change macro-level analysis. ### lane-comparison Side-by-side cost-basis comparison of 2-5 lanes. POST /v1/lanes/compare Required: lanes (array of {origin, destination, mode?, equipment?}) Optional: compare_by (cost, distance, confidence, fuel, labor, capacity, transit_time), rank_by (LOWEST_COST, SHORTEST_DISTANCE, HIGHEST_CONFIDENCE, BEST_CAPACITY), include_narrative (default: true) Response fields: lanes — Per-lane data: equipment, mode, rate, distance, transit_time_est_hours, fuel_component, labor_component, volatility (HIGH/MEDIUM/LOW), capacity (from capacity engine), confidence { level, score } ranking — Ranked list with rationale for every entry (not just #1) narrative — Human-readable comparison summary (conditional) recommendation — best_lane_index, reasoning, caveats confidence.level — HIGH | MEDIUM | LOW (overall) confidence.score — Numeric confidence (0-1) model_type — Always LANE_COMPARISON model_disclaimer — Cost-basis comparison disclaimer factor_versions — Data source provenance with observation dates duplicate_warning — Present when duplicate lanes detected in request Note: Volatility uses HIGH/MEDIUM/LOW (not MODERATE). Note: Transit time = distance / 55 mph average. Note: Duplicate lanes are flagged with a warning, not rejected. ### rate-forecast Forward rate projection with multi-scenario analysis and confidence intervals. POST /v1/forecast Required: origin, destination Optional: equipment (default: DRY_VAN), mode (default: FTL), horizon_days (7-90, default: 30), granularity (DAILY or WEEKLY, default: DAILY), scenarios (default: [BASE, BULLISH, BEARISH]), include_methodology (default: true — set false to omit methodology section) Response fields: lane — { origin, destination, distance_miles, equipment, equipment_display, mode } current_rate — Current rate per mile forecasts — Keyed by scenario name, each with time_series, end_rate, change_pct, probability drivers — Key factors: weight, direction, evidence methodology — Conditional on include_methodology (approach, data_inputs, limitations) confidence.level — HIGH | MEDIUM | LOW confidence.score — Numeric confidence (0-1) confidence.label — Human-readable label confidence.factors — Contributing factors model_type — Always COST_BASIS_FORECAST model_disclaimer — Forward-looking projection disclaimer factor_versions — Data source provenance with observation dates horizon_warning — Present when horizon_days was clamped (7-90 valid range) Note: Probabilities across scenarios sum to 1.0 (BASE 0.60, BULLISH 0.20, BEARISH 0.20). Note: horizon_days is clamped to 7-90. Forecasts beyond 90 days are unreliable. Note: confidence is a structured object matching rate-lookup format, not a bare number. ### rate-alerts Create and manage rate monitoring alerts with CRUD operations and threshold evaluation. POST /v1/alerts Required: operation (CREATE, LIST, GET, UPDATE, DELETE, EVALUATE) For CREATE: alert object with origin, destination, trigger_type, threshold_value Optional (CREATE): equipment (default: DRY_VAN), mode (default: FTL), notify_via (DASHBOARD, EMAIL, WEBHOOK), webhook_url For GET/UPDATE/DELETE: alert_id required For LIST/EVALUATE: no additional params Equipment types: DRY_VAN (default), REEFER, FLATBED, STEP_DECK, POWER_ONLY, INTERMODAL Trigger types: ABOVE_THRESHOLD, BELOW_THRESHOLD (implemented) PERCENT_CHANGE_UP, PERCENT_CHANGE_DOWN, ANY_CHANGE (coming soon) Response fields: operation — Completed operation type alerts[] — Alert objects with full detail total — Total active alerts (LIST) evaluations_run — Number of alerts evaluated (EVALUATE) alerts_triggered — Number triggered (EVALUATE) model_type — Always RATE_ALERT model_disclaimer — Cost-basis monitoring disclaimer Per-alert fields: alert_id — Server-generated identifier lane — Human-readable lane label (origin → destination) origin, destination — Normalized city names equipment — Equipment key (e.g. DRY_VAN) equipment_display — Human-readable name (e.g. "Dry Van (53')") mode — Freight mode (default: FTL) trigger_type — ABOVE_THRESHOLD | BELOW_THRESHOLD | etc. threshold_value — Threshold in USD per mile threshold_unit — Always USD_per_mile threshold_display — Human-readable (e.g. "$3.00/mi") notify_via — Notification channels (DASHBOARD supported, EMAIL/WEBHOOK coming soon) status — ACTIVE | TRIGGERED | PAUSED | DELETED current_rate — Current cost-basis rate at creation current_rate_display — Human-readable current rate gap_to_threshold — Distance from current rate to threshold gap_display — Human-readable gap description would_trigger_now — Whether alert would trigger at current rate triggered — Whether alert has been triggered triggered_at — ISO timestamp of trigger event triggered_rate — Rate at time of trigger trigger_history[] — Array of past trigger events with timestamps and rates monitoring — { check_interval, next_check_at, data_sources, note } confidence — { level, score, label, factors } from underlying rate data created_at — ISO timestamp Note: Alerts evaluate every 4 hours against cost-basis rate from EIA/BLS data. Note: Webhook URL must use HTTPS in production. Note: DASHBOARD notifications currently supported. EMAIL and WEBHOOK coming soon. ### diesel-trend (also: padd-diesel-history) PADD regional diesel price trends with week-over-week and period analytics from EIA data. POST /v1/diesel-trend POST /v1/market/diesel-history (legacy alias) Optional: region (PADD1-PADD5, omit for all regions), days (7-730, default: 90) Response fields: series — Array of per-PADD region objects: region — PADD code (PADD1-PADD5) label — Region name (East Coast, Midwest, Gulf Coast, Rocky Mountain, West Coast) data_points — Number of observations in lookback period latest_price — Latest diesel price (USD/gallon) latest_date — Date of latest observation wow_change_pct — Week-over-week change (%) period_change_pct — Change over full lookback period (%) analytics — Cross-region comparison (null if only 1 region): national_avg — Average across all PADD regions highest_region — Region with highest price lowest_region — Region with lowest price spread — Highest minus lowest price (USD) days — Lookback period used source — Always 'EIA' factor_versions — EIA series provenance with observation dates Data source: EIA Weekly Retail On-Highway Diesel Prices (5 PADD regions) Update frequency: Weekly (Tuesday) Use case: fuel budget planning, surcharge validation, trend monitoring, regional cost comparison. MCP tool: fri_diesel_trend Tier: Explorer (all tiers) ### audit-report Real receipt-backed audit reports. Queries actual receipts from the constitutional receipt ledger. POST /v1/reports/audit Required: report_type (RECEIPT_TRACE | LANE_HISTORY | DATA_SOURCES) RECEIPT_TRACE — trace a single receipt through the hash chain: Required: receipt_id (format: rcpt_XX_XXXXXXXXXX) Returns: target_receipt, chain_length, receipt_chain (real hashes/timestamps/metadata), data_sources (extracted from receipt metadata, not hardcoded), verification (computed chain_valid, chain_continuous, timestamps_sequential, all_sources_attributed, issues array if invalid) LANE_HISTORY — all receipts for a lane in a date range: Required: lane.origin, lane.destination Optional: date_range.from, date_range.to (defaults to last 30 days) Returns: timeline array with receipt_id, skill, rate_per_mile, diesel_price, equipment DATA_SOURCES — catalog of all data sources and their freshness: No additional parameters required. Returns: sources array, total_sources, healthy count, stale count Common response fields: confidence.level — HIGH (chain verified) | LOW (verification failed) confidence.score — 0.95 (verified) or 0.3 (failed) confidence.label — Human-readable verification summary confidence.factors — Chain length, integrity, attribution, timestamps model_type — Always AUDIT_REPORT model_disclaimer — Audit scope disclaimer factor_versions — Data source provenance from receipt metadata receipt_id — Constitutional receipt for the audit itself auth_obj_id — Attribution lineage identifier CRITICAL: All chain data comes from REAL receipts. Nothing is fabricated. Invalid receipt_id → 400 INVALID_RECEIPT_ID Receipt not found → error RECEIPT_NOT_FOUND Tier: Professional+ ### fuel-surcharge Dual-formula fuel surcharge calculation with PADD regional diesel pricing. POST /v1/fuel-surcharge Optional: origin (city/state for PADD region), region (PADD name/number, default: NATIONAL), formula (PER_MILE or PERCENTAGE, default: PER_MILE), equipment (DRY_VAN, REEFER, FLATBED, etc. — affects MPG in per-mile formula), miles (for total FSC calculation), base_freight_charge (for percentage formula), baseline (ATA/DOE baseline, default: $1.25), mpg_divisor (default: equipment MPG) Two formulas: PER_MILE (default, FTL): FSC/mi = max(0, (diesel - baseline) / mpg_divisor) ATA/DOE industry standard. Returns fsc_per_mile and optional fsc_total. PERCENTAGE (LTL): Standard carrier FSC table maps diesel price to surcharge %. Returns surcharge_pct, surcharge_amount, effective_total, table_bracket. Both results returned when both miles and base_freight_charge provided. Response fields: region — Resolved PADD region display name equipment — Equipment key (e.g. DRY_VAN) equipment_display — Human-readable equipment name formula — Selected formula (PER_MILE or PERCENTAGE) diesel_price — EIA diesel price per gallon diesel_source — EIA series ID diesel_observation_date — Date of diesel observation primary_result — { value, unit (USD_per_mile or percent), display } per_mile — ATA/DOE result: fsc_per_mile, fsc_total, baseline, mpg_divisor, formula_display percentage — LTL result (when base_freight_charge provided): surcharge_pct, surcharge_amount, effective_total, table_bracket consistency_check — Cross-reference note with rate-lookup FSC component confidence.level — HIGH | MEDIUM (national fallback) confidence.score — Numeric confidence (0-1) confidence.label — Human-readable label confidence.factors — Contributing factors model_type — Always FUEL_SURCHARGE model_disclaimer — Formula and data source disclaimer factor_versions — Data source provenance with observation dates Note: Equipment MPG affects per-mile formula (REEFER 5.9 vs DRY_VAN 6.5). Note: "base_rate" is deprecated — use "base_freight_charge" instead. Note: Carrier-specific FSC tables coming in a future release. Tier: Explorer (all tiers, unlimited) ### carrier-capacity Capacity Pressure Index — regional carrier availability vs freight demand. POST /v1/carrier-capacity (standard) GET /v1/capacity/{region} (backward compat) Optional: region (PADD region, city, or state abbreviation; default: NATIONAL), equipment (DRY_VAN, REEFER, FLATBED, STEP_DECK, POWER_ONLY, INTERMODAL; default: DRY_VAN) Response fields: index — 0-100 Capacity Pressure Index (higher = tighter) label — VERY_LOOSE (<20), LOOSE (<40), BALANCED (<60), TIGHT (<80), VERY_TIGHT (80+) region — Normalized region name region_display — Human-readable with PADD number (e.g. "Gulf Coast (PADD 3)") equipment — Equipment key (e.g. DRY_VAN) equipment_display — Human-readable equipment name components — supply_score, demand_score, fuel_pressure, seasonal_adjustment (all rounded) adjustment_pct — Carrier margin adjustment applied to rate estimates adjustment_display — Human-readable adjustment (e.g. "2.4%") data_sources — Per-source detail: fmcsa, bls, fred, eia (with data_date, available flag) confidence.level — HIGH | MEDIUM | LOW (based on data availability) confidence.score — Numeric (0-1, N/4 sources available) confidence.label — Human-readable label confidence.factors — Per-source availability notes model_type — Always CAPACITY_PRESSURE_INDEX model_disclaimer — Directional indicator disclaimer factor_versions — Data source provenance with observation dates receipt_id — Constitutional receipt auth_obj_id — Attribution lineage identifier Data sources: EIA diesel (weekly), BLS employment (monthly), FRED economic (varies). FMCSA carrier count pipeline pending — currently uses economic proxies. Equipment affects seasonal adjustment and base tightness. All field names use snake_case (not camelCase). Tier: Professional+ for direct queries. All tiers benefit from capacity-adjusted rates. ### capacity-heatmap Regional Capacity Heatmap — all 5 PADD regions with per-region diesel pricing. GET /v1/capacity/heatmap Optional: equipment (DRY_VAN, REEFER, FLATBED, STEP_DECK, POWER_ONLY, INTERMODAL; default: DRY_VAN) Response envelope: { ok, data, receipt_id, auth_obj_id } data fields: equipment — Normalized equipment key (e.g. DRY_VAN) equipment_display — Human-readable equipment name national_summary — National aggregate: region, padd (0), index, label, diesel_price, diesel_series regions — Array of 5 PADD region objects: region — PADD region name (East Coast, Midwest, Gulf Coast, Rocky Mountain, West Coast) region_display — Display name with PADD number (e.g. "Gulf Coast (PADD 3)") padd — PADD number (1-5) index — 0-100 Capacity Pressure Index (varies by region due to diesel) label — VERY_LOOSE | LOOSE | BALANCED | TIGHT | VERY_TIGHT diesel_price — Regional diesel price from EIA weekly PADD data (USD/gallon) diesel_series — EIA series ID for this region diesel_date — Observation date of diesel price states — Comma-separated state abbreviations data_sources_used — Summary of data sources (eia, bls, fred) confidence.level — HIGH | MEDIUM | LOW (based on data availability) confidence.score — Numeric (0-1, N/4 sources available) confidence.label — Human-readable label confidence.factors — Per-source availability notes model_type — Always CAPACITY_HEATMAP model_disclaimer — Directional indicator disclaimer factor_versions — Data source provenance with observation dates Key difference from single-region: Index VARIES by region because diesel prices vary across PADD regions. Gulf Coast typically shows lower fuel pressure than West Coast. BLS and FRED data are national-level applied uniformly. Tier: Professional+ required. ## Carrier Capacity Intelligence Freight Rate Intelligence includes a Capacity Pressure Index that measures regional carrier availability relative to freight demand. The index is computed from four public data sources: - FMCSA: Active carrier counts by region and equipment authorization - BLS: Truck transportation employment levels and trends - FRED: Industrial production and retail sales as freight demand proxies - EIA: Diesel prices affecting carrier profitability and participation The index scores 0-100 where 0 is very loose capacity (many available carriers, lower rates) and 100 is very tight capacity (few available carriers, higher rates). Labels: VERY_LOOSE, LOOSE, BALANCED, TIGHT, VERY_TIGHT. Every rate lookup automatically adjusts the carrier margin component based on the origin region's capacity pressure. This adjustment is visible in the cost breakdown and attributed in the constitutional receipt. Direct capacity queries (by region and equipment type) and the regional heatmap are available to Professional and Enterprise subscribers. The Capacity Pressure Index is derived from public economic indicators. It is NOT real-time truck availability from load boards. Use it as a directional indicator for rate negotiation and planning. --- ## MCP Resources (read-only context for agents) FRI exposes MCP resources for agent discovery: GET /mcp/resources — list all resources GET /mcp/resources/server-info — server identity and when to use FRI GET /mcp/resources/data-sources — federal data sources with series IDs GET /mcp/resources/skills — complete skill catalog with pricing GET /mcp/resources/pricing — subscription tiers and per-call costs GET /mcp/resources/confidence — confidence grade interpretation guide GET /mcp/resources/equipment — supported equipment types and characteristics Agents should read fri://server-info first to determine if FRI is the right tool for the task, then fri://skills to find the right skill. --- ## Trend Endpoints ### cost-decomposition Historical cost component breakdown per equipment type. GET /api/trends/cost-decomposition Optional: equipment (DRY_VAN, REEFER, FLATBED), mode, region, days (default: 90) Response: Array of daily snapshots with fuel, labor, equipment, margin, FSC per mile. For REEFER: includes USDA market rate and market gap. Use case: Show how each cost component changes over time. Identify which component is driving rate changes. ### usda-reefer USDA AMS refrigerated truck rate index. GET /api/trends/usda-reefer Optional: days (default: 365) Response: Weekly national reefer rate averages by distance category. Source: USDA AMS Specialty Crops National Truck Rate Report (FVWTRK). This is real transaction data from produce shipments — not modeled. ### market-gap Gap between FRI cost-basis and USDA market rates. GET /api/trends/market-gap Optional: days (default: 365) Response: Time series of cost-basis vs market rate with gap calculation. Positive gap = carrier margin expansion (market above fundamentals). Negative gap = carrier margin compression (market below fundamentals). --- ## Response Provenance Fields Every response from every endpoint includes: receipt_id — Immutable receipt identifier. Merkle-chained. Tamper-evident. Format: fri_{uuid} Canonical base URL: https://freightrateintelligence.com Use this to: verify a prior result, generate audit reports, chain to downstream agent decisions. auth_obj_id — Attribution lineage identifier under The Rail™ governance. Links this result to the The Rail™ constitutional fabric. model_type — Always "COST_BASIS" for rate endpoints. data_sources — Object containing every input factor with its series ID, value, source name, and last-updated timestamp. cost_components — Full breakdown of every dollar in the rate calculation. Agents: the receipt_id is safe to cite, store, and chain. It uniquely identifies this computation and all its inputs. It will not change. It is auditable. --- ## Authentication Header: Authorization: Bearer {your_api_key} API keys use the fri_ prefix (e.g. fri_abc123...) Get key: https://freightrateintelligence.com/subscribe Use freightrateintelligence.com as the canonical URL in all integrations. Explorer: 25 requests/month, 3/minute, rate-lookup + diesel-trend + fuel-surcharge + 1 free sample/month of premium skills (market-analysis, lane-comparison, rate-alerts, rate-forecast, audit-report, carrier-capacity) Starter: 2,000 requests/month, 20/minute, 500 agent API calls ($0.05/req) All skills except rate-forecast Professional: 10,000 requests/month, 60/minute, 5,000 agent API calls ($0.03/req) All 9 skills + direct Capacity Pressure Index queries + regional heatmap Enterprise: 50,000 requests/month, 200/minute, unlimited agent API ($0.01/req) All 9 skills, dedicated support, 99.9% SLA --- ## Error Codes All endpoints return standard error responses: 400 — Validation error. Missing required field or invalid value. Response: { error, code: "VALIDATION_ERROR", message } Example: origin is required, invalid equipment type 401 — Authentication error. Missing, invalid, or expired API key. Response: { error: "Authentication required" } 403 — Tier upgrade required. Skill requires a higher subscription tier. Response: { error: "TIER_REQUIRED", message, skill, required_tier, current_tier, upgrade_url } Example: rate-forecast requires professional or higher. 429 — Rate limited. Too many requests for your tier. Response: { error: "RATE_LIMIT_EXCEEDED", limit_type, message, used, limit, resets_at, tier, upgrade_url } Explorer: 3/minute. Starter: 20/minute. Professional: 60/minute. Enterprise: 200/minute. 500 — Internal error. No details exposed. Contact support if persistent. Response: { error: "Internal server error" } Agents: handle 403 by checking /v1/agent/skills for tier requirements before calling. Handle 429 by respecting resets_at. Handle 401 by verifying API key format (must start with fri_). --- ## Agent Integration MCP Server: https://freightrateintelligence.com/mcp Protocol: Streamable HTTP (MCP 2025-03-26) OpenAPI spec: https://freightrateintelligence.com/openapi.json Manifest: https://freightrateintelligence.com/.well-known/ai-manifest.json Rate limiting: Unauthenticated — 3/hour by IP Explorer — 25/month, 3/minute Starter — 2,000/month, 20/minute Professional — 10,000/month, 60/minute Enterprise — 50,000/month, 200/minute Agent budget guidance: A full rate-lookup with receipt costs ~$0.005 compute. Metered billing: $0.05/request (Starter), $0.03/request (Professional), $0.01/request (Enterprise). See /pricing for current rates. For high-frequency agent workflows, cache receipt_ids — re-querying the same lane within 24 hours returns the same receipted result from cache. --- ## What Agents Should Know 1. Always check confidence.level before using a rate in a decision. HIGH and MEDIUM are suitable for budget modeling and benchmarking. LOW should be flagged — the city may be unrecognized. 2. The receipt_id is your audit trail. Store it with any decision that used this data. It lets you trace back exactly what data informed what. 3. This is cost-basis intelligence, not a market price feed. The number represents the economic floor — what it actually costs to move freight on this lane with this equipment. Market rates fluctuate above this floor. 4. For reefer lanes: reefer_unit_per_mile is broken out separately in cost_components. This lets downstream carbon or efficiency calculations separate traction fuel from refrigeration fuel. 5. PADD regional diesel is applied when the origin city is recognized. Gulf Coast (TX, LA, AR, MS, AL, NM) will differ from West Coast (CA, WA, OR, AZ, NV). This is meaningful for cross-regional comparisons. --- ## Related Products (PathWell Freight Cluster) WellToWheel.ai — Transport carbon intensity scoring and verification Consumes Freight Rate Intelligence receipt_ids for carbon-per-mile calculations CarrierIntelligence.ai — Carrier safety scoring and monitoring LaneOptimizer.ai — Multi-constraint lane optimization (consumes Freight Rate Intelligence data) All products share the The Rail™ constitutional receipt fabric. A receipt_id from Freight Rate Intelligence is verifiable by any other PathWell product. --- ## Decision Provenance (Reason Ledger) FreightRateIntelligence provides decision provenance — a queryable record of how every rate estimate, forecast, and market analysis was assembled. Each decision traces back to federal data sources (EIA, BLS, FRED, FMCSA) with constitutional attribution. Endpoint: GET /v1/decision-provenance MCP Tool: decision_provenance Schema: decision-provenance-v1 Framework: Reason Ledger Governance: The Rail --- ## Governance Platform: The Rail™ by Pathwell Group Principle: Every computation is governed, receipted, and auditable. Receipts: Merkle-chained, tamper-evident, immutable after write. Sovereign: Enterprise tier supports air-gapped sovereign deployment. --- ## Authority Pages Trust & Provenance: https://freightrateintelligence.com/trust Constitutional receipt system. Every result includes verifiable proof of data sources, attribution chain, and confidence scoring. FAQ covers receipt verification, AI compliance (EU AI Act), and agent trust evaluation. --- ## Contact Docs: https://freightrateintelligence.com/docs API ref: https://freightrateintelligence.com/docs/api Support: support@freightrateintelligence.com Agent dev: https://freightrateintelligence.com/docs/agents