list_activity

Reads a project’s activity log, newest first. Every schema change, row write, sharing change, and refused write is listed, whether it came from the web app or an AI assistant.


Scope	`mcp:read`
Annotations	`readOnlyHint: true`

Use it to check what a previous step changed, or to answer questions such as “who deleted rows from contacts this week?”

Parameters

string

required

Project id from list_projects. Read access is enough.

string

Return only events of this kind, such as delete_rows or write.denied. See Activity events for every action.

integer

default:"100"

Events to return, from 1 to 200. Values above 200 return 200.

Result

An array of events, newest first.

string

Event id (uuid).

string

What happened, such as table.created or insert_rows.

string

web for the web app, mcp for an AI assistant.

object

Specifics for the action, such as {"table": "books", "count": 3}. See Activity events.

string

When it happened, as an ISO 8601 string in UTC.

string

The user who acted. For mcp, the user who approved the AI assistant.

string | null

The actor’s name, or null if Auxilian has none or their account was deleted.

string | null

The actor’s email address, or null if their account was deleted.

Example

Arguments

{ "projectId": "01k7m3x9q2v8d4h6n1r5t0w2yz", "action": "delete_rows", "limit": 2 }

Result

{
  "data": [
    {
      "id": "5d0c9a3e-2b7f-4e61-8f14-3a9b6c2d7e05",
      "action": "delete_rows",
      "surface": "mcp",
      "details": { "table": "contacts", "count": 4 },
      "createdAt": "2026-10-15T09:12:44.031Z",
      "actorId": "user_01K7M3X9Q2V8D4H6N1R5T0W2YZ",
      "actorName": "Ada Lovelace",
      "actorEmail": "[email protected]"
    },
    {
      "id": "b81e4f27-6c3d-4a90-9e5b-0d7f2a1c8e63",
      "action": "delete_rows",
      "surface": "web",
      "details": { "table": "deals", "count": 1 },
      "createdAt": "2026-10-14T17:40:02.918Z",
      "actorId": "user_01K7M4B2C6D8E0F2G4H6J8K0M2",
      "actorName": "Grace Hopper",
      "actorEmail": "[email protected]"
    }
  ]
}

Errors

Code	When
`ACCESS_DENIED`	The project doesn’t exist or you can’t access it

Notes

Row events record the table and the number of rows, not the values.
Events are kept for 90 days. See Activity log.

Overview

Read tools

Write tools

Destructive tools

Parameters

Result

Example

Errors

Notes

​Parameters

​Result

​Example

​Errors

​Notes

Parameters

Result

Example

Errors

Notes