Skip to main content
Glama

Create schedule

create_schedule
Destructive

Send the same text to one number every day, week or month at a local time (e.g. a weekly reminder). Every occurrence runs the usual send checks.

Input Schema

NameRequiredDescriptionDefault
toYes
bodyYes
fromNoOne of your numbers. Optional when the account has exactly one number for the key's mode.
repeatYes
categoryNoOptional. It can make each occurrence stricter (`marketing`), never looser: the sending number's registration and the wording decide ([which messages are marketing](/docs/compliance-checks#which-messages-are-marketing)).
end_dateNoLast local date it may run (inclusive).
start_dateNoFirst local date it may run. Defaults to today.
quiet_hoursNoOptional. What to do with a message in the recipient's quiet hours: `block` refuses it (403 quiet_hours), `defer` holds it until their next 8:00am. Omitted: an occurrence in quiet hours is held until the recipient's 8:00am and recorded as `deferred`.
idempotency_keyNoOptional. Retries are already safe: the same call with the same inputs within 10 minutes is done once and answers with the first result. Pass your own key to dedupe across a longer gap, or a new one to repeat an identical call on purpose.
max_occurrencesNoThe schedule completes after this many messages have been sent.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

B3.2/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already flag the operation as non-read-only, destructive, open-world, and non-idempotent, so the safety profile is covered. The one genuinely additive line is 'Every occurrence runs the usual send checks,' which tells the agent that compliance checks repeat per firing; nothing is said about cost, how to stop a live schedule, or what happens on failures. No contradiction with annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two tight sentences, zero filler, with the core behavior front-loaded before the compliance note. Its brevity is appropriate to the format, though it leaves substantial ground uncovered for a ten-parameter tool.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Considering the schema already documents the recurrence fields, quiet_hours, idempotency, and date bounds in detail, and there is no output schema to explain, the description covers the essential 'what and why' adequately. It is thin on lifecycle questions (pausing, cancelling, what a created schedule returns) relative to a destructive recurring-send tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is high (70%) and the nested repeat object is fully documented in-schema, so the baseline is 3. The description contributes two useful clarifications, 'one number' (to is a single recipient, not a list) and 'at a local time' (the time is wall-clock in the given timezone), but says nothing about start_date, end_date, max_occurrences, or quiet_hours behavior.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb and resource: send the same text to one number on a daily, weekly, or monthly cadence at a local time. That implicitly separates it from send_message (one-off) and update_schedule/delete_schedule, though it never names a sibling outright. 'One number' also fixes the cardinality of the target, which the bare name does not.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Beyond the parenthetical 'e.g. a weekly reminder' there is no statement of when to choose a schedule over send_message, a scheduled message, or create_automation, all of which sit nearby in the sibling list. No exclusions, prerequisites, or limits (e.g. per-account schedule caps) are given, so an agent must infer the fit from the name alone.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources