​
MCP Tool: search_teams

Searches for teams using Thena’s powerful search API with advanced filtering capabilities. This tool allows you to find teams based on various criteria including name, team UID, and other team properties.

​
Example Prompt

Search for teams with "we" in their name

​
Response Fields

The response will contain a result object with the following structure:
FieldTypeDescription
foundnumberTotal number of teams found
hitsarrayArray of team objects matching the search criteria
pagenumberCurrent page number
facet_countsarrayFacet counts for search results
request_paramsobjectParameters used for the search request
search_cutoffbooleanWhether the search was cut off due to limits

​
Team Object Fields

Each team in the hits array contains a document object with the following fields:
FieldTypeDescription
idstringTeam unique identifier
namestringTeam name
iconstringTeam icon
colorstringTeam color (RGB format)
identifierstringTeam identifier/code
descriptionstringTeam description
teamOwnerstringTeam owner name
teamOwnerIdstringTeam owner ID
isActivebooleanWhether the team is active
isPrivatebooleanWhether the team is private
createdAtstring (ISO8601)Team creation timestamp
updatedAtstring (ISO8601)Last update timestamp
ticketTypesarrayAvailable ticket types for this team
tagsarrayTeam tags
prioritiesarrayAvailable ticket priorities
sentimentsarrayAvailable ticket sentiments
statusesarrayAvailable ticket statuses
formsarrayTeam forms
subTeamsarraySub-teams
ticketFieldsarrayCustom ticket fields
isDefaultTeambooleanWhether this is the default team
ticketSourcesarrayAvailable ticket sources

​
Nested Object Fields

Ticket Types:
  • id: Ticket type ID
  • name: Ticket type name
  • icon: Ticket type icon
  • color: Ticket type color
  • autoAssign: Whether tickets auto-assign
Priorities:
  • id: Priority ID
  • name: Priority name
  • description: Priority description
  • isDefault: Whether this is the default priority
Sentiments:
  • id: Sentiment ID
  • name: Sentiment name
  • isDefault: Whether this is the default sentiment
Statuses:
  • id: Status ID
  • name: Status name
  • description: Status description
  • isDefault: Whether this is the default status
Forms:
  • id: Form ID
  • name: Form name
  • description: Form description
  • fields: Array of form fields
Ticket Sources:
  • label: Source label
  • value: Source value

​
Sample Response

{
  "result": {
    "found": 1,
    "hits": [
      {
        "document": {
          "id": "THETT4QZZD9PPM",
          "name": "wed",
          "icon": "",
          "color": "rgb(155, 135, 245)",
          "identifier": "WED",
          "description": null,
          "teamOwner": "shakthi+1",
          "teamOwnerId": "UTH00SEXXFNVVN",
          "isActive": true,
          "isPrivate": false,
          "createdAt": "2025-07-09T09:17:14.954Z",
          "updatedAt": "2025-07-09T09:17:14.954Z",
          "ticketTypes": [
            {
              "id": "9W5K7QZJ10DG45E7T1FJHHF2MM32P",
              "name": "Bug",
              "icon": "",
              "color": "#db1f61",
              "autoAssign": true
            },
            {
              "id": "MW5K7QZJ106FT03R2JKSBDD9DTGQZ",
              "name": "Feature Request",
              "icon": "",
              "color": "#1f74db",
              "autoAssign": true
            },
            {
              "id": "MW5K7QZJ1068644FX44KR04C6801D",
              "name": "Question",
              "icon": "",
              "color": "#1fdb8a",
              "autoAssign": true
            },
            {
              "id": "MW5K7QZJ10QHFEJQWXBJHYPG146C3",
              "name": "Task",
              "icon": "",
              "color": "#db7a1f",
              "autoAssign": true
            }
          ],
          "tags": [],
          "priorities": [
            {
              "id": "WQ5K7QZJ102C4JKG6XE01M2G3HEAQ",
              "name": "Low",
              "description": "Low priority tickets.",
              "isDefault": false
            },
            {
              "id": "GR5K7QZJ10H0300NBSAPN5CG4TN9F",
              "name": "Medium",
              "description": "Medium priority tickets.",
              "isDefault": true
            },
            {
              "id": "GR5K7QZJ105KWTPW1AG052HBVAPNF",
              "name": "High",
              "description": "High priority tickets.",
              "isDefault": false
            },
            {
              "id": "GR5K7QZJ10RPP1CQV6KG57SM7M75E",
              "name": "Urgent",
              "description": "Urgent priority tickets.",
              "isDefault": false
            }
          ],
          "sentiments": [
            {
              "id": "4T5K7QZJ10MR5QR6KZZ43M5G3YKPH",
              "name": "Positive",
              "isDefault": false
            },
            {
              "id": "JT5K7QZJ1047VQT6M06TMANM3D9TQ",
              "name": "Negative",
              "isDefault": false
            },
            {
              "id": "JT5K7QZJ107BR5DAKC2HBC4G3NA5A",
              "name": "Neutral",
              "isDefault": true
            }
          ],
          "statuses": [
            {
              "id": "TN5K7QZJ10AXB995EXD07ZSXBYPM4",
              "name": "In progress",
              "description": "Tickets that are currently in progress and being worked on.",
              "isDefault": false
            },
            {
              "id": "VN5K7QZJ10CJK5E47S8TQSA19XCXA",
              "name": "On hold",
              "description": "Tickets that are currently on hold.",
              "isDefault": false
            },
            {
              "id": "VN5K7QZJ1042MM6W6DF59ZZAK5DTP",
              "name": "Closed",
              "description": "Tickets that are closed or resolved.",
              "isDefault": false
            },
            {
              "id": "YM5K7QZJ10NPP6GZXZTR1C2DB9AG3",
              "name": "Open",
              "description": "Tickets that are open and awaiting prioritization.",
              "isDefault": true
            }
          ],
          "forms": [
            {
              "id": "FODDKPKKXW88L",
              "name": "Default team form",
              "description": "Default form for the team",
              "fields": [
                {
                  "field": "NMW047ZJ10RJHW0W5DB19SEM5W75A",
                  "fieldType": "thena_restricted",
                  "defaultValue": null,
                  "mandatoryOnClose": true,
                  "visibleToCustomer": true,
                  "editableByCustomer": true,
                  "mandatoryOnCreation": true
                },
                {
                  "field": "NMW047ZJ109W62PM4FR82YG58KXTN",
                  "fieldType": "thena_restricted",
                  "defaultValue": null,
                  "mandatoryOnClose": true,
                  "visibleToCustomer": true,
                  "editableByCustomer": true,
                  "mandatoryOnCreation": true
                },
                {
                  "field": "NMW047ZJ10D2JAMZRM4TGPMVYYG2K",
                  "fieldType": "thena_restricted",
                  "defaultValue": null,
                  "mandatoryOnClose": true,
                  "visibleToCustomer": true,
                  "editableByCustomer": true,
                  "mandatoryOnCreation": true
                }
              ]
            },
            {
              "id": "FOCCGUHH8GEE4",
              "name": "Default team escalation form",
              "description": "Default escalation form for the team",
              "fields": [
                {
                  "field": "3PW047ZJ105ENAGR1BT2NM5PG3ZM5",
                  "fieldType": "thena_restricted",
                  "defaultValue": null,
                  "mandatoryOnClose": false,
                  "visibleToCustomer": false,
                  "editableByCustomer": true,
                  "mandatoryOnCreation": true
                }
              ]
            }
          ],
          "subTeams": [],
          "ticketFields": [],
          "isDefaultTeam": true,
          "ticketSources": [
            {
              "label": "Api",
              "value": "api"
            },
            {
              "label": "Manual",
              "value": "manual"
            },
            {
              "label": "Web",
              "value": "web"
            }
          ]
        }
      }
    ],
    "page": 1,
    "facet_counts": [],
    "request_params": {
      "search_mode": "fallback",
      "q": "*",
      "query_by": "*",
      "filter_by": "name:=we"
    },
    "search_cutoff": false
  }
}

​
Notes

  • Only authorized users can access this tool; results are scoped to the user’s organization.
  • The search API supports full-text search on team names using ILike pattern matching.
  • Team UID searches require exact matches.
  • Filters can be combined using AND or OR logic for complex queries.
  • Boolean filters use true/false values.
  • The search is case-insensitive for text fields.
  • Results are paginated with a maximum of 250 items per page.
  • Use the range operator for date ranges (e.g., “[2024-01-01..2024-12-31]”).