MCP server for financial market analysis using AlphaVantage API, providing technical analysis tools including moving averages, RSI, MACD, and trading recommendations
Server has 4 tools with visible schemas and descriptions, but quality is inconsistent. All tools have input schemas with types and descriptions (baseline met), but descriptions vary widely in clarity and actionability. calculate_macd has a minimal 31-char description; calculate_moving_averages and calculate_rsi have verbose docstrings with Args/Returns sections that duplicate parameter descriptions; trade_recommendation is incomplete in the source. No output schemas documented. No error handling guidance. No tool annotations (readOnlyHint, destructiveHint). Parameter descriptions are present but generic (e.g., 'The ticker symbol to analyze' lacks format/constraint hints). No pagination, no batch operations. Tools lack recovery guidance on API failures (AlphaVantage rate limits, missing data).
Calculate MACD and Signal Line
Calculate short and long moving averages for a symbol Args: symbol: The ticker symbol to analyze short_period: Short moving average period in minutes long_period: Long moving average period in minutes Returns: Dictionary with moving average data and analysis
Calculate Relative Strength Index (RSI) for a symbol Args: symbol: The ticker symbol to analyze period: RSI calculation period in minutes Returns: Dictionary with RSI data and analysis
Provide a comprehensive trade recommendation based on multiple indicators Args: symbol: The ticker symbol to analyze Returns: Dictionary with trading recommendation and supporting data
calculate_macd description is 31 characters ('Calculate MACD and Signal Line'), below 20-char hard floor for scoring. Lacks context on when to use it, what it returns, or prerequisites (price list format, minimum length).
No output schemas documented for any tool. LLMs cannot plan downstream calls or extract fields without knowing return structure. calculate_moving_averages returns a dict with 8+ fields; trade_recommendation is incomplete in source.
No error handling or recovery guidance. AlphaVantage API calls can fail (rate limits, invalid symbol, network timeout). Tools raise ValueError but do not guide LLM on retry strategy or fallback actions.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 58 | 2026-07-28+ | v2 |
Parameter descriptions are generic and lack constraints. 'The ticker symbol to analyze' does not specify format (uppercase? length? valid exchanges?). 'period in minutes' is ambiguous, does it mean candle size or lookback window?
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). All tools are read-only (marked in metadata) but this is not declared in tool definitions, forcing LLMs to infer safety.