Skip to main content
Glama

Cherami

Read saved draft

get_draft
Read-onlyIdempotent

Read a draft's saved recipients, bodies, reply target and attachments, including file bytes.

Input Schema

NameRequiredDescriptionDefault
draft_idYes

Output Schema

NameRequiredDescriptionDefault
idYes
fromYesSender from the inbox's current settings, applied when the draft is sent. For a submitted draft, the linked sent message shows the sender used.
stateYes
contentYes
subjectYes
inbox_idYes
created_atYesAbsolute ISO 8601 service timestamp in UTC (Z), with millisecond precision.
updated_atYesAbsolute ISO 8601 service timestamp in UTC (Z), with millisecond precision.
sent_message_idYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / properties / from / description
      Previous value: -"Current inbox sender settings. For a submitted draft, the linked sent message holds the sender used."New value: +"Sender from the inbox's current settings, applied when the draft is sent. For a submitted draft, the linked sent message shows the sender used."
  2. Changed1 schema field changed
    • changedOutput schema / properties / from / description
      Previous value: -"Current inbox sender settings, not a historical sender snapshot. For submitted drafts, retrieve the linked sent message."New value: +"Current inbox sender settings. For a submitted draft, the linked sent message holds the sender used."
  3. First observed

TDQS

A3.7/5.0
Behavior4/5

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

Annotations already declare readOnlyHint, idempotentHint, and destructiveHint=false, so the safety profile is covered. The description adds useful context beyond them by noting the read includes file bytes, hinting at potentially heavy payloads. It stops short of pagination, size limits, or error behavior.

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?

A single front-loaded sentence with no filler; the resource is stated first and its contents enumerated immediately after. Efficient and easy to scan.

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?

For a single-resource read with an output schema and full annotation coverage, the description covers the essentials. The only gap is the absence of any usage routing against the many sibling read/list tools.

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 description coverage is 0%, so the description must carry the parameter meaning, and it only implies selection by a single draft via 'a draft's'. The lone draft_id parameter is trivially named and format-constrained in the schema, so little is actually lost, but no syntax or constraint detail is added.

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?

Names a specific verb ('Read') and resource ('draft') and goes on to enumerate the returned contents (recipients, bodies, reply target, attachments, file bytes), so the agent knows exactly what a draft fetch yields. It is clearly distinguished from list_drafts by the singular, by-ID framing, though it never names a sibling explicitly.

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

Usage Guidelines3/5

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

Usage is only implied: the singular 'a draft's' signals retrieval by ID rather than listing. There is no statement of when to prefer this over list_drafts or get_message, and no prerequisites or exclusions are given.

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