How to Use the KnowBe4 (KMSAT Reporting) MCP in Vercel AI SDK

Q: How do I get user risk scores from KnowBe4 (KMSAT Reporting) with the Vercel AI SDK?

Your agent can call the getaccountriskscore tool to get the overall score. You can also combine listusers with getuserdetails to check on individuals, streaming the results directly into your React components.

Q: Can I list all active phishing tests?

Yes, the listphishingtests tool returns a list of your phishing security tests. You can then use getphishingtestdetails with a specific ID to get more data on one test.

Q: What's the best way to audit training with KnowBe4 (KMSAT Reporting) and the Vercel AI SDK?

Start with listtrainingcampaigns to see all campaigns. From there, your agent can use gettrainingcampaigndetails to drill down into specifics like completion rates, which you can render live in your UI.

Q: Can my agent see which groups a user belongs to in KnowBe4 (KMSAT Reporting) using the Vercel AI SDK?

Absolutely. After getting a user ID from listusers, just call listusergroups with that ID. It will return all the groups that user is a member of.

Build live security dashboards with the Vercel AI SDK, streaming KnowBe4 risk data directly into your UI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect KnowBe4 (KMSAT Reporting) MCP to Vercel AI SDK

Create your Vinkius account to connect KnowBe4 (KMSAT Reporting) 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 KnowBe4 (KMSAT Reporting) with Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Stream Real-Time Risk Scores

Instantly check your organization's security posture. Use `get_account_risk_score` to pull the overall risk number and stream it directly into your Next.js dashboard, giving leadership a live, zero-latency view. Then, build components that fetch and display details for individual users with `get_user_details`. Because the Vercel AI SDK streams the results, your UI updates field-by-field as the data arrives, not after some spinner finishes.

Build Interactive Campaign Audits with the Vercel AI SDK

Let your security team audit training effectiveness without leaving your app. Your AI client can use `list_training_campaigns` and `list_phishing_tests` to populate interactive tables in your frontend. When a user clicks a campaign, you trigger a new call to `get_training_campaign_details` or `get_phishing_test_details`. The results stream right back, creating a responsive, app-like experience for analyzing security data.

Create On-Demand User Profiles

Build a feature that lets managers look up their team members' security status. A simple prompt can trigger `list_users` to find someone, then `get_user_details` and `list_user_groups` to pull their specific training history and group assignments. This isn't just a data dump. You're building a real tool inside your application, powered by this MCP connection, that gives managers the context they need without having to log into another system.

Setup guide

Set up KnowBe4 (KMSAT Reporting) 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 KnowBe4 (KMSAT Reporting) 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 KnowBe4 (KMSAT Reporting) 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 KnowBe4. 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 KnowBe4 (KMSAT Reporting) 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 KnowBe4 (KMSAT Reporting) MCP in Vercel AI SDK

Your agent can call the `get_account_risk_score` tool to get the overall score. You can also combine `list_users` with `get_user_details` to check on individuals, streaming the results directly into your React components.

Yes, the `list_phishing_tests` tool returns a list of your phishing security tests. You can then use `get_phishing_test_details` with a specific ID to get more data on one test.

Start with `list_training_campaigns` to see all campaigns. From there, your agent can use `get_training_campaign_details` to drill down into specifics like completion rates, which you can render live in your UI.

Absolutely. After getting a user ID from `list_users`, just call `list_user_groups` with that ID. It will return all the groups that user is a member of.

This server only reads KnowBe4 user details, risk scores, and campaign data. Vinkius runs each request in a sandboxed, ephemeral environment, and your connection is secured through a single endpoint token, so your credentials are never exposed.

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