agent-cronjob is an MCP server published by ai.agentasy, hosted at cronjob.agentasy.ai. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 15 tools, including create_job, verify_challenge, claim_credentials, retry_challenge, list_jobs.
Scheduled, HMAC-signed, retried webhook triggers for AI agents. No account: self-register via tools.
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Step 1. Register your webhook and schedule (no account, no API key). Returns job_id and a one-time setup_token, and POSTs a url_verification challenge to webhook_url. Your webhook must answer it (echo: reply 2xx {"challenge":"<same>"}) — then call claim_credentials. Or reply 2xx and call verify_challenge with the value (callback). Nothing triggers before verification. (REST: POST /v1/jobs)
| Parameter | Type | Description |
|---|---|---|
| name | ["string","null"] | |
| payload | object | Sent unchanged in every trigger (≤ 8 KB). |
| max_runs | any | Complete after this many dispatched runs; null = unlimited. |
| schedule * | object | Exactly one of {cron, timezone?}, {interval_sec}, {run_at}. Minimum spacing 60 s. |
| timeout_ms | integer | |
| webhook_url * | string | Public https URL of your agent. It receives the challenge now and the signed triggers later. |
| outgoing_auth | any | Optional header your webhook requires (e.g. a Grok routine webhook that needs Authorization). Sent on the url_verification POST and every trigger; never overrides the X-Cronjob-* headers. |
| catchup_policy | string | one of ["skip","run_once","run_all"] |
| retry_base_sec | integer | |
| signature_in_body | boolean | Default false. true = every trigger body also carries cronjob_signature {version, timestamp, delivery_id, signatures[], signature} (HMAC over "v1b:{timestamp}:{delivery_id}:" + canonical JSON of the body without cronjob_signature). Use it when your webhook platform drops the X-Cronjob-* headers (e.g… |
| verification_mode | string | Informational; both answers work. Default echo. |
| catchup_window_sec | integer | |
| retry_max_attempts | integer | |
| retry_max_backoff_sec | integer |
{
"name": "create_job",
"title": "Create a job (start registration)",
"description": "Step 1. Register your webhook and schedule (no account, no API key). Returns job_id and a one-time setup_token, and POSTs a url_verification challenge to webhook_url. Your webhook must answer it (echo: reply 2xx {\"challenge\":\"<same>\"}) — then call claim_credentials. Or reply 2xx and call verify_challenge with the value (callback). Nothing triggers before verification. (REST: POST /v1/jobs)",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"webhook_url",
"schedule"
],
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"payload": {
"type": "object",
"description": "Sent unchanged in every trigger (≤ 8 KB).",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"max_runs": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
],
"description": "Complete after this many dispatched runs; null = unlimited."
},
"schedule": {
"type": "object",
"properties": {
"cron": {
"type": "string",
"description": "5-field cron or @hourly/@daily/@weekly/@monthly/@yearly"
},
"run_at": {
"type": "string",
"description": "ISO 8601 with Z or an offset, in the future (one-off)"
},
"timezone": {
"type": "string",
"description": "IANA zone for cron, default UTC"
},
"interval_sec": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "60 … 31622400"
}
},
"description": "Exactly one of {cron, timezone?}, {interval_sec}, {run_at}. Minimum spacing 60 s.",
"additionalProperties": false
},
"timeout_ms": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"webhook_url": {
"type": "string",
"description": "Public https URL of your agent. It receives the challenge now and the signed triggers later."
},
"outgoing_auth": {
"anyOf": [
{
"type": "object",
"required": [
"value"
],
"properties": {
"value": {
"type": "string",
"description": "Header value (1 … 4096 chars, no CR/LF), e.g. \"Bearer <token>\". Secret: stored encrypted, never shown back."
},
"header": {
"type": "string",
"description": "Authorization (default) or an X-… header name (not X-Cronjob-…)."
}
},
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Optional header your webhook requires (e.g. a Grok routine webhook that needs Authorization). Sent on the url_verification POST and every trigger; never overrides the X-Cronjob-* headers."
},
"catchup_policy": {
"enum": [
"skip",
"run_once",
"run_all"
],
"type": "string"
},
"retry_base_sec": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"signature_in_body": {
"type": "boolean",
"description": "Default false. true = every trigger body also carries cronjob_signature {version, timestamp, delivery_id, signatures[], signature} (HMAC over \"v1b:{timestamp}:{delivery_id}:\" + canonical JSON of the body without cronjob_signature). Use it when your webhook platform drops the X-Cronjob-* headers (e.g. Grok Bot routines)."
},
"verification_mode": {
"enum": [
"echo",
"callback"
],
"type": "string",
"description": "Informational; both answers work. Default echo."
},
"catchup_window_sec": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"retry_max_attempts": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"retry_max_backoff_sec": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
}
},
"additionalProperties": false
},
"annotations": {
"title": "Create a job (start registration)",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Step 2 (callback mode). Send back the challenge value your webhook received. On success the result holds hmac_secret and management_token — SHOWN ONCE, store them now. (REST: POST /v1/jobs/{id}/verify)
| Parameter | Type | Description |
|---|---|---|
| job_id * | string | job_<ULID> returned by create_job |
| challenge * | string | The challenge value from the url_verification POST |
{
"name": "verify_challenge",
"title": "Verify the challenge (callback mode)",
"description": "Step 2 (callback mode). Send back the challenge value your webhook received. On success the result holds hmac_secret and management_token — SHOWN ONCE, store them now. (REST: POST /v1/jobs/{id}/verify)",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"job_id",
"challenge"
],
"properties": {
"job_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "job_<ULID> returned by create_job"
},
"challenge": {
"type": "string",
"description": "The challenge value from the url_verification POST"
}
},
"additionalProperties": false
},
"annotations": {
"title": "Verify the challenge (callback mode)",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Step 3. Poll verification state with the setup_token. The first call after the webhook is verified returns hmac_secret (signs triggers) and management_token (manages the job) — SHOWN ONCE, store them now; later calls say credentials: "already_issued". (REST: GET /v1/jobs/{id}/verification)
| Parameter | Type | Description |
|---|---|---|
| job_id * | string | job_<ULID> returned by create_job |
| setup_token | string | act_st_… setup token from create_job. Optional if the MCP HTTP request carries Authorization: Bearer <setup_token>. |
{
"name": "claim_credentials",
"title": "Poll verification / collect credentials",
"description": "Step 3. Poll verification state with the setup_token. The first call after the webhook is verified returns hmac_secret (signs triggers) and management_token (manages the job) — SHOWN ONCE, store them now; later calls say credentials: \"already_issued\". (REST: GET /v1/jobs/{id}/verification)",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "job_<ULID> returned by create_job"
},
"setup_token": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "act_st_… setup token from create_job. Optional if the MCP HTTP request carries Authorization: Bearer <setup_token>."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Poll verification / collect credentials",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Re-send a fresh url_verification challenge to your webhook (at most 5 re-sends (6 challenges in total), at least 60 s apart). The previous challenge stops working. (REST: POST /v1/jobs/{id}/verification/retry)
| Parameter | Type | Description |
|---|---|---|
| job_id * | string | job_<ULID> returned by create_job |
| setup_token | string | act_st_… setup token from create_job. Optional if the MCP HTTP request carries Authorization: Bearer <setup_token>. |
{
"name": "retry_challenge",
"title": "Re-send the challenge",
"description": "Re-send a fresh url_verification challenge to your webhook (at most 5 re-sends (6 challenges in total), at least 60 s apart). The previous challenge stops working. (REST: POST /v1/jobs/{id}/verification/retry)",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "job_<ULID> returned by create_job"
},
"setup_token": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "act_st_… setup token from create_job. Optional if the MCP HTTP request carries Authorization: Bearer <setup_token>."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Re-send the challenge",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Status of every job you hold a management token for. There are no accounts, so pass each {job_id, management_token} pair (up to 20); a pair without management_token uses the Authorization header. (REST: GET /v1/jobs/{id} (once per job))
| Parameter | Type | Description |
|---|---|---|
| jobs * | array |
{
"name": "list_jobs",
"title": "List your jobs",
"description": "Status of every job you hold a management token for. There are no accounts, so pass each {job_id, management_token} pair (up to 20); a pair without management_token uses the Authorization header. (REST: GET /v1/jobs/{id} (once per job))",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"jobs"
],
"properties": {
"jobs": {
"type": "array",
"items": {
"type": "object",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "job_<ULID> returned by create_job"
},
"management_token": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "act_mt_… management token. Optional if the MCP HTTP request carries Authorization: Bearer <management_token>."
}
},
"additionalProperties": false
},
"maxItems": 20,
"minItems": 1
}
},
"additionalProperties": false
},
"annotations": {
"title": "List your jobs",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Settings, status, next_run_at, run_count and credential prefixes of one job (webhook path masked). (REST: GET /v1/jobs/{id})
| Parameter | Type | Description |
|---|---|---|
| job_id * | string | job_<ULID> returned by create_job |
| management_token | string | act_mt_… management token. Optional if the MCP HTTP request carries Authorization: Bearer <management_token>. |
{
"name": "get_job",
"title": "Get a job",
"description": "Settings, status, next_run_at, run_count and credential prefixes of one job (webhook path masked). (REST: GET /v1/jobs/{id})",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "job_<ULID> returned by create_job"
},
"management_token": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "act_mt_… management token. Optional if the MCP HTTP request carries Authorization: Bearer <management_token>."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get a job",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Change a job in place: signature_in_body (true = triggers also carry cronjob_signature in the JSON body, for platforms that drop the X-Cronjob-* headers; applies from the next attempt sent) and/or max_runs. Raising max_runs on a job completed with max_runs_reached reactivates it (next run = next occurrence after now, no catch-up); there is no separate resume for completed jobs. Returns the updated job. (REST: PATCH /v1/jobs/{id})
| Parameter | Type | Description |
|---|---|---|
| job_id * | string | job_<ULID> returned by create_job |
| max_runs | any | New run limit (1 … 1000000), must be greater than run_count; null = unlimited. ≤ run_count → 400. Paused/disabled jobs keep their status. |
| management_token | string | act_mt_… management token. Optional if the MCP HTTP request carries Authorization: Bearer <management_token>. |
| signature_in_body | boolean | Default false. true = every trigger body also carries cronjob_signature {version, timestamp, delivery_id, signatures[], signature} (HMAC over "v1b:{timestamp}:{delivery_id}:" + canonical JSON of the body without cronjob_signature). Use it when your webhook platform drops the X-Cronjob-* headers (e.g… |
{
"name": "update_job",
"title": "Change job settings",
"description": "Change a job in place: signature_in_body (true = triggers also carry cronjob_signature in the JSON body, for platforms that drop the X-Cronjob-* headers; applies from the next attempt sent) and/or max_runs. Raising max_runs on a job completed with max_runs_reached reactivates it (next run = next occurrence after now, no catch-up); there is no separate resume for completed jobs. Returns the updated job. (REST: PATCH /v1/jobs/{id})",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "job_<ULID> returned by create_job"
},
"max_runs": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
{
"type": "null"
}
],
"description": "New run limit (1 … 1000000), must be greater than run_count; null = unlimited. ≤ run_count → 400. Paused/disabled jobs keep their status."
},
"management_token": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "act_mt_… management token. Optional if the MCP HTTP request carries Authorization: Bearer <management_token>."
},
"signature_in_body": {
"type": "boolean",
"description": "Default false. true = every trigger body also carries cronjob_signature {version, timestamp, delivery_id, signatures[], signature} (HMAC over \"v1b:{timestamp}:{delivery_id}:\" + canonical JSON of the body without cronjob_signature). Use it when your webhook platform drops the X-Cronjob-* headers (e.g. Grok Bot routines)."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Change job settings",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Stop triggering (idempotent). Schedule points while paused are not made up later. (REST: POST /v1/jobs/{id}/pause)
| Parameter | Type | Description |
|---|---|---|
| job_id * | string | job_<ULID> returned by create_job |
| management_token | string | act_mt_… management token. Optional if the MCP HTTP request carries Authorization: Bearer <management_token>. |
{
"name": "pause_job",
"title": "Pause a job",
"description": "Stop triggering (idempotent). Schedule points while paused are not made up later. (REST: POST /v1/jobs/{id}/pause)",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "job_<ULID> returned by create_job"
},
"management_token": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "act_mt_… management token. Optional if the MCP HTTP request carries Authorization: Bearer <management_token>."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Pause a job",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Resume a paused or disabled job from its next schedule point; resets consecutive_failures. (REST: POST /v1/jobs/{id}/resume)
| Parameter | Type | Description |
|---|---|---|
| job_id * | string | job_<ULID> returned by create_job |
| management_token | string | act_mt_… management token. Optional if the MCP HTTP request carries Authorization: Bearer <management_token>. |
{
"name": "resume_job",
"title": "Resume a job",
"description": "Resume a paused or disabled job from its next schedule point; resets consecutive_failures. (REST: POST /v1/jobs/{id}/resume)",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "job_<ULID> returned by create_job"
},
"management_token": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "act_mt_… management token. Optional if the MCP HTTP request carries Authorization: Bearer <management_token>."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Resume a job",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Stop the job forever and revoke all its credentials. Cannot be undone. (REST: DELETE /v1/jobs/{id})
| Parameter | Type | Description |
|---|---|---|
| job_id * | string | job_<ULID> returned by create_job |
| management_token | string | act_mt_… management token. Optional if the MCP HTTP request carries Authorization: Bearer <management_token>. |
{
"name": "delete_job",
"title": "Delete a job",
"description": "Stop the job forever and revoke all its credentials. Cannot be undone. (REST: DELETE /v1/jobs/{id})",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "job_<ULID> returned by create_job"
},
"management_token": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "act_mt_… management token. Optional if the MCP HTTP request carries Authorization: Bearer <management_token>."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Delete a job",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Trigger log, newest first: scheduled_at, first attempt time, delay, attempts, status and last response code of each run. since/until (ISO 8601) filter scheduled_at; page with next_cursor. (REST: GET /v1/jobs/{id}/runs)
| Parameter | Type | Description |
|---|---|---|
| limit | integer | |
| since | string | |
| until | string | |
| cursor | string | |
| job_id * | string | job_<ULID> returned by create_job |
| status | string | one of ["pending","succeeded","failed","missed","superseded","cancelled"] |
| management_token | string | act_mt_… management token. Optional if the MCP HTTP request carries Authorization: Bearer <management_token>. |
{
"name": "get_deliveries",
"title": "Run history",
"description": "Trigger log, newest first: scheduled_at, first attempt time, delay, attempts, status and last response code of each run. since/until (ISO 8601) filter scheduled_at; page with next_cursor. (REST: GET /v1/jobs/{id}/runs)",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"job_id"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 200,
"minimum": 1
},
"since": {
"type": "string"
},
"until": {
"type": "string"
},
"cursor": {
"type": "string"
},
"job_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "job_<ULID> returned by create_job"
},
"status": {
"enum": [
"pending",
"succeeded",
"failed",
"missed",
"superseded",
"cancelled"
],
"type": "string"
},
"management_token": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "act_mt_… management token. Optional if the MCP HTTP request carries Authorization: Bearer <management_token>."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Run history",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}One run and each delivery attempt: sent_at, response status, duration, error and next retry. (REST: GET /v1/jobs/{id}/runs/{run_id})
| Parameter | Type | Description |
|---|---|---|
| job_id * | string | job_<ULID> returned by create_job |
| run_id * | string | |
| management_token | string | act_mt_… management token. Optional if the MCP HTTP request carries Authorization: Bearer <management_token>. |
{
"name": "get_run",
"title": "One run with every delivery attempt",
"description": "One run and each delivery attempt: sent_at, response status, duration, error and next retry. (REST: GET /v1/jobs/{id}/runs/{run_id})",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"job_id",
"run_id"
],
"properties": {
"job_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "job_<ULID> returned by create_job"
},
"run_id": {
"type": "string",
"maxLength": 64,
"minLength": 1
},
"management_token": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "act_mt_… management token. Optional if the MCP HTTP request carries Authorization: Bearer <management_token>."
}
},
"additionalProperties": false
},
"annotations": {
"title": "One run with every delivery attempt",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}On-time rate, p50/p95 first-attempt delay and success rate over a window (default 24h). (REST: GET /v1/jobs/{id}/stats)
| Parameter | Type | Description |
|---|---|---|
| job_id * | string | job_<ULID> returned by create_job |
| window | string | one of ["1h","24h","7d","30d"] |
| management_token | string | act_mt_… management token. Optional if the MCP HTTP request carries Authorization: Bearer <management_token>. |
{
"name": "get_stats",
"title": "Punctuality stats",
"description": "On-time rate, p50/p95 first-attempt delay and success rate over a window (default 24h). (REST: GET /v1/jobs/{id}/stats)",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "job_<ULID> returned by create_job"
},
"window": {
"enum": [
"1h",
"24h",
"7d",
"30d"
],
"type": "string"
},
"management_token": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "act_mt_… management token. Optional if the MCP HTTP request carries Authorization: Bearer <management_token>."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Punctuality stats",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}New hmac_secret (SHOWN ONCE, store it now). Until previous.expires_at (grace_sec, default 24 h) triggers carry two v1= signatures, new first. (REST: POST /v1/jobs/{id}/rotate-secret)
| Parameter | Type | Description |
|---|---|---|
| job_id * | string | job_<ULID> returned by create_job |
| grace_sec | integer | |
| management_token | string | act_mt_… management token. Optional if the MCP HTTP request carries Authorization: Bearer <management_token>. |
{
"name": "rotate_secret",
"title": "Rotate the HMAC signing secret",
"description": "New hmac_secret (SHOWN ONCE, store it now). Until previous.expires_at (grace_sec, default 24 h) triggers carry two v1= signatures, new first. (REST: POST /v1/jobs/{id}/rotate-secret)",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "job_<ULID> returned by create_job"
},
"grace_sec": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"management_token": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "act_mt_… management token. Optional if the MCP HTTP request carries Authorization: Bearer <management_token>."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Rotate the HMAC signing secret",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}
}New management_token (SHOWN ONCE, store it now). The old one stops working after grace_sec (default 0 = immediately). (REST: POST /v1/jobs/{id}/rotate-token)
| Parameter | Type | Description |
|---|---|---|
| job_id * | string | job_<ULID> returned by create_job |
| grace_sec | integer | |
| management_token | string | act_mt_… management token. Optional if the MCP HTTP request carries Authorization: Bearer <management_token>. |
{
"name": "rotate_token",
"title": "Rotate the management token",
"description": "New management_token (SHOWN ONCE, store it now). The old one stops working after grace_sec (default 0 = immediately). (REST: POST /v1/jobs/{id}/rotate-token)",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "job_<ULID> returned by create_job"
},
"grace_sec": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"management_token": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "act_mt_… management token. Optional if the MCP HTTP request carries Authorization: Bearer <management_token>."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Rotate the management token",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}
}agent-cronjob triggers YOUR webhook on a schedule (cron / interval / one-off): HMAC-signed, retried with exponential backoff, every run logged. No account or API key. Flow: 1. create_job {webhook_url, schedule} → job_id + setup_token (keep it private). We immediately POST {"type":"url_verification","challenge":"…"} to webhook_url. 2. Prove you control the webhook — either - echo: your webhook replies 2xx {"challenge":"<same value>"}; or - callback: your webhook replies 2xx, then call verify_challenge {job_id, challenge}. Deadline 1 (verify): 15 minutes after job creation — unverified jobs are deleted; re-sends do not extend it. Not received? retry_challenge. 3. Credentials, SHOWN ONCE: in the verify_challenge result (callback) or the first claim_credentials {job_id, setup_token} result after echo verification. Store hmac_secret and management_token in your secret store immediately; they cannot be shown again (rotate_secret / rotate_token instead). Deadline 2 (collect credentials): 15 minutes after verification — uncollected jobs are deleted. 4. Triggers arrive as POSTs with X-Cronjob-Signature: v1=hex(HMAC-SHA256(hmac_secret, "v1:{X-Cronjob-Timestamp}:{X-Cronjob-Delivery-Id}:{raw body}")). Verify it, de-duplicate on delivery_id, reply 2xx (others are retried; 410 pauses the job). 5. Manage with management_token (tool argument, or Authorization: Bearer on the MCP HTTP request): get_job, list_jobs, pause_job, resume_job, delete_job, get_deliveries (run history: scheduled vs actual time, delay, response code), get_run, get_stats. Your webhook must be a public https URL (private/loopback addresses are refused). Same rate limits as the REST API (https://cronjob.agentasy.ai/v1). Full guide: resource how_it_works (https://cronjob.agentasy.ai/llms.txt). Entry point for plain HTTP agents: https://new-cronjob.agentasy.ai/.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.