How to Use the edX MCP in Mastra AI

Q: How do I register the edX tools inside a Mastra AI agent?

Import MCPClient from @mastra/mcp and connect to the Vinkius endpoint. Call listTools() to extract the functions, then spread them directly into your Mastra agent's tool array.

Q: How does Mastra AI branch workflows based on edX program types?

Your agent executes searchprograms to find professional certificates or bootcamps. Mastra's conditional routing then directs the workflow down different paths depending on whether the program is an XSeries or a MicroMasters.

Build resilient, branching workflows to discover and map edX courses using Mastra AI agents.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect edX MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Resilient edX course discovery with Mastra AI

The `search_courses` tool scans the active edX catalog for matching curricula, providing raw structured data directly to your Mastra AI agent. If the upstream network fails, Mastra's built-in execution engine automatically triggers retries with exponential backoff to ensure your discovery step succeeds using this MCP Server. You can construct a Mastra workflow that starts with this search and branches based on the results. If no beginner courses are found, the workflow triggers a fallback search for intermediate modules without needing custom error-handling code.

Automated program mapping via Mastra AI workflows

The `get_program` tool extracts the exact structural requirements of professional certificates and MicroMasters tracks. Your Mastra AI agent uses this metadata to construct step-by-step learning paths, verifying each step's validity against active course runs. The agent chains this tool with `get_course` to inspect the prerequisites of each module in the program. Mastra's human-in-the-loop feature allows you to require manual approval before the agent saves a generated curriculum to your database.

Multi-step institution validation using this MCP Server

The `get_organizations` tool retrieves verified details about academic partners like MIT, Berkeley, and Harvard, including active course counts. Your Mastra AI agent runs this tool to cross-reference and validate the institutions offering a specific set of programs. By combining this with `get_subjects`, your workflow automatically categorizes courses under verified academic domains. This eliminates manual data entry when building curated directories of university-backed online education.

Setup guide

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

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

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

Import `MCPClient` from `@mastra/mcp` and connect to the Vinkius endpoint. Call `listTools()` to extract the functions, then spread them directly into your Mastra agent's tool array.

Yes. Mastra's workflow engine manages rate limits by wrapping calls to `get_course_run` in a resilient step execution. If the server detects a rate limit, Mastra pauses and retries automatically.

Your agent executes `search_programs` to find professional certificates or bootcamps. Mastra's conditional routing then directs the workflow down different paths depending on whether the program is an XSeries or a MicroMasters.

Yes. Mastra deploys to any cloud provider with a single command. The agent connects to the hosted Vinkius endpoint over HTTP or SSE, requiring no local server configuration.

This MCP Server operates in a secure, zero-trust V8 isolate. The specific course keys and program IDs processed by your Mastra workflows are processed ephemerally and never logged or stored by Vinkius.

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