System MCP Server
MCP server with six tools for preferences, notifications, a tool inventory, file-name search and the active task, backed by a JSON file with sample data.
packages/system-mcp
System MCP exposes a small set of “system” tools to an agent. The data comes from ~/.config/robos/system/state.json, which is created with built-in sample values on first run and edited by the tools afterwards.
Tools and resources
| Tool | Behavior |
|---|---|
robos_system_get_preferences |
Returns the preferences object in the state file (sample: theme, AI model, port values). It does not read ~/.config/robos/settings.json. |
robos_system_send_notification |
Adds a notification (title, body, urgency) to the state file. It does not show a toast. |
robos_system_search_files |
Substring search over a fixed list of file names stored in the state file. It does not scan your disk. |
robos_system_get_installed_tools |
Returns the tool list in the state file (sample entries for gh, kubectl, docker, cargo). |
robos_system_install_tool |
Marks a tool as installed in the state file; nothing is installed. |
robos_system_get_active_task |
Returns the sample activeTask object. |
Resources: robos://system-mcp/system/preferences, .../system/notifications/recent and .../system/tools.
For real notifications use robos-notify from RobOS CLI Tools.
The console window
System MCP Server Console has @-Search Files and Send Toast Notification buttons, panels for tools, preferences and recent notifications, and a protocol trace. The server is created without an HTTP port, so it only registers itself in ~/.config/robos/mcp/servers.json; it does not listen on the network. Run it with npm start in packages/system-mcp. npm test runs node --test.
More in Agent Services & MCP Servers
Agent Autoconfig
Writes MCP configuration and instruction files so Claude Code, Gemini, Copilot and Cursor all point at the RobOS MCP router.
Agent Daemon (agentd)
Keeps a registry of sub-agent sessions, each with its own home directory and environment, behind a Unix socket and a small window.
Agent Profile Daemon
Creates short-lived agent profiles with their own home directory (tmpfs when run as root) and runs commands with that home and environment.
Agent Session Library
Node.js client for the agentd socket, plus a small demo window and a simulated test-driven-development runner.
CI Monitor MCP Server
An MCP server that lets agents list Buildkite builds and read failed-job logs, backed by the connection set up in CI Monitor.
Dev Tools MCP Server
An MCP server with a small catalog of developer CLI tools; "install" and "check" read and write a JSON file and do not touch the system.
Engineering Knowledge Graph MCP Server
An MCP server that lets agents search and edit a small node store, query and propose changes to the SDLC graph, and look up schema types.
IDE Bridge MCP Server
An MCP server that forwards IDE commands (open file, breakpoints, run configurations, refactorings) to the RobOS IntelliJ plugin on port 63343.
MCP Router
Single MCP endpoint that lists the tools of the servers in the registry and routes tool calls to them, with built-in fallbacks.
MCP Server Framework
Node.js library for building small Model Context Protocol servers, with an HTTP and a stdio transport and a shared registry file.
RobOS CLI Tools
Four shell scripts for scripts and agents: send a notification, set the active task, append to the work journal, and emit or read events.
Task Manager MCP Server
MCP server with seven tools for listing, creating and advancing tasks stored in ~/.config/robos/tasks/tasks.json.
Workspace Manager MCP Server
MCP server with six workspace tools, backed by a JSON file of sample workspaces. Several tools return canned results and do not run anything.