# descope-mcp-server-stdio

> MCP Server

The Descope MCP server provides an interface to interact with Descope's Management APIs, enabling the search and retrieval of project-related information, and user management. It offers tools for audits, users, and invitations.

## Overview

- **Category:** Developer Tools
- **Language:** TypeScript
- **Stars:** 34
- **Forks:** 2
- **Owner:** descope-sample-apps
- **GitHub:** https://github.com/descope-sample-apps/descope-mcp-server-stdio
- **Created:** 2025-01-24T22:19:15+00:00
- **Updated:** 2025-03-18T18:40:50+00:00
- **Source:** https://model-context-protocol.com/servers/descope-management-api-server-user-management

## Setup

## Setup

### Installing via Smithery

To install Descope MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@descope-sample-apps/descope-mcp-server):

```bash
npx -y @smithery/cli install @descope-sample-apps/descope-mcp-server --client claude
```

### Manual Installation
1. Clone the repository:

    ```bash
    git clone https://github.com/descope-sample-apps/descope-mcp-server.git
    cd descope-mcp-server
    ```

2. Install the necessary dependencies:

    ```bash
    npm install
    ```

3. 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:

```bash
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
```

#### On Windows:

```bash
code %APPDATA%\Claude\claude_desktop_config.json
```

### 2. Add the Descope server configuration:

```json
{
  "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](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:

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.

## Tools

## Available Tools

		1. `search-audits` (Retrieves up to 10 audit log entries from your Descope project.)
		2. `search-users` (Retrieves up to 10 user records from your Descope project.)
		3. `create-user` (Creates a new user in your Descope project.)
		4. `invite-user` (Invites a new user to your Descope project.)