Sign Customiser

Navigation

Dark mode

Discovery

report_feedback

write

Report feedback to Sign Customiser

Copy page

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

readOnlyHintfalse
destructiveHintfalse
idempotentHintfalse
openWorldHintfalse

Prerequisites

  • A valid connection. No scope is required.

Side effects

  • Sends the report to the Sign Customiser team.
  • Changes nothing in the Store.

Arguments

categorystringrequired

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

summarystringrequired

The problem in one sentence, at most 200 characters.

detailsstring

Optional. What you called, what happened and what you expected, at most 3000 characters. Leave out customer personal data, credentials and secrets.

tool_namestring

Optional. The tool the report is about.

related_request_idstring

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.

request_idstringalways present
storeobjectalways present
store.idintegeralways present
store.namestringalways present
reportobjectalways present
report.categorystringalways present

One of: bug, unexpected_result, missing_capability, documentation_gap, other

report.receivedbooleanalways present

Error cases

rate_limited

This connection sent 20 reports in the last hour. Wait retry_after seconds.

validation_failed

summary is empty after surrounding whitespace is removed. Describe the problem in one sentence.

Report a tool error that looks wrong

tools/call
{
  "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"
    }
  }
}
result
{
  "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)

tools/call
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "report_feedback",
    "arguments": {
      "category": "missing_capability",
      "summary": "No tool sets a customiser storefront theme."
    }
  }
}
result
{
  "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"
      }
    }
  }
}

Type a question and press Enter. Use the arrow keys to move between the results.