An MCP (Model Context Protocol) server that connects AI assistants to Crontinel, the background job monitoring platform for Laravel. It runs as a local stdio process, proxying tool calls from your AI assistant to the Crontinel REST API.

Ask your AI assistant questions like "Did my cron jobs run last night?" or "What's the queue depth right now?" and get answers inline, without opening a browser.

• Node.js 18+
• A Crontinel account with an API key (app.crontinel.com)

npx -y @crontinel/mcp-server

Or install globally:

npm install -g @crontinel/mcp-server

Add to ~/.claude/settings.json (or use the Claude Code settings UI):

{
  "mcpServers": {
    "crontinel": {
      "command": "npx",
      "args": ["-y", "@crontinel/mcp-server"],
      "env": {
        "CRONTINEL_API_KEY": "your-api-key-here"
      }
    }
  }
}

Add to ~/.cursor/mcp.json or the project-level .cursor/mcp.json:

{
  "mcpServers": {
    "crontinel": {
      "command": "npx",
      "args": ["-y", "@crontinel/mcp-server"],
      "env": {
        "CRONTINEL_API_KEY": "your-api-key-here"
      }
    }
  }
}

List all monitored cron jobs for an app, with their last run status and timing.

Parameters:

Returns: Array of job objects with command, schedule, last_run_at, last_exit_code, last_duration_ms, status (ok / late / failing / never_ran).

Get the last run result for a specific cron command.

Parameters:

Returns: command, last_run_at, exit_code, duration_ms, output (last 500 chars of stdout/stderr), status.

Get queue depth, failed count, and oldest pending job age.

Parameters:

Returns: Array of queue objects with name, depth, failed_count, oldest_job_age_seconds.

Get a health snapshot of Laravel Horizon: supervisor states, paused/running, failed jobs per minute.

Parameters:

Returns: status (running / paused / inactive), failed_jobs_per_minute, supervisors array with name, status, processes.

List alerts that have fired within the last N hours.

Parameters:

Returns: Array of alert objects with alert_key, state (firing / resolved), fired_at, resolved_at, message.

Dismiss an active alert so it stops notifying.

Parameters:

Returns: { acknowledged: true, alert_key: "..." } on success.

Create a new alert channel for an app. Requires a Pro or Team plan.

Parameters:

Config by type:

Returns: The new alert channel ID on success.

1. Your AI assistant spawns the MCP server as a local stdio process
2. The server receives JSON-RPC tool calls over stdin
3. It forwards each call as an HTTP request to app.crontinel.com/api/mcp with your API key in the Authorization header
4. The JSON-RPC response is returned over stdout

All tool definitions are declared locally so your AI can inspect them without a network round-trip.

401 Unauthorized: Your CRONTINEL_API_KEY is missing or invalid. Check that the env var is set in your MCP config, not your shell profile (MCP servers don't inherit your shell environment).

404 Not Found on a tool call: The app_slug doesn't match any app in your account. Copy the slug from the app URL in the Crontinel dashboard (app.crontinel.com/apps/{slug}).

Tools not showing up in Claude/Cursor: Restart the AI client after updating the MCP config. Most clients only load MCP servers at startup.

npx slow on first run: npx -y downloads the package on first use. Run npm install -g @crontinel/mcp-server once to cache it locally, then change command to crontinel-mcp and remove the args.

For the full integration guide, tool reference, and setup walkthroughs:

• MCP Overview
• Available Tools Reference
• Claude Code Setup

MIT