Skip to content

fix: feedback_tool sends feedback to the app's developer, not to Mapbox - #329

Merged
mattpodwysocki merged 6 commits into
mainfrom
fix/feedback-tool-description
Nov 11, 2026
Merged

mattpodwysocki merged 6 commits into
mainfrom
fix/feedback-tool-description

Conversation

@mattpodwysocki

@mattpodwysocki mattpodwysocki commented Nov 10, 2026 •

Copy link
Copy Markdown
Contributor

The feedback_tool description didn't match what the Feedback API is for.

The Feedback API is how end users of a developer's app send feedback to that developer. Items land in the token owner's account, in the same feed as Feedback Agent reports, and the developer reviews them in Feedback Explorer. They don't go to Mapbox. So the tool's real use case is a developer who builds an app or agent on this server with their own token: their users' feedback reaches them.

What was off

  • It presented itself as reporting map problems "to Mapbox", which "may fix the data".
  • It said each report "may be billed", and a duplicate result said a second one "would only add a charge". The API is free during Public Preview; the $0.02 per item is the Feedback Agent charge at General Availability.
  • The docs' examples use routing_issue, which wasn't in our category enum.

Changes

  • Description: sends the user's feedback to the developer of the app or agent, filed under the token owner's account and reviewed in Feedback Explorer. It says the tool doesn't report to Mapbox, and explains the duplicate check as avoiding the same problem twice rather than cost.
  • Prompt, result and annotations: the confirmation prompt, the result text and the title say the same.
  • Categories: adds routing_issue.
  • README and CHANGELOG: updated to match.

No behavior change beyond accepting routing_issue. Feedback about the MCP server itself goes through report_tool (#330).

🤖 Generated with Claude Code

The Feedback API is free during Public Preview, so drop the claims that a
report may be billed or that a duplicate adds a charge. Say the report is
filed under the user's own account, and add routing_issue to the categories.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@mattpodwysocki mattpodwysocki added the enhancement New feature or request label Nov 10, 2026
@mattpodwysocki
mattpodwysocki requested a review from a team as a code owner November 10, 2026 15:15
@mattpodwysocki mattpodwysocki added the enhancement New feature or request label Nov 10, 2026
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Comment thread src/tools/feedback-tool/FeedbackTool.ts Outdated
name = 'feedback_tool';
description =
'Report a problem with Mapbox map, place or routing data to Mapbox through the Feedback API, ' +
'Report a problem with Mapbox map, place or routing data through the Mapbox Feedback API (Public Preview), ' +

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

feedback_tool is designed to let users of a Mapbox developer’s app report issues to that developer, rather than to Mapbox.

In a separate PR, we could extend the report tool to handle MCP or general Mapbox issues. Let’s clarify these use cases in the tool descriptions.

Per review: the Feedback API is how end users of a developer's app send
feedback to that developer. Items land in the token owner's account and
Feedback Explorer. Reword the description, confirmation, result and README
around a developer building an app or agent on this server with their own
token.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@mattpodwysocki mattpodwysocki changed the title fix: feedback_tool description matches the Feedback API docs fix: feedback_tool sends feedback to the app's developer, not to Mapbox Nov 10, 2026
mattpodwysocki and others added 3 commits November 10, 2026 12:02
Per review, like Feedback Agent: feedback can be about the app itself, not
only map data.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The Feedback API requires lat/lon, and the Feedback API team asked us to
send 0, 0 for feedback without a place until location becomes optional.
That feedback skips the duplicate check, since it would all match at 0, 0.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@mattpodwysocki
mattpodwysocki merged commit b03c3e4 into main Nov 11, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants