Operator MCP Tools

PulseStream exposes 14 operator-only MCP tools for autonomous customer investigation. These require an operator access token (ps_at_ created by an operator user).

Authentication

Operator tools require a ps_at_ access token. Use whoami to verify connectivity and token scope.

MCP: set_token
  token: "ps_at_..."

MCP: whoami

Tool Reference

Tenant & Workspace Management

Tool	Description
`lookup_tenant`	Find organization/workspace by name, email, or domain
`list_workspaces`	List all workspaces in an organization
`get_fleet_summary`	Fleet-wide health overview across all tenants

Investigation

Tool	Description
`remote_debug`	Execute debug commands on a connected agent
`list_debug_commands`	Discover available debug commands and parameters
`query_logs`	Query structured logs for a workspace
`get_connection_history`	Agent connection/disconnection timeline
`get_connection_slo`	Connection uptime SLO metrics

Operations

Tool	Description
`start_capture_session`	Start a diagnostic capture session on an agent
`get_capture_session`	Check status of a capture session
`query_audit_logs`	Query audit trail for a workspace
`get_ai_analytics`	AI analysis quality metrics (accuracy, latency, errors)
`get_onboarding_status`	Customer onboarding progress
`get_system_health`	System-wide health check across all components

Common Workflows

Full Customer Investigation

1. lookup_tenant → get org/workspace IDs
2. remote_debug (agent_health) → check agent status
3. get_connection_history → review connectivity timeline
4. query_audit_logs → check recent activity
5. get_ai_analytics → review analysis quality

Fleet Health Check

1. get_fleet_summary → overview of all tenants
2. get_system_health → component-level health
3. For each degraded tenant: lookup_tenant → remote_debug