# List quote AI designs (`list_quote_ai_designs`)

List the AI designs linked to one quote of this store, newest first, with an opaque cursor: the designs made from its files with the AI sign designer, and the design a Save design form submission saved. quote_file names the quote file a design was made from, as the field_id and file_index of the quote files. Use it before create_quote_ai_design to see which files were converted. Requires ai_sign_designs:read and quotes:read. Has no side effects.

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

## Purpose

See which files of a quote were converted with the AI sign designer, and the outcome of each conversion.

## Annotations

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

## Prerequisites

- A quote id from list_quotes.
- A merchant has connected this store and approved the ai_sign_designs:read and quotes:read scopes.

## Arguments

| Property | Type | Required | Description |
| --- | --- | --- | --- |
| `quote_id` | integer | yes | The quote id, from list_quotes. |
| `limit` | integer | no | How many designs to return per page, between 1 and 100. Defaults to 20. |
| `cursor` | string | no | The opaque next_cursor value from the previous page of the same quote. |

## Result

A page of designs and the pagination block, as get_ai_design returns each design. An erased design is not listed.

| Property | Type | Required | Description |
| --- | --- | --- | --- |
| `request_id` | string | yes |  |
| `store` | object | yes |  |
| `store.id` | integer | yes |  |
| `store.name` | string | yes |  |
| `quote_id` | integer | yes |  |
| `ai_designs` | array of object | yes | The page of designs, newest first. |
| `ai_designs[].id` | integer | yes |  |
| `ai_designs[].origin` | string | yes | customer_customiser (a shopper used the AI sign designer), quote (a quote file was converted), merchant_admin (an upload in the merchant admin) or api (an AI sign design job). Expected to grow. One of: `customer_customiser`, `quote`, `merchant_admin`, `api`. |
| `ai_designs[].status` | string | yes | processing, then delivered (a design exists), refused (a check refused the design) or failed (no design for another reason). No credit is charged for refused or failed. Expected to grow. One of: `processing`, `delivered`, `refused`, `failed`. |
| `ai_designs[].product_family` | string or null | no | One of: `neon`, `channel_letter`, `metal_cut_out`. |
| `ai_designs[].customiser_id` | integer or null | no |  |
| `ai_designs[].files` | array of object | yes | The SVG, EPS, PDF, preview and face files only when status is delivered, and the uploaded source and its preview for every status. |
| `ai_designs[].files[].kind` | string | yes | One of: `svg`, `eps`, `illustrator_pdf`, `raster_preview`, `face_svg`, `source`, `source_preview`. |
| `ai_designs[].files[].purpose` | string | yes |  |
| `ai_designs[].files[].media_type` | string | yes |  |
| `ai_designs[].files[].access` | string | yes | One of: `private`, `public`. |
| `ai_designs[].files[].download_url` | string or null | no | A URL that needs no login. For a private file of an api design it is a revocable Sign Customiser link. For a public file it is the public storage URL, which cannot be revoked. Null for every other private file. |
| `ai_designs[].product_ids` | array of integer | yes |  |
| `ai_designs[].order_ids` | array of integer | yes |  |
| `ai_designs[].quote_id` | integer or null | no |  |
| `ai_designs[].quote_file` | object or null | no | The quote file the design was converted from, or null. |
| `ai_designs[].quote_file.field_id` | string | yes |  |
| `ai_designs[].quote_file.file_index` | integer | yes |  |
| `ai_designs[].ai_sign_design_job_id` | string or null | no |  |
| `ai_designs[].feedback_rating` | string or null | no | One of: `thumbs_up`, `thumbs_down`. |
| `ai_designs[].created_at` | string | yes |  |
| `pagination` | object | yes |  |
| `pagination.has_more` | boolean | yes |  |
| `pagination.next_cursor` | string or null | no |  |

## Error cases

| Code | Recovery |
| --- | --- |
| `insufficient_scope` | The connection was approved without ai_sign_designs:read or without quotes:read. |
| `invalid_cursor` | The cursor belongs to another quote. Call the tool again without a cursor. |
| `resource_not_found` | The quote id is unknown or belongs to another store. |

## Example: The conversions of a quote

Request:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_quote_ai_designs",
    "arguments": {
      "quote_id": 8123
    }
  }
}
```

Response:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "structuredContent": {
      "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t",
      "store": {
        "id": 12,
        "name": "Demo Signs"
      },
      "quote_id": 8123,
      "ai_designs": [
        {
          "id": 51234,
          "origin": "quote",
          "status": "delivered",
          "product_family": "neon",
          "customiser_id": 42,
          "files": [
            {
              "kind": "svg",
              "purpose": "design",
              "media_type": "image/svg+xml",
              "access": "private",
              "download_url": null
            },
            {
              "kind": "source",
              "purpose": "source",
              "media_type": "image/png",
              "access": "private",
              "download_url": null
            }
          ],
          "product_ids": [],
          "order_ids": [],
          "quote_id": 8123,
          "quote_file": {
            "field_id": "field_artwork",
            "file_index": 0
          },
          "ai_sign_design_job_id": null,
          "feedback_rating": "thumbs_up",
          "created_at": "2026-10-20T09:32:00Z"
        }
      ],
      "pagination": {
        "has_more": false,
        "next_cursor": null
      }
    }
  }
}
```

## Example: A connection without quotes:read (error)

Request:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_quote_ai_designs",
    "arguments": {
      "quote_id": 8123
    }
  }
}
```

Response:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "isError": true,
    "structuredContent": {
      "error": {
        "code": "insufficient_scope",
        "title": "Insufficient scope",
        "detail": "This operation requires the quotes:read scope.",
        "recovery": "The connection was authorised without the scope this tool needs. Ask the merchant to reconnect the Sign Customiser connector and approve the scope named in required_scopes. If the approval screen does not offer that permission, ask them to remove the connector from this AI agent and add it again. Do not retry this call.",
        "required_scopes": [
          "quotes:read"
        ],
        "granted_scopes": [
          "ai_sign_designs:read"
        ]
      }
    }
  }
}
```
