How to Use the Descope (Auth Platform) MCP in Mastra AI

Build resilient authentication workflows and tenant provisioning pipelines with Mastra AI and Descope.

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 Mastra AI

Create your Vinkius account to connect Descope (Auth Platform) to Mastra AI 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 Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated User Provisioning

Create new accounts reliably using `mgmt_create_user` wrapped in a Mastra AI workflow. If the initial email signup fails due to a network blip, the engine's automatic retries kick in with exponential backoff to ensure the record gets created. Complex onboarding sequences become simple. After the user generates, the next workflow step calls `mgmt_create_role` and assigns permissions, handling any timeouts gracefully via the MCP Server.

Conditional Auth Branching via MCP

Route users through different login paths based on their security requirements. The agent checks their profile and either triggers `auth_otp_signup_sms` for standard accounts or demands a WebAuthn start for administrators. Fallbacks happen automatically without writing custom logic. If a text message fails to deliver, the workflow catches the error and pivots to `auth_otp_signup_voice` to read the code out loud.

Machine-to-Machine Token Exchange

Background jobs need secure access, which `mgmt_create_access_key` provides on demand. Your agent generates the key, then immediately trades it via `auth_exchange_access_key` to get a short-lived session JWT. This setup keeps long-running scripts secure. The workflow requests fresh credentials right before executing a sensitive task, rather than hardcoding static secrets in your environment variables.

Setup guide

Set up Descope (Auth Platform) MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Descope (Auth Platform) tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "descope-auth-platform-mcp-client",
  servers: {
    "descope-auth-platform-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Descope (Auth Platform) Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Descope (Auth Platform) tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Descope (Auth Platform) transactions"
);
console.log(result.text);

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 Mastra AI

Instantiate a new client with your Vinkius URL in the servers object. Run the list tools method and spread the results into your agent's configuration. Mastra auto-detects the streamable HTTP transport.

You turn on approval requirements for destructive actions like deleting a user. The workflow pauses execution, pings an admin on Slack, and waits for a manual thumbs-up before dropping the record.

Mastra's built-in workflow engine catches HTTP 429 errors from Descope automatically. It pauses the loop making the tenant creation calls and retries after the specified backoff period.

The agent polls the status using the polling tool. If it hits a timeout, the conditional branch routes back to the start and fires the signup endpoint to generate a fresh link.

The V8 Isolate sandbox destroys itself the millisecond the request finishes. Phone numbers routed to SMS OTPs and email addresses sent to Magic Links never touch a persistent database on our end.

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