Skip to main content
Glama

See the lists

list
Read-onlyIdempotent

The project's open tasks, requests and questions; key reads one item, open or done. Answer every question about the work and the lists with it. Shows 50 items at a time and says where the next ones start.

Input Schema

NameRequiredDescriptionDefault
keyNoone item by its key (B-k3f9) or whole title, with its notes, what it waits on and frees, and its history
findNowords to look for: items with all of them, else titles with any; searches done items too unless status is set
fromNostart at this item (from 0)
fullNowith key: every note whole (past 10, those between the first and the latest are a line each)
kindNotask, request, question, one of your own lists by name, or all (default)
limitNohow many items to show, 50 by default
statusNoopen (default), ready (open, waits on nothing), done or all
historyNotrue: what changed lately instead, who did it and when, deletions too; with find, only the items it names
projectNoIts name or id, as the projects tool lists them; leave it out on one project, or in a folder linked to one.
sectionNoonly items under this heading

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=true, idempotentHint=true, and destructiveHint=false, so the safety profile is covered. The description adds useful behavior about pagination (50 items at a time, plus where the next page starts) and the one-item key mode, but does not describe rate limits, permissions, or deeper output behavior.

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?

The description is short and reasonably front-loaded. However, the middle sentence ('Answer every question about the work and the lists with it') is vague and does not clearly earn its place compared with the more useful purpose and pagination sentences.

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?

Given ten optional parameters, rich schema descriptions, and strong annotations, the description is minimally adequate. It still leaves important gaps around how to choose among sibling tools and what a returned list item looks like beyond the pagination note.

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 all ten parameters are already well documented in the schema. The description mentions key, open/done status, the 50-item default, and pagination, but it mostly restates what the schema already says rather than adding new parameter semantics.

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 identifies a resource collection (open tasks, requests, questions) and notes that passing a key reads one item instead of listing. However, it does not clearly distinguish this tool from close siblings such as lists, view, or find, and the phrasing is indirect rather than a crisp verb+resource statement.

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 sentence 'Answer every question about the work and the lists with it' implies broad use but provides no real when-to-use/when-not-to-use guidance. It names no alternatives and gives no rule for choosing between this tool and sibling list/view/search-style tools.

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