Descope — Claude Code MCP server: what it does, how to install
Descope's MCP server hands your agent four tools for the Management API: audit and user search, user creation, invites.
no license updated 2026-10-29
Open on GitHubWhat Descope does
Four tools land in your agent. search-audits returns up to 10 audit log entries, search-users returns up to 10 user records, create-user adds someone, invite-user sends an invite. Every call goes to the Descope Management API, so the dashboard stays closed.
The repo is a Node.js project: clone it, run npm install, then npm run build. Register the server in your MCP client config with the node command, the path to build/index.js, and two env vars, DESCOPE_PROJECT_ID and DESCOPE_MANAGEMENT_KEY. It runs over stdio via npm run start:stdio or over SSE via npm run start:sse.
Node.js 18 or newer and Git are required. Both credentials are created in the Descope console, and the server will not connect to a project without them. Edit the config, then quit the client completely and launch it again; the plug icon confirms the connection.
What it helps with
- read recent audit events without leaving the editor
- look up a user record by email address
- create a user from the agent while working
- send a project invite mid-task
- check who signed in to a Descope project
Example prompts for the agent
- Show the latest audit entries from Descope
- Find the Descope user with email
[email protected] - Invite
[email protected]to the project
How to install Descope
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Descope
How do I install the Descope MCP server?
Run git clone https://github.com/descope-sample-apps/descope-mcp-server.git, then cd descope-mcp-server, npm install and npm run build. Add the server to your MCP client config with DESCOPE_PROJECT_ID and DESCOPE_MANAGEMENT_KEY set, then restart the client.
What does the Descope MCP server do?
It exposes four Descope tools to your agent: audit search, user search, user creation and user invites. Search calls return up to 10 records each.
What do I need before running it?
Node.js 18 or later, Git, plus a Project ID and Management Key from your Descope account. Both values go into the env block of the server config.