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 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](https://nodejs.org/) (version 18 or later)
- [Claude Desktop](https://claude.ai/download) installed on your system
- A valid Descope [Project ID](https://app.descope.com/settings/project) and [Management Key](https://app.descope.com/settings/company/managementkeys)
- Git installed
To confirm your Node.js installation, run:
Setup Instructions
Installing via Smithery
To install Descope MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@descope-sample-apps/descope-mcp-server):
Manual Installation
- Clone the repository: ```bash git clone https://github.com/descope-sample-apps/descope-mcp-server.git cd descope-mcp-server ```
- Install the necessary dependencies: ```bash npm install ```
- Build the project: ```bash 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:
On Windows:
2. Add the Descope server configuration:
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](https://app.descope.com/settings/project) and [app.descope.com/settings/company/managementkeys](https://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: