@cronicorn/mcp-server

Cronicorn MCP Server

Manage cron jobs by talking to your AI assistant.

You: "Check my API health every 5 minutes"
AI: ✅ Created job with health check running every 5 minutes.

You: "Help me migrate my app's scheduling to Cronicorn"
AI: I found 3 cron jobs in your codebase. Here's how to move each one...

You: "Give me 5 profitable SaaS ideas built on Cronicorn"
AI: Based on Cronicorn's adaptive scheduling and AI capabilities...

Works with Claude, GitHub Copilot, Cursor, Cline, Continue, and any MCP-compatible assistant.

Setup

Claude Code (CLI)

claude mcp add cronicorn -- npx -y @cronicorn/mcp-server

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS)

{
  "mcpServers": {
    "cronicorn": {
      "command": "npx",
      "args": ["-y", "@cronicorn/mcp-server"]
    }
  }
}

VS Code / GitHub Copilot

In VS Code settings (JSON):

{
  "github.copilot.chat.mcp.servers": {
    "cronicorn": {
      "command": "npx",
      "args": ["-y", "@cronicorn/mcp-server"]
    }
  }
}

Or create ~/.vscode/mcp.json:

{
  "mcpServers": {
    "cronicorn": {
      "command": "npx",
      "args": ["-y", "@cronicorn/mcp-server"]
    }
  }
}

Cursor / Cline / Continue

{
  "mcpServers": {
    "cronicorn": {
      "command": "npx",
      "args": ["-y", "@cronicorn/mcp-server"]
    }
  }
}

Authentication

On first run, the server starts OAuth device flow:

• Opens browser to https://cronicorn.com/device/approve
• Enter the displayed user code
• Credentials stored in ~/.cronicorn/credentials.json

Tokens are valid for 30 days. Re-authentication is automatic when expired.

Tools

Jobs

Tool	Description
createJob	Create a new job container
getJob	Get job details
listJobs	List all jobs
updateJob	Update job properties
archiveJob	Archive a job (soft delete)
pauseJob	Pause job execution
resumeJob	Resume paused job

Endpoints

Tool	Description
addEndpoint	Add HTTP endpoint to a job
getEndpoint	Get endpoint details
listEndpoints	List endpoints for a job
updateEndpoint	Update endpoint config
archiveEndpoint	Archive an endpoint
pauseResumeEndpoint	Pause/unpause endpoint

AI Scheduling

Tool	Description
applyIntervalHint	Suggest new interval
scheduleOneShot	Trigger immediate run
clearHints	Remove pending hints
resetFailures	Reset failure count

Monitoring

Tool	Description
listEndpointRuns	Get execution history
getRunDetails	Get specific run details
getEndpointHealth	Get health summary
getDashboardStats	Get account-wide stats

Documentation Resources

The server bundles comprehensive docs as MCP resources — concepts, recipes, API reference, troubleshooting, and self-hosting guides. AI assistants read these automatically to answer questions about Cronicorn.

For conversational examples and detailed tool call walkthroughs, see the full docs.

Updating

Use @latest tag to always get the newest version:

{
  "mcpServers": {
    "cronicorn": {
      "command": "npx",
      "args": ["-y", "@cronicorn/mcp-server@latest"]
    }
  }
}

Environment Variables

Variable	Default	Description
CRONICORN_API_URL	https://cronicorn.com/api	API base URL
CRONICORN_WEB_URL	https://cronicorn.com	Web UI URL

Development

# From monorepo root
pnpm install
pnpm --filter @cronicorn/mcp-server build
pnpm --filter @cronicorn/mcp-server dev

Troubleshooting

"No credentials found" - Delete ~/.cronicorn/credentials.json and re-authenticate.

Browser doesn't open - Manually visit the URL shown in terminal.

"Invalid grant" error - Token revoked. Delete credentials and re-authenticate.

License

FSL-1.1-MIT