MCP Tool

`messages_write`

Schedule or cancel a message. `schedule` fires an HTTP request at a URL at a future time — provide either `scheduled_at` (absolute Unix seconds) or `delay_seconds` (relative to now). `cancel` deletes a scheduled message (requires `id`); if it hasn't fired yet, it never will.

Input schema

api_keystring

Optional API key for authentication.

action"schedule" | "cancel"required

The operation to perform.

idstring

Message ID (required for cancel).

urlstring

Target URL (http/https) to send the request to (required for schedule).

method"GET" | "POST" | "PUT" | "PATCH" | "DELETE"

HTTP method (default POST).

headersobject

Optional request headers.

bodystring

Optional request body (sent for non-GET methods).

scheduled_atinteger

Absolute fire time, Unix seconds.

delay_secondsinteger

Fire this many seconds from now.

Example call

tools/call params

{
  "name": "messages_write",
  "arguments": {
    "api_key": "agt_…",
    "action": "schedule"
  }
}