MCP Tool: get_activity_registry

Retrieves the activity registry for a specific team, showing all available activities that can be used in workflow steps. This tool helps you discover what actions are available for workflow configuration.

Example Prompt

Get activity registry for team "TEAM001"

Input Parameters

NameTypeRequiredDescription
teamIdstringYesThe team ID to fetch activity registry for

Response Fields

Below are the fields you may see in each activity object in the response:
FieldTypeDescription
idstringThe unique identifier of the activity
namestringThe name of the activity
uniqueIdentifierstringThe unique identifier used in workflow definitions
descriptionstringThe description of the activity
categorystringThe category of the activity
versionnumberThe version of the activity
inputSchemaobjectThe JSON schema for the activity input parameters
outputSchemaobjectThe JSON schema for the activity output
isActivebooleanWhether the activity is active and available
createdAtstring (ISO8601)The creation timestamp
updatedAtstring (ISO8601)The last update timestamp

Sample Response

{
  "data": [
    {
      "id": "ACTIVITY001",
      "name": "Send Notification",
      "uniqueIdentifier": "notification.activity",
      "description": "Sends notifications to specified recipients via email, Slack, or other channels",
      "category": "communication",
      "version": 2,
      "inputSchema": {
        "type": "object",
        "properties": {
          "recipients": {
            "type": "array",
            "items": { "type": "string" },
            "description": "List of recipient identifiers (emails, user IDs, or channel names)"
          },
          "message": {
            "type": "string",
            "description": "The message content to send"
          },
          "priority": {
            "type": "string",
            "enum": ["low", "normal", "high", "urgent"],
            "description": "The priority level of the notification"
          },
          "channel": {
            "type": "string",
            "enum": ["email", "slack", "sms", "webhook"],
            "description": "The notification channel to use"
          },
          "template": {
            "type": "string",
            "description": "Optional template ID to use for formatting"
          }
        },
        "required": ["recipients", "message"]
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "notificationId": {
            "type": "string",
            "description": "The unique identifier of the sent notification"
          },
          "sentTo": {
            "type": "array",
            "items": { "type": "string" },
            "description": "List of recipients who received the notification"
          },
          "deliveryStatus": {
            "type": "string",
            "enum": ["sent", "delivered", "failed"],
            "description": "The delivery status of the notification"
          },
          "timestamp": {
            "type": "string",
            "format": "date-time",
            "description": "The timestamp when the notification was sent"
          }
        }
      },
      "isActive": true,
      "createdAt": "2025-07-24T07:19:10.258Z",
      "updatedAt": "2025-07-24T07:19:10.258Z"
    },
    {
      "id": "ACTIVITY002",
      "name": "Assign Ticket",
      "uniqueIdentifier": "assignment.activity",
      "description": "Assigns tickets to agents based on skills, availability, and load balancing",
      "category": "ticket-management",
      "version": 1,
      "inputSchema": {
        "type": "object",
        "properties": {
          "ticketId": {
            "type": "string",
            "description": "The ID of the ticket to assign"
          },
          "priority": {
            "type": "string",
            "enum": ["low", "medium", "high", "urgent"],
            "description": "The priority level of the ticket"
          },
          "skillSet": {
            "type": "array",
            "items": { "type": "string" },
            "description": "Required skills for the agent"
          },
          "autoAssign": {
            "type": "boolean",
            "description": "Whether to automatically assign or just find candidates"
          },
          "loadBalancing": {
            "type": "boolean",
            "description": "Whether to consider current workload in assignment"
          }
        },
        "required": ["ticketId"]
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "assignedAgentId": {
            "type": "string",
            "description": "The ID of the assigned agent"
          },
          "assignedAgentName": {
            "type": "string",
            "description": "The name of the assigned agent"
          },
          "assignmentReason": {
            "type": "string",
            "description": "The reason for the assignment decision"
          },
          "candidatesConsidered": {
            "type": "number",
            "description": "Number of agents considered for assignment"
          }
        }
      },
      "isActive": true,
      "createdAt": "2025-07-24T07:19:10.258Z",
      "updatedAt": "2025-07-24T07:19:10.258Z"
    },
    {
      "id": "ACTIVITY003",
      "name": "Update Ticket Status",
      "uniqueIdentifier": "status-update.activity",
      "description": "Updates the status of a ticket with optional comments",
      "category": "ticket-management",
      "version": 1,
      "inputSchema": {
        "type": "object",
        "properties": {
          "ticketId": {
            "type": "string",
            "description": "The ID of the ticket to update"
          },
          "status": {
            "type": "string",
            "description": "The new status to set"
          },
          "comment": {
            "type": "string",
            "description": "Optional comment to add with the status update"
          },
          "addTimestamp": {
            "type": "boolean",
            "description": "Whether to add a timestamp to the comment"
          }
        },
        "required": ["ticketId", "status"]
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "updatedTicketId": {
            "type": "string",
            "description": "The ID of the updated ticket"
          },
          "previousStatus": {
            "type": "string",
            "description": "The previous status of the ticket"
          },
          "newStatus": {
            "type": "string",
            "description": "The new status of the ticket"
          },
          "commentId": {
            "type": "string",
            "description": "The ID of the added comment (if any)"
          }
        }
      },
      "isActive": true,
      "createdAt": "2025-07-24T07:19:10.258Z",
      "updatedAt": "2025-07-24T07:19:10.258Z"
    },
    {
      "id": "ACTIVITY004",
      "name": "Sleep/Wait",
      "uniqueIdentifier": "sleep.activity",
      "description": "Pauses workflow execution for a specified duration",
      "category": "control-flow",
      "version": 1,
      "inputSchema": {
        "type": "object",
        "properties": {
          "duration": {
            "type": "number",
            "description": "Duration to sleep in seconds"
          },
          "reason": {
            "type": "string",
            "description": "Optional reason for the sleep"
          }
        },
        "required": ["duration"]
      },
      "outputSchema": {
        "type": "object",
        "properties": {
          "sleptFor": {
            "type": "number",
            "description": "Actual duration slept in seconds"
          },
          "startTime": {
            "type": "string",
            "format": "date-time",
            "description": "When the sleep started"
          },
          "endTime": {
            "type": "string",
            "format": "date-time",
            "description": "When the sleep ended"
          }
        }
      },
      "isActive": true,
      "createdAt": "2025-07-24T07:19:10.258Z",
      "updatedAt": "2025-07-24T07:19:10.258Z"
    }
  ],
  "status": true,
  "message": "Activity registry retrieved successfully!",
  "timestamp": "2025-07-25T12:50:38.937Z"
}