search-users

search-users

Filter and search for Descope project users by email, login ID, phone, role, status, or tenant. Supports pagination and includes options for test users.

Instructions

Search for users in Descope project

Input Schema

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

Input Schema (JSON Schema)

{
  "$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

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from descope-mcp-server

Related Tools