Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add self-starter -- npx -y self-starter
Open on GitHub

What 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-smi to 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 ui to review active background probe tasks

How to install Self-Starter

Platform CLI

claude mcp add self-starter -- npx -y self-starter

Step 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.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open