Skip to main content
The 3ngram MCP server exposes the following schedules tools. Every entry is generated from the tool’s source signature and docstring, so this page never drifts from the backend.
Required parameters are marked with the required attribute. Optional parameters show their default value.

​
create_schedule

Create Schedule · writes · non-destructive · non-idempotent · closed-world Create a time-driven agent schedule that runs a prompt on a cron expression (minimum 1 hour interval). For event-driven agents use create_trigger instead. Returns: str Source: backend/src/engram/mcp/tools/schedules.py

​
Parameters

​
name
str
required
Schedule name (lowercase, alphanumeric/hyphens/underscores, 1-63 chars).
​
cron_expr
str
required
Standard 5-field cron expression (e.g. ‘0 8 * * 1’ for Monday 08:00). Minimum interval is 1 hour.
​
prompt_name
str
required
Name of an existing custom prompt to run.
​
context_template
str | None
default:"None"
Optional template text injected into the prompt at execution.
​
timezone
str
default:"'UTC'"
IANA timezone (default: UTC). E.g. ‘America/New_York’, ‘Europe/London’.
​
action_on_result
str
default:"'log_only'"
‘log_only’ (default), ‘propose_action’, or ‘auto_execute’. ‘propose_action’ asks the LLM for a structured JSON envelope and writes any non-null proposed_action into pending_actions for user approval via the authenticated pending-action approval endpoint. ‘auto_execute’ runs the proposed action immediately (no approval step); requires auto_execute_confirmed=True. Use ‘propose_action’ if you want approval-gated writes.
​
auto_execute_confirmed
bool
default:"False"
Required True when action_on_result=‘auto_execute’. Explicit per-schedule opt-in acknowledging that each cron firing performs a write to an external system (or internal mutation) without further approval. Ignored for other action_on_result values.

​
delete_schedule

Delete Schedule · writes · destructive · idempotent · closed-world Delete a scheduled agent by name. Stops future cron firings; past execution history is preserved. Returns: str Source: backend/src/engram/mcp/tools/schedules.py

​
Parameters

​
name
str
required
Name of the schedule to delete.

​
get_schedule_history

Get Schedule History · read-only · non-destructive · idempotent · closed-world View recent execution history for a scheduled agent (status, duration, result summary, errors). Returns: str Source: backend/src/engram/mcp/tools/schedules.py

​
Parameters

​
name
str
required
Name of the schedule to view history for.
​
limit
int
default:"10"
Number of recent runs to return (default: 10, max: 50).

​
update_schedule

Update Schedule · writes · non-destructive · idempotent · closed-world Update fields on an existing scheduled agent (cron expression, prompt, context template, timezone, enabled flag, action_on_result mode). Returns: str Source: backend/src/engram/mcp/tools/schedules.py

​
Parameters

​
name
str
required
Name of the schedule to update.
​
cron_expr
str | None
default:"None"
New cron expression (optional).
​
prompt_name
str | None
default:"None"
New prompt name (optional).
​
context_template
str | None
default:"None"
New context template (optional, empty string to clear).
​
timezone
str | None
default:"None"
New timezone (optional).
​
enabled
str | None
default:"None"
‘true’ or ‘false’ (optional).
​
action_on_result
str | None
default:"None"
‘log_only’, ‘propose_action’, or ‘auto_execute’ (optional).
​
auto_execute_confirmed
bool
default:"False"
Required True when switching action_on_result to ‘auto_execute’. Explicit per-schedule opt-in acknowledging each run executes a write without further approval. Ignored for other values.