MCP Tool: get_all_account_activities

Retrieves a paginated list of all activities for a specific account. This tool supports pagination for efficient data retrieval and provides comprehensive activity information including type, status, participants, and timing details.

Example Prompt

Get all activities for account ACC001

Input Parameters

NameTypeRequiredDescription
accountIdstringYesThe identifier of the account to find activities for
pagenumberNoPage number for pagination (default: 1)
limitnumberNoNumber of activities per page (default: 10)

Response Fields

Below are the fields you may see in each account activity object in the response:
FieldTypeDescription
idstringUnique identifier of the activity
accountIdstringID of the account the activity belongs to
accountstringName of the account
activityTimestampstring (ISO8601)Timestamp when the activity occurred
durationnumberDuration of the activity in minutes
locationstringLocation where the activity took place
titlestringTitle of the activity
descriptionstringDescription of the activity
typestringThe type of the activity (e.g., “Meeting”, “Call”, “Email”)
typeIdstringID of the activity type attribute
typeConfigurationobjectConfiguration of the activity type
statusstringThe status of the activity (e.g., “Completed”, “Scheduled”)
statusIdstringID of the activity status attribute
statusConfigurationobjectConfiguration of the activity status
participantsarrayArray of participant names
creatorstringName of the activity creator
creatorIdstringID of the activity creator
creatorEmailstringEmail of the activity creator
attachmentsarrayArray of file attachments for the activity
metadataobjectAdditional metadata for the activity
createdAtstring (ISO8601)Creation timestamp
updatedAtstring (ISO8601)Last update timestamp

Sample Response

{
  "data": [
    {
      "id": "ACTIVITY001",
      "accountId": "ACC001",
      "account": "Acme Corporation",
      "activityTimestamp": "2025-07-24T10:00:00Z",
      "duration": 60,
      "location": "Conference Room A",
      "title": "Quarterly Business Review",
      "description": "Q2 2025 business review meeting to discuss performance metrics and strategic initiatives.",
      "type": "Meeting",
      "typeId": "TYPE001",
      "typeConfiguration": {
        "id": "TYPE001",
        "name": "Meeting",
        "color": "#3B82F6"
      },
      "status": "Completed",
      "statusId": "STATUS001",
      "statusConfiguration": {
        "id": "STATUS001",
        "name": "Completed",
        "color": "#10B981"
      },
      "participants": ["John Smith", "Jane Doe", "Bob Johnson"],
      "creator": "John Doe",
      "creatorId": "USER001",
      "creatorEmail": "john.doe@company.com",
      "attachments": [
        {
          "id": "ATTACH001",
          "fileName": "qbr_presentation.pdf",
          "fileSize": 2048000,
          "fileType": "application/pdf",
          "url": "https://example.com/files/qbr_presentation.pdf"
        }
      ],
      "metadata": {
        "priority": "high",
        "tags": ["business-review", "quarterly"],
        "followUpRequired": true
      },
      "createdAt": "2025-07-24T07:19:10.258Z",
      "updatedAt": "2025-07-24T07:19:10.258Z"
    },
    {
      "id": "ACTIVITY002",
      "accountId": "ACC001",
      "account": "Acme Corporation",
      "activityTimestamp": "2025-07-23T14:30:00Z",
      "duration": 30,
      "location": "Phone Call",
      "title": "Follow-up Call",
      "description": "Follow-up call to discuss the technical requirements for the new feature implementation.",
      "type": "Call",
      "typeId": "TYPE002",
      "typeConfiguration": {
        "id": "TYPE002",
        "name": "Call",
        "color": "#8B5CF6"
      },
      "status": "Completed",
      "statusId": "STATUS001",
      "statusConfiguration": {
        "id": "STATUS001",
        "name": "Completed",
        "color": "#10B981"
      },
      "participants": ["John Smith", "Jane Doe"],
      "creator": "Jane Smith",
      "creatorId": "USER002",
      "creatorEmail": "jane.smith@company.com",
      "attachments": [],
      "metadata": {
        "priority": "medium",
        "tags": ["follow-up", "technical"],
        "followUpRequired": false
      },
      "createdAt": "2025-07-23T08:19:10.258Z",
      "updatedAt": "2025-07-23T08:19:10.258Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 2,
    "totalPages": 1
  },
  "status": true,
  "message": "Account activities retrieved successfully!",
  "timestamp": "2025-07-25T12:50:38.937Z"
}