How to Use the Degreed MCP in Mastra AI

Q: How can I build a Mastra AI agent to report on Degreed skill gaps?

Your agent should use the listdefinedskills tool to get the target skills, then call getuserprofile for each user. Mastra AI's workflow engine can then compare the two and generate a report or trigger another action.

Build resilient Degreed workflows with Mastra AI. Automate skill tracking and reporting that actually runs on schedule.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Degreed MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate New Hire Onboarding

Build a Mastra AI workflow that fully automates your training assignments. When a new user is created in your HR system, it triggers an agent that uses `list_learning_pathways` to find the correct onboarding plan in Degreed. The agent assigns the content and sets a schedule. From there, the workflow runs on its own. It periodically calls `list_user_completions` to check progress. If a new hire falls behind, Mastra's engine can automatically send a reminder or notify a manager. You set it up once and it just works.

Run Resilient Skill Gap Reports

You can create a workflow that performs a monthly skill audit for a department. The agent gets a roster with `list_degreed_users`, then loops through it, calling `get_user_profile` for each person to check their skills against a baseline from `list_defined_skills`. The real power is in Mastra's conditional logic. If a critical skill gap is found, the agent can open a ticket in your project management tool. If the Degreed API is temporarily down, the built-in exponential backoff means the agent just tries again later. No manual re-runs.

Keep External Systems in Sync

Use a Mastra AI agent to keep another application's user data consistent with Degreed. The agent can run on a schedule, calling `list_active_learners` to see who's been training and `list_degreed_users` to get the master list. It compares the data and pushes updates where needed. This is the kind of tedious task that's perfect for automation. If an API call fails, the workflow doesn't crash. Mastra AI's retry mechanism ensures the sync will eventually complete, making your data integration far more reliable.

Setup guide

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

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

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

Your agent should use the `list_defined_skills` tool to get the target skills, then call `get_user_profile` for each user. Mastra AI's workflow engine can then compare the two and generate a report or trigger another action.

Absolutely. You build a workflow that runs on a schedule. The agent calls the `list_user_completions` tool for a specific user or group and formats the output. Mastra handles the scheduling and execution.

It's a single tool call. Inside your Mastra AI agent, you just invoke the `list_degreed_users` tool. It returns the full list of registered users in your Degreed organization with their metadata.

Yes, through the Mastra AI framework. You can configure your agent with `requireToolApproval` for any of the Degreed tools, forcing the workflow to pause until a person approves the action.

The agent processes employee profiles, their assigned skills, and learning histories from Degreed. Your Mastra AI client connects via a single, revocable Vinkius token, and all tool calls are executed in a zero-trust environment that isolates each transaction.

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