Skip to main content
Glama

get_agent_conversation

Read-onlyIdempotent

Read only the authenticated client and customer account's own conversation.

Input Schema

NameRequiredDescriptionDefault
thread_idYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

C2.8/5.0
Behavior3/5

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

Annotations already declare readOnlyHint, idempotentHint, destructiveHint=false and openWorldHint=false, so the safety profile is fully covered elsewhere. The description's one contribution beyond that is the access-scoping constraint (only the authenticated client/customer's own conversation), which is meaningful, but it says nothing about authorization failure behavior or what is returned.

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 short sentence with the read-only scope front-loaded and no padding. The phrasing is slightly tangled ('client and customer account's'), costing a bit of immediacy, but nothing is wasteful.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a one-parameter read tool with rich annotations and no output schema, the description covers enough to act, but it omits the key gap: how thread_id is sourced (presumably from list_agent_conversations) and that a non-matching thread is rejected. Those omissions are the difference between adequate and complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0% and the single required parameter thread_id has no documentation in the schema, so the description must compensate — and it does not. It never mentions thread_id, its provenance, or its 36-character format, leaving the agent to infer how to obtain a valid identifier.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose3/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a verb ('Read') and a resource ('conversation'), and the qualifier 'own' signals it returns a single conversation scoped to the caller rather than a collection. It never states that it retrieves by thread identifier, and the awkward phrasing ('the authenticated client and customer account's own conversation') leaves the exact subject of the read fuzzy, so it only weakly separates itself from get/list siblings.

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

Usage Guidelines2/5

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

'Read only ... own conversation' implies single-item retrieval, which hints at the boundary against list_agent_conversations, but no sibling is named and no condition is given for choosing one over the other. There is also no guidance on when the call fails, e.g. when the thread belongs to another account.

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