AI-powered content generator that fetches real-time information and generates short-form video scripts for Instagram Reels and YouTube Shorts
Story Forge has 2 tools with basic descriptions and minimal parameter documentation. Both tools accept a single string parameter ('query') with adequate descriptions, but lack structured output schemas, error handling guidance, and parameter constraints. Naming follows verb_noun convention (get_*, generate_*), which is good. However, descriptions are functional but generic (194-char baseline suggests these are below average). No input validation, enum constraints, or recovery guidance. The tools are simple wrappers around underlying functions, which is acceptable, but the MCP interface lacks production-grade polish.
Generate a short-form video script (Instagram Reels / YouTube Shorts). This tool performs two steps: 1. Fetches real-time information using the query 2. Converts that information into a creative ~200-word video script
Fetch real-time information for a given query. This tool retrieves up-to-date information (news, trends, or general info) based on the user query. It acts as a wrapper over the underlying `get_realtime_info` function.
No output schema documented. Tools return str but LLMs cannot infer structure, field names, or downstream chaining requirements.
No error handling or recovery guidance. Functions return error strings on failure, but LLMs receive no actionable next steps (retry, fallback, user input).
Query parameter lacks constraints. No enum, regex, length limits, or format guidance. LLMs may pass invalid or excessively long queries.
No pagination or result limits documented. get_latest_info_mcp fetches 5 results from Tavily but does not expose limit/offset parameters or indicate max response size.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 46 | 2026-07-28+ | v2 |
API keys (OPENAI_API_KEY, TAVILY_API_KEY) loaded from .env in app.py. While not exposed as tool parameters, best practice is explicit server-side secret injection documentation.