Security MCP Server 🐳 Docker

KnowBe4 MCP

MCP server for KnowBe4 — security awareness training enrollment, phishing simulation results, user risk scoring, and group management.

🔗 Companion Plugin

Pair this MCP server with the Knowbe4 plugin for skills, commands, and API knowledge alongside direct API access.

Installation

Run the MCP server with npx:

npx @wyre-technology/knowbe4-mcp

Or install the package:

npm install @wyre-technology/knowbe4-mcp

MCPB Bundle (Claude Desktop)

Download the .mcpb bundle from GitHub Releases for a zero-config Claude Desktop install. No Node.js or terminal required — just open the bundle in Claude Desktop via Settings → MCP Servers → Install from file. Requires Claude Desktop 0.10+.

Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "knowbe4": {
      "command": "npx",
      "args": [
        "@wyre-technology/knowbe4-mcp"
      ],
      "env": {
        "KNOWBE4_API_KEY": "your-knowbe4-api-key"
      }
    }
  }
}

Authentication

Variable	Required	Description
`KNOWBE4_API_KEY`	Yes	KnowBe4 API key (generate under Account Settings → API)
`KNOWBE4_REGION`	No	KnowBe4 region: us \| eu \| ca \| uk \| de (defaults to us)
`KNOWBE4_BASE_URL`	No	Explicit base URL override (alternative to region)

Architecture

Decision-tree MCP server with per-domain handlers, supporting multiple KnowBe4 regions (US/EU/CA/UK/DE).

Available Tools (10)

Tools are organized into 6 domains:

Account

Tenant account metadata and subscription info.

Tool	Description
`knowbe4_account_get`	Get account / subscription details

Users

Manage trainees and user risk scores.

Tool	Description
`knowbe4_users_list`	List users with filters
`knowbe4_users_get`	Get user details + risk score

Groups

User group membership for training enrollment.

Tool	Description
`knowbe4_groups_list`	List groups
`knowbe4_groups_get`	Get group details and members

Training

Training campaign enrollment and progress.

Tool	Description
`knowbe4_training_campaigns_list`	List training campaigns
`knowbe4_training_enrollments_list`	List enrollments for a campaign

Phishing

Phishing simulation campaigns and per-user results.

Tool	Description
`knowbe4_phishing_campaigns_list`	List phishing simulation campaigns
`knowbe4_phishing_results_list`	List per-user phishing simulation results

Reporting

Aggregate reporting on training + phishing performance.

Tool	Description
`knowbe4_reporting_summary`	Get tenant-level training + phishing summary