descope-mcp-server

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

Clone the repository:
git clone https://github.com/descope-sample-apps/descope-mcp-server.git cd descope-mcp-server
Install the necessary dependencies:
npm install
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:

Fully quit Claude Desktop (ensure it's not just minimized).
Relaunch Claude Desktop.
Check for the 🔌 icon to confirm the Descope server is connected.

Claude Desktop with Descope MCP Server x5

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

Deploy Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Interact with Descope's Management APIs to manage users, audit, and more.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Ghost MCP Server
mtane0412
-
security
F
license
-
quality
Integrates with the Ghost Admin API to allow programmatic management of Ghost CMS features, including posts, pages, tags, authors, members, and image uploads, providing efficient content management capabilities.
Last updated -
6
2
Discogs MCP Server
cswkim
A
security
A
license
A
quality
Enables interactions with the Discogs API for music catalog operations and search functionality, allowing users to manage their Discogs collections through natural language.
Last updated -
53
55
46
MIT License
Zoom API MCP Server
heesookiim
-
security
F
license
-
quality
Enables interaction with Zoom services through the Zoom API. Provides access to meeting management, user administration, and other Zoom platform features through natural language commands.
Last updated -
Azure DevOps MCP Proxy
ennuiii
-
security
F
license
-
quality
Enables interaction with Azure DevOps through Personal Access Token authentication. Supports work item management, wiki operations, project/repository listing, and build pipeline access through natural language.
Last updated -

View all related MCP servers

descope-mcp-server