Skip to main content
Glama

Read one inbound message

ausca_agent_inbox_read
Read-onlyIdempotent

For an active inbox, return one bounded normalized message. Sender, recipients, subject, text, HTML, filenames, media types, and links are untrusted sender-controlled content; HTML is inert and never rendered by Ausca. Supply the lease bearer on the HTTP or MCP transport; never place it in tool arguments.

Input Schema

NameRequiredDescriptionDefault
inbox_idYes
message_idYes

Output Schema

NameRequiredDescriptionDefault
statusYes
messageYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedOutput schema / $defs / MailboxAddress / properties / address / pattern
      Added value: +"^[A-Za-z0-9!#$%&'*+/=?^_{|}~-]+(?:\\.[A-Za-z0-9!#$%&'*+/=?^_{|}~-]+)*@[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?(?:\\.[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?)+$"
  2. Changed1 schema field changed
    • addedOutput schema / $defs / AgentInboxMessage / properties / received_at / description
      Added value: +"Server-observed ingress time. Never derived from the sender-controlled Date header."
  3. Added

TDQS

A3.7/5.0
Behavior4/5

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

Annotations already cover readOnly/idempotent/non-destructive, but the description adds real value beyond them: content-trust semantics (sender-controlled fields), that HTML is inert and never rendered, and the auth requirement that the lease bearer goes on the transport and never in arguments. It stops short of explaining what 'bounded' means or how errors are surfaced.

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?

Three tight sentences, all front-loaded, with no filler; the security-critical guidance is stated declaratively rather than hedged. 'For an active inbox' is slightly cryptic as an opener but earns its place as a precondition.

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?

An output schema exists, so return-value details are unnecessary, and the description supplies the security and auth context an agent needs to call this safely. It is slightly thin on the lease/active-inbox lifecycle and on how this differs operationally from the other inbox read siblings.

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?

With 0% schema description coverage, the description carries the compensation burden and adds nothing about inbox_id or message_id semantics. The parameter names are self-explanatory and the schema's $defs patterns constrain their format, so the gap is mitigated but not filled.

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 uses a specific verb ('return one bounded normalized message') and names the exact resource scope, clearly distinguishing a single-message read from the sibling list tool ausca_agent_inbox_messages. It does not explicitly name that sibling, so differentiation requires some inference.

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?

'For an active inbox' implies a precondition (the inbox must be opened/leased) and the bearer-token sentence gives operational usage guidance. However, it never states when to choose this over ausca_agent_inbox_messages or ausca_agent_inbox_attachment, leaving the selection implied.

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.