# Report feedback to Sign Customiser (`report_feedback`)

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.

- Source URL: https://www.signcustomiser.com/help/mcp/tools/report_feedback/
- Markdown URL: https://www.signcustomiser.com/help/mcp/tools/report_feedback.md
- MCP endpoint: https://mcp.signcustomiser.com
- Required scope: none beyond a connected store
- Behaviour: write

## Purpose

Tell the Sign Customiser team about a bug, a confusing result, a documentation gap or a missing capability found while using the connector.

## Annotations

| Hint | Value |
| --- | --- |
| readOnlyHint | false |
| destructiveHint | false |
| idempotentHint | false |
| openWorldHint | false |

## Prerequisites

- A valid connection. No scope is required.

## Side effects

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

## Arguments

| Property | Type | Required | Description |
| --- | --- | --- | --- |
| `category` | string | yes | 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`. |
| `summary` | string | yes | The problem in one sentence, at most 200 characters. |
| `details` | string | no | Optional. What you called, what happened and what you expected, at most 3000 characters. Leave out customer personal data, credentials and secrets. |
| `tool_name` | string | no | Optional. The tool the report is about. |
| `related_request_id` | string | no | 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.

| Property | Type | Required | Description |
| --- | --- | --- | --- |
| `request_id` | string | yes |  |
| `store` | object | yes |  |
| `store.id` | integer | yes |  |
| `store.name` | string | yes |  |
| `report` | object | yes |  |
| `report.category` | string | yes | One of: `bug`, `unexpected_result`, `missing_capability`, `documentation_gap`, `other`. |
| `report.received` | boolean | yes |  |

## Error cases

| Code | Recovery |
| --- | --- |
| `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. |

## Example: Report a tool error that looks wrong

Request:

```json
{
  "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"
    }
  }
}
```

Response:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "structuredContent": {
      "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t",
      "store": {
        "id": 12,
        "name": "Demo Signs"
      },
      "report": {
        "category": "bug",
        "received": true
      }
    }
  }
}
```

## Example: Too many reports from one connection (error)

Request:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "report_feedback",
    "arguments": {
      "category": "missing_capability",
      "summary": "No tool sets a customiser storefront theme."
    }
  }
}
```

Response:

```json
{
  "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"
      }
    }
  }
}
```
