Quick Start

One key. One shape. Every ELD, TMS platform and insurer.

1. Authenticate

X-Api-Key: your-api-key

2. Call the API

curl -H "X-Api-Key: your-api-key" https://fennecmesh.com/v1/vehicles

3. Connect an AI agent

POST https://fennecmesh.com/mcp

Need the provider's own payload?

Every entity read accepts ?include_raw=true (MCP: include_raw on read tools). Each entity gains raw: { provider, fetched_at, payload } next to the normalized fields — the provider's own shape (Motive, Samsara, Geotab, Omnitracs, McLeod, Tai, Turvo, insurer portals, FMCSA Socrata rows), regenerated on demand and not stored. Raw payloads are opaque passthrough: provider-specific, may differ per provider, and carry no stability guarantee.

curl -H "X-Api-Key: …" https://fennecmesh.com/v1/vehicles?include_raw=true

Authentication

All endpoints require an X-Api-Key header. The sandbox key is shared with the console.

AI Agents (MCP)

FennecMesh speaks MCP natively — 18 tools over live freight data. Point Claude, Cursor, or any MCP client at /mcp.

Agent bootstrap prompt·paste into any AI agent
You have access to FennecMesh, a freight data API, via MCP.

## Connection
URL: https://fennecmesh.com/mcp
Header: X-Api-Key: your-api-key
Transport: HTTP (Streamable, stateless)

## What you have access to
18 tools over live freight data — including:
- fennecmesh_overview (fleet KPIs)
- list_vehicles (every truck, live)
- get_load (stops + live tracking, ETA)
- verify_insurance (verdict + ELD cross-check)
- fmcsa_lookup (live government filings)
- create_invitation (onboard a carrier)

## How to use it
Call tools via JSON-RPC tools/call.
Data is normalized (speed_mph, ISO-8601 UTC).
Read tools accept include_raw: true (provider's own payload).
HOS is planning info; the ELD is the legal record.

Start with fennecmesh_overview to see fleet status.
Client config·18 tools
{
  "mcpServers": {
    "fennecmesh": {
      "type": "http",
      "url": "https://fennecmesh.com/mcp",
      "headers": { "X-Api-Key": "your-api-key" }
    }
  }
}
fennecmesh_overviewlist_vehiclesget_loadverify_insurancecreate_invitation+13 more

telematics API

10 endpoints

GET/v1/overview

Fleet KPIs: counts, violations, freshness

GET/v1/vehicles

Every vehicle with driver, duty, position

include_raw — true — also return the provider's own payload in an opaque `raw` field

GET/v1/vehicles/{id}

One vehicle with recent inspections

include_raw — true — also return the provider's own payload in an opaque `raw` field

GET/v1/vehicles/{id}/locations

Breadcrumb history with derived stops

start — ISO timestamp

end — ISO timestamp

include_raw — true — also return the provider's own payload in an opaque `raw` field

GET/v1/locations/latest

Latest position for every vehicle

include_raw — true — also return the provider's own payload in an opaque `raw` field

GET/v1/drivers

Drivers with HOS clocks (FMCSA rules)

include_raw — true — also return the provider's own payload in an opaque `raw` field

GET/v1/drivers/{id}/hos

8-day duty log with violations

include_raw — true — also return the provider's own payload in an opaque `raw` field

GET/v1/hos/violations

Drivers currently in violation

include_raw — true — also return the provider's own payload in an opaque `raw` field

GET/v1/inspections

DVIR inspections with defects

include_raw — true — also return the provider's own payload in an opaque `raw` field

GET/v1/inspections/{id}

One inspection with its full defect list

include_raw — true — also return the provider's own payload in an opaque `raw` field

tms API

3 endpoints

GET/v1/tms/summary

In transit, delivering today, uncovered, late, revenue

GET/v1/tms/loads

Loads from every TMS in one model

status — available, covered, dispatched, at_pickup, in_transit, at_delivery, delivered, invoiced

include_raw — true — also return the provider's own payload in an opaque `raw` field

GET/v1/tms/loads/{id}

One load with stops and live tracking

include_raw — true — also return the provider's own payload in an opaque `raw` field

insurance API

4 endpoints

GET/v1/insurance/verify/{dot}

Full verification verdict with checks and ELD cross-check

include_raw — true — also return the provider's own payload in an opaque `raw` field

GET/v1/insurance/verified

Every verified carrier with verdict

GET/v1/insurance/{q}

Live FMCSA L&I lookup

q — USDOT or MC docket

include_raw — true — also return the provider's own payload in an opaque `raw` field

GET/v1/insurance/watchlist

Watched carriers, re-checked every 6 hours

platform API

4 endpoints

GET/v1/connections

Every connection with status and freshness

GET/v1/invitations

Carrier invitations with links

POST/v1/invitations

Create a carrier invitation

POST/v1/connections

Connect a TMS or insurer directly