descope-mcp-server
OfficialThe Descope MCP Server allows you to interact with Descope's Management APIs to manage and retrieve project-related information. You can:
Search audit logs: Retrieve audit log entries with filters for locations, action types, authentication methods, tenant IDs, and more
Search users: Find user records with filters like roles, email addresses, phone numbers, login IDs, statuses, and tenant IDs
Create users: Add new users to your Descope project, specifying details like email, phone, roles, and custom attributes
Invite users: Create and invite new users to your project with customizable invitation options
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@descope-mcp-server search for recent audit logs from the last 24 hours"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Descope MCP Server
Introduction
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.
Related MCP server: Dify Management MCP
Available Tools
search-audits: Retrieves up to 10 audit log entries from your Descope project.search-users: Retrieves up to 10 user records from your Descope project.create-user: Creates a new user in your Descope project.invite-user: Invites a new user to your Descope project.
Requirements
Before proceeding, make sure you have the following:
Node.js (version 18 or later)
Claude Desktop installed on your system
A valid Descope Project ID and Management Key
Git installed
To confirm your Node.js installation, run:
node --version # Expected output: v18.0.0 or laterSetup Instructions
Installing via Smithery
To install Descope MCP Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @descope-sample-apps/descope-mcp-server --client claudeManual Installation
Clone the repository:
git clone https://github.com/descope-sample-apps/descope-mcp-server.git cd descope-mcp-serverInstall the necessary dependencies:
npm installBuild the project:
npm run build
Configuration
1. Configure Claude Desktop to recognize the Descope MCP server
To locate the claude_desktop_config.json file, open the Claude Desktop app and enable Developer Mode from the top-left menu bar.
Once enabled, go to Settings (also in the top-left menu), navigate to the Developer section, and click the Edit Config button to access and edit claude_desktop_config.json.
Alternatively, to open the configuration file via terminal:
On macOS:
code ~/Library/Application\ Support/Claude/claude_desktop_config.jsonOn Windows:
code %APPDATA%\Claude\claude_desktop_config.json2. Add the Descope server configuration:
{
"mcpServers": {
"descope": {
"command": "node",
"args": ["/path/to/descope-mcp-server/build/index.js"],
"env": {
"DESCOPE_PROJECT_ID": "your-descope-project-id-here",
"DESCOPE_MANAGEMENT_KEY": "your-descope-management-key-here"
}
}
}
}Replace your-descope-project-id-here and your-descope-management-key-here with your actual Descope Project ID and Management Key from app.descope.com/settings/project and app.descope.com/settings/company/managementkeys.
3. Restart Claude Desktop
To apply the changes:
Fully quit Claude Desktop (ensure it's not just minimized).
Relaunch Claude Desktop.
Check for the 🔌 icon to confirm the Descope server is connected.
Running the server
First, build the project:
npm run build1. Running the server on stdio
npm run start:stdio2. Running the server on SSE
npm run start:sseAvailable Tools
4 toolscreate-userC
Create a new user in Descope project
Inputs: loginId (required), additionalLoginIds, email, verifiedEmail, +11 more.
invite-userC
Create and invite a new user to the Descope project
Inputs: loginId (required), additionalLoginIds, email, verifiedEmail, +16 more.
search-auditsC
Search Descope project audit logs
Inputs: loginIds, actions, excludedActions, tenants, +5 more.
search-usersC
Search for users in Descope project
Inputs: text, emails, phones, statuses, +8 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
The tools 'create-user' and 'invite-user' have significant overlap in purpose, as both involve creating new users, which could cause confusion for an agent. The other tools target distinct resources (audits vs. users), but the core user creation ambiguity is problematic.
All tool names follow a consistent verb_noun pattern with hyphens (e.g., create-user, search-audits), making them predictable and readable. There are no deviations in naming style across the set.
With only 4 tools, the set feels thin for a user management and audit domain, potentially lacking operations like update-user, delete-user, or get-user. However, it covers basic creation and search functions, placing it in a borderline range.
For a user management server, there are significant gaps: no update, delete, or get operations for users, and audit functionality is limited to search only. This incomplete surface will likely cause agent failures in handling full user lifecycles.
Maintenance
Related MCP Connectors
Manage your WorkOS workspace in plain language: orgs, users, SSO, Directory Sync, and AuthKit.
Manage API keys, identities, permissions, rate-limit overrides and verification analytics.
Users, organizations, roles, permissions, applications and feature flags.
Inspect RudderStack workspaces, pipelines, and schemas, and manage transformations and audiences.
Related MCP Servers
- AlicenseBqualityAmaintenanceEnables interaction with the Admina API to manage and query organizational SaaS resources including devices, user identities, service integrations, and account information across multiple services.31326 npm6Apache 2.0
- FlicenseNot gradedqualityCmaintenanceAllows programmatic management of a Dify instance, including listing and creating datasets, managing applications, and tool providers.-
- FlicenseNot gradedqualityDmaintenanceEnables programmatic management of a Dify instance, including datasets, apps, and tools.-

ConfigCat MCP Serverofficial
AlicenseCqualityBmaintenanceProvides access to ConfigCat's management API for feature flag and configuration management, enabling CRUD operations on entities like feature flags, configs, environments, and products, as well as SDK documentation.961,488 npm17MIT