Tool tree
gradeNot graded
get_map_viewAnswer
Read the current state of the crash map: where it is centred, the zoom, the active year range, the fatal-crash toll inside the current view, and any pin, isolated road or checked route. Call this first to know what the user is looking at.
View tool JSON
{
"name": "get_map_view",
"kind": "answer",
"impl": "imperative",
"description": "Read the current state of the crash map: where it is centred, the zoom, the active year range, the fatal-crash toll inside the current view, and any pin, isolated road or checked route. Call this first to know what the user is looking at.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"page": "/Highway-to-Hell/"
}set_year_rangeAction
Limit the map to a range of crash years. FARS coverage on this map runs 2001 to 2024. Everything else — the heat field, the road toll, the route check — re-counts for the chosen years.
View tool JSON
{
"name": "set_year_range",
"kind": "act",
"impl": "imperative",
"description": "Limit the map to a range of crash years. FARS coverage on this map runs 2001 to 2024. Everything else — the heat field, the road toll, the route check — re-counts for the chosen years.",
"inputSchema": {
"type": "object",
"properties": {
"from": {
"type": "integer",
"description": "First year to include, 2001-2024."
},
"to": {
"type": "integer",
"description": "Last year to include, 2001-2024."
}
},
"required": [
"from",
"to"
],
"additionalProperties": false
},
"page": "/Highway-to-Hell/"
}set_map_viewAction
Move the map to a place, or to explicit coordinates and zoom. Zoom past level 9 to make individual crashes appear; the whole lower 48 sits near zoom 4.
View tool JSON
{
"name": "set_map_view",
"kind": "act",
"impl": "imperative",
"description": "Move the map to a place, or to explicit coordinates and zoom. Zoom past level 9 to make individual crashes appear; the whole lower 48 sits near zoom 4.",
"inputSchema": {
"type": "object",
"properties": {
"place": {
"type": "string",
"description": "A US place to centre on, e.g. \"Flagstaff, AZ\". Ignored if lat and lng are given."
},
"lat": {
"type": "number",
"description": "Latitude to centre on."
},
"lng": {
"type": "number",
"description": "Longitude to centre on."
},
"zoom": {
"type": "number",
"description": "Zoom level, 3 (national) to 18 (street). Defaults to 11 for a place."
}
},
"additionalProperties": false
},
"page": "/Highway-to-Hell/"
}find_placeAnswer
Look up candidate US places for a search string without touching the map. Use it to disambiguate before dropping a pin or checking a route.
View tool JSON
{
"name": "find_place",
"kind": "answer",
"impl": "imperative",
"description": "Look up candidate US places for a search string without touching the map. Use it to disambiguate before dropping a pin or checking a route.",
"inputSchema": {
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Place name, address or landmark."
},
"limit": {
"type": "integer",
"description": "How many candidates to return, 1-10. Default 5."
}
},
"required": [
"query"
],
"additionalProperties": false
},
"page": "/Highway-to-Hell/"
}set_pinAction
Drop the pin on a place or coordinate and scope the map to a radius around it, so every count becomes "within N miles of here". This is the tool for "how bad is it around me / around this address".
View tool JSON
{
"name": "set_pin",
"kind": "act",
"impl": "imperative",
"description": "Drop the pin on a place or coordinate and scope the map to a radius around it, so every count becomes \"within N miles of here\". This is the tool for \"how bad is it around me / around this address\".",
"inputSchema": {
"type": "object",
"properties": {
"place": {
"type": "string",
"description": "A US place to pin. Ignored if lat and lng are given."
},
"lat": {
"type": "number",
"description": "Latitude to pin."
},
"lng": {
"type": "number",
"description": "Longitude to pin."
},
"radiusMiles": {
"type": "number",
"description": "Ring radius in miles; snapped to the nearest offered value (1, 3, 5 or 10)."
}
},
"additionalProperties": false
},
"page": "/Highway-to-Hell/"
}search_roadsAnswer
Search the national road index by name and get each road's full 2001-2024 toll across every state it runs through. Use it to find the exact road name before isolating one.
View tool JSON
{
"name": "search_roads",
"kind": "answer",
"impl": "imperative",
"description": "Search the national road index by name and get each road's full 2001-2024 toll across every state it runs through. Use it to find the exact road name before isolating one.",
"inputSchema": {
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Part of a road name, e.g. \"I-40\" or \"US-1\"."
},
"limit": {
"type": "integer",
"description": "How many roads to return, 1-25. Default 10."
}
},
"required": [
"query"
],
"additionalProperties": false
},
"page": "/Highway-to-Hell/"
}select_roadAction
Isolate one road nationally: the map shows only its crashes, coast to coast, and reports its toll for the active year range. Takes a name from search_roads, or a colloquial one like "hwy 6", which resolves to the deadliest road carrying that number.
View tool JSON
{
"name": "select_road",
"kind": "act",
"impl": "imperative",
"description": "Isolate one road nationally: the map shows only its crashes, coast to coast, and reports its toll for the active year range. Takes a name from search_roads, or a colloquial one like \"hwy 6\", which resolves to the deadliest road carrying that number.",
"inputSchema": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Exact road name as returned by search_roads."
}
},
"required": [
"name"
],
"additionalProperties": false
},
"page": "/Highway-to-Hell/"
}check_routeAnswer
Check a drive end to end: routes A to B, counts every death within a quarter mile of the road, colours the route by how deadly each stretch has been, and returns the worst stretches. This is the tool for "is this drive dangerous".
View tool JSON
{
"name": "check_route",
"kind": "answer",
"impl": "imperative",
"description": "Check a drive end to end: routes A to B, counts every death within a quarter mile of the road, colours the route by how deadly each stretch has been, and returns the worst stretches. This is the tool for \"is this drive dangerous\".",
"inputSchema": {
"type": "object",
"properties": {
"from": {
"type": "string",
"description": "Start of the drive, e.g. \"Barstow, CA\"."
},
"to": {
"type": "string",
"description": "End of the drive, e.g. \"Las Vegas, NV\"."
}
},
"required": [
"from",
"to"
],
"additionalProperties": false
},
"page": "/Highway-to-Hell/"
}list_crashes_in_viewAnswer
List the individual fatal crashes currently plotted, deadliest first, with the case id needed by get_crash_record. Needs the map zoomed in far enough for dots to appear; if a pin is set the list is limited to its ring.
View tool JSON
{
"name": "list_crashes_in_view",
"kind": "answer",
"impl": "imperative",
"description": "List the individual fatal crashes currently plotted, deadliest first, with the case id needed by get_crash_record. Needs the map zoomed in far enough for dots to appear; if a pin is set the list is limited to its ring.",
"inputSchema": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"description": "How many crashes to return, 1-200. Default 25."
}
},
"additionalProperties": false
},
"page": "/Highway-to-Hell/"
}get_crash_recordAnswer
Pull the full FARS case file for one crash: date and time, conditions, every vehicle with speed and outcome, every person with age, restraint and injury. Use case ids from list_crashes_in_view.
View tool JSON
{
"name": "get_crash_record",
"kind": "answer",
"impl": "imperative",
"description": "Pull the full FARS case file for one crash: date and time, conditions, every vehicle with speed and outcome, every person with age, restraint and injury. Use case ids from list_crashes_in_view.",
"inputSchema": {
"type": "object",
"properties": {
"state": {
"type": "string",
"description": "State name or two-digit FIPS code, e.g. \"Arizona\" or \"04\"."
},
"year": {
"type": "integer",
"description": "Crash year, 2001-2024."
},
"caseId": {
"type": "integer",
"description": "FARS case number from list_crashes_in_view."
}
},
"required": [
"state",
"year",
"caseId"
],
"additionalProperties": false
},
"page": "/Highway-to-Hell/"
}capture_map_screenshotAction
Take a PNG of the map exactly as the user sees it, so you can look at the heat field, the plotted crashes or a coloured route yourself. Returns the picture plus the same numbers get_map_view reports. The map canvas only; side panels are HTML and are described in the text instead.
View tool JSON
{
"name": "capture_map_screenshot",
"kind": "act",
"impl": "imperative",
"description": "Take a PNG of the map exactly as the user sees it, so you can look at the heat field, the plotted crashes or a coloured route yourself. Returns the picture plus the same numbers get_map_view reports. The map canvas only; side panels are HTML and are described in the text instead.",
"inputSchema": {
"type": "object",
"properties": {
"maxWidth": {
"type": "integer",
"description": "Longest edge in pixels, 320-3000. Default 1280."
}
},
"additionalProperties": false
},
"page": "/Highway-to-Hell/"
}set_basemapAction
Switch the basemap. "dark" is the default CARTO Dark Matter, best for reading the heat field; "street" shows road names and buildings, better for a screenshot of one neighbourhood.
View tool JSON
{
"name": "set_basemap",
"kind": "act",
"impl": "imperative",
"description": "Switch the basemap. \"dark\" is the default CARTO Dark Matter, best for reading the heat field; \"street\" shows road names and buildings, better for a screenshot of one neighbourhood.",
"inputSchema": {
"type": "object",
"properties": {
"style": {
"type": "string",
"enum": [
"dark",
"street"
],
"description": "Which basemap to show."
}
},
"required": [
"style"
],
"additionalProperties": false
},
"page": "/Highway-to-Hell/"
}clear_selectionAction
Drop the pin, the isolated road and the route check and go back to the whole country. Use it before starting a different question.
View tool JSON
{
"name": "clear_selection",
"kind": "act",
"impl": "imperative",
"description": "Drop the pin, the isolated road and the route check and go back to the whole country. Use it before starting a different question.",
"inputSchema": {
"type": "object",
"properties": {
"recenter": {
"type": "boolean",
"description": "Also fit the map back to the lower 48. Default true."
}
},
"additionalProperties": false
},
"page": "/Highway-to-Hell/"
}