> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thena.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get event registry

> MCP tool to retrieve available events that can trigger workflows from the Thena platform.

import Admonition from '@theme/Admonition';

### MCP tool: `get_event_registry`

Retrieves the event registry for a specific team, showing all available events that can be used to trigger workflows. This tool helps you discover what events are available for workflow configuration.

<Admonition type="note">
  You must provide the team ID to retrieve the event registry for that specific team.
</Admonition>

### Example prompt

```prompt theme={null}
Get event registry for team "TEAM001"
```

<Admonition type="info">
  When you use this prompt in a chat with the model (with the MCP tool registered), the model will automatically call the <code>get\_event\_registry</code> tool with the correct arguments.
</Admonition>

### Input parameters

| Name   | Type   | Required | Description                             |
| ------ | ------ | -------- | --------------------------------------- |
| teamId | string | Yes      | The team ID to fetch event registry for |

### Response fields

Below are the fields you may see in each event object in the response:

<table>
  <thead>
    <tr>
      <th>Field</th>
      <th>Type</th>
      <th>Description</th>
    </tr>
  </thead>

  <tbody>
    <tr><td>id</td><td>string</td><td>The unique identifier of the event</td></tr>
    <tr><td>name</td><td>string</td><td>The name of the event</td></tr>
    <tr><td>description</td><td>string</td><td>The description of the event</td></tr>
    <tr><td>category</td><td>string</td><td>The category of the event</td></tr>
    <tr><td>schema</td><td>object</td><td>The JSON schema for the event payload</td></tr>
    <tr><td>isActive</td><td>boolean</td><td>Whether the event is active and available</td></tr>
    <tr><td>createdAt</td><td>string (ISO8601)</td><td>The creation timestamp</td></tr>
    <tr><td>updatedAt</td><td>string (ISO8601)</td><td>The last update timestamp</td></tr>
  </tbody>
</table>

### Sample response

```json theme={null}
{
  "data": [
    {
      "id": "EVENT001",
      "name": "ticket.created",
      "description": "Triggered when a new ticket is created",
      "category": "ticket",
      "schema": {
        "type": "object",
        "properties": {
          "ticketId": {
            "type": "string",
            "description": "The unique identifier of the ticket"
          },
          "title": {
            "type": "string",
            "description": "The title of the ticket"
          },
          "priority": {
            "type": "string",
            "enum": ["low", "medium", "high", "urgent"],
            "description": "The priority level of the ticket"
          },
          "team": {
            "type": "string",
            "description": "The team assigned to the ticket"
          },
          "accountId": {
            "type": "string",
            "description": "The account ID associated with the ticket"
          },
          "createdBy": {
            "type": "string",
            "description": "The user who created the ticket"
          }
        },
        "required": ["ticketId", "title", "priority", "team"]
      },
      "isActive": true,
      "createdAt": "2025-07-24T07:19:10.258Z",
      "updatedAt": "2025-07-24T07:19:10.258Z"
    },
    {
      "id": "EVENT002",
      "name": "ticket.updated",
      "description": "Triggered when a ticket is updated",
      "category": "ticket",
      "schema": {
        "type": "object",
        "properties": {
          "ticketId": {
            "type": "string",
            "description": "The unique identifier of the ticket"
          },
          "changes": {
            "type": "object",
            "description": "The changes made to the ticket"
          },
          "updatedBy": {
            "type": "string",
            "description": "The user who updated the ticket"
          }
        },
        "required": ["ticketId", "changes"]
      },
      "isActive": true,
      "createdAt": "2025-07-24T07:19:10.258Z",
      "updatedAt": "2025-07-24T07:19:10.258Z"
    },
    {
      "id": "EVENT003",
      "name": "comment.created",
      "description": "Triggered when a new comment is created",
      "category": "comment",
      "schema": {
        "type": "object",
        "properties": {
          "commentId": {
            "type": "string",
            "description": "The unique identifier of the comment"
          },
          "entityType": {
            "type": "string",
            "enum": ["ticket", "account", "contact"],
            "description": "The type of entity the comment is on"
          },
          "entityId": {
            "type": "string",
            "description": "The ID of the entity"
          },
          "author": {
            "type": "string",
            "description": "The author of the comment"
          },
          "visibility": {
            "type": "string",
            "enum": ["public", "private"],
            "description": "The visibility of the comment"
          }
        },
        "required": ["commentId", "entityType", "entityId", "author"]
      },
      "isActive": true,
      "createdAt": "2025-07-24T07:19:10.258Z",
      "updatedAt": "2025-07-24T07:19:10.258Z"
    },
    {
      "id": "EVENT004",
      "name": "account.created",
      "description": "Triggered when a new account is created",
      "category": "account",
      "schema": {
        "type": "object",
        "properties": {
          "accountId": {
            "type": "string",
            "description": "The unique identifier of the account"
          },
          "name": {
            "type": "string",
            "description": "The name of the account"
          },
          "industry": {
            "type": "string",
            "description": "The industry of the account"
          },
          "createdBy": {
            "type": "string",
            "description": "The user who created the account"
          }
        },
        "required": ["accountId", "name"]
      },
      "isActive": true,
      "createdAt": "2025-07-24T07:19:10.258Z",
      "updatedAt": "2025-07-24T07:19:10.258Z"
    }
  ],
  "status": true,
  "message": "Event registry retrieved successfully!",
  "timestamp": "2025-07-25T12:50:38.937Z"
}
```

<Admonition type="tip">
  Always pass an object as input, even if empty, to avoid errors when calling the tool directly.
</Admonition>

***