# Get customiser diagnostics (`get_customiser_diagnostics`)

Reads what went wrong when shoppers checked out from one customiser of the connected Store in the last seven days: an outcome (errors_found, no_failed_activity or no_integration), up to five failed integration or webhook requests with a plain summary and classification each, the last storefront pages the customiser was used on, and the last cart handoffs with their state. A failed cart handoff after the platform accepted the product is not an integration failure. It requires the integrations:read scope and has no side effects.

- Source URL: https://www.signcustomiser.com/help/mcp/tools/get_customiser_diagnostics/
- Markdown URL: https://www.signcustomiser.com/help/mcp/tools/get_customiser_diagnostics.md
- MCP endpoint: https://mcp.signcustomiser.com
- Required scope: `integrations:read`
- Behaviour: read

## Purpose

Answer why shoppers could not add a customiser design to the cart or why its products did not reach the selling platform.

## Annotations

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

## Prerequisites

- A customiser id from list_customisers.
- A merchant has connected this store and approved the integrations:read scope.

## Arguments

| Property | Type | Required | Description |
| --- | --- | --- | --- |
| `customiser_id` | integer | yes | The customiser id, from list_customisers. |

## Result

The outcome, the failed requests, the recent storefront pages and the recent cart handoffs of the customiser, at most five of each.

| Property | Type | Required | Description |
| --- | --- | --- | --- |
| `request_id` | string | yes |  |
| `store` | object | yes |  |
| `store.id` | integer | yes |  |
| `store.name` | string | yes |  |
| `diagnostics` | object | yes |  |
| `diagnostics.customiser_id` | integer | yes |  |
| `diagnostics.outcome` | string | yes | Expected to grow. One of: `errors_found`, `no_failed_activity`, `no_integration`. |
| `diagnostics.incidents` | array of object | yes | The failed requests, newest first, at most five. |
| `diagnostics.incidents[].occurred_at` | string | yes |  |
| `diagnostics.incidents[].operation` | string | yes | product_sync, product_webhook, order_webhook or external_request. Expected to grow. |
| `diagnostics.incidents[].status_code` | integer or null | no |  |
| `diagnostics.incidents[].classification` | string | yes | http_client_error, http_server_error, timeout, connection_error, transport_error or unknown_failure. Expected to grow. |
| `diagnostics.incidents[].merchant_summary` | string | yes |  |
| `diagnostics.incidents[].trace_id` | string | yes | The identifier of the failed request, to quote to support. |
| `diagnostics.incidents[].storefront_page` | object or null | no | The storefront page the shopper was on when the request started, or null. |
| `diagnostics.recent_storefront_pages` | array of object | yes | The last storefront pages the customiser was used on, at most five: url, origin, source, availability and captured_at. |
| `diagnostics.recent_cart_handoffs` | array of object | yes | The last cart handoffs, at most five: checkout_attempt_id, state (started, unacknowledged, succeeded or failed), summary, classification, classification_summary, started_at, reported_at and storefront_page. |

## Error cases

| Code | Recovery |
| --- | --- |
| `insufficient_scope` | The connection was approved without integrations:read. |
| `resource_not_found` | No customiser with that id belongs to this store. Call list_customisers to find a valid id. |

## Example: A customiser whose product sync failed

Request:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_customiser_diagnostics",
    "arguments": {
      "customiser_id": 42
    }
  }
}
```

Response:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "structuredContent": {
      "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t",
      "store": {
        "id": 12,
        "name": "Demo Signs"
      },
      "diagnostics": {
        "customiser_id": 42,
        "outcome": "errors_found",
        "incidents": [
          {
            "occurred_at": "2026-11-14T09:30:00Z",
            "operation": "product_sync",
            "status_code": 502,
            "classification": "http_server_error",
            "merchant_summary": "The connected platform had a server error while Sign Customiser sent the product.",
            "trace_id": "88123",
            "storefront_page": null
          }
        ],
        "recent_storefront_pages": [],
        "recent_cart_handoffs": []
      }
    }
  }
}
```

## Example: A customiser of another store (error)

Request:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_customiser_diagnostics",
    "arguments": {
      "customiser_id": 999
    }
  }
}
```

Response:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "isError": true,
    "structuredContent": {
      "error": {
        "code": "resource_not_found",
        "title": "Resource not found",
        "detail": "The requested resource does not exist or does not belong to the authenticated store.",
        "recovery": "The identifier does not exist in this store. Use the matching list tool to rediscover a valid id."
      }
    }
  }
}
```
