WebStream Ops MCP

Manage and observe WebStream from any AI agent

Natural language admin, observability, governance, and compliance — 48 tools exposed via the open Model Context Protocol. Open source on GitHub.

The Protocol

What is MCP?

Model Context Protocol

MCP is an open standard created by Anthropic for connecting AI agents to external tools and data sources. It provides a universal interface so that any compatible AI client — Cursor, Claude Desktop, ChatGPT — can discover and invoke tools without custom integration code.

WebStream Ops MCP Server

The WebStream Ops MCP Server connects any AI agent to the WebStream admin and metrics APIs. It exposes 48 tools across 9 categories — from real-time session monitoring to full compliance audits — with built-in privacy controls and scope-based access restriction.

Architecture

How it Works

Three steps from natural language question to structured result.

1

Ask

You ask a question in natural language via your AI client — Cursor, Claude Desktop, or ChatGPT.

2

Discover

The AI agent discovers the right tool(s) from the MCP server’s 48 registered tools and builds the correct parameters.

3

Execute

The MCP server calls the WebStream Gateway API, applies privacy transforms, and returns structured results to the agent.

48 Tools, 9 Categories

Capability Overview

Every operation available in the WebStream admin panel is exposed as an MCP tool that any AI agent can discover and invoke.

Observe 7

Real-time session monitoring, node health, infrastructure status, and activity feeds.

Reports 5

User access reports, activity audit logs, security policy posture, usage metering, and session activity.

Usage Analytics 6

Workspace and app ranking, peak hour analysis, per-user summaries, and stale resource detection.

Governance 7

Inactive users, orphaned accounts, empty groups, MFA gaps, over-provisioning, and access recertification.

Anomaly Detection 4

Long-running sessions, after-hours activity, high clipboard events, and multi-session violations.

Users 9

Create, update, find, disable, delete, import, export, and query entitlements.

Groups 8

Create, update, delete groups and manage membership — add and remove users.

Workspaces 6

List workspaces, view applications and access rights, grant and revoke group access.

Policies 8

List, inspect, create from templates, clone, compare side-by-side, and resolve effective policies.

4 Compound Workflows

Multi-step operations that orchestrate several tools in sequence: Onboard User, Offboard User, Compliance Audit, and Executive Summary.

Real-World Value

Use Cases

Just ask. The agent discovers and calls the right tools automatically.

Observability

What’s happening right now?

  • Show me all active streaming sessions
  • How is session sess-001 performing?
  • Check platform health
  • Are there any sessions running longer than 8 hours?

Administration

Manage users and access in seconds.

  • Onboard user jsmith with email j.smith@company.com and add them to the Designers group
  • Offboard user jsmith — disconnect their sessions and remove all access
  • Which applications are assigned to the Finance workspace?
  • Grant the Sales group access to the CRM workspace

Governance & Compliance

Continuous compliance, not quarterly.

  • Run a full compliance audit
  • Find users who haven’t logged in for 30 days
  • Which users don’t have MFA enabled?
  • Run a full access review for recertification

Reporting

Executive insights on demand.

  • Generate an executive summary for the last 30 days
  • What does our security policy posture look like?
  • Show me usage and billing for this month
  • Rank our workspaces by usage over the last 30 days
Security by Design

Privacy & Scope Controls

Two independent controls ensure the AI agent sees only what it should — at the data level and at the tool level.

Privacy Modes

Control what PII reaches the AI agent. The same query produces different output depending on the mode.

noRestriction

Full data passes through unmodified. For on-prem admin with a trusted, self-hosted LLM.

maskRestriction (default)

Usernames replaced with stable HMAC hashes. Emails and display names stripped. Clipboard content redacted.

fullRestriction

No per-user data at all. Only counts, averages, and distributions. Maximum privacy.

Scope Presets

Control which tools the agent can even discover. Out-of-scope tools are not denied — they are invisible.

Role Allowed Scope
Read-only reporting observe.* reports.* usage.*
Governance / compliance + governance.* anomaly.*
IT helpdesk observe.* users.* groups.* workflows.onboard workflows.offboard
Full admin *
Quick Start

Works with Your AI Client

The server uses stdio transport. Your AI client spawns it as a child process — no HTTP, no ports, no firewall changes.

Cursor

Add to .cursor/mcp.json in your workspace root.

{
  "mcpServers": {
    "webstream-ops": {
      "command": "node",
      "args": ["path/to/dist/index.js"]
    }
  }
}

Claude Desktop

Edit claude_desktop_config.json and add the server.

{
  "mcpServers": {
    "webstream-ops": {
      "command": "node",
      "args": ["path/to/dist/index.js"]
    }
  }
}

ChatGPT Desktop

Settings → Tools & Integrations → Add Server.

Name: webstream-ops
Command: node
Args: path/to/dist/index.js

Build, configure, and connect in under five minutes. See the Quick Start guide on GitHub for full setup instructions including API key configuration.

Open Source

Open Source on GitHub

The WebStream Ops MCP Server is open source. Explore the code, contribute tools, adapt the privacy model, or build your own workflows.