← Back to Kontasks
MCP Tools for System Events
Added four new MCP tools to konui's MCP server for gvSystemEvent management
Output
MCP Tools for System Events
Added 4 new MCP tools to konui/mcp/server.ts for gvSystemEvent management.
New Tools
konui_create_system_event |
Create service restarts, account switches, alerts, etc. |
konui_list_system_events |
List events with filters (type, service, severity, time range) |
konui_get_system_event |
Get single event by ID (sysev_...) |
konui_get_system_event_stats |
Get aggregate counts by type/service/severity |
Event Types Supported
service_restart # Service restarted service_start # Initial boot account_switch # Claude account changed system_alert # System-wide alert user_login # User logged in user_logout # User logged out quota_warning # Quota threshold reached error # System error occurred maintenance # Maintenance mode
Example Usage
// Create a system event await konui_create_system_event({ type: "service_restart", service: "konui", message: "Service restarted after config update", severity: "info" }); // List recent errors await konui_list_system_events({ severity: "error", limit: 10 });
Commit
9f4ca505 Turn: Add MCP tools for gvSystemEvent
These tools expose the gvSystemEvent API to Claude, allowing system events to be created and queried. Events appear as grey markers on the timeline.
Note: Requires konui restart to load the new MCP tools. See greatvibe-restart-permitted status.
Quick Actions
Original Request
No layout configured
Details
Type
General
Status
Completed
Scope
greatvibe
Tags
mcpsystem-eventskonui
Created
11 Jan 2026, 10:09 pm
Updated
11 Jan 2026, 10:10 pm
Timing
⏱️ 196.5s
0 tools
● TTFE 0%
● Thinking 100%
● Tools 0%
Created By
claude
📋 Claude's Context
Session
ses_f1a97fe1...
🔗 Git Commit
9f4ca505
Raw Data
{
"id": "5c9ce271-6c2b-43b9-81e1-5c0a55caf4c3",
"type": "general",
"status": "completed",
"title": "MCP Tools for System Events",
"description": "Added four new MCP tools to konui's MCP server for gvSystemEvent management",
"context": {
"output": "<div style=\"background:#1e1e1e;color:#e0e0e0;padding:20px;border-radius:8px;font-family:'Consolas','Monaco',monospace;\">\n<h2 style=\"font-family:sans-serif;color:#fff;margin:0 0 16px 0;\">MCP Tools for System Events</h2>\n\n<p style=\"color:#7f848e;margin-bottom:16px;\">Added 4 new MCP tools to <code style=\"background:#2d2d2d;padding:2px 6px;border-radius:4px;\">konui/mcp/server.ts</code> for gvSystemEvent management.</p>\n\n<h3 style=\"color:#98c379;margin:16px 0 12px 0;\">New Tools</h3>\n\n<table style=\"width:100%;border-collapse:collapse;margin-bottom:16px;\">\n<tr style=\"border-bottom:1px solid #3d3d3d;\">\n <td style=\"padding:8px 12px;\"><code style=\"color:#61afef;\">konui_create_system_event</code></td>\n <td style=\"padding:8px 12px;color:#7f848e;\">Create service restarts, account switches, alerts, etc.</td>\n</tr>\n<tr style=\"border-bottom:1px solid #3d3d3d;\">\n <td style=\"padding:8px 12px;\"><code style=\"color:#61afef;\">konui_list_system_events</code></td>\n <td style=\"padding:8px 12px;color:#7f848e;\">List events with filters (type, service, severity, time range)</td>\n</tr>\n<tr style=\"border-bottom:1px solid #3d3d3d;\">\n <td style=\"padding:8px 12px;\"><code style=\"color:#61afef;\">konui_get_system_event</code></td>\n <td style=\"padding:8px 12px;color:#7f848e;\">Get single event by ID (sysev_...)</td>\n</tr>\n<tr>\n <td style=\"padding:8px 12px;\"><code style=\"color:#61afef;\">konui_get_system_event_stats</code></td>\n <td style=\"padding:8px 12px;color:#7f848e;\">Get aggregate counts by type/service/severity</td>\n</tr>\n</table>\n\n<h3 style=\"color:#98c379;margin:16px 0 12px 0;\">Event Types Supported</h3>\n<pre style=\"background:#2d2d2d;padding:12px;border-radius:6px;overflow-x:auto;line-height:1.6;\">\n<span style=\"color:#e5c07b;\">service_restart</span> <span style=\"color:#7f848e;\"># Service restarted</span>\n<span style=\"color:#e5c07b;\">service_start</span> <span style=\"color:#7f848e;\"># Initial boot</span>\n<span style=\"color:#e5c07b;\">account_switch</span> <span style=\"color:#7f848e;\"># Claude account changed</span>\n<span style=\"color:#e5c07b;\">system_alert</span> <span style=\"color:#7f848e;\"># System-wide alert</span>\n<span style=\"color:#e5c07b;\">user_login</span> <span style=\"color:#7f848e;\"># User logged in</span>\n<span style=\"color:#e5c07b;\">user_logout</span> <span style=\"color:#7f848e;\"># User logged out</span>\n<span style=\"color:#e5c07b;\">quota_warning</span> <span style=\"color:#7f848e;\"># Quota threshold reached</span>\n<span style=\"color:#e5c07b;\">error</span> <span style=\"color:#7f848e;\"># System error occurred</span>\n<span style=\"color:#e5c07b;\">maintenance</span> <span style=\"color:#7f848e;\"># Maintenance mode</span>\n</pre>\n\n<h3 style=\"color:#98c379;margin:16px 0 12px 0;\">Example Usage</h3>\n<pre style=\"background:#2d2d2d;padding:12px;border-radius:6px;overflow-x:auto;line-height:1.6;\">\n<span style=\"color:#7f848e;\">// Create a system event</span>\n<span style=\"color:#c678dd;\">await</span> <span style=\"color:#61afef;\">konui_create_system_event</span>({\n <span style=\"color:#e5c07b;\">type</span>: <span style=\"color:#98c379;\">\"service_restart\"</span>,\n <span style=\"color:#e5c07b;\">service</span>: <span style=\"color:#98c379;\">\"konui\"</span>,\n <span style=\"color:#e5c07b;\">message</span>: <span style=\"color:#98c379;\">\"Service restarted after config update\"</span>,\n <span style=\"color:#e5c07b;\">severity</span>: <span style=\"color:#98c379;\">\"info\"</span>\n});\n\n<span style=\"color:#7f848e;\">// List recent errors</span>\n<span style=\"color:#c678dd;\">await</span> <span style=\"color:#61afef;\">konui_list_system_events</span>({\n <span style=\"color:#e5c07b;\">severity</span>: <span style=\"color:#98c379;\">\"error\"</span>,\n <span style=\"color:#e5c07b;\">limit</span>: <span style=\"color:#d19a66;\">10</span>\n});\n</pre>\n\n<h3 style=\"color:#98c379;margin:16px 0 12px 0;\">Commit</h3>\n<p style=\"margin:0;\"><code style=\"background:#2d2d2d;padding:4px 8px;border-radius:4px;color:#56b6c2;\">9f4ca505</code> <span style=\"color:#7f848e;\">Turn: Add MCP tools for gvSystemEvent</span></p>\n\n<div style=\"margin-top:20px;padding-top:16px;border-top:1px solid #3d3d3d;\">\n<p style=\"color:#7f848e;margin:0 0 8px 0;\">These tools expose the gvSystemEvent API to Claude, allowing system events to be created and queried. Events appear as grey markers on the timeline.</p>\n<p style=\"color:#f97316;margin:0;\"><strong>Note:</strong> Requires konui restart to load the new MCP tools. See greatvibe-restart-permitted status.</p>\n</div>\n</div>",
"requestedAt": "2026-01-11T07:00:00.000Z",
"requestId": "4fcffa79-5806-4426-a185-6534dd6dc6fe",
"commitSha": "9f4ca505",
"choices": [
{
"label": "Restart konui",
"value": "Restart konui to load the new MCP tools",
"primary": true
},
{
"label": "Test the API",
"value": "Test the system events API endpoints directly with curl"
},
{
"label": "Update CLAUDE.md",
"value": "Add documentation for the new MCP tools to CLAUDE.md"
}
],
"turnTiming": {
"totalMs": 196466,
"ttfeMs": 94,
"thinkingMs": 196370,
"toolExecutionMs": 0,
"toolCallCount": 0,
"thinkingPct": 100,
"toolsPct": 0,
"ttfePct": 0
}
},
"createdBy": "claude",
"createdAt": "2026-01-11T12:09:52.753Z",
"updatedAt": "2026-01-11T12:10:10.028Z",
"requestId": "4fcffa79-5806-4426-a185-6534dd6dc6fe",
"scope": "greatvibe",
"tags": [
"mcp",
"system-events",
"konui"
],
"sessionId": "ses_f1a97fe1-589"
}