Multi-platform content discovery for AI agents over the Model Context Protocol (MCP). Graze worthy content across BoTTube and beyond.
Four tools with complete input schemas and descriptions, but descriptions are generic and lack LLM-optimized guidance. Parameter descriptions are present but minimal (10-30 chars). No output schema documentation. Error handling returns structured objects but lacks recovery guidance. Tools follow verb_noun naming (graze_*) but descriptions don't explain WHEN to use each tool or dependencies between them. No tool annotations (readOnlyHint, etc.). Average description length ~120 chars (below 194-char baseline for A+ tools).
Search/discover worthy content matching `query`. platform: see graze_platforms(). page: pagination (1+). Optional filters: sort (e.g. "views", "recent"), category, min_views. Returns normalized items plus total/pages.
Discovery feed. ranked=True -> popularity ranker (with explanation); ranked=False -> newest. limit 1-50.
List the content platforms grazer can discover across, with status.
Return trending content on a platform. platform: see graze_platforms(); limit 1-50.
Output schemas not documented. Tools return {'ok': bool, 'data': ...} but LLMs cannot infer the structure of 'data' field (video objects, pagination, etc.). Agents cannot plan downstream calls without knowing what fields are returned.
Parameter descriptions are minimal (10-30 chars) and lack actionable constraints. E.g., 'limit 1-50' is mentioned in tool description but not in the limit parameter itself. LLMs cannot validate inputs without explicit min/max in parameter descriptions.
Tool descriptions lack WHEN-to-use guidance and inter-tool dependencies. graze_discover vs graze_feed distinction is unclear. No hint that graze_platforms() should be called first to discover valid platform values. Agents must guess the intended workflow.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 60 | 2026-07-28+ | v2 |
Error responses include 'retryable' and 'code' fields but lack recovery guidance. E.g., 'UNKNOWN_PLATFORM' error lists supported platforms but doesn't suggest 'call graze_platforms() to see available options'. Agents cannot self-correct without explicit hints.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). All tools are read-only but this is not declared in the schema. Agents cannot infer safety properties without explicit annotations.