Generate research reports by fetching and compiling multiple web sources on a topic.
Single tool with adequate naming (research_generate_report) and comprehensive description (194 chars, within baseline 34-392 range). Input schema present with proper types and descriptions for both parameters. However, output schema is completely undocumented, the tool returns markdown-formatted report but LLMs have no structured schema to parse response fields. No error handling guidance, no parameter constraints (depth enum should be enforced), and no documentation of what fields the markdown contains or how to extract data from it. Tool description includes helpful anti-patterns (what NOT to use it for) but lacks actionable error recovery guidance.
Use this when you need a comprehensive research report on any topic. Accepts a topic and optional depth parameter. Fetches multiple web sources, extracts key information, and compiles a structured report with summary, key findings, sources, and analysis. Returns markdown-formatted report. Do NOT use for simple web search — use web_search_query instead. Do NOT use for single page scraping — use web_scrape_to_markdown instead. Do NOT use for SEO analysis — use seo_audit_page instead.
Output schema completely undocumented. Tool returns markdown-formatted report but no structured schema defines response fields, format, or structure. LLMs cannot reliably extract data from unstructured markdown.
depth parameter accepts free-form string instead of enum. Should constrain to ['quick', 'standard', 'deep'] to prevent hallucinated values and self-document valid options.
No error handling guidance. Tool can fail (missing TAVILY_API_KEY, network timeouts, invalid topic) but provides no recovery hints. Error responses should guide LLM on next steps.
No pagination or result limits documented. Tool fetches 3-8 sources but response structure (how many sources returned, total available, next_cursor) is undefined.
Inferred effective spec: 2025-06-18+.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 60 | 2025-06-18+ | v2 |
Tool description lacks WHEN to use it beyond anti-patterns. Should explicitly state: 'Use when you need a multi-source synthesis with citations. Returns markdown report with summary, key findings, and source links.'