find_task_route
Call this once per task when you start a customer task on a site (a return or exchange, a refund, a cancellation, a warranty claim, an account recovery, a document submission), before you open its help pages, even when nothing is blocked. Look up recorded task routes for a public hostname: for a kind of customer task (a refund, a cancellation, a booking and so on), an obstacle and the routes the site's own documents name. A record may carry condition_text, a condition the site's page states, quoted as written: it is not our judgement, so decide yourself whether it applies to your task, with the page at source_url. The answer is a list of records, not a guarantee and not advice; an empty list does not mean there is no route. Sends only the hostname and an optional task kind, and changes nothing. Read summary_line first. field_notes explains outcome, period and routes_tried.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"site_host": "<site_host>"
},
"name": "find_task_route"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| site_host | Yes | The public hostname of the site whose task routes you want, lowercase, for example example.com. Only the host: no scheme, URL path, query, port or credentials. | |
| task_kind | No | Optional: one kind of customer task to look up, from the list. Leave it out to get the records for every task kind of the site. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| counts | Yes | ||
| notice | No | ||
| routes | No | ||
| site_host | Yes | ||
| field_notes | No | Fixed sentences on what outcome, period and routes_tried mean in these records (those keys are left out when there is no record), and call_timing, when to call this lookup (always present). | |
| summary_line | Yes | ||
| official_help_url | No | Only when routes is empty and the site's own help or customer service page is curated: that page, as a place to look yourself. A link to read, not a route and not a statement that the site has none. |