Skip to main content
Glama
watchcron-mcp

watchcron-mcp

Official
by watchcron

watchcron-mcp

npm version License: MIT

Monitor your cron jobs and scheduled tasks from AI agents. MCP server for WatchCron.

Features

  • List all cron job monitors and their current status

  • Create new monitors with simple interval or cron expression schedules

  • Get the ping URL to add to your crontab or task scheduler

  • View ping history and incident timeline

  • Pause and resume monitors

  • Update monitor settings (schedule, grace period, tags)

  • Delete monitors you no longer need

  • List notification channels (email, Slack, webhook)

Related MCP server: healthchecks-io-mcp

Quick Start

1. Get your API key

Sign up and generate an API key at watchcron.com.

2. Configure your AI client

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "watchcron": {
      "command": "npx",
      "args": ["-y", "watchcron-mcp"],
      "env": {
        "WATCHCRON_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude Code

claude mcp add watchcron \
  npx -y watchcron-mcp \
  -e WATCHCRON_API_KEY=your_api_key_here

Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "watchcron": {
      "command": "npx",
      "args": ["-y", "watchcron-mcp"],
      "env": {
        "WATCHCRON_API_KEY": "your_api_key_here"
      }
    }
  }
}

Windsurf

Add to your Windsurf MCP configuration with the same npx -y watchcron-mcp command and set the WATCHCRON_API_KEY environment variable.

Available Tools

list_monitors

List all cron job monitors in your project. Optionally filter by tag.

Parameter

Type

Description

tag

string

Filter monitors by tag (optional)

get_monitor

Get detailed info about a specific monitor.

Parameter

Type

Description

uuid

string

Monitor UUID

create_monitor

Create a new cron job monitor. Returns the ping URL to add to your cron job.

Parameter

Type

Default

Description

name

string

required

Monitor name (e.g. "Daily backup")

description

string

—

Optional description

schedule_type

simple | cron

required

Fixed interval or cron expression

period_seconds

number

—

Interval in seconds (for simple schedule, min 60)

cron_expression

string

—

Cron expression (for cron schedule)

timezone

string

UTC

Timezone for schedule

grace_seconds

number

—

Grace period before alerting

tags

string[]

—

Tags for organizing

update_monitor

Update an existing monitor's settings.

Parameter

Type

Description

uuid

string

Monitor UUID

name

string

New name

description

string

New description

schedule_type

simple | cron

New schedule type

period_seconds

number

New interval

cron_expression

string

New cron expression

timezone

string

New timezone

grace_seconds

number

New grace period

tags

string[]

New tags

delete_monitor

Permanently delete a monitor.

Parameter

Type

Description

uuid

string

Monitor UUID

pause_monitor

Pause or resume a monitor.

Parameter

Type

Default

Description

uuid

string

required

Monitor UUID

paused

boolean

true

true to pause, false to resume

get_pings

Get recent ping history for a monitor.

Parameter

Type

Default

Description

uuid

string

required

Monitor UUID

limit

number

10

Number of pings to return (1-100)

get_incidents

Get status change history (down/up transitions).

Parameter

Type

Default

Description

uuid

string

required

Monitor UUID

limit

number

10

Number of incidents to return (1-100)

list_channels

List notification channels (email, Slack, webhook, etc.).

No parameters required.

Example Prompts

  • "Show me all my cron monitors"

  • "Create a monitor for my daily backup that runs every 24 hours"

  • "Create a monitor for '*/5 * * * *' called 'Health check'"

  • "What's the status of my database cleanup monitor?"

  • "Show me the last 20 pings for monitor abc-123"

  • "Pause the nightly report monitor"

  • "Has my backup job had any incidents recently?"

  • "List my notification channels"

How It Works

  1. Your AI agent receives a request about cron job monitoring

  2. The agent calls WatchCron tools (list, create, check status, etc.)

  3. The MCP server communicates with the WatchCron API

  4. Results are returned to the AI agent in a readable format

Typical workflow

You: "Set up monitoring for my backup script that runs at 2am daily"

Agent: Creates a monitor with cron expression "0 2 * * *"
       Returns the ping URL

You: Add to your crontab:
     0 2 * * * /path/to/backup.sh && curl -fsS https://watchcron.com/ping/xxx > /dev/null

Requirements

  • Node.js 18+

  • A WatchCron API key (sign up)

Other Projects by WatchCron

License

MIT

Available Tools

9 tools
create_monitorA

Create a new cron job monitor. Returns the ping URL that your cron job should call. Supports simple interval (every N seconds) or cron expression schedules.

Inputs: name (required), schedule_type (required), tags, timezone, +4 more.

delete_monitorB

Permanently delete a cron job monitor. This cannot be undone.

Inputs: uuid (required).

get_incidentsA

Get status change history (incidents) for a monitor. Shows when the monitor went down, recovered, or changed status.

Inputs: uuid (required), limit.

get_monitorA

Get detailed information about a specific cron job monitor, including its status, schedule, ping URL, last ping time, and next expected ping.

Inputs: uuid (required).

get_pingsB

Get recent ping history for a monitor. Shows when pings were received, their type (success/start/fail), source IP, and duration.

Inputs: uuid (required), limit.

list_channelsA

List notification channels configured in your WatchCron project (email, Slack, webhook, etc.).

Inputs: no named parameters.

list_monitorsA

List all cron job monitors in your WatchCron project. Shows name, status, schedule, last ping time, and ping URL for each monitor.

Inputs: tag.

pause_monitorA

Pause or resume a cron job monitor. Paused monitors won't trigger alerts when pings are missed.

Inputs: uuid (required), paused.

update_monitorC

Update an existing cron job monitor's settings (name, schedule, grace period, tags).

Inputs: uuid (required), name, tags, timezone, +5 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 9 tools

    Disambiguation5/5

    Each tool has a distinct resource+action target: monitor CRUD is split cleanly across list/get/create/update/delete, with pause_monitor covering the orthogonal state toggle. get_pings and get_incidents target clearly separate history types, and list_channels is the only channel tool, so there are no ambiguous boundaries.

    Naming Consistency5/5

    All tools follow a consistent snake_case verb_noun pattern (list_monitors, get_monitor, create_monitor, delete_monitor, get_pings, get_incidents). The single deviation, pause_monitor, still fits the pattern even though it also resumes.

    Tool Count5/5

    Nine tools is well-scoped for a cron monitoring service, with each tool earning its place across the lifecycle (create/list/get/update/delete) plus observability and notification surfaces. No redundant or filler tools.

    Completeness4/5

    Monitor lifecycle is fully covered (create, list, get, update, delete, pause/resume) with ping and incident history reads, so core workflows have no dead ends. The gap is channels: list_channels exists with no create/update/delete-channel counterpart, and there is no manual ping/test trigger.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI assistants to interact with Healthchecks.io, allowing users to list, create, update, pause, resume, and delete checks, as well as view ping history and integrations.
      78 npm
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables users to manage OmniWatchGuard website monitors and alerts via natural language. Supports listing, creating, updating, pausing, resuming, and deleting monitors, plus reviewing recent notifications across channels.
      7
      547 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables assistants to monitor cron jobs, investigate failures via runs and incidents, and create or manage monitors through the Tickwatch API.
      MIT