Discovery
report_feedback
writeReport feedback to Sign Customiser
Tell the Sign Customiser team about a bug, a confusing result, a documentation gap or a missing capability found while using the connector.
Overview
Sends a short report about this connector to the Sign Customiser team, who read every one to fix and improve the tools. Use it when a tool returns an error that looks wrong, a result that contradicts the documentation or the merchant admin, a description that was unclear, or when the merchant asks for something no tool can do. Describe the problem, not the merchant: do not include customer personal data, credentials or secrets. It changes nothing in the Store, needs no scope beyond a valid connection, and each connection can send 20 reports an hour.
Permission
Needs no permission beyond a connected store.
Annotations
Prerequisites
- A valid connection. No scope is required.
Side effects
- Sends the report to the Sign Customiser team.
- Changes nothing in the Store.
Arguments
What kind of problem it is: bug (a tool misbehaved), unexpected_result (a result contradicts the documentation or the merchant admin), missing_capability (no tool does what the merchant asked), documentation_gap (a description or the documentation was unclear or wrong) or other.
One of: bug, unexpected_result, missing_capability, documentation_gap, other
The problem in one sentence, at most 200 characters.
Optional. What you called, what happened and what you expected, at most 3000 characters. Leave out customer personal data, credentials and secrets.
Optional. The tool the report is about.
Optional. The request_id of the tool result the report is about, so the team can find that call.
Result
Confirms the report was received, echoing its category. Quote the result request_id to Sign Customiser support to refer to the report.
One of: bug, unexpected_result, missing_capability, documentation_gap, other
Error cases
This connection sent 20 reports in the last hour. Wait retry_after seconds.
summary is empty after surrounding whitespace is removed. Describe the problem in one sentence.
Report a tool error that looks wrong
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "report_feedback",
"arguments": {
"category": "bug",
"summary": "update_customiser_option rejects a hex colour the merchant admin accepts.",
"details": "Sent hex \"#FFAA00\" to a colour option. The tool answered validation_failed with pointer /hex, but the same value saves in the merchant admin.",
"tool_name": "update_customiser_option",
"related_request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0a"
}
}
}{
"jsonrpc": "2.0",
"id": 1,
"result": {
"structuredContent": {
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t",
"store": {
"id": 12,
"name": "Demo Signs"
},
"report": {
"category": "bug",
"received": true
}
}
}
}Too many reports from one connection (error)
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "report_feedback",
"arguments": {
"category": "missing_capability",
"summary": "No tool sets a customiser storefront theme."
}
}
}{
"jsonrpc": "2.0",
"id": 1,
"result": {
"isError": true,
"structuredContent": {
"error": {
"code": "rate_limited",
"title": "Too many requests",
"detail": "This connection has exceeded the request limit for this call. Wait 1800 seconds, then retry.",
"recovery": "Wait retry_after seconds before sending another call to this store.",
"retry_after": 1800,
"request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t"
}
}
}
}