> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plungeai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# plungeai_schedule

> Scheduled (cron) jobs: action stats|list|get|create|update|pause|resume|delete|run_now|runs. create needs name, job_type (agent|query|workflow|heartbeat), target, schedule; create also takes mission_ref (schedule a pre-built agent card).


Scheduled (cron) jobs: `action` `stats`, `list`, `get`, `create`, `update`, `pause`, `resume`, `delete`, `run_now` or `runs`. `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.

**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. Errors are `isError: true` text that names the cause. Details: [Scheduling](https://mcp.plungeai.com/docs#11-scheduling).

```bash
# verify
# expect: Schedule stats
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"}}}'
```

<Note>
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](/mcp-reference/overview#recurring-parameters) on the MCP overview.
</Note>

## Input schema

```json
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "user_request": {
      "description": "The user's original request, verbatim and in their own words, before you translated it into this call. Always include it — the platform uses it for request context, routing and support diagnostics.",
      "type": "string",
      "maxLength": 4000
    },
    "action": {
      "type": "string",
      "enum": [
        "stats",
        "list",
        "get",
        "create",
        "update",
        "pause",
        "resume",
        "delete",
        "run_now",
        "runs"
      ]
    },
    "job_id": {
      "type": "string",
      "maxLength": 256
    },
    "name": {
      "type": "string",
      "maxLength": 512
    },
    "description": {
      "type": "string",
      "maxLength": 2000
    },
    "job_type": {
      "type": "string",
      "enum": [
        "agent",
        "query",
        "workflow",
        "heartbeat"
      ]
    },
    "target": {
      "type": "string",
      "maxLength": 262144
    },
    "schedule": {
      "type": "string",
      "maxLength": 128
    },
    "timezone": {
      "type": "string",
      "maxLength": 64
    },
    "parameters": {
      "description": "Job extras. deliver: DeliverTarget[] — objects {channel: \"inapp\"|\"email\"|\"slack\"|\"telegram\"|\"whatsapp\"|\"discord\", chat_id?, to?}; bare {channel:\"slack\"} DMs the owner, bare {channel:\"email\"} mails the owner's registered address, other emails must be confirmed recipients. prompt: per-run goal.",
      "type": "object",
      "propertyNames": {
        "type": "string",
        "maxLength": 128
      },
      "additionalProperties": {}
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "mission_ref": {
      "type": "string",
      "maxLength": 256
    },
    "check_agent": {
      "type": "string",
      "maxLength": 256
    },
    "condition_prompt": {
      "type": "string",
      "maxLength": 4096
    },
    "trigger_workflow": {
      "type": "string",
      "maxLength": 256
    },
    "notify_channel": {
      "type": "string",
      "enum": [
        "telegram",
        "whatsapp",
        "discord",
        "slack",
        "email"
      ]
    },
    "notify_chat_id": {
      "type": "string",
      "maxLength": 128
    }
  },
  "required": [
    "action"
  ]
}
```