# List customiser languages (`list_customiser_languages`)

Lists the languages one customiser publishes to shoppers: each language code, its source language, display name, status, whether it is the customiser default, a translation-completeness summary and the state of any AI translation run against it. It returns no translation strings, which are a separate bounded read. Results are paginated. It requires the customisers:read scope and has no side effects.

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

## Purpose

See which languages a customiser offers and how complete each translation is.

## 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 customisers:read scope.

## Arguments

| Property | Type | Required | Description |
| --- | --- | --- | --- |
| `customiser_id` | integer | yes | The customiser id, from list_customisers. |
| `limit` | integer | no | How many languages to return per page, between 1 and 100. Defaults to 20. |
| `cursor` | string | no | The opaque next_cursor value from the previous page. Omit it for the first page. |

## Result

Up to `limit` language records with completeness counts, plus the cursor for the next page. Never any translation strings.

| Property | Type | Required | Description |
| --- | --- | --- | --- |
| `request_id` | string | yes |  |
| `store` | object | yes |  |
| `store.id` | integer | yes |  |
| `store.name` | string | yes |  |
| `customiser_id` | integer | yes |  |
| `languages` | array of object | yes | The page of languages. |
| `languages[].language_code` | string | yes |  |
| `languages[].source_language_code` | string or null | no |  |
| `languages[].display_name` | string or null | no |  |
| `languages[].status` | string | yes |  |
| `languages[].is_default` | boolean | yes |  |
| `languages[].translation_summary` | object or null | no |  |
| `languages[].ai_translation` | object or null | no |  |
| `languages[].published_at` | string or null | no |  |
| `languages[].updated_at` | string or null | no |  |
| `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 customisers:read. |
| `invalid_cursor` | The cursor was altered or reused; restart with no cursor. |
| `resource_not_found` | No customiser with that id belongs to this store. Call list_customisers to rediscover a valid id. |

## Example: Languages of one customiser

Request:

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

Response:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "structuredContent": {
      "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t",
      "store": {
        "id": 12,
        "name": "Demo Signs"
      },
      "customiser_id": 42,
      "languages": [
        {
          "language_code": "en",
          "source_language_code": "en",
          "display_name": "English",
          "status": "published",
          "is_default": true,
          "translation_summary": {
            "key_count": 184,
            "required_key_count": 96,
            "translated_key_count": 184,
            "missing_required_key_count": 0,
            "publishable": true
          },
          "ai_translation": null,
          "published_at": "2026-05-04T09:12:31Z",
          "updated_at": "2026-05-04T09:12:31Z"
        }
      ],
      "pagination": {
        "has_more": false,
        "next_cursor": null
      }
    }
  }
}
```

## Example: A customiser id that does not exist (error)

Request:

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

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."
      }
    }
  }
}
```