Skip to main content
Glama

Curated

Read a list's picks

get_list_items
Read-onlyIdempotent

Read one list and report each pick's details status. The capture read-back check; use the exact slug returned by create_list or list_my_lists.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
listYesExact returned slug, handle/slug, title, or id.
formatNoHow to render the reply text. 'text' (default): numbered rows, one field per line, best for reading the list yourself. 'markdown': linked bold titles and quoted notes, for relaying the list to the user as-is.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

C2.7/5.0
Behavior3/5

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

Annotations already declare readOnlyHint=true, idempotentHint=true and destructiveHint=false, so the safety profile is covered. The description adds only that each pick's "details status" is reported and that the slug must come from create_list/list_my_lists — useful but thin; no pagination, ordering, or auth context.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

It is short and front-loads the core action, which is good. However, the second sentence is a fragment ("The capture read-back check; use the exact slug...") that reads as two clauses stitched together, costing clarity for no gain in brevity.

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

Completeness2/5

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

There is no output schema, so the description carries the burden of describing what comes back, and "each pick's details status" is too vague for that. It also omits any pagination/limit behavior for a list that could contain many picks, leaving an agent under-informed before calling.

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 100%, so both parameters are already documented, including the format enum's two modes. The description's note about using "the exact slug returned by create_list or list_my_lists" marginally reinforces the `list` parameter but adds nothing the schema doesn't already say.

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 verb+resource are identifiable (read one list and report its picks), but the phrasing is awkward and never distinguishes this tool from near-identical siblings such as list_items, get_list, or get_list_updates. An agent could not confidently pick this over list_items from the description alone.

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?

"The capture read-back check" is a garbled sentence fragment that only obliquely hints at a usage scenario (verifying picks after a capture). It names no alternatives and gives no when-not guidance, which matters given several overlapping list-reading siblings.

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