Descope Authentication API MCP Server

SecurityJavaScript

Access and manage Descope authentication services directly from Claude

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

The Descope Authentication API provides a seamless interface to interact with Descope's Management APIs from within Claude Desktop. This integration enables you to search and retrieve user information, audit logs, and perform user management operations like creating and inviting users to your Descope projects without leaving your AI assistant.

Overview

The Descope Authentication API allows you to interact with Descope's user management and authentication services directly from Claude Desktop. This integration provides a convenient way to search for users, review audit logs, create new users, and send invitations without switching between applications.

Requirements

Before setting up the Descope Authentication API, ensure you have:

Node.js version 18 or later installed
Claude Desktop application
A Descope account with a valid Project ID and Management Key
Git (for manual installation)

Installation Options

Option 1: Install via Smithery (Recommended)

The easiest way to install the Descope Authentication API is through Smithery:

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

This command automatically configures the server for use with Claude Desktop.

Option 2: Manual Installation

If you prefer to install manually:

Clone the repository:

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

Install dependencies and build the project:

npm install
npm run build

Configuration

To configure Claude Desktop to work with the Descope Authentication API:

Open Claude Desktop and enable Developer Mode from the menu
Access the configuration file by:
- Going to Settings > Developer > Edit Config, or
- Opening ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
Add the following configuration to the file:

{
  "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 the placeholder values:
- /path/to/descope-mcp-server/build/index.js with the actual path to the built server
- your-descope-project-id-here with your Project ID from the Descope dashboard
- your-descope-management-key-here with your Management Key from Descope
Save the configuration file and restart Claude Desktop

Verification

After restarting Claude Desktop, look for the 🔌 icon which indicates that the Descope server is connected and ready to use. You can now start using the available tools to interact with your Descope project.

Usage Examples

Once configured, you can ask Claude to perform various Descope-related tasks:

"Search for recent user sign-ins in my Descope project"
"Find users with gmail addresses in my Descope project"
"Create a new user with email john.doe@example.com"
"Send an invitation to sarah.smith@example.com to join our project"

Claude will use the appropriate tools to fulfill these requests and display the results directly in your conversation.