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.
2.1K
4 Tools
Packaged by
Requires Configuration
Requires Secrets
Add to Docker Desktop
Version 4.43 or later needs to be installed to add the server automatically
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.
Characteristics
| Attribute | Details |
|---|---|
| Docker Image | mcp/descope |
| Author | descope-sample-apps |
| Repository | https://github.com/descope-sample-apps/descope-mcp-server |
| Dockerfile | https://github.com/descope-sample-apps/descope-mcp-server/blob/main/Dockerfile |
| 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 | arrayoptional | Additional login identifiers |
customAttributes | objectoptional | Custom attributes for the user |
displayName | stringoptional | User's display name |
email | stringoptional | User's email address |
familyName | stringoptional | User's family/last name |
givenName | stringoptional | User's given/first name |
middleName | stringoptional | User's middle name |
phone | stringoptional | User's phone number in E.164 format |
picture | stringoptional | URL to user's profile picture |
roles | arrayoptional | Global role names to assign to the user |
ssoAppIds | arrayoptional | SSO application IDs to associate |
userTenants | arrayoptional | Tenant associations with specific roles |
verifiedEmail | booleanoptional | Whether the email is pre-verified |
verifiedPhone | booleanoptional | 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 | arrayoptional | Additional login identifiers |
customAttributes | objectoptional | Custom attributes for the user |
displayName | stringoptional | User's display name |
email | stringoptional | User's email address |
familyName | stringoptional | User's family/last name |
givenName | stringoptional | User's given/first name |
inviteUrl | stringoptional | Custom URL for the invitation link |
middleName | stringoptional | User's middle name |
phone | stringoptional | User's phone number in E.164 format |
picture | stringoptional | URL to user's profile picture |
roles | arrayoptional | Global role names to assign to the user |
sendMail | booleanoptional | Send invite via email (default follows project settings) |
sendSMS | booleanoptional | Send invite via SMS (default follows project settings) |
ssoAppIds | arrayoptional | SSO application IDs to associate |
templateId | stringoptional | Custom template ID for the invitation |
templateOptions | objectoptional | Options for customizing the invitation template |
userTenants | arrayoptional | Tenant associations with specific roles |
verifiedEmail | booleanoptional | Whether the email is pre-verified |
verifiedPhone | booleanoptional | Whether the phone is pre-verified |
Tool: search-audits
Search Descope project audit logs
| Parameters | Type | Description |
|---|---|---|
actions | arrayoptional | Filter by specific action types |
excludedActions | arrayoptional | Actions to exclude from results |
geos | arrayoptional | Filter by geographic locations |
hoursBack | numberoptional | Hours to look back (max 720 hours / 30 days) |
limit | numberoptional | Number of audit logs to fetch (max 10) |
loginIds | arrayoptional | Filter by specific login IDs |
methods | arrayoptional | Filter by authentication methods |
noTenants | booleanoptional | If true, only show events without tenants |
tenants | arrayoptional | Filter by specific tenant IDs |
Tool: search-users
Search for users in Descope project
| Parameters | Type | Description |
|---|---|---|
emails | arrayoptional | Filter by specific email addresses |
limit | numberoptional | Number of users per page (max 100) |
loginIds | arrayoptional | Filter by specific login IDs |
page | numberoptional | Page number for pagination |
phones | arrayoptional | Filter by specific phone numbers |
roles | arrayoptional | Filter users by role names |
ssoAppIds | arrayoptional | Filter users by SSO application IDs |
statuses | arrayoptional | Filter by user statuses ('enabled', 'disabled', or 'invited') |
tenantIds | arrayoptional | Filter users by specific tenant IDs |
testUsersOnly | booleanoptional | Return only test users |
text | stringoptional | Text to search for in user fields |
withTestUser | booleanoptional | 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"
}
}
}
}
Manual installation
You can install the MCP server using:
Installation for