Self-Starter — Claude Code MCP server: what it does, how to install
Self-Starter — an MCP server for Claude Code that runs background event probes locally without model calls. It wakes your agent only when CI fails, services crash, or log files report errors.
MIT ★ 8 updated 2026-11-16
claude mcp add self-starter -- npx -y self-starterWhat Self-Starter does
Self-Starter attaches an autonomous background event layer to your coding assistant. The agent drafts a short TypeScript probe, tests it, and registers it with launchd on macOS or systemd on Linux. Routine checks run purely on your machine, burning zero tokens until an event triggers.
The core engine tracks state shifts, enforces cooldowns, prevents alert spam, and halts pings during quiet hours. Once conditions match, the agent restarts with the original instructions, checks logs or CLI outputs, and evaluates whether to notify you. The integrated local console via self-starter ui on 127.0.0.1 handles probe inspection and alert delivery to Desktop, Telegram, Discord, or Slack.
Running probes requires macOS or Linux, a working Node.js runtime with npx, and access to background system daemons.
What it helps with
- watch long CI workflows and investigate failed job logs automatically
- track local service uptime and read logs when an HTTP endpoint stays down
- monitor GPU idle state via
nvidia-smito queue the next training job - route alerts from background probes to Telegram, Slack, or desktop popups
Example prompts for the agent
- Keep watching this PR with Self-Starter, investigate any failing CI run, and continue in this conversation
- Set a probe on local port 3000: if it goes down for two minutes, trace container logs and explain the root cause
- Run
self-starter uito review active background probe tasks
How to install Self-Starter
Platform CLI
claude mcp add self-starter -- npx -y self-starterPlatform CLI
codex mcp add self-starter -- npx -y self-starterConfig file
{
"mcpServers": {
"self-starter": {
"command": "npx",
"args": [
"-y",
"self-starter"
]
}
}
}Config file
{
"servers": {
"self-starter": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"self-starter"
]
}
}
}Platform CLI
gemini mcp add self-starter npx -y self-starterStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Self-Starter
How to install Self-Starter in Claude Code?
Run claude mcp add self-starter -- npx -y self-starter in your terminal to register the server directly.
What does Self-Starter do?
It delegates waiting tasks to local system daemons instead of running polling loops inside agent sessions. Your agent wakes up only when an actual event occurs, keeping zero-token overhead during the wait.
What is required to run Self-Starter?
You need macOS or Linux, Node.js with npx, and an active background service manager like launchd or systemd.