search-users

Name	Required	Description
`emails`	No	Filter by specific email addresses
`limit`	No	Number of users per page (max 100)
`loginIds`	No	Filter by specific login IDs
`page`	No	Page number for pagination
`phones`	No	Filter by specific phone numbers
`roles`	No	Filter users by role names
`ssoAppIds`	No	Filter users by SSO application IDs
`statuses`	No	Filter by user statuses ('enabled', 'disabled', or 'invited')
`tenantIds`	No	Filter users by specific tenant IDs
`testUsersOnly`	No	Return only test users
`text`	No	Text to search for in user fields
`withTestUser`	No	Include test users in results

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "emails": {
      "description": "Filter by specific email addresses",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "limit": {
      "default": 10,
      "description": "Number of users per page (max 100)",
      "maximum": 100,
      "minimum": 1,
      "type": "number"
    },
    "loginIds": {
      "description": "Filter by specific login IDs",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "page": {
      "description": "Page number for pagination",
      "minimum": 0,
      "type": "number"
    },
    "phones": {
      "description": "Filter by specific phone numbers",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "roles": {
      "description": "Filter users by role names",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "ssoAppIds": {
      "description": "Filter users by SSO application IDs",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "statuses": {
      "description": "Filter by user statuses ('enabled', 'disabled', or 'invited')",
      "items": {
        "enum": [
          "enabled",
          "disabled",
          "invited"
        ],
        "type": "string"
      },
      "type": "array"
    },
    "tenantIds": {
      "description": "Filter users by specific tenant IDs",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "testUsersOnly": {
      "description": "Return only test users",
      "type": "boolean"
    },
    "text": {
      "description": "Text to search for in user fields",
      "type": "string"
    },
    "withTestUser": {
      "description": "Include test users in results",
      "type": "boolean"
    }
  },
  "type": "object"
}

descope-mcp-server

Input Schema

Input Schema (JSON Schema)

Other Tools