A public, read-only API for overland trip planning. Plan a route, scan it for wildfire, air quality and weather, and search campsites. Every response carries an evidence envelope — where each fact came from, when it was observed, and how fresh it is.
https://www.mytrailsync.com/api/v1https://www.mytrailsync.com/api/mcp/routesplan_routePlan a driving route between two points, with optional vias.
originrequired— Place name ("Bishop, CA") or [lng, lat].destinationrequired— Place name or [lng, lat].vias— Up to 10 intermediate points.dates— { start, end } (YYYY-MM-DD).rig— Accepted; does not yet alter routing.curl -X POST https://www.mytrailsync.com/api/v1/routes \
-H "Content-Type: application/json" \
-d '{"origin":"Bishop, CA","destination":"Lee Vining, CA"}'{
"request_id": "req_...",
"generated_at": "2026-09-21T18:00:00Z",
"expires_at": null,
"data": {
"distance_mi": 57.4,
"duration_min": 71,
"geometry": { "type": "LineString", "coordinates": [ ... ] }
},
"sources": [{ "name": "Mapbox Directions" }],
"warnings": [],
"next_actions": ["scan_route_risks", "search_campsites"]
}/risk-scanscan_route_risksScan a route corridor for wildfire, air quality, weather, and burn restrictions (published restriction orders, NWS Red Flag Warnings, and the land managers who set fire rules). A missing reading is reported as unknown, never as safe.
route / route_id / from + torequired— Supply one: a [lng,lat][] line, a route_id from plan_route, or from + to place names.corridor_mi— Scan width, 5 to 100 (default 30).departure_window— { start, end } (ISO date-time).curl -X POST https://www.mytrailsync.com/api/v1/risk-scan \
-H "Content-Type: application/json" \
-d '{"from":"Bishop, CA","to":"Lee Vining, CA"}'{
"request_id": "req_...",
"generated_at": "2026-09-21T18:00:00Z",
"data": {
"wildfire": { "status": "active", "nearest_mi": 33, "name": "DOME" },
"air": { "status": "moderate", "aqi": 74, "source": "Open-Meteo (incl. smoke)" },
"weather": { "temp_f": 61, "conditions": "clear" },
"burn_restrictions": {
"status": "unknown",
"summary": "No published restriction feed covers this route. Fire rules here are set by Inyo National Forest and BLM California.",
"land_managers": [{ "agency": "USFS", "unit": "Inyo National Forest", "check_url": "https://www.fs.usda.gov/r05/inyo/alerts" }],
"red_flag_alerts": [], "orders": []
}
},
"sources": [ ... ],
"warnings": [],
"next_actions": []
}/campsitessearch_campsitesSearch campsites near a point or along a planned route. Each result is tagged with source, confirmation status, and confidence.
lat, lng— Point mode: search around a coordinate.from, to— Route mode: origin and destination place names.radius_km— Point mode radius, 5 to 250 (default 80).source— all | osm | community (default all).min_rig_length_ft— Your rig length (ft). Drops sites known to be too short; others are marked rig_fit fits or unknown.limit— 1 to 200 (default 100).curl "https://www.mytrailsync.com/api/v1/campsites?lat=37.94&lng=-119.03&radius_km=30&min_rig_length_ft=38"{
"request_id": "req_...",
"generated_at": "2026-09-21T18:00:00Z",
"data": {
"campsites": [
{
"name": "Oh Ridge Campground",
"coordinates": [-119.061, 37.794],
"source": "osm",
"confirmation": "osm_mapped",
"confidence": "medium"
}
]
},
"sources": [{ "name": "OpenStreetMap" }, { "name": "TrailSync community" }],
"warnings": [],
"next_actions": []
}/ski-areasfind_ski_areasRank western US ski areas within a drive time by forecast snowfall. Each result carries the numbers behind its rank: forecast snow, overnight low, drive time, pass, avalanche rating and community campsites nearby. Snow totals are model forecasts, not resort snow reports.
fromrequired— Place name ("Reno, NV") or [lng, lat].max_drive_hours— 1 to 10 (default 5).days— Forecast window, 1 to 7 (default 3).pass— epic | ikon.rig_length_ft— Rig length as driven (ft); counts nearby campsites with a recorded limit that fits.limit— 1 to 12 (default 8).curl -X POST https://www.mytrailsync.com/api/v1/ski-areas \
-H "Content-Type: application/json" \
-d '{"from":"Reno, NV","max_drive_hours":4}'{
"request_id": "req_...",
"generated_at": "2026-10-19T20:20:48Z",
"data": {
"from": { "label": "Reno, Nevada, United States", "center": [-119.81, 39.53] },
"considered": 15,
"results": [
{
"rank": 1, "name": "Mammoth Mountain", "state": "CA", "pass": "ikon",
"snow_in": 0.6, "low_f": 28, "drive_minutes": 196, "drive_miles": 167.7,
"avalanche": { "danger": "no rating", "center": "Eastern Sierra Avalanche Center" },
"overnight": { "total": 42, "fits": 0, "unknown_length": 42 },
"reasons": ["0.6 in of snow forecast over 3 days", "3 h 16 min drive, 168 mi"]
}
]
},
"sources": [ ... ],
"warnings": ["Snow totals are model forecasts at each ski area, not resort snow reports. ..."],
"next_actions": ["scan_winter_conditions", "search_campsites"]
}/winter-scanscan_winter_conditionsWinter conditions for a drive: Caltrans chain controls (quoted verbatim) and the state DOT to check elsewhere, NWS winter alerts, forecast snow along the route, nights below freezing at the destination, and the avalanche center rating. Unknown is reported as unknown, never clear.
route / route_id / from + torequired— Supply one: a [lng,lat][] line, a route_id from plan_route, or from + to. A [lng, lat] to is also the destination forecast point.days— Forecast window, 1 to 7 (default 3).curl -X POST https://www.mytrailsync.com/api/v1/winter-scan \
-H "Content-Type: application/json" \
-d '{"from":"Reno, NV","to":"Mammoth Lakes, CA"}'{
"request_id": "req_...",
"generated_at": "2026-10-19T20:20:57Z",
"data": {
"route_label": "Reno, Nevada, United States -> Mammoth Lakes, California, United States",
"winter": {
"status": "no_winter_hazard_found",
"summary": "No meaningful snow forecast on the route over 3 days. Freezing nights at the destination, low 28°F. ...",
"chain_controls": { "status": "unknown", "stations": [], "stations_checked": 40,
"check_with": [{ "state": "NV", "agency": "Nevada DOT (NVroads)", "url": "https://www.nvroads.com/" }] },
"alerts": [],
"snow": { "status": "ok", "route_max_in": 0.6 },
"destination": { "nights_below_32f": 3, "coldest_low_f": 28 },
"avalanche": [{ "center": "Eastern Sierra Avalanche Center", "danger": "no rating", "danger_level": -1 }],
"rig_notes": ["3 nights below freezing at the destination (low 28°F). ..."]
}
},
"sources": [ ... ],
"warnings": [],
"next_actions": ["search_campsites", "scan_route_risks"]
}Every successful response is wrapped in the same shape, so an agent can cite and age-check any fact it uses:
request_id — trace id for support.generated_at — when the response was built.expires_at — when volatile results go stale; null if stable.data — the endpoint payload.sources — name, url, and observed_at for each fact.warnings — degraded sources or partial results.next_actions — suggested follow-up calls.| Code | HTTP | Meaning |
|---|---|---|
| VALIDATION_ERROR | 400 | A required field is missing or malformed. |
| SOURCE_UNAVAILABLE | 503 | An upstream data source could not be read. |
| RATE_LIMITED | 429 | Over 30 requests/minute from one IP. |
| NOT_FOUND | 404 | A route_id was not in the cache. |
| METHOD_NOT_ALLOWED | 405 | Wrong HTTP method for the endpoint. |
| UPSTREAM_ERROR | 502 | A provider returned an unexpected error. |
A missing risk reading is always reported as unknown, never as safe. Treat every campsite as a starting point and verify current conditions, fees and legality with the land manager before you go.
This is the public read-only surface. Account-linked features — rig telemetry, saving a trip, and Pro checkout — arrive in later releases behind OAuth. Questions: rr@roamresilient.com.