# List integrations (`list_integrations`)

Lists the commerce integrations connected to the connected Store, enabled or not, with each integration id, platform type, name, whether it is enabled, whether it accepts order and product writes, and its settings that are not credentials, such as a Shopify domain or a custom integration product URL. Tokens and secrets are never returned. It cannot connect, change or remove an integration. It requires the integrations:read scope and has no side effects.

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

## Purpose

See how the Store is connected to its selling platforms, and obtain the integration ids get_integration and list_integration_activity_logs take.

## Annotations

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

## Prerequisites

- A merchant has connected this store and approved the integrations:read scope.

## Arguments

| Property | Type | Required | Description |
| --- | --- | --- | --- |
| `limit` | integer | no | How many integrations to return per page, between 1 and 100. Defaults to 20. |
| `cursor` | string | no | The opaque next_cursor value from the previous page. |

## Result

Up to `limit` integrations, oldest first, plus the cursor for the next page.

| Property | Type | Required | Description |
| --- | --- | --- | --- |
| `request_id` | string | yes |  |
| `store` | object | yes |  |
| `store.id` | integer | yes |  |
| `store.name` | string | yes |  |
| `integrations` | array of object | yes | The page of integrations. |
| `integrations[].id` | integer | yes |  |
| `integrations[].type` | string | yes | Expected to grow. One of: `shopify`, `woocommerce`, `wix`, `etsy`, `custom`. |
| `integrations[].name` | string | yes |  |
| `integrations[].enabled` | boolean | yes |  |
| `integrations[].accepts_writes` | boolean | yes | True only for an enabled custom integration, the kind create_order and create_integration_product accept. |
| `integrations[].settings` | object | yes | The settings of the integration type, never its credentials, tokens or platform session ids. Each type carries only its own keys, and a key that is not set is null. |
| `integrations[].settings.api_url` | string or null | no | woocommerce only: the address of the WooCommerce store, as its scheme, host, port and path only (no user name, password, path parameter, query string or fragment). |
| `integrations[].settings.create_product_url` | string or null | no | custom only: the address Sign Customiser sends new products to, as its scheme, host, port and path only (no user name, password, path parameter, query string or fragment). |
| `integrations[].settings.domain` | string or null | no | shopify only: the myshopify.com domain of the Shopify store. |
| `integrations[].settings.publication_id` | string or null | no | shopify only: the Shopify publication new products are published to, or null for the default. |
| `integrations[].settings.default_product_status` | string or null | no | shopify only: the status new products get on Shopify (closed). One of: `active`, `unlisted`. |
| `integrations[].settings.version` | string or null | no | wix only: the Wix catalogue version (closed), or null before it is known. One of: `v1`, `v3`. |
| `integrations[].settings.managed_by` | string or null | no | etsy only: what manages the integration. |
| `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 integrations:read. |
| `invalid_cursor` | The cursor was altered or reused for a different collection or Store; restart with no cursor. |
| `invalid_parameter` | limit is not an integer from 1 to 100. |

## Example: The Store integrations

Request:

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

Response:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "structuredContent": {
      "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t",
      "store": {
        "id": 12,
        "name": "Demo Signs"
      },
      "integrations": [
        {
          "id": 31,
          "type": "shopify",
          "name": "Main store",
          "enabled": true,
          "accepts_writes": false,
          "settings": {
            "domain": "example.myshopify.com",
            "publication_id": null,
            "default_product_status": "active"
          }
        }
      ],
      "pagination": {
        "has_more": false,
        "next_cursor": null
      }
    }
  }
}
```

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

Request:

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

Response:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "isError": true,
    "structuredContent": {
      "error": {
        "code": "insufficient_scope",
        "title": "Insufficient scope",
        "detail": "The tool [list_integrations] requires the integrations:read scope, which this connection was not granted.",
        "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": [
          "integrations:read"
        ],
        "granted_scopes": [
          "store:read"
        ]
      }
    }
  }
}
```
