What is Descope

The Descope Model Context Protocol (MCP) server serves as an interface for interacting with Descope’s Management APIs. It facilitates the searching and retrieval of project-related information, enabling users to manage their Descope projects efficiently.

Use cases

The server can be used to retrieve audit logs, manage user records, create new users, and invite users to a Descope project. This functionality is essential for project administration, security audits, and user management, making it valuable for teams utilizing Descope for authentication and user management.

How to use

To use the MCP server, install it either via Smithery or manually by cloning the repository, installing dependencies, and building the project. Configure it in Claude Desktop to recognize the server by editing the claude_desktop_config.json with the appropriate command and Descope credentials. After setup, run the server in standard input/output or server-sent events mode.

Key features

Key features include the ability to search for up to 10 audit log entries and user records, the ability to create new users, and sending invitations to users. It operates with a straightforward command-line interface and integrates seamlessly with Claude Desktop for enhanced project management.

Where to use

The MCP server is primarily used in environments where Descope’s authentication and user management services are implemented. It is particularly beneficial for development teams and project managers who need to interact with the backend of Descope projects for operational and administrative tasks.

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