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
- Access token
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. 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>Create the Cronly connection
In AgentKit > Connections, create a Cronly connection. The name you give it is the
connection_nameyour code passes. See Configure connections.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.actionsconst connector = 'cronly'const identifier = 'user_123'// Generate an authorization link for the userconst { 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 callconst result = await actions.executeTool({connector,identifier,toolName: 'cronly_backups_list',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "cronly"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Cronly:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="cronly_backups_list",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach 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 toexecute_toolcronly_backup_getGet the crontab back-up for one user on one server, with its snapshots.Read-onlyGet 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-onlyList 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-onlyGet 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-onlyList 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-onlyGet 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-onlyGet 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-onlyList 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-onlyList 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.
cronly_project_getGet one Cronly project with its monitors.Read-onlyGet Project
Get one Cronly project with its monitors. Returns the project's id, name and monitors; 404 when not found. Use cronly_projects_list to find IDs.
Inputs
project_idintegerrequired- Numeric ID of the project. Get it from cronly_projects_list. Example: 12.
cronly_projects_listList the projects used to group monitors in Cronly.Read-onlyList Projects
List the projects used to group monitors in Cronly. Returns each project's id and name. Use this to find a project_id.
Inputs
This tool takes no inputs.
cronly_server_getGet one registered server.Read-onlyGet Server
Get one registered server. Returns the server's id, name, identifier and IP address; 404 when not found. Use cronly_servers_list to find IDs.
Inputs
server_idintegerrequired- Numeric ID of the server. Get it from cronly_servers_list. Example: 3.
cronly_servers_listList the servers registered for crontab back-ups.Read-onlyList Servers
List the servers registered for crontab back-ups. Returns each server's id, name, identifier and IP address. Use this to find a server identifier for back-ups.
Inputs
This tool takes no inputs.
cronly_user_getGet one user in your Cronly organisation.Read-onlyGet User
Get one user in your Cronly organisation. Returns the user's id, name, email and role; 404 when not found. Use cronly_users_list to find IDs.
Inputs
user_idintegerrequired- Numeric ID of the user. Get it from cronly_users_list. Example: 7.
cronly_users_listList the users (employees) in your Cronly organisation.Read-onlyList Users
List the users (employees) in your Cronly organisation. Returns each user's id, name, email and role. Use this to see who has access.
Inputs
This tool takes no inputs.
cronly_certificate_createStart monitoring the SSL certificate of a hostname so Cronly warns you before it expires.WriteCreate SSL Certificate Monitor
Start monitoring the SSL certificate of a hostname so Cronly warns you before it expires. Returns the new certificate monitor. Use cronly_certificates_list to see all monitored hosts.
Inputs
hostnamestringrequired- Hostname to check, without https://. Example: www.example.com.
portinteger- TLS port. Defaults to 443. Example: 443.
project_idinteger- Project to group it under, from cronly_projects_list. Example: 12.
cronly_monitor_createCreate a cron job monitor that expects a ping on a cron schedule and alerts you when a run is late or too slow.WriteCreate Job Monitor
Create a cron job monitor that expects a ping on a cron schedule and alerts you when a run is late or too slow. Returns the new monitor with its id and the token your job pings. Make the job call https://cronly.app/api/monitors/pulse/<token> (or use cronly_monitor_pulse) each time it runs.
Inputs
durationintegerrequired- Maximum minutes the job may run before it counts as late. Example: 30.
namestringrequired- Monitor name. Example: Nightly database backup.
schedulestringrequired- Cron expression for when the job runs. Example: 0 2 * * *.
timezonestringrequired- IANA time zone the schedule is in. Example: UTC.
project_idinteger- Project to group it under, from cronly_projects_list. Example: 12.
cronly_monitor_pulseRecord a heartbeat (pulse) for a job monitor, the same ping a monitored job sends when it runs.WriteSend Monitor Ping
Record a heartbeat (pulse) for a job monitor, the same ping a monitored job sends when it runs. Returns status ok. Use this to mark a job run from an agent or workflow. The token comes from cronly_monitors_list.
Inputs
monitor_tokenstringrequired- The monitor's ping token (a UUID), from cronly_monitors_list or cronly_monitor_create. Example: 6e9c5250-a609-4fcc-aec8-710104fd744e.
cronly_project_createCreate a project to group monitors.WriteCreate Project
Create a project to group monitors. Returns the new project with its id. Pass its id as project_id when creating monitors.
Inputs
namestringrequired- Project name. Example: Billing service.
cronly_server_createRegister a server whose crontab back-ups Cronly stores.WriteRegister Server
Register a server whose crontab back-ups Cronly stores. Back-ups are only accepted from the server's IP address. Returns the new server. Use the identifier you set here as server_id in the back-up tools.
Inputs
identifierstringrequired- Your own unique identifier for the server. Example: web-01.
ip_addressstringrequired- Public IP address the server sends back-ups from. Example: 203.0.113.10.
namestringrequired- Server name. Example: Web server 1.
cronly_backup_deleteDelete the crontab back-up for one user on one server.DestructiveDelete Crontab Back-up
Delete the crontab back-up for one user on one server. Returns status ok, or 404 when not found. Use cronly_backups_list to see what exists.
- Idempotent
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_certificate_deleteStop monitoring a certificate and delete its monitor.DestructiveDelete SSL Certificate Monitor
Stop monitoring a certificate and delete its monitor. Returns status ok, or 404 when not found. Use cronly_certificates_list to find IDs.
- Idempotent
Inputs
certificate_idintegerrequired- Numeric ID of the certificate. Get it from cronly_certificates_list. Example: 88.
cronly_monitor_deleteDelete a cron job monitor.DestructiveDelete Job Monitor
Delete a cron job monitor. Pings to its token stop being recorded. Returns status ok, or 404 when not found. Use cronly_monitors_list to find IDs.
- Idempotent
Inputs
monitor_idintegerrequired- Numeric ID of the monitor. Get it from cronly_monitors_list. Example: 1042.
cronly_project_deleteDelete a Cronly project.DestructiveDelete Project
Delete a Cronly project. Returns status ok, or 404 when not found. Use cronly_projects_list to find IDs.
- Idempotent
Inputs
project_idintegerrequired- Numeric ID of the project. Get it from cronly_projects_list. Example: 12.
cronly_server_deleteDelete a registered server.DestructiveDelete Server
Delete a registered server. Returns status ok, or 404 when not found. Use cronly_servers_list to find it.
- Idempotent
Inputs
server_idintegerrequired- Numeric ID of the server, from cronly_servers_list. Example: 3.
No tools match.