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’.

​
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). 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).