Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to Cronly

Scalekit connector
Open markdown

The Cronly connector lets your AI agent act in each user's Cronly account. Each user connects their own Cronly access token once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 24 tools.

Tools
24
What they doRead · write · destructive
14 · 5 · 514 read5 write5 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>
  3. Create the Cronly connection

    In AgentKit > Connections, create a Cronly connection. The name you give it is the connection_name your code passes. See Configure connections.

  4. Authorize a user and make your first call

    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    const scalekit = new ScalekitClient(
    process.env.SCALEKIT_ENVIRONMENT_URL,
    process.env.SCALEKIT_CLIENT_ID,
    process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    const connector = 'cronly'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Cronly:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    // Make your first call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'cronly_backups_list',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their Cronly credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • cronly_backup_getGet the crontab back-up for one user on one server, with its snapshots.Read-only

    Get Crontab Back-up

    Get the crontab back-up for one user on one server, with its snapshots. Returns the back-up and its crontab file contents; 404 when not found. Use cronly_backups_list to see what exists.

    Inputs

    server_idstringrequired
    Identifier of the server (the identifier you set when creating it), from cronly_servers_list. Example: web-01.
    usernamestringrequired
    Username on the server whose crontab back-up this is. Example: deploy.
  • cronly_backups_listList the crontab back-ups stored in Cronly.Read-only

    List Crontab Back-ups

    List the crontab back-ups stored in Cronly. Returns each back-up's server, username and snapshots. Use cronly_backup_get for one back-up's contents.

    Inputs

    This tool takes no inputs.

  • cronly_certificate_getGet one SSL certificate monitor.Read-only

    Get SSL Certificate Monitor

    Get one SSL certificate monitor. Returns its hostname, port, certificate details, expiry date and status; 404 when not found. Use cronly_certificates_list to find IDs.

    Inputs

    certificate_idintegerrequired
    Numeric ID of the certificate. Get it from cronly_certificates_list. Example: 88.
  • cronly_certificates_listList the SSL certificate monitors in your Cronly account.Read-only

    List SSL Certificate Monitors

    List the SSL certificate monitors in your Cronly account. Returns each monitor's id, hostname, port, issuer, expiry date and status. Use this to see which certificates expire soon.

    Inputs

    This tool takes no inputs.

  • cronly_company_getGet your Cronly company (organisation) details and notification settings.Read-only

    Get Company

    Get your Cronly company (organisation) details and notification settings. Returns the company's name, timezone, plan and notification channel settings. Use this to check the connection works.

    Inputs

    This tool takes no inputs.

  • cronly_monitor_getGet one cron job monitor with its schedule, status and recent pings.Read-only

    Get Job Monitor

    Get one cron job monitor with its schedule, status and recent pings. Returns the monitor's id, name, token, schedule, timezone, duration, project and status; 404 when not found. Use cronly_monitors_list to find IDs.

    Inputs

    monitor_idintegerrequired
    Numeric ID of the monitor. Get it from cronly_monitors_list. Example: 1042.
  • cronly_monitors_listList all cron job monitors in your Cronly account.Read-only

    List Job Monitors

    List all cron job monitors in your Cronly account. Returns each monitor's id, name, ping token, schedule, timezone, maximum duration, project and current status. Use this to find a monitor ID or its ping token.

    Inputs

    This tool takes no inputs.

  • cronly_notifications_listList the notifications Cronly has raised (late, failed or recovered jobs, expiring certificates), newest first, with paging.Read-only

    List Notifications

    List the notifications Cronly has raised (late, failed or recovered jobs, expiring certificates), newest first, with paging. Returns data with each notification's type, message, related monitor and time, plus paging info. Use this to see recent alerts.

    Inputs

    pageinteger
    Page to return. Defaults to 1. Example: 1.
    per_pageinteger
    Results per page. Defaults to 10. Example: 10.