MCP Tool

`messages_read`

Read scheduled messages. Pass an `id` to fetch a single message (with its delivery status), or omit it to list messages. Anonymous callers can't list, but can fetch a public message by ID.

Input schema

api_keystring

Optional API key for authentication.

idstring

Message ID — when set, returns that single message.

limitinteger

List size (1–100, default 20).

afterstring

List cursor: ID of the last message from the previous page.

Example call

tools/call params

{
  "name": "messages_read",
  "arguments": {
    "api_key": "agt_…"
  }
}