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.