vigil

v0.15.0

Self-scheduling follow-up MCP server. No external scheduler, no gateway, no cron.

What is vigil?

vigil is an MCP server that schedules and monitors follow-up tasks autonomously. When an AI agent needs to check something later - build status, deployment health, async operations - vigil handles the scheduling, checking, retries, and notifications internally.

Single dependency (mcp). 148 passing tests. 13 notification channels.

How It Works

1. Agent calls loop_schedule with a task + check command
2. Internal scheduler thread polls every 10s
3. When it's time, the check runs automatically
4. Success -> loop closes. Failure -> retry with backoff. Timeout -> expire.
5. Notifications via Slack, Telegram, Discord, Teams, email, webhook, and 7 more channels
            

11 MCP Tools

loop_schedule

Schedule a follow-up with task, check command, timing, and retry policy

loop_check

Run a check immediately without waiting for the scheduler

loop_list

List all tasks with optional status filter

loop_cancel

Cancel a pending task before it completes

loop_batch

Schedule multiple follow-ups in a single call

loop_dashboard

Summary view: active, completed, failed counts + recent events

loop_history

Execution history for a specific task

loop_schedule_template

Schedule from predefined templates (CI check, deploy verify, etc.)

loop_write_result

Manually write a result for tasks that can't be auto-checked

5 Check Types

TypeHow It Works
shellRun a command, exit 0 = success
httpGET a URL, 2xx = success
fileCheck if file exists or was recently modified
processCheck if a PID is still running
compositeRun multiple checks, all must pass

13 Notification Channels

file (JSONL) | webhook (POST) | Slack (Block Kit) | Telegram (Bot API) | Discord (Embeds) | Teams (Adaptive Cards) | ntfy.sh | Pushover | Gotify | Matrix | Twilio SMS | Google Chat (Cards v2) | email (SMTP)

Get Involved

vigil is open source under the MIT license.

View on GitHub Report Issue