# List activity logs (`list_activity_logs`)

Lists the requests Sign Customiser sent and received for the connected Store, newest first, as the merchant admin Activity page shows them: each request direction, the line the admin shows, its HTTP status and duration, what caused it (an integration, a webhook or an API key, named by kind, name and the last four characters of a key) and the storefront page the shopper was on. Filters narrow it by customiser, by status (failed or success) and by causer kind. No credential, request body or header is returned. It requires the integrations:read scope and has no side effects.

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

## Purpose

Find failed requests across the Store, for example why orders or products stopped reaching a selling platform, before reading one integration with list_integration_activity_logs.

## 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 requests to return per page, between 1 and 100. Defaults to 20. |
| `cursor` | string | no | The opaque next_cursor value from the previous page, sent back with identical filters. |
| `filter` | object | no | Optional filters. An unknown filter is rejected, never ignored. |
| `filter.customiser_id` | integer | no | Only requests of this customiser. |
| `filter.status` | string | no | failed for requests that failed, success for the rest (closed). One of: `failed`, `success`. |
| `filter.causer` | string | no | Only requests caused by this kind of causer (expected to grow). One of: `api_key`, `integration`, `webhook`. |

## Result

Up to `limit` logged requests, newest 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 |  |
| `activity_logs` | array of object | yes | The page of logged requests, newest first. |
| `activity_logs[].id` | integer | yes |  |
| `activity_logs[].event` | string or null | no | The request direction: request:outgoing or request:incoming, or the older outgoing-request and incoming-request names on old rows. Expected to grow. |
| `activity_logs[].description` | string | yes | The line the merchant admin shows for the request. |
| `activity_logs[].status_code` | integer or null | no | The HTTP status of the request, or null. |
| `activity_logs[].duration_ms` | integer or null | no | How long the request took, or null. |
| `activity_logs[].causer` | object or null | no | What sent or caused the request, or null. |
| `activity_logs[].causer.kind` | string | yes | One of: `api_key`, `integration`, `webhook`. |
| `activity_logs[].causer.name` | string or null | no |  |
| `activity_logs[].causer.last_four` | string or null | no | The last four characters of an API key; null for every other kind. |
| `activity_logs[].storefront_page` | object or null | no | The storefront page the shopper was on when the request started, or null. |
| `activity_logs[].storefront_page.url` | string or null | no |  |
| `activity_logs[].storefront_page.origin` | string or null | no |  |
| `activity_logs[].storefront_page.source` | string | yes | One of: `window`, `parent`, `referrer`, `unavailable`. |
| `activity_logs[].storefront_page.availability` | string | yes | One of: `available`, `unavailable`. |
| `activity_logs[].storefront_page.captured_at` | string or null | no |  |
| `activity_logs[].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 integrations:read. |
| `invalid_cursor` | The cursor was altered or reused for a different collection, Store or filters; restart with no cursor. |
| `invalid_parameter` | A filter value is not allowed: customiser_id is not an integer from 1 to 2147483647, status is not failed or success, or causer is not api_key, integration or webhook. limit is not an integer from 1 to 100. |
| `unknown_filter` | Remove the filter named in parameter. This tool forwards unknown filter names so the API can refuse them explicitly. |

## Example: Failed requests of one customiser

Request:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_activity_logs",
    "arguments": {
      "limit": 1,
      "filter": {
        "customiser_id": 42,
        "status": "failed"
      }
    }
  }
}
```

Response:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "structuredContent": {
      "request_id": "req_01jz9x2k7c8f3m5n6p7q8r9s0t",
      "store": {
        "id": 12,
        "name": "Demo Signs"
      },
      "activity_logs": [
        {
          "id": 88123,
          "event": "request:outgoing",
          "description": "Create product on Shopify",
          "status_code": 502,
          "duration_ms": 1840,
          "causer": {
            "kind": "integration",
            "name": "Main store",
            "last_four": null
          },
          "storefront_page": null,
          "created_at": "2026-11-14T09:30:00Z"
        }
      ],
      "pagination": {
        "has_more": true,
        "next_cursor": "eyJ2IjoxfQ"
      }
    }
  }
}
```

## Example: A filter the Store-wide list does not take (error)

Request:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_activity_logs",
    "arguments": {
      "filter": {
        "integration_id": 31
      }
    }
  }
}
```

Response:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "isError": true,
    "structuredContent": {
      "error": {
        "code": "unknown_filter",
        "title": "Unknown filter",
        "detail": "The request includes filters this endpoint does not support: integration_id. Supported filters: customiser_id, status, causer.",
        "parameter": "filter[integration_id]",
        "recovery": "Remove the filter named in parameter. The list tool description names the filters the operation accepts."
      }
    }
  }
}
```
