Descope

The Descope Model Context Protocol (MCP) server provides an interface to interact with Descope's Management APIs, enabling the search and retrieval of project-related information.

10K+4 ToolsPackaged byRequires ConfigurationRequires Secrets

Overview Tools (4)Config

Docker Hub Github repository

Use cases

About

Descope MCP Server

The Descope Model Context Protocol (MCP) server provides an interface to interact with Descope's Management APIs, enabling the search and retrieval of project-related information.

What is an MCP Server?⁠

MCP Info

Attribute	Details
Docker Image	mcp/descope⁠
Author	descope-sample-apps⁠
Repository	https://github.com/descope-sample-apps/descope-mcp-server⁠

Image Building Info

Attribute	Details
Dockerfile	https://github.com/descope-sample-apps/descope-mcp-server/blob/e983c18dd340924aa40a1c72ab6608b8b0b35ee7/Dockerfile⁠
Commit	`e983c18dd340924aa40a1c72ab6608b8b0b35ee7`
Docker Image built by	Docker Inc.
Docker Scout Health Score
Verify Signature	`COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/descope --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub`
Licence	MIT License

Available Tools (4)

Tools provided by this Server	Short Description
`create-user`	Create a new user in Descope project
`invite-user`	Create and invite a new user to the Descope project
`search-audits`	Search Descope project audit logs
`search-users`	Search for users in Descope project

Tools Details

Tool: `create-user`

Create a new user in Descope project

Parameters	Type	Description
`loginId`	`string`	Primary login identifier for the user
`additionalLoginIds`	`array`optional	Additional login identifiers
`customAttributes`	`object`optional	Custom attributes for the user
`displayName`	`string`optional	User's display name
`email`	`string`optional	User's email address
`familyName`	`string`optional	User's family/last name
`givenName`	`string`optional	User's given/first name
`middleName`	`string`optional	User's middle name
`phone`	`string`optional	User's phone number in E.164 format
`picture`	`string`optional	URL to user's profile picture
`roles`	`array`optional	Global role names to assign to the user
`ssoAppIds`	`array`optional	SSO application IDs to associate
`userTenants`	`array`optional	Tenant associations with specific roles
`verifiedEmail`	`boolean`optional	Whether the email is pre-verified
`verifiedPhone`	`boolean`optional	Whether the phone is pre-verified

Tool: `invite-user`

Create and invite a new user to the Descope project

Parameters	Type	Description
`loginId`	`string`	Primary login identifier for the user
`additionalLoginIds`	`array`optional	Additional login identifiers
`customAttributes`	`object`optional	Custom attributes for the user
`displayName`	`string`optional	User's display name
`email`	`string`optional	User's email address
`familyName`	`string`optional	User's family/last name
`givenName`	`string`optional	User's given/first name
`inviteUrl`	`string`optional	Custom URL for the invitation link
`middleName`	`string`optional	User's middle name
`phone`	`string`optional	User's phone number in E.164 format
`picture`	`string`optional	URL to user's profile picture
`roles`	`array`optional	Global role names to assign to the user
`sendMail`	`boolean`optional	Send invite via email (default follows project settings)
`sendSMS`	`boolean`optional	Send invite via SMS (default follows project settings)
`ssoAppIds`	`array`optional	SSO application IDs to associate
`templateId`	`string`optional	Custom template ID for the invitation
`templateOptions`	`object`optional	Options for customizing the invitation template
`userTenants`	`array`optional	Tenant associations with specific roles
`verifiedEmail`	`boolean`optional	Whether the email is pre-verified
`verifiedPhone`	`boolean`optional	Whether the phone is pre-verified

Tool: `search-audits`

Search Descope project audit logs

Parameters	Type	Description
`actions`	`array`optional	Filter by specific action types
`excludedActions`	`array`optional	Actions to exclude from results
`geos`	`array`optional	Filter by geographic locations
`hoursBack`	`number`optional	Hours to look back (max 720 hours / 30 days)
`limit`	`number`optional	Number of audit logs to fetch (max 10)
`loginIds`	`array`optional	Filter by specific login IDs
`methods`	`array`optional	Filter by authentication methods
`noTenants`	`boolean`optional	If true, only show events without tenants
`tenants`	`array`optional	Filter by specific tenant IDs

Tool: `search-users`

Search for users in Descope project

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

Use this MCP Server

{
  "mcpServers": {
    "descope": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DESCOPE_PROJECT_ID",
        "-e",
        "DESCOPE_MANAGEMENT_KEY",
        "mcp/descope"
      ],
      "env": {
        "DESCOPE_PROJECT_ID": "your-descope-project-id-here",
        "DESCOPE_MANAGEMENT_KEY": "your-descope-management-key-here"
      }
    }
  }
}

Why is it safer to run MCP Servers with Docker?⁠