All 5 tools have basic descriptions and parameter schemas, but quality is inconsistent. Descriptions are generic (10-60 chars) and lack actionable context for LLM selection. Parameter schemas exist but lack type specificity, 'filter' and 'orderBy' are typed as 'object' and 'array' with minimal guidance on structure. No output schemas documented. No error handling guidance. Tools follow verb_noun naming (get_*) but descriptions do not explain WHEN to use each tool or what distinguishes them. No tool annotations (readOnlyHint, etc.). Pagination parameters present but no documented result limits or total count fields.
Get a list of form responses with optional filtering and pagination.
Get a list of forms with optional filtering and pagination.
Get a list of Loomers with optional filtering and pagination.
Get the number of Loomers in a specified area.
Get a list of projects with optional filtering and pagination.
Parameter schemas lack type specificity. 'filter' and 'orderBy' typed as generic 'object'/'array' with no documentation of expected structure, field names, or valid values. LLMs cannot infer correct usage.
Tool descriptions are too generic (10-60 chars) and do not explain WHEN to use each tool or what distinguishes them. 'Get a list of Loomers' does not tell LLM why to call this vs get_loomers_in_area. Descriptions should be 50-200 chars with context.
No output schemas documented. LLMs cannot plan downstream tool calls or extract required fields (e.g., does get_loomers return areaId for chaining to get_loomers_in_area?). Every tool must document return type structure.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 43 | 2026-07-28+ | v2 |
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). All tools are read-only but this is not declared in schema. Agents cannot distinguish safe-to-retry tools from destructive ones.
Pagination parameters present but no documented result limits or total count fields. Tools may return unbounded lists, risking context window exhaustion. Baseline: cap results at 20-50 items and return pageInfo with hasNextPage.