Descope Stdio MCP Server

The Descope Model Context Protocol (MCP) server provides an interface to interact with Descope's Management APIs, enabling the search and retrieval

Local serverstdioGo

What is the Descope Stdio MCP server?

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. That is what the descope stdio mcp server brings to an AI assistant: the same capability, reachable through the Model Context Protocol rather than a separate app or dashboard.

The tools it exposes

The server publishes 4 tools. What each one is for:

  • 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

What it needs from you

Configuration is passed through the environment: DESCOPE_PROJECT_ID, DESCOPE_MANAGEMENT_KEY. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

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:

Getting it running

The server ships on npm as @smithery/cli, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

How it compares

Among the developer tooling options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Descope Stdio's toolset — search-audits, search-users, create-user and 1 more — is a fair guide to whether it matches your workflow. It is maintained by descope-sample-apps; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Descope Stdio's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
search-auditsRetrieves up to 10 audit log entries from your Descope project.
search-usersRetrieves up to 10 user records from your Descope project.
create-userCreates a new user in your Descope project.
invite-userInvites a new user to your Descope project.

How to install the Descope Stdio MCP server

{
  "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"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

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:

VariableDescriptionRequired
DESCOPE_PROJECT_IDConfiguration value read at startup.Optional
DESCOPE_MANAGEMENT_KEYCredential the server authenticates with.Yes

Example prompts to try

  • Use Descope Stdio to search-audits.
  • Use Descope Stdio to search-users.
  • Use Descope Stdio to create-user.

Frequently asked questions

It connects Descope Stdio to MCP-compatible AI assistants such as Claude and Cursor, exposing 4 tools (search-audits, search-users, create-user, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Descope Stdio directly.