How to Use the Descope (Auth Platform) MCP in Claude Code

Q: How can I use the Descope (Auth Platform) server with claude-code for automation?

You call claude-code from any shell script with a prompt that invokes a tool. For instance, claude mcp exec descope "create a new tenant named 'staging'" will run the mgmtcreatetenant tool. The output is plain text, so you can pipe it to jq or other tools.

Q: Can I manage user passwords from the terminal with the Descope (Auth Platform) server and claude-code?

Yes. The server exposes the authpasswordreset tool. You can write a script that uses claude-code to trigger a password reset for a specific user, which is useful for internal support tools.

Q: What's the command to add the Descope (Auth Platform) server to claude-code?

You connect it with a single command: claude mcp add --transport http descope-auth-platform -- . Then run claude mcp list to confirm it's connected and ready.

Q: Is it possible to check if a user exists using the Descope (Auth Platform) server from claude-code?

It is. You can use the mgmtgetuser tool. A command like claude mcp exec descope "get user with login id 'user@example.com'" will return the user's details if they exist or an error if they don't, which you can check in your script.

Manage Descope users and auth from the command line. Pipe `claude-code` into your shell scripts for powerful, headless auth automation.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Descope (Auth Platform) MCP to Claude Code

Create your Vinkius account to connect Descope (Auth Platform) to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Descope (Auth Platform) with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate User Management in Shell Scripts

This server turns `claude-code` into a command-line interface for Descope. Now you can write shell scripts to automate user management. A simple command can run `mgmt_create_user` to provision a new developer or `mgmt_delete_user` to offboard someone. It's perfect for batch operations. Pipe a list of user emails into a script that calls `claude-code` with the `mgmt_search_users` tool, then use the output to update records with `mgmt_update_user`. It's all done headlessly, perfect for cron jobs.

Integrate Descope into Your CI/CD Pipelines

Use this MCP Server in your CI/CD pipeline to manage test environments. Before a test run, your GitHub Action can call `claude-code` to provision a fresh test user via `mgmt_create_user` and create a tenant with `mgmt_create_tenant`. After the tests, the pipeline can tear everything down. Just call `claude-code` again to run `mgmt_delete_user` and clean up the test data. This ensures every test run starts from a known, clean state without manual intervention.

Authenticate Services with this MCP Server

This server is ideal for machine-to-machine (M2M) authentication in your backend scripts. A service can use `claude-code` to call `auth_exchange_access_key` and get a valid session JWT for making authenticated API requests. You can also validate tokens without needing a full SDK. Just use `claude-code` to call `auth_get_keys` to fetch the public keys from Descope. Pipe the JWKS output to any other command-line tool for verification.

Setup guide

Set up Descope (Auth Platform) MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see descope-auth-platform-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Descope (Auth Platform) transactions." It will automatically discover and invoke the available Descope (Auth Platform) tools.

Terminal

claude mcp add --transport http descope-auth-platform-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Descope (Auth Platform) MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "descope-auth-platform-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Descope. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Descope (Auth Platform) now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Descope (Auth Platform) MCP in Claude Code

You call `claude-code` from any shell script with a prompt that invokes a tool. For instance, `claude mcp exec descope "create a new tenant named 'staging'"` will run the `mgmt_create_tenant` tool. The output is plain text, so you can pipe it to `jq` or other tools.

Yes. The server exposes the `auth_password_reset` tool. You can write a script that uses `claude-code` to trigger a password reset for a specific user, which is useful for internal support tools.

You connect it with a single command: `claude mcp add --transport http descope-auth-platform -- `. Then run `claude mcp list` to confirm it's connected and ready.

It is. You can use the `mgmt_get_user` tool. A command like `claude mcp exec descope "get user with login id 'user@example.com'"` will return the user's details if they exist or an error if they don't, which you can check in your script.

The server is restricted to accessing user identifiers (like email or phone number) and tenant information necessary for Descope's auth APIs. Your local environment variables and other script data are not visible to the Vinkius-hosted server. Each request is isolated and ephemeral.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript