Skip to main content
Glama

List sent emails

listSentEmails
Read-onlyIdempotent

List outbound emails sent by this org, with cursor pagination and filters. Each row is id, thread_id, created_at, status, from, to, subject and a snippet, plus the error, SMTP response or gate denial when the send did not deliver. Use getSentEmail to read the body of one. Useful for auditing delivery status, finding bounced sends, or checking gate-denied attempts.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
fullNoSet true for the record as stored. By default the result is a compact view for reading, which leaves out idempotency and content hashes, message ids, signing details and, for a delivered row, the SMTP response.
limitNoMaximum number of sent emails to return (1 to 100, default 50).
cursorNoPagination cursor from a previous response's `meta.cursor` field.
statusNoFilter to rows in this status. Use "scheduled" to find pending scheduled sends and "canceled" for ones already canceled.
date_toNoInclusive upper bound on created_at. An ISO 8601 date-time with Z or a UTC offset ("2026-10-01T09:00:00Z", "2026-10-01T09:00:00-04:00"), or a calendar date ("2026-10-01"), which runs to the end of that day, UTC. A time with no offset is read as UTC.
date_fromNoInclusive lower bound on created_at. An ISO 8601 date-time with Z or a UTC offset ("2026-10-01T09:00:00Z", "2026-10-01T09:00:00-04:00"), or a calendar date ("2026-10-01"), which starts at 00:00 UTC. A time with no offset is read as UTC.
request_idNoFilter to the row matching a specific server-issued request_id from a /send-mail response.
idempotency_keyNoFilter to rows with the given client idempotency key.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
dataYes
toolYes
statusYes
statusTextNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / status / description
      Previous value: -"Filter to rows in this status. Use \"scheduled\" to find pending scheduled sends (cancelable via cancelScheduledSend) and \"canceled\" for ones already canceled."New value: +"Filter to rows in this status. Use \"scheduled\" to find pending scheduled sends and \"canceled\" for ones already canceled."
  2. Changed7 schema fields changed
    • changedInput schema / properties / date_from / description
      Previous value: -"Inclusive lower bound on created_at (ISO 8601)."New value: +"Inclusive lower bound on created_at. An ISO 8601 date-time with Z or a UTC offset (\"2026-10-01T09:00:00Z\", \"2026-10-01T09:00:00-04:00\"), or a calendar date (\"2026-10-01\"), which starts at 00:00 UTC. A time with no offset is read as UTC."
    • removedInput schema / properties / date_from / format
      Removed value: -"date-time"
    • changedInput schema / properties / date_to / description
      Previous value: -"Inclusive upper bound on created_at (ISO 8601)."New value: +"Inclusive upper bound on created_at. An ISO 8601 date-time with Z or a UTC offset (\"2026-10-01T09:00:00Z\", \"2026-10-01T09:00:00-04:00\"), or a calendar date (\"2026-10-01\"), which runs to the end of that day, UTC. A time with no offset is read as UTC."
    • removedInput schema / properties / date_to / format
      Removed value: -"date-time"
    • addedInput schema / properties / full
      Added value: +{
      +  "default": false,
      +  "description": "Set true for the record as stored. By default the result is a compact view for reading, which leaves out idempotency and content hashes, message ids, signing details and, for a delivered row, the SMTP response.",
      +  "type": "boolean"
      +}
    • changedInput schema / properties / limit / description
      Previous value: -"Maximum number of sent emails to return (1–100, default 50)."New value: +"Maximum number of sent emails to return (1 to 100, default 50)."
    • changedInput schema / properties / limit / type
      Previous value: -"number"New value: +"integer"
  3. Changed2 schema fields changed
    • changedInput schema / properties / status / description
      Previous value: -"Filter to rows in this status."New value: +"Filter to rows in this status. Use \"scheduled\" to find pending scheduled sends (cancelable via cancelScheduledSend) and \"canceled\" for ones already canceled."
    • changedInput schema / properties / status / enum
      Previous value: -[
      -  "queued",
      -  "accepted",
      -  "delivered",
      -  "bounced",
      -  "gate_denied",
      -  "failed"
      -]New value: +[
      +  "queued",
      +  "submitted_to_agent",
      +  "agent_failed",
      +  "gate_denied",
      +  "unknown",
      +  "delivered",
      +  "bounced",
      +  "deferred",
      +  "wait_timeout",
      +  "scheduled",
      +  "canceled"
      +]
  4. Changed3 schema fields changed
    • changedInput schema / properties / date_from / description
      Previous value: -"Inclusive lower bound on created_at."New value: +"Inclusive lower bound on created_at (ISO 8601)."
    • changedInput schema / properties / date_to / description
      Previous value: -"Inclusive upper bound on created_at."New value: +"Inclusive upper bound on created_at (ISO 8601)."
    • addedInput schema / properties / limit / description
      Added value: +"Maximum number of sent emails to return (1–100, default 50)."
  5. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources