search-auditsLABSCO SUMMARY
User lookups without the console tab.
Four narrow tools, useful mostly while an auth flow is being debugged: the user record and the audit entries that explain what happened to them, in the same place as the code.
What it is
A client for Descope's Management APIs. It retrieves user records and audit log entries from a project — up to 10 at a time — and creates or invites new users.
What you get
- Up to 10 audit log entries retrieved from a project
- Up to 10 user records retrieved from a project
- A new user created in the project
- A new user invited to the project
Requirements
A Descope project ID and a management key from your Descope settings, plus a recent Node.js and a local build. The management key carries the rights of the project it belongs to.
Setup effort
Build from source — git clone https://github.com/descope-sample-apps/descope-mcp-server-stdio.git
USE CASES
01
Working out why a login failed
The audit entries around the attempt, next to the user record they belong to.
02
Checking whether an account exists
A direct lookup, instead of asking someone with console access.
03
Adding a test user while building
Create the account from the conversation rather than switching to the dashboard.
04
Getting a colleague into a project
Send the invitation without leaving the terminal.
4 tools
Listed in project docs. Your client may show a different list.
search-userscreate-userinvite-userBEFORE YOU INSTALL
What to know first
Tools you get
4 tools named in the project's documentation.
Requires
- Node.js 18 or later
- DESCOPE_MANAGEMENT_KEY in your environment
- DESCOPE_PROJECT_ID in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone and build this one yourself.
Server setup
TERMINAL
git clone https://github.com/descope-sample-apps/descope-mcp-server-stdio.git
cd descope-mcp-server-stdio
npm install
npm run buildMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"descope": {
"command": "node",
"args": [
"<YOUR_PATH_TO_DESCOPE_MCP_SERVER>/build/index.js"
],
"env": {
"DESCOPE_PROJECT_ID": "<YOUR_DESCOPE_PROJECT_ID>",
"DESCOPE_MANAGEMENT_KEY": "<YOUR_DESCOPE_MANAGEMENT_KEY>"
}
}
}
}<YOUR_PATH_TO_DESCOPE_MCP_SERVER> is the full path of the descope-mcp-server-stdio folder you cloned — npm run build creates build/index.js there.
