product: maestro audience: test-developer, operator, ai-assistant authority: normative
MCP Tools — Live Events
Tools for real-time test progress monitoring via SignalR. The MCP server maintains a persistent hub connection and buffers up to 100 events per type.
For full architecture, polling workflow, and buffer-limit guidance see live-events.md.
All tool responses include a top-level station field containing the StationLabel
configured for this server instance.
See also:
tools-reference.mdfor the full tool index.
connect_live_events
Opens (or re-establishes) the SignalR connection to the station hub. Safe to call multiple times — reconnects only when not already connected.
| Parameter | Type | Required | Description |
|---|---|---|---|
| (none) |
Returns: connected (bool), message (string)
Calls: HubConnectionBuilder → /testExecutionHub
poll_test_progress
Drains all events buffered since the last call. Returns immediately with empty arrays if no new events have arrived. Call every 1–5 seconds while a test is running.
| Parameter | Type | Required | Description |
|---|---|---|---|
| (none) |
Returns: connected (bool),
statusEvents[] (each: executionId, status, verdict),
stepEvents[] (each: executionId, stepExecutionId, stepName, currentStep, totalSteps)
Calls: in-memory drain — no HTTP call