How to Use the Illumidesk MCP in Mastra AI

Q: How do I add Illumidesk tools to a Mastra AI agent?

Install @mastra/mcp and instantiate the client with the Vinkius server URL. Call mcpClient.listTools() and spread the returned tools directly into your agent's tool configuration array. Mastra handles the underlying transport protocol automatically.

Build self-healing LMS workflows by connecting Mastra AI to the Illumidesk MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Illumidesk MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Self-healing LTI credential provisioning

The `list_lti_credentials` tool lets your Mastra AI agent inspect current keys and verify setup parameters without manual intervention. When an LTI handshake fails, the agent can automatically diagnose the issue. If a key is misconfigured, the Mastra AI workflow engine branches to fetch current deployments via `list_lti_deployments`. It runs automatic retries with exponential backoff until the security handshake resolves.

Campus activity auditing via Mastra AI

The `list_campuses` tool lets you monitor system health across multiple departments using Mastra workflows. The agent finds active nodes, then loops through each to pull operational data. It calls `get_activity_logs` for each target campus. If it detects a critical error pattern, the Mastra AI workflow branches to notify your IT staff with the exact error details. Connect this MCP Server to build automated loops.

Multi-step course enrollment syncing

The `list_courses` tool enables complex enrollment routines inside Mastra AI that handle API rate limits gracefully. Your Mastra agent calls the endpoint to find target classes, then pulls the student roster. By using `list_users` and `list_memberships` in a structured Mastra AI workflow, the agent flags mismatched profiles. It retries failed syncs automatically before logging the final status.

Setup guide

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

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

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

Install `@mastra/mcp` and instantiate the client with the Vinkius server URL. Call `mcpClient.listTools()` and spread the returned tools directly into your agent's tool configuration array. Mastra handles the underlying transport protocol automatically.

Yes, you can build a workflow that triggers when an LTI setup fails. The agent uses `list_lti_deployments` to check for mismatches and compares them against active credentials. The workflow engine then manages the retry logic automatically.

You can use Mastra's built-in tool approval feature. When the agent attempts to inspect campus settings using `get_campus`, the system pauses. It waits for an administrator to approve the action before executing the tool.

You can deploy your Mastra agent to any cloud provider with a single command. The agent connects to the hosted MCP Server on Vinkius using a secure HTTP or SSE transport, meaning you do not have to manage local server processes.

Your activity logs and administrative records are isolated within ephemeral V8 sandboxes. The server only accesses raw logs when the agent invokes `get_activity_logs`. All API communication is encrypted, and no sensitive campus configurations are cached or stored on this MCP setup.

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