Weather decisions for outdoor plans: should I go, when, what to wear, what you will meet en route.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
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.
What to wear for an activity at a time and place, short and practical, followed by the weather it rests on. It dresses you for the effort, not just the temperature: a runner is warmer than a person standing still at the same feels-like, and the same rules as the website's outfit card apply. Optional: intensity, and preferences such as { "feel": "runs_cold" } or { "avoid": ["shorts"] }.
imperial (F, mph, inches) or metric (C, km/h, mm). Defaults to imperial in the United States and metric elsewhere.
What the person is doing, if known. One of: walking, hiking, trail_running, road_running, cycling, camping, hunting, fishing, yard_work, construction, painting_finishing, general_outdoor. Plain words work too ("run", "hike", "stain the deck"). "Running" with no more words is treated as road_running.
Latitude in degrees. Use with longitude instead of location.
A place name such as "Glenbeulah, WI" or "Greenbush, Wisconsin", or coordinates as "43.79,-88.05". Add the state or country for small towns, because a bare "Greenbush" matches several places.
How hard the effort is, which changes what to wear. Defaults to the usual effort for the activity.
Longitude in degrees, west negative. Use with latitude instead of location.
When. Defaults to now. An ISO 8601 time such as 2026-10-03T18:00:00-05:00 (read in the place's own time zone when it has no offset), or plain words: "now", "tonight", "tomorrow morning", "Saturday", "6 PM", "between 6 PM and midnight". A bare hour with no AM or PM is refused rather than guessed.
Optional: { "feel": "runs_cold" | "runs_warm", "avoid": ["shorts"] }.
How long they will be out. Defaults to the usual length for the activity.
What to wear for an activity at a time and place, short and practical, followed by the weather it rests on. It dresses you for the effort, not just the temperature: a runner is warmer than a person standing still at the same feels-like, and the same rules as the website's outfit card apply. Optional: intensity, and preferences such as { "feel": "runs_cold" } or { "avoid": ["shorts"] }.
| Argument | Type | Description |
|---|---|---|
| units | string | imperial (F, mph, inches) or metric (C, km/h, mm). Defaults to imperial in the United States and metric elsewhere. |
| activity | string | What the person is doing, if known. One of: walking, hiking, trail_running, road_running, cycling, camping, hunting, fishing, yard_work, construction, painting_finishing, general_outdoor. Plain words work too ("run", "hike", "stain the deck"). "Running" with no more words is treated as road_running. |
| latitude | number | Latitude in degrees. Use with longitude instead of location. |
| location | string | A place name such as "Glenbeulah, WI" or "Greenbush, Wisconsin", or coordinates as "43.79,-88.05". Add the state or country for small towns, because a bare "Greenbush" matches several places. |
| intensity | string | How hard the effort is, which changes what to wear. Defaults to the usual effort for the activity. |
| longitude | number | Longitude in degrees, west negative. Use with latitude instead of location. |
| start_time | string | When. Defaults to now. An ISO 8601 time such as 2026-10-03T18:00:00-05:00 (read in the place's own time zone when it has no offset), or plain words: "now", "tonight", "tomorrow morning", "Saturday", "6 PM", "between 6 PM and midnight". A bare hour with no AM or PM is refused rather than guessed. |
| preferences | object | Optional: { "feel": "runs_cold" | "runs_warm", "avoid": ["shorts"] }. |
| duration_hours | number | How long they will be out. Defaults to the usual length for the activity. |
{
"type": "object",
"properties": {
"units": {
"enum": [
"imperial",
"metric"
],
"type": "string",
"description": "imperial (F, mph, inches) or metric (C, km/h, mm). Defaults to imperial in the United States and metric elsewhere."
},
"activity": {
"type": "string",
"maxLength": 60,
"description": "What the person is doing, if known. One of: walking, hiking, trail_running, road_running, cycling, camping, hunting, fishing, yard_work, construction, painting_finishing, general_outdoor. Plain words work too (\"run\", \"hike\", \"stain the deck\"). \"Running\" with no more words is treated as road_running."
},
"latitude": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Latitude in degrees. Use with longitude instead of location."
},
"location": {
"type": "string",
"maxLength": 120,
"description": "A place name such as \"Glenbeulah, WI\" or \"Greenbush, Wisconsin\", or coordinates as \"43.79,-88.05\". Add the state or country for small towns, because a bare \"Greenbush\" matches several places."
},
"intensity": {
"enum": [
"low",
"moderate",
"high"
],
"type": "string",
"description": "How hard the effort is, which changes what to wear. Defaults to the usual effort for the activity."
},
"longitude": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitude in degrees, west negative. Use with latitude instead of location."
},
"start_time": {
"type": "string",
"maxLength": 80,
"description": "When. Defaults to now. An ISO 8601 time such as 2026-10-03T18:00:00-05:00 (read in the place's own time zone when it has no offset), or plain words: \"now\", \"tonight\", \"tomorrow morning\", \"Saturday\", \"6 PM\", \"between 6 PM and midnight\". A bare hour with no AM or PM is refused rather than guessed."
},
"preferences": {
"type": "object",
"properties": {
"feel": {
"enum": [
"runs_cold",
"runs_warm",
"neutral"
],
"type": "string"
},
"avoid": {
"type": "array",
"items": {
"type": "string"
}
},
"notes": {
"type": "string",
"maxLength": 200
}
},
"description": "Optional: { \"feel\": \"runs_cold\" | \"runs_warm\", \"avoid\": [\"shorts\"] }."
},
"duration_hours": {
"type": "number",
"maximum": 72,
"minimum": 0.25,
"description": "How long they will be out. Defaults to the usual length for the activity."
}
}
}Explains weather in plain terms for conversation: why it feels colder than the temperature, whether rain will matter on a hike, whether wind matters, whether the trail will be muddy, humidity, fog, frost, pressure. It separates what the forecast says (facts, each labelled forecast or formula) from what we are reasoning (inferences, each with its basis and how sure we are) and lists what we cannot see (unknowns). Pass the question as asked, or a topic. If it cannot tell what was asked it says so and gives the general picture.
| Argument | Type | Description |
|---|---|---|
| topic | string | The topic, if you know it. Otherwise it is read from the question. |
| units | string | imperial (F, mph, inches) or metric (C, km/h, mm). Defaults to imperial in the United States and metric elsewhere. |
| activity | string | What the person is doing, if known. One of: walking, hiking, trail_running, road_running, cycling, camping, hunting, fishing, yard_work, construction, painting_finishing, general_outdoor. Plain words work too ("run", "hike", "stain the deck"). "Running" with no more words is treated as road_running. |
| latitude | number | Latitude in degrees. Use with longitude instead of location. |
| location | string | A place name such as "Glenbeulah, WI" or "Greenbush, Wisconsin", or coordinates as "43.79,-88.05". Add the state or country for small towns, because a bare "Greenbush" matches several places. |
Compatibility tool for ChatGPT connectors. Returns the weather for an id from `search`. For real use prefer get_weather.
| Argument | Type | Description |
|---|---|---|
| id* | string | An id from `search`, like place:43.79,-88.05. |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 60,
"description": "An id from `search`, like place:43.79,-88.05."
}
}
}Finds the best time on a day for an activity. Returns the best window, an alternate, and any clearly bad stretch, each with a short reason. Windows are stretches, not exact hours: when several start times are about equally good they are reported as one stretch, and when the whole day is about the same it says so. Use it for "when should I go?", "what's the best time Saturday?", "Kilian and I want to hike Saturday". Give a date such as "Saturday", "tomorrow" or 2026-10-03. If nothing on the day is good it says so and names the least bad stretch.
| Argument | Type | Description |
|---|---|---|
| date | string | The day to search. Defaults to today. A part of a day ("tomorrow morning") narrows the search to it, and "this weekend" compares both days. An ISO 8601 time such as 2026-10-03T18:00:00-05:00 (read in the place's own time zone when it has no offset), or plain words: "now", "tonight", "tomorrow morning", "Saturday", "6 PM", "between 6 PM and midnight". A bare hour with no AM or PM is refused rather than guessed. |
| units | string | imperial (F, mph, inches) or metric (C, km/h, mm). Defaults to imperial in the United States and metric elsewhere. |
| activity* | string | What the person is doing. One of: walking, hiking, trail_running, road_running, cycling, camping, hunting, fishing, yard_work, construction, painting_finishing, general_outdoor. Plain words work too ("run", "hike", "stain the deck"). "Running" with no more words is treated as road_running. |
| latitude | number | Latitude in degrees. Use with longitude instead of location. |
The forecast for a stretch of time: "What's Saturday looking like?", "What will conditions be between 6 PM and midnight?", "this weekend". Give start_time (and optionally end_time or duration_hours). Returns a one-line summary, the temperature range, rain, wind, any conditions worth acting on, and the hourly and daily rows. The forecast reaches about seven days. Beyond that it says so and does not guess.
| Argument | Type | Description |
|---|---|---|
| units | string | imperial (F, mph, inches) or metric (C, km/h, mm). Defaults to imperial in the United States and metric elsewhere. |
| end_time | string | When the period ends, in the same formats as start_time. "midnight" means the next midnight. |
| latitude | number | Latitude in degrees. Use with longitude instead of location. |
| location | string | A place name such as "Glenbeulah, WI" or "Greenbush, Wisconsin", or coordinates as "43.79,-88.05". Add the state or country for small towns, because a bare "Greenbush" matches several places. |
| longitude | number | Longitude in degrees, west negative. Use with latitude instead of location. |
| start_time | string | When the period starts. Defaults to now. An ISO 8601 time such as 2026-10-03T18:00:00-05:00 (read in the place's own time zone when it has no offset), or plain words: "now", "tonight", "tomorrow morning", "Saturday", "6 PM", "between 6 PM and midnight". A bare hour with no AM or PM is refused rather than guessed. |
Weather for a trail over time, sampled along the trail rather than at one point: starting conditions, how the temperature changes through the trip, rain windows, wind and gusts, humidity and dew point, wind chill and heat index, sunrise, sunset, twilight, the moon, significant changes, alerts, and what to wear and carry. Give a trail_id (call list_trails) or the route itself, plus start_time and a pace or total_duration_hours. Returns a timeline every two hours and a bottom line. It does not know the terrain, shade or exposure unless the trail record says so, and it says that.
| Argument | Type | Description |
|---|---|---|
| gpx | string | The text of a GPX file (track points). Up to about 450 KB. |
| pace | object | How fast the person moves, as a value and a unit. |
| units | string | imperial (F, mph, inches) or metric (C, km/h, mm). Defaults to imperial in the United States and metric elsewhere. |
| geojson | any | GeoJSON as an object or a string: a LineString, MultiLineString, or Features holding them. Longitude first, as GeoJSON has it. |
| activity | string | What the person is doing, if known. One of: walking, hiking, trail_running, road_running, cycling, camping, hunting, fishing, yard_work, construction, painting_finishing, general_outdoor. Plain words work too ("run", "hike", "stain the deck"). "Running" with no more words is treated as road_running. |
| polyline |
Plain-language weather for a place: one sentence first, then current conditions, the next 24 hours, the next 7 days, and official alerts. Use it for "what's the weather", "do I need a jacket", "is it going to rain". For a decision about doing something outdoors (a run, a hike, staining a deck), use outdoor_activity_weather instead: it answers "should I?", not just "what is it?". `data.current` says whether it is a station observation, a model estimate, or a forecast hour. `data.alerts.status` says whether "no alerts" can be believed: only "ok" means we checked. Answers carry their sources, how old the data is, and say so when it came from cache.
| Argument | Type | Description |
|---|---|---|
| hours | integer | Hours of hourly detail to include. Default 24. |
| units | string | imperial (F, mph, inches) or metric (C, km/h, mm). Defaults to imperial in the United States and metric elsewhere. |
| latitude | number | Latitude in degrees. Use with longitude instead of location. |
| location | string | A place name such as "Glenbeulah, WI" or "Greenbush, Wisconsin", or coordinates as "43.79,-88.05". Add the state or country for small towns, because a bare "Greenbush" matches several places. |
| longitude | number | Longitude in degrees, west negative. Use with latitude instead of location. |
{
"type": "object",
"properties": {
"hours": {
"type": "integer",
"maximum": 72,
"minimum": 1,
"description": "Hours of hourly detail to include. Default 24."
},
"units": {
"enum": [
"imperial",
"metric"
],
"type": "string",
"description": "imperial (F, mph, inches) or metric (C, km/h, mm). Defaults to imperial in the United States and metric elsewhere."
},
"latitude": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Latitude in degrees. Use with longitude instead of location."
},
"location": {
"type": "string",
"maxLength": 120,
"description": "A place name such as \"Glenbeulah, WI\" or \"Greenbush, Wisconsin\", or coordinates as \"43.79,-88.05\". Add the state or country for small towns, because a bare \"Greenbush\" matches several places."
},
"longitude": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitude in degrees, west negative. Use with latitude instead of location."
}
}
}Lists the trails WTDS knows by name, with length, bounds and whether we have data on which sections are exposed. Use a trail's id as trail_id in get_trail_weather or route_weather. If a trail is not listed, send the route itself.
No arguments.
{
"type": "object",
"properties": {}
}Our flagship tool. Turns weather into a decision for a specific outdoor activity: a practical verdict (go, go_with_caveats, marginal, no_go), a one-sentence reason, the temperature and feels-like range, rain, wind, sunset, what to wear, and the concerns. Activities: walking, hiking, trail_running, road_running, cycling, camping, hunting, fishing, yard_work, construction, painting_finishing, general_outdoor. Give a start_time and a duration_hours, or a phrase like "tomorrow morning". If you name a whole day ("Saturday"), it finds and judges the best window inside it. It keeps the forecast apart from our advice, says what it is inferring (mud, ice, fog) and what it cannot know (the trail surface), and an official warning overrides everything. To find WHEN to go, use find_best_weather_window.
| Argument | Type | Description |
|---|---|---|
| units | string | imperial (F, mph, inches) or metric (C, km/h, mm). Defaults to imperial in the United States and metric elsewhere. |
| activity* | string | What the person is doing. One of: walking, hiking, trail_running, road_running, cycling, camping, hunting, fishing, yard_work, construction, painting_finishing, general_outdoor. Plain words work too ("run", "hike", "stain the deck"). "Running" with no more words is treated as road_running. |
| latitude | number | Latitude in degrees. Use with longitude instead of location. |
| location | string | A place name such as "Glenbeulah, WI" or "Greenbush, Wisconsin", or coordinates as "43.79,-88.05". Add the state or country for small towns, because a bare "Greenbush" matches several places. |
What weather you will meet as you move along a route, at the moment you reach each part of it. Not "the weather on the trail" but "what will I encounter, where, and when". Accepts a known trail_id, a GPX file, GeoJSON, an encoded polyline, coordinates, or place names. With a start_time and a pace it works out when you reach each checkpoint, reads the forecast for that place at that time, and reports what changes: rain starting, the cold coming in, the light going. For someone already out there, pass `progress` (how far they are, or where) and it answers for the rest of the route from now. Returns checkpoints with arrival time, place, weather and light, the changes, and a bottom line. Use get_trail_weather for an hour-by-hour timeline and clothing advice.
| Argument | Type | Description |
|---|---|---|
| gpx | string | The text of a GPX file (track points). Up to about 450 KB. |
| pace | object | How fast the person moves, as a value and a unit. |
| units | string | imperial (F, mph, inches) or metric (C, km/h, mm). Defaults to imperial in the United States and metric elsewhere. |
| geojson | any | GeoJSON as an object or a string: a LineString, MultiLineString, or Features holding them. Longitude first, as GeoJSON has it. |
| activity | string | What the person is doing, if known. One of: walking, hiking, trail_running, road_running, cycling, camping, hunting, fishing, yard_work, construction, painting_finishing, general_outdoor. Plain words work too ("run", "hike", "stain the deck"). "Running" with no more words is treated as road_running. |
Compatibility tool for ChatGPT connectors. Finds places matching a query and returns ids to pass to `fetch`. For real use prefer get_weather, outdoor_activity_weather and the other tools, which answer directly.
| Argument | Type | Description |
|---|---|---|
| query* | string | A place name, such as "Greenbush, WI". |
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"maxLength": 120,
"description": "A place name, such as \"Greenbush, WI\"."
}
}
}| question |
| string |
| The question as the person asked it, for example "Why does it feel colder than the temperature?". |
| longitude | number | Longitude in degrees, west negative. Use with latitude instead of location. |
| start_time | string | The time the question is about. Defaults to now. An ISO 8601 time such as 2026-10-03T18:00:00-05:00 (read in the place's own time zone when it has no offset), or plain words: "now", "tonight", "tomorrow morning", "Saturday", "6 PM", "between 6 PM and midnight". A bare hour with no AM or PM is refused rather than guessed. |
| duration_hours | number | How many hours to look at. Default 6. |
{
"type": "object",
"properties": {
"topic": {
"enum": [
"feels_like",
"rain_impact",
"wind",
"mud",
"humidity",
"fog",
"frost",
"pressure",
"storms"
],
"type": "string",
"description": "The topic, if you know it. Otherwise it is read from the question."
},
"units": {
"enum": [
"imperial",
"metric"
],
"type": "string",
"description": "imperial (F, mph, inches) or metric (C, km/h, mm). Defaults to imperial in the United States and metric elsewhere."
},
"activity": {
"type": "string",
"maxLength": 60,
"description": "What the person is doing, if known. One of: walking, hiking, trail_running, road_running, cycling, camping, hunting, fishing, yard_work, construction, painting_finishing, general_outdoor. Plain words work too (\"run\", \"hike\", \"stain the deck\"). \"Running\" with no more words is treated as road_running."
},
"latitude": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Latitude in degrees. Use with longitude instead of location."
},
"location": {
"type": "string",
"maxLength": 120,
"description": "A place name such as \"Glenbeulah, WI\" or \"Greenbush, Wisconsin\", or coordinates as \"43.79,-88.05\". Add the state or country for small towns, because a bare \"Greenbush\" matches several places."
},
"question": {
"type": "string",
"maxLength": 300,
"description": "The question as the person asked it, for example \"Why does it feel colder than the temperature?\"."
},
"longitude": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitude in degrees, west negative. Use with latitude instead of location."
},
"start_time": {
"type": "string",
"maxLength": 80,
"description": "The time the question is about. Defaults to now. An ISO 8601 time such as 2026-10-03T18:00:00-05:00 (read in the place's own time zone when it has no offset), or plain words: \"now\", \"tonight\", \"tomorrow morning\", \"Saturday\", \"6 PM\", \"between 6 PM and midnight\". A bare hour with no AM or PM is refused rather than guessed."
},
"duration_hours": {
"type": "number",
"maximum": 48,
"minimum": 0.5,
"description": "How many hours to look at. Default 6."
}
}
}| location | string | A place name such as "Glenbeulah, WI" or "Greenbush, Wisconsin", or coordinates as "43.79,-88.05". Add the state or country for small towns, because a bare "Greenbush" matches several places. |
| intensity | string | How hard the effort is, which changes what to wear. Defaults to the usual effort for the activity. |
| longitude | number | Longitude in degrees, west negative. Use with latitude instead of location. |
| duration_hours | number | How long the activity lasts. Defaults to the usual length for the activity, and says so. |
{
"type": "object",
"required": [
"activity"
],
"properties": {
"date": {
"type": "string",
"maxLength": 80,
"description": "The day to search. Defaults to today. A part of a day (\"tomorrow morning\") narrows the search to it, and \"this weekend\" compares both days. An ISO 8601 time such as 2026-10-03T18:00:00-05:00 (read in the place's own time zone when it has no offset), or plain words: \"now\", \"tonight\", \"tomorrow morning\", \"Saturday\", \"6 PM\", \"between 6 PM and midnight\". A bare hour with no AM or PM is refused rather than guessed."
},
"units": {
"enum": [
"imperial",
"metric"
],
"type": "string",
"description": "imperial (F, mph, inches) or metric (C, km/h, mm). Defaults to imperial in the United States and metric elsewhere."
},
"activity": {
"type": "string",
"maxLength": 60,
"description": "What the person is doing. One of: walking, hiking, trail_running, road_running, cycling, camping, hunting, fishing, yard_work, construction, painting_finishing, general_outdoor. Plain words work too (\"run\", \"hike\", \"stain the deck\"). \"Running\" with no more words is treated as road_running."
},
"latitude": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Latitude in degrees. Use with longitude instead of location."
},
"location": {
"type": "string",
"maxLength": 120,
"description": "A place name such as \"Glenbeulah, WI\" or \"Greenbush, Wisconsin\", or coordinates as \"43.79,-88.05\". Add the state or country for small towns, because a bare \"Greenbush\" matches several places."
},
"intensity": {
"enum": [
"low",
"moderate",
"high"
],
"type": "string",
"description": "How hard the effort is, which changes what to wear. Defaults to the usual effort for the activity."
},
"longitude": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitude in degrees, west negative. Use with latitude instead of location."
},
"duration_hours": {
"type": "number",
"maximum": 24,
"minimum": 0.25,
"description": "How long the activity lasts. Defaults to the usual length for the activity, and says so."
}
}
}| duration_hours | number | Instead of end_time: how many hours to cover. |
{
"type": "object",
"properties": {
"units": {
"enum": [
"imperial",
"metric"
],
"type": "string",
"description": "imperial (F, mph, inches) or metric (C, km/h, mm). Defaults to imperial in the United States and metric elsewhere."
},
"end_time": {
"type": "string",
"maxLength": 80,
"description": "When the period ends, in the same formats as start_time. \"midnight\" means the next midnight."
},
"latitude": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Latitude in degrees. Use with longitude instead of location."
},
"location": {
"type": "string",
"maxLength": 120,
"description": "A place name such as \"Glenbeulah, WI\" or \"Greenbush, Wisconsin\", or coordinates as \"43.79,-88.05\". Add the state or country for small towns, because a bare \"Greenbush\" matches several places."
},
"longitude": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitude in degrees, west negative. Use with latitude instead of location."
},
"start_time": {
"type": "string",
"maxLength": 80,
"description": "When the period starts. Defaults to now. An ISO 8601 time such as 2026-10-03T18:00:00-05:00 (read in the place's own time zone when it has no offset), or plain words: \"now\", \"tonight\", \"tomorrow morning\", \"Saturday\", \"6 PM\", \"between 6 PM and midnight\". A bare hour with no AM or PM is refused rather than guessed."
},
"duration_hours": {
"type": "number",
"maximum": 180,
"minimum": 0.5,
"description": "Instead of end_time: how many hours to cover."
}
}
}| string |
| An encoded polyline (Google format). |
| progress | object | For someone already on the route: how far along they are right now. The answer is for the rest of the route, starting now. Give distance_miles or distance_km, or a latitude and longitude. The position is used for this answer only and is never stored or logged. |
| trail_id | string | A trail we know by name. Call list_trails to see them. Use this OR one of the route formats below. |
| intensity | string | How hard the effort is, which changes what to wear. Defaults to the usual effort for the activity. |
| waypoints | array | Two to twelve places to travel between, each a name like "Glenbeulah, WI" or { "latitude": 43.79, "longitude": -88.05 }. They are joined by straight lines, so distances are approximate. |
| start_time | string | When the trip starts. Defaults to now. An ISO 8601 time such as 2026-10-03T18:00:00-05:00 (read in the place's own time zone when it has no offset), or plain words: "now", "tonight", "tomorrow morning", "Saturday", "6 PM", "between 6 PM and midnight". A bare hour with no AM or PM is refused rather than guessed. |
| step_hours | number | Hours between timeline rows. Default 2. |
| coordinates | array | A list of [latitude, longitude] pairs, latitude FIRST. |
| preferences | object | Optional: { "feel": "runs_cold" | "runs_warm", "avoid": ["shorts"] }. |
| out_and_back | boolean | True if the route is walked out and then back along the same line. |
| polyline_precision | integer | Digits of precision in the polyline. 5 is usual, 6 is what some routers send. |
| total_duration_hours | number | Instead of a pace: how long the whole trip is expected to take. The pace is worked out from the length of the route. |
| break_minutes_per_hour | number | Minutes of stops per hour of moving, which stretches arrival times. |
| rest_at_turnaround_hours | number | Hours spent resting at the turn of an out-and-back (a night's sleep, say). |
{
"type": "object",
"properties": {
"gpx": {
"type": "string",
"description": "The text of a GPX file (track points). Up to about 450 KB."
},
"pace": {
"type": "object",
"required": [
"value",
"unit"
],
"properties": {
"unit": {
"enum": [
"min_per_mile",
"min_per_km",
"mph",
"kph"
],
"type": "string"
},
"value": {
"type": "number",
"maximum": 1000,
"minimum": 0.1
}
},
"description": "How fast the person moves, as a value and a unit."
},
"units": {
"enum": [
"imperial",
"metric"
],
"type": "string",
"description": "imperial (F, mph, inches) or metric (C, km/h, mm). Defaults to imperial in the United States and metric elsewhere."
},
"geojson": {
"description": "GeoJSON as an object or a string: a LineString, MultiLineString, or Features holding them. Longitude first, as GeoJSON has it."
},
"activity": {
"type": "string",
"maxLength": 60,
"description": "What the person is doing, if known. One of: walking, hiking, trail_running, road_running, cycling, camping, hunting, fishing, yard_work, construction, painting_finishing, general_outdoor. Plain words work too (\"run\", \"hike\", \"stain the deck\"). \"Running\" with no more words is treated as road_running."
},
"polyline": {
"type": "string",
"description": "An encoded polyline (Google format)."
},
"progress": {
"type": "object",
"properties": {
"latitude": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"direction": {
"enum": [
"outbound",
"return"
],
"type": "string",
"description": "Which way, for an out-and-back, when only a position is given."
},
"longitude": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"distance_km": {
"type": "number",
"minimum": 0
},
"distance_miles": {
"type": "number",
"minimum": 0
}
},
"description": "For someone already on the route: how far along they are right now. The answer is for the rest of the route, starting now. Give distance_miles or distance_km, or a latitude and longitude. The position is used for this answer only and is never stored or logged."
},
"trail_id": {
"type": "string",
"maxLength": 60,
"description": "A trail we know by name. Call list_trails to see them. Use this OR one of the route formats below."
},
"intensity": {
"enum": [
"low",
"moderate",
"high"
],
"type": "string",
"description": "How hard the effort is, which changes what to wear. Defaults to the usual effort for the activity."
},
"waypoints": {
"type": "array",
"maxItems": 12,
"description": "Two to twelve places to travel between, each a name like \"Glenbeulah, WI\" or { \"latitude\": 43.79, \"longitude\": -88.05 }. They are joined by straight lines, so distances are approximate."
},
"start_time": {
"type": "string",
"maxLength": 80,
"description": "When the trip starts. Defaults to now. An ISO 8601 time such as 2026-10-03T18:00:00-05:00 (read in the place's own time zone when it has no offset), or plain words: \"now\", \"tonight\", \"tomorrow morning\", \"Saturday\", \"6 PM\", \"between 6 PM and midnight\". A bare hour with no AM or PM is refused rather than guessed."
},
"step_hours": {
"type": "number",
"maximum": 6,
"minimum": 0.5,
"description": "Hours between timeline rows. Default 2."
},
"coordinates": {
"type": "array",
"items": {
"type": "array"
},
"maxItems": 60000,
"description": "A list of [latitude, longitude] pairs, latitude FIRST."
},
"preferences": {
"type": "object",
"properties": {
"feel": {
"enum": [
"runs_cold",
"runs_warm",
"neutral"
],
"type": "string"
},
"avoid": {
"type": "array",
"items": {
"type": "string"
}
},
"notes": {
"type": "string",
"maxLength": 200
}
},
"description": "Optional: { \"feel\": \"runs_cold\" | \"runs_warm\", \"avoid\": [\"shorts\"] }."
},
"out_and_back": {
"type": "boolean",
"description": "True if the route is walked out and then back along the same line."
},
"polyline_precision": {
"enum": [
5,
6
],
"type": "integer",
"description": "Digits of precision in the polyline. 5 is usual, 6 is what some routers send."
},
"total_duration_hours": {
"type": "number",
"maximum": 200,
"minimum": 0.1,
"description": "Instead of a pace: how long the whole trip is expected to take. The pace is worked out from the length of the route."
},
"break_minutes_per_hour": {
"type": "number",
"maximum": 50,
"minimum": 0,
"description": "Minutes of stops per hour of moving, which stretches arrival times."
},
"rest_at_turnaround_hours": {
"type": "number",
"maximum": 48,
"minimum": 0,
"description": "Hours spent resting at the turn of an out-and-back (a night's sleep, say)."
}
}
}| intensity | string | How hard the effort is, which changes what to wear. Defaults to the usual effort for the activity. |
| longitude | number | Longitude in degrees, west negative. Use with latitude instead of location. |
| start_time | string | When it starts. Defaults to now. An ISO 8601 time such as 2026-10-03T18:00:00-05:00 (read in the place's own time zone when it has no offset), or plain words: "now", "tonight", "tomorrow morning", "Saturday", "6 PM", "between 6 PM and midnight". A bare hour with no AM or PM is refused rather than guessed. |
| duration_hours | number | How long it lasts. Defaults to the usual length for the activity, and says so. |
{
"type": "object",
"required": [
"activity"
],
"properties": {
"units": {
"enum": [
"imperial",
"metric"
],
"type": "string",
"description": "imperial (F, mph, inches) or metric (C, km/h, mm). Defaults to imperial in the United States and metric elsewhere."
},
"activity": {
"type": "string",
"maxLength": 60,
"description": "What the person is doing. One of: walking, hiking, trail_running, road_running, cycling, camping, hunting, fishing, yard_work, construction, painting_finishing, general_outdoor. Plain words work too (\"run\", \"hike\", \"stain the deck\"). \"Running\" with no more words is treated as road_running."
},
"latitude": {
"type": "number",
"maximum": 90,
"minimum": -90,
"description": "Latitude in degrees. Use with longitude instead of location."
},
"location": {
"type": "string",
"maxLength": 120,
"description": "A place name such as \"Glenbeulah, WI\" or \"Greenbush, Wisconsin\", or coordinates as \"43.79,-88.05\". Add the state or country for small towns, because a bare \"Greenbush\" matches several places."
},
"intensity": {
"enum": [
"low",
"moderate",
"high"
],
"type": "string",
"description": "How hard the effort is, which changes what to wear. Defaults to the usual effort for the activity."
},
"longitude": {
"type": "number",
"maximum": 180,
"minimum": -180,
"description": "Longitude in degrees, west negative. Use with latitude instead of location."
},
"start_time": {
"type": "string",
"maxLength": 80,
"description": "When it starts. Defaults to now. An ISO 8601 time such as 2026-10-03T18:00:00-05:00 (read in the place's own time zone when it has no offset), or plain words: \"now\", \"tonight\", \"tomorrow morning\", \"Saturday\", \"6 PM\", \"between 6 PM and midnight\". A bare hour with no AM or PM is refused rather than guessed."
},
"duration_hours": {
"type": "number",
"maximum": 72,
"minimum": 0.25,
"description": "How long it lasts. Defaults to the usual length for the activity, and says so."
}
}
}| polyline | string | An encoded polyline (Google format). |
| progress | object | For someone already on the route: how far along they are right now. The answer is for the rest of the route, starting now. Give distance_miles or distance_km, or a latitude and longitude. The position is used for this answer only and is never stored or logged. |
| trail_id | string | A trail we know by name. Call list_trails to see them. Use this OR one of the route formats below. |
| intensity | string | How hard the effort is, which changes what to wear. Defaults to the usual effort for the activity. |
| waypoints | array | Two to twelve places to travel between, each a name like "Glenbeulah, WI" or { "latitude": 43.79, "longitude": -88.05 }. They are joined by straight lines, so distances are approximate. |
| start_time | string | When the trip starts. Defaults to now. Ignored when progress is given. An ISO 8601 time such as 2026-10-03T18:00:00-05:00 (read in the place's own time zone when it has no offset), or plain words: "now", "tonight", "tomorrow morning", "Saturday", "6 PM", "between 6 PM and midnight". A bare hour with no AM or PM is refused rather than guessed. |
| coordinates | array | A list of [latitude, longitude] pairs, latitude FIRST. |
| preferences | object | Optional: { "feel": "runs_cold" | "runs_warm", "avoid": ["shorts"] }. |
| out_and_back | boolean | True if the route is walked out and then back along the same line. |
| polyline_precision | integer | Digits of precision in the polyline. 5 is usual, 6 is what some routers send. |
| total_duration_hours | number | Instead of a pace: how long the whole trip is expected to take. The pace is worked out from the length of the route. |
| break_minutes_per_hour | number | Minutes of stops per hour of moving, which stretches arrival times. |
| rest_at_turnaround_hours | number | Hours spent resting at the turn of an out-and-back (a night's sleep, say). |
{
"type": "object",
"properties": {
"gpx": {
"type": "string",
"description": "The text of a GPX file (track points). Up to about 450 KB."
},
"pace": {
"type": "object",
"required": [
"value",
"unit"
],
"properties": {
"unit": {
"enum": [
"min_per_mile",
"min_per_km",
"mph",
"kph"
],
"type": "string"
},
"value": {
"type": "number",
"maximum": 1000,
"minimum": 0.1
}
},
"description": "How fast the person moves, as a value and a unit."
},
"units": {
"enum": [
"imperial",
"metric"
],
"type": "string",
"description": "imperial (F, mph, inches) or metric (C, km/h, mm). Defaults to imperial in the United States and metric elsewhere."
},
"geojson": {
"description": "GeoJSON as an object or a string: a LineString, MultiLineString, or Features holding them. Longitude first, as GeoJSON has it."
},
"activity": {
"type": "string",
"maxLength": 60,
"description": "What the person is doing, if known. One of: walking, hiking, trail_running, road_running, cycling, camping, hunting, fishing, yard_work, construction, painting_finishing, general_outdoor. Plain words work too (\"run\", \"hike\", \"stain the deck\"). \"Running\" with no more words is treated as road_running."
},
"polyline": {
"type": "string",
"description": "An encoded polyline (Google format)."
},
"progress": {
"type": "object",
"properties": {
"latitude": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"direction": {
"enum": [
"outbound",
"return"
],
"type": "string",
"description": "Which way, for an out-and-back, when only a position is given."
},
"longitude": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"distance_km": {
"type": "number",
"minimum": 0
},
"distance_miles": {
"type": "number",
"minimum": 0
}
},
"description": "For someone already on the route: how far along they are right now. The answer is for the rest of the route, starting now. Give distance_miles or distance_km, or a latitude and longitude. The position is used for this answer only and is never stored or logged."
},
"trail_id": {
"type": "string",
"maxLength": 60,
"description": "A trail we know by name. Call list_trails to see them. Use this OR one of the route formats below."
},
"intensity": {
"enum": [
"low",
"moderate",
"high"
],
"type": "string",
"description": "How hard the effort is, which changes what to wear. Defaults to the usual effort for the activity."
},
"waypoints": {
"type": "array",
"maxItems": 12,
"description": "Two to twelve places to travel between, each a name like \"Glenbeulah, WI\" or { \"latitude\": 43.79, \"longitude\": -88.05 }. They are joined by straight lines, so distances are approximate."
},
"start_time": {
"type": "string",
"maxLength": 80,
"description": "When the trip starts. Defaults to now. Ignored when progress is given. An ISO 8601 time such as 2026-10-03T18:00:00-05:00 (read in the place's own time zone when it has no offset), or plain words: \"now\", \"tonight\", \"tomorrow morning\", \"Saturday\", \"6 PM\", \"between 6 PM and midnight\". A bare hour with no AM or PM is refused rather than guessed."
},
"coordinates": {
"type": "array",
"items": {
"type": "array"
},
"maxItems": 60000,
"description": "A list of [latitude, longitude] pairs, latitude FIRST."
},
"preferences": {
"type": "object",
"properties": {
"feel": {
"enum": [
"runs_cold",
"runs_warm",
"neutral"
],
"type": "string"
},
"avoid": {
"type": "array",
"items": {
"type": "string"
}
},
"notes": {
"type": "string",
"maxLength": 200
}
},
"description": "Optional: { \"feel\": \"runs_cold\" | \"runs_warm\", \"avoid\": [\"shorts\"] }."
},
"out_and_back": {
"type": "boolean",
"description": "True if the route is walked out and then back along the same line."
},
"polyline_precision": {
"enum": [
5,
6
],
"type": "integer",
"description": "Digits of precision in the polyline. 5 is usual, 6 is what some routers send."
},
"total_duration_hours": {
"type": "number",
"maximum": 200,
"minimum": 0.1,
"description": "Instead of a pace: how long the whole trip is expected to take. The pace is worked out from the length of the route."
},
"break_minutes_per_hour": {
"type": "number",
"maximum": 50,
"minimum": 0,
"description": "Minutes of stops per hour of moving, which stretches arrival times."
},
"rest_at_turnaround_hours": {
"type": "number",
"maximum": 48,
"minimum": 0,
"description": "Hours spent resting at the turn of an out-and-back (a night's sleep, say)."
}
}
}