Send Feedback to the Developer
feedback_toolSends user feedback about map, place, route, traffic, or app problems to the developer via Mapbox Feedback API so they can review and improve the product.
Instructions
Send the user's feedback about this app or agent to its developer, through the Mapbox Feedback API (Public Preview), so the developer can understand what users need and improve the product. Feedback can be about anything in the product: for example a place that has closed or has wrong details, a missing place, a closed road, a route with an illegal turn, a wrong travel time, or something about the app itself. It is filed under the Mapbox account that owns the access token, in the same feed as that account's Feedback Agent reports, and the developer reviews it in Feedback Explorer. It does not report the problem to Mapbox. Use it only when the user asks to send feedback, or agrees when you offer. Before calling it, show the user the exact feedback text, category and location you will send and get their go-ahead. Take the coordinates from an earlier search, place or directions result rather than guessing, and leave them out when the feedback is not about a place, such as most feedback about the app itself. Send one report per problem, and do not resend one that already succeeded. To avoid filing the same problem twice, the tool first checks the account's own reports from the last 30 days and does not send if one with the same category within 50 m is still awaiting review; it returns that report instead. Only set send_anyway when the user says the earlier report is about a different problem. Returns the item id and its status (received).
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": {
"feedback": "<feedback>",
"category": "<category>"
},
"name": "feedback_tool"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| category | Yes | The kind of problem: - poi_closed: the place no longer exists - poi_details: wrong name, hours, phone, website or other details - poi_location: the place is on the wrong spot - poi_missing: a place, address or business could not be found - map_data_issue / map_rendering_issue: wrong map features, or the map draws wrong - routing_issue: something else wrong with a route - poor_routing_issue / alternative_route_issue / no_route: a bad, missing or no route - illegal_turn / illegal_entrance / missing_expected_maneuver: a turn or entrance the route got wrong - eta_issue: the travel time was wrong - road_closure_issue / road_incident_issue / speed_limit_issue: road data - traffic_issue / false_negative_traffic_issue / false_positive_traffic_issue: traffic shown wrong (missed congestion, or congestion that is not there) - application_issue: anything about the app itself rather than the map data, such as a bug, a confusing screen or a suggestion | |
| feedback | Yes | What is wrong, in the user's own words, plus what it should be if they said. Name the place or road. Example: "Blue Bottle Coffee at 66 Mint St has closed permanently." | |
| coordinates | No | Where the feedback is about: the place or the spot on the route, usually taken from an earlier search or directions result. Do not guess. Leave it out when the feedback is not about a place, such as most feedback about the app itself. | |
| send_anyway | No | Skip the check for an earlier report from this account. Set it only after the tool said a report already exists and the user says theirs is about a different problem. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| status | Yes | received (new, awaiting review), fixed, reviewed or out_of_scope. The API may add more. | |
| category | Yes | ||
| feedback | Yes | ||
| location | No | ||
| trace_id | No | ||
| duplicate | No | True when nothing was sent because this account already has a matching report awaiting review; the fields describe that earlier report. | |
| created_at | No | ||
| updated_at | No | ||
| received_at | No |