How to Use the JumpCloud MCP in Mastra AI

Build resilient, multi-step IT automation for JumpCloud with Mastra AI's TypeScript-native workflow engine.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect JumpCloud MCP to Mastra AI

Create your Vinkius account to connect JumpCloud 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 JumpCloud with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate User Lifecycle Audits

Define a workflow that runs on a schedule. It starts by calling `list_users` to get a complete list of accounts. Then, for each user, it can call `get_user` to check their group memberships and other metadata against your company policies. Mastra AI's engine handles the details. If the JumpCloud API rate-limits your requests, the workflow automatically retries with exponential backoff. This makes your automation stable and reliable without extra code.

Build Reliable Compliance Checks

Create a Mastra AI workflow to enforce device security. The agent gets all devices with `list_systems`, then fetches your security rules using `list_policies`. The workflow can then check each device for compliance—for example, making sure disk encryption is enabled. Because Mastra supports conditional logic, you can define what happens next. If a device is non-compliant, the workflow can branch to create a ticket in your ITSM or send an alert. This MCP Server provides the data; Mastra provides the logic.

Design Conditional Access Workflows

Mastra AI excels at complex, stateful automation. You can design an agent that uses `list_user_groups` to identify all members of a specific team, like 'External Contractors'. From there, the workflow can use `list_applications` to check which software each contractor can access. If it finds a mismatch—a contractor with access to an internal-only app—it can flag the account for human review. It's precise, automated access control.

Setup guide

Set up JumpCloud 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 JumpCloud 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: "jumpcloud-mcp-client",
  servers: {
    "jumpcloud-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

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

const result = await agent.generate(
  "List recent JumpCloud 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 JumpCloud. 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 JumpCloud 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 JumpCloud MCP in Mastra AI

Since this MCP server is read-only, you'd build the discovery part of the workflow. The agent uses `get_user` and `list_systems` to find all assets tied to a user, then passes that data to another system or a human for the final deactivation step.

No. Mastra AI's workflow engine has built-in retry logic. If a call to a tool like `list_users` fails, it will automatically wait and try again, making your automation resilient to temporary network or API issues.

Absolutely. Deploy a Mastra agent on a cron schedule. The workflow can use `list_policies` and `list_systems` to gather compliance data, format it, and then send it to a specified destination like an email address or a Slack channel.

The server only processes read-only data like user lists and system configurations from JumpCloud. Your API key is managed by Vinkius's secure vault, and the server instance itself is ephemeral, meaning it doesn't store any of your data after a request is complete.

Yes, Mastra AI supports human-in-the-loop actions. Your workflow can gather information using tools like `list_users` and `list_applications`, then pause and wait for an admin to approve the next step via the `requireToolApproval` setting.

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