Tools
plungeai_schedule
Scheduled (cron) jobs: action stats|list|get|create|update|pause|resume|delete|run_now|runs|wake.
Authorizations
Authorization: Bearer ozk_….X-API-Key: ozk_….Every request needs a key, tools/list included.
Arguments
Maximum string length: 4000
Available options: stats, list, get, create, update, pause, resume, delete, run_now, runs, wake, webhook_mint, webhook_list, webhook_delete, webhook_rotate, email_mint, email_list, email_delete, email_rotate, hooks_mint, hooks_list, hooks_delete
for `get`, `update`, `pause`, `resume`, `delete`, `run_now`, `wake` and every trigger action
Maximum string length: 256
for `create`
Maximum string length: 512
Maximum string length: 2000
for a plain `create`
Available options: agent, query, workflow, heartbeat
for a plain `create`
Maximum string length: 262144
for `create`
Maximum string length: 128
Default: UTC
Maximum string length: 64
for `create` with `schedule: "@once"`
Maximum string length: 64
Maximum string length: 64
Default: 50 for list, 20 for runs
Required range: 1 <= x <= 100
Maximum string length: 256
for a heartbeat, unless `check_workflow`
Maximum string length: 256
Maximum string length: 256
for a heartbeat
Maximum string length: 4096
Maximum string length: 256
Available options: telegram, whatsapp, discord, slack, teams, email
Maximum string length: 128
Maximum string length: 512
for `webhook_delete`, `webhook_rotate`, `email_delete`, `email_rotate`, `hooks_delete`
Maximum string length: 256
Maximum string length: 16384
Default: generic
Maximum string length: 64
Default: anyone
Maximum string length: 16384
for `hooks_mint`
Maximum string length: 512
for `hooks_mint`
Maximum array length: 16
Output
Markdown text.
Scheduled (cron) jobs: action stats|list|get|create|update|pause|resume|delete|run_now|runs|wake. create needs name, job_type (agent|query|workflow|heartbeat), target, schedule; create also takes mission_ref (schedule a pre-built agent card), ends_at, and schedule "@once" with run_at (an ISO-8601 time with a UTC offset) for a one-time run. wake (job_id, note) fires the job's saved workflow once. Triggers of a job (job_id): webhook_mint|webhook_list|webhook_delete, email_mint|email_list|email_delete, hooks_mint|hooks_list|hooks_delete (trigger_id deletes one; a secret is shown once, at mint); webhook_rotate|email_rotate (trigger_id) mint a successor with the same settings and revoke the old one.
Scheduled (cron) jobs: action stats, list, get, create, update, pause, resume, delete, run_now, runs or wake. create needs name, job_type (agent, query, workflow or heartbeat), target and schedule; create also takes mission_ref to schedule a pre-built agent card, ends_at to stop the job at a time, and schedule: "@once" with run_at for a one-time run. wake fires the job's saved workflow once with a note. The triggers of a job are the actions webhook_mint / webhook_list / webhook_delete / webhook_rotate, email_mint / email_list / email_delete / email_rotate and hooks_mint / hooks_list / hooks_delete. A rotate mints a successor with the same settings, then revokes the old trigger.
Returns. Markdown text per action: tables for list and runs, the job as JSON for get, a one-line confirmation for the writes, and for run_now the execution id to poll. wake: the time the woken run starts. The trigger actions answer with the scheduler's JSON in a block: a mint or a rotate shows its secret once and never again. Errors are isError: true text that names the cause. Details: Scheduling (opens in a new tab).
curl -s https://mcp.plungeai.com/v1 \
-H "Authorization: Bearer $PLUNGE_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"plungeai_schedule","arguments":{"user_request":"what do I have scheduled?","action":"stats"}}}'One parameter recurs across the tools: user_request (on every tool: a string of up to 4,000 characters, optional; clients should always send it). It is described once in Recurring parameters on the MCP overview.