How to Use the MSAAQ MCP in Vercel AI SDK

Q: How do I initialize the MSAAQ MCP Server inside Vercel AI SDK?

Install @ai-sdk/mcp and ai via npm, then initialize the connection using createMCPClient pointing to your Vinkius MSAAQ endpoint. You then pass the tools directly into Vercel AI SDK's generateText or streamText function.

Q: How does Vercel AI SDK handle MSAAQ student authentication?

You configure the authProvider during the createMCPClient setup to pass the user's token. This ensures Vercel AI SDK calls to getloggedinuserprofile only return data belonging to the authenticated student.

Q: Do I need to manually close the connection after running an MSAAQ query?

Always call mcpClient.close() once your Vercel AI SDK finishes streaming MSAAQ course details. This prevents open connections from hanging in your serverless environment and preserves your execution resources.

Stream MSAAQ student enrollments and certificate checks directly into your Next.js frontend using the Vercel AI SDK and our managed 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 MSAAQ MCP to Vercel AI SDK

Create your Vinkius account to connect MSAAQ to Vercel AI SDK 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 MSAAQ with Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Live course browsing in Vercel AI SDK

The `list_available_learning_courses` tool lets your users browse current learning options in real-time as the Vercel AI SDK streams raw data straight into your UI components. If a user wants to drill down, the Vercel AI SDK triggers `get_learning_course_details` to populate the view instantly. This direct connection lets you build snappy, interactive MSAAQ catalogs where the agent handles the fetching while the frontend handles the rendering.

Instant enrollment using MSAAQ MCP Server

The `create_new_student_account` tool allows your agent to register student details on the spot inside your Vercel AI SDK app. Your application doesn't need complex backend routing because the MCP Server handles the MSAAQ API handshake directly from the edge. Once the account is active, the Vercel AI SDK triggers `enroll_student_in_course` to complete the registration. The student sees their MSAAQ enrollment status update in their browser window the millisecond the backend confirms the transaction.

Real-time certificate verification on the edge

The `verify_issued_certificate` tool enables real-time academic validation directly within your Vercel AI SDK chat interface. Academic validation shouldn't feel like a slow backend batch process when verifying MSAAQ credentials. The agent retrieves the necessary history using `list_student_certificates` and displays the verified status on the screen. Because this Vercel AI SDK setup runs on edge-compatible infrastructure, the MSAAQ verification process completes without adding latency to your main application server.

Setup guide

Set up MSAAQ MCP in Vercel AI SDK

Prerequisites

Node.js 18+ and a TypeScript project
ai + @modelcontextprotocol/sdk packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies

Run npm install ai @modelcontextprotocol/sdk plus your preferred model provider (e.g. @ai-sdk/openai).
2

Create the Streamable HTTP transport

Use StreamableHTTPClientTransport with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and use tools

Call mcpClient.tools() to auto-discover all MSAAQ tools. Pass them directly to generateText() or streamText() — no manual schema definitions needed.
4

Works with any model provider

Swap openai("gpt-4o") for any AI SDK provider — Anthropic, Google, Mistral. The MCP tools work identically across all supported models.

index.ts

import { experimental_createMCPClient as createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";

const transport = new StreamableHTTPClientTransport(
  new URL("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
);

const mcpClient = await createMCPClient({ transport });
const tools = await mcpClient.tools();

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools,
  prompt: "List recent MSAAQ transactions",
});

console.log(text);
await mcpClient.close();

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 MSAAQ. 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 MSAAQ 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 MSAAQ MCP in Vercel AI SDK

Install `@ai-sdk/mcp` and `ai` via npm, then initialize the connection using `createMCPClient` pointing to your Vinkius MSAAQ endpoint. You then pass the tools directly into Vercel AI SDK's `generateText` or `streamText` function.

Yes, this setup is fully compatible with Edge runtimes. The Vercel AI SDK calls MSAAQ tools like `check_api_connectivity` directly from the edge, keeping your serverless execution times low.

You configure the `authProvider` during the `createMCPClient` setup to pass the user's token. This ensures Vercel AI SDK calls to `get_logged_in_user_profile` only return data belonging to the authenticated student.

Always call `mcpClient.close()` once your Vercel AI SDK finishes streaming MSAAQ course details. This prevents open connections from hanging in your serverless environment and preserves your execution resources.

Vinkius runs the MSAAQ integration inside secure, ephemeral V8 isolates. Student emails and registration profiles fetched via `list_registered_users_admin` never persist on the Vinkius platform, keeping your student database isolated from external storage.

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