Free trend monitoring & breakout alerts that run in your own GitHub repo. Powered by Trends MCP.
TrendWatch exposes 2 tools with basic verb-noun naming (get_trends, get_growth) and reasonable descriptions (60-80 chars). However, critical gaps undermine quality: parameter descriptions are minimal or absent (e.g., 'data_mode' lacks explanation of valid values or purpose), no output schemas are documented, no error handling guidance is provided, and no tool annotations (readOnlyHint, etc.) are present. The tools appear to be thin wrappers around a REST API with minimal LLM-optimization. Descriptions meet minimum length but lack actionable context (e.g., when to use get_trends vs get_growth, what 'data_mode' controls, what fields are returned).
Point-to-point % growth for a keyword across one or more periods.
Historical normalized (0-100) time series for a keyword.
No output schemas documented. LLMs cannot plan downstream calls or extract fields without knowing what get_trends and get_growth return. Baseline: 100% of A+ tools document return types.
Parameter 'data_mode' lacks description. It appears in both tools but has no explanation of valid values, purpose, or when to use it. LLMs will guess or omit it.
No error handling guidance. Client code defines TrendsError, RateLimited, MissingKey exceptions, but tool descriptions do not explain what errors are possible, when they occur, or how to recover. Pattern: recovery-guide.
No tool annotations. Tools lack readOnlyHint (both are read-only), idempotentHint (both appear idempotent), or destructiveHint. Annotations help LLMs reason about retry safety and side effects.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 52 | 2026-07-28+ | v2 |
Minimal parameter descriptions. 'source' and 'keyword' have brief descriptions; 'periods' (array) lacks detail on format, length, or valid period strings (e.g., '7D', '30D'). Baseline: 100% of A+ tool params have descriptions.