Descope MCP Server
Description
# Descope MCP Server [](https://smithery.ai/server/@descope-sample-apps/descope-mcp-server) ## Introduction The Descope Model Context Protocol (MCP) server provides an interface to interact with…
About
# Descope MCP Server [](https://smithery.ai/server/@descope-sample-apps/descope-mcp-server) ## Introduction The Descope Model Context Protocol (MCP) server provides an interface to interact with Descope's Management APIs, enabling the…
Details
- Author
- descope-sample-apps
- GitHub stars
- 32
- Downloads
- 177
- Categories
- Other
Jump to
- Search audit logs (up to 10 entries)
- Search user records (up to 10 users)
- Create new users in your Descope project
- Invite new users to your Descope project
- Runs on stdio or SSE transport
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Descope MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install the server via Smithery (npx -y @smithery/cli install @descope-sample-apps/descope-mcp-server --client claude) or manually clone the repo, run npm install and npm run build. Configure Claude Desktop by adding the server to claude_desktop_config.json with your Descope Project ID and Management Key as environment variables, then restart Claude Desktop.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"descope mcp server": {
"descope-mcp-server": {
"command": "node",
"args": [
"--version",
"#",
"Expected",
"output:",
"v18.0.0",
"or",
"later"
]
}
}
}
}McpServers
{
"descope-mcp-server": {
"command": "node",
"args": [
"--version",
"#",
"Expected",
"output:",
"v18.0.0",
"or",
"later"
]
}
}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.
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 later
Setup 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 claude
Manual Installation
1. Clone the repository: git clone https://github.com/descope-sample-apps/descope-mcp-server.git
cd descope-mcp-server
2. Install the necessary dependencies:
npm install
3. Build 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.json
On Windows:
code %APPDATA%\Claude\claude_desktop_config.json
2. 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:
1. Fully quit Claude Desktop (ensure it's not just minimized).
2. Relaunch Claude Desktop.
3. Check for the 🔌 icon to confirm the Descope server is connected.
Running the server
First, build the project:
npm run build
1. Running the server on stdio
npm run start:stdio
2. Running the server on SSE
npm run start:sse
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
